### Set configuration options examples

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

Examples demonstrating various data types and string escaping for the set command.

```default
set option1 5
set option2 2.0
set option3 hello
set option4 hello\ world
set option5 "hello world"
```

--------------------------------

### Build and install Zathura with Meson

Source: https://github.com/pwmt/zathura/blob/develop/README.md

Use these commands to compile and install the application from the source directory.

```bash
meson build
cd build
ninja
ninja install
```

--------------------------------

### Conditional monitoring setup

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Initializes the monitor only if the user preference allows it.

```c
ZathuraFileMonitor* monitor = NULL;
bool watch_file = true;  // user preference

if (watch_file) {
    monitor = zathura_filemonitor_new(filepath, ZATHURA_FILEMONITOR_GLIB);
    if (monitor != NULL) {
        g_signal_connect(monitor, "reload-file", 
                         G_CALLBACK(on_file_changed), NULL);
        zathura_filemonitor_start(monitor);
    }
}
```

--------------------------------

### Mapping Shortcut Functions

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

Examples of mapping key combinations to specific shortcut functions with arguments.

```default
map <C-i> zoom in
map <C-o> zoom out
```

--------------------------------

### Implement Plugin Registration

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Example implementation of the plugin functions struct and registration macro call.

```c
static zathura_plugin_functions_t functions = {
    .document_open = pdf_document_open,
    .document_free = pdf_document_free,
    .page_init = pdf_page_init,
    .page_render_cairo = pdf_page_render_cairo,
    .page_search_text = pdf_page_search_text,
    .page_links_get = pdf_page_links_get,
    // ... other callbacks ...
};

const char* pdf_mime_types[] = {
    "application/pdf",
    "application/x-pdf"
};

ZATHURA_PLUGIN_REGISTER_WITH_FUNCTIONS(
    "pdf",
    "0.4.9",
    functions,
    pdf_mime_types
);
```

--------------------------------

### Example: Create GLib-based file monitor

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Demonstrates initializing a GLib-based monitor and checking for allocation errors.

```c
// Create GLib-based file monitor
ZathuraFileMonitor* monitor = zathura_filemonitor_new(
    "/home/user/document.pdf",
    ZATHURA_FILEMONITOR_GLIB
);

if (monitor == NULL) {
    fprintf(stderr, "Failed to create monitor\n");
}
```

--------------------------------

### Implement basic file monitoring

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Demonstrates creating, connecting, and starting a file monitor instance.

```c
void on_document_reloaded(ZathuraFileMonitor* monitor, gpointer user_data) {
    const char* filepath = zathura_filemonitor_get_filepath(monitor);
    printf("Document changed: %s\n", filepath);
    
    // Reload document
    zathura_t* zathura = (zathura_t*)user_data;
    zathura_document_t* doc = /* get current doc */;
    
    // Close and re-open with same path
    // (implementation-specific)
}

// Create and start monitor
ZathuraFileMonitor* monitor = zathura_filemonitor_new(
    "/home/user/document.pdf",
    ZATHURA_FILEMONITOR_GLIB
);

if (monitor != NULL) {
    // Connect signal
    g_signal_connect(monitor, "reload-file", 
                     G_CALLBACK(on_document_reloaded), zathura);
    
    // Start monitoring
    zathura_filemonitor_start(monitor);
}
```

--------------------------------

### Map buffer commands

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

Examples of mapping character sequences to buffer commands.

```default
map abc quit
map test quit
```

--------------------------------

### zathura_filemonitor_start

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Starts the monitoring process for the given file monitor instance.

```APIDOC
## void zathura_filemonitor_start(ZathuraFileMonitor* monitor)

### Description
Activates the file monitoring process for the provided monitor instance. Once started, the monitor will emit the 'reload-file' signal when changes are detected.

### Parameters
- **monitor** (ZathuraFileMonitor*) - Required - The monitor instance to start.
```

--------------------------------

### Initialize bookmark system in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Required setup function to be called once per session before bookmark operations.

```c
bool zathura_bookmarks_init(zathura_t* zathura);
```

--------------------------------

### Configure Zathura build options

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/configuration.md

Use this command to set build-time options during the Meson setup phase.

```bash
meson setup build -D<option>=<value>
```

--------------------------------

### Map special keys to shortcuts

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

Examples of mapping special keys and modifier combinations to functions.

```default
map <Space> shortcut_function
map <C-Space> shortcut_function
```

--------------------------------

### Map mouse buttons to shortcuts

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

Examples of mapping mouse buttons and modifier combinations to functions.

```default
map <Button1> shortcut_function
map <C-Button1> shortcut_function
```

--------------------------------

### Get document file information

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/database.md

Retrieves session state for a document. The example demonstrates restoring document properties like page number and zoom level.

```c
bool zathura_db_get_fileinfo(zathura_database_t* db, 
                            const char* file, 
                            const uint8_t* hash, 
                            zathura_fileinfo_t* file_info);
```

```c
zathura_fileinfo_t info;
if (zathura_db_get_fileinfo(db, path, hash, &info)) {
    // Restore session
    zathura_document_set_current_page_number(doc, info.current_page);
    zathura_document_set_zoom(doc, info.zoom);
    zathura_document_set_position_x(doc, info.position_x);
    zathura_document_set_position_y(doc, info.position_y);
}
```

--------------------------------

### Get recently opened files

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/database.md

Retrieves a list of recently opened documents. The example shows how to iterate through the returned list of file paths.

```c
girara_list_t* zathura_db_get_recent_files(zathura_database_t* db, 
                                          int max, 
                                          const char* basepath);
```

```c
girara_list_t* recent = zathura_db_get_recent_files(db, 10, NULL);
if (recent != NULL) {
    for (girara_list_iterator_t* it = girara_list_iterator(recent);
         it != NULL; it = girara_list_iterator_next(it)) {
        printf("%s\n", (char*)girara_list_iterator_data(it));
    }
}
```

--------------------------------

### Set color configuration options

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

Examples of setting color options using quoted strings or escaped hash symbols.

```default
set default-fg "#CCBBCC"
set default-fg \#CCBBCC
```

--------------------------------

### Get document information

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Retrieves document metadata entries. Includes an example of iterating through the returned list.

```c
girara_list_t* zathura_document_get_information(zathura_document_t* document,
                                               zathura_error_t* error);
```

```c
zathura_error_t error;
girara_list_t* info = zathura_document_get_information(doc, &error);
if (info != NULL) {
    for (girara_list_iterator_t* it = girara_list_iterator(info);
         it != NULL; it = girara_list_iterator_next(it)) {
        zathura_document_information_entry_t* entry = girara_list_iterator_data(it);
        printf("%d: %s\n", entry->type, entry->value);
    }
}
```

--------------------------------

### Start file monitoring

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Activates the monitoring process. Must be called after creation to begin emitting reload signals.

```c
void zathura_filemonitor_start(ZathuraFileMonitor* file_monitor);
```

--------------------------------

### Map single key bindings

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

Examples of mapping single characters, numbers, or signs to shortcut functions.

```default
map a shortcut_function optional_argument
map b shortcut_function optional_argument
map c shortcut_function optional_argument
map 1 shortcut_function optional_argument
map 2 shortcut_function optional_argument
map 3 shortcut_function optional_argument
map ! shortcut_function optional_argument
map ? shortcut_function optional_argument
```

--------------------------------

### Zathura Development Paths

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/00-START-HERE.md

A visual guide outlining the recommended steps for learning APIs, embedding the application, plugin development, and configuration.

```text
┌─ Learning Zathura APIs
│  1. Read README.md (overview)
│  2. Pick one: document.md, page.md, or plugin.md
│  3. Try the example code
│  └─ Refer back to [types.md](types.md) and [errors.md](errors.md) as needed
│
├─ Embedding in Your App
│  1. Read README.md "Quick Start" section
│  2. Follow [api-reference/document.md](api-reference/document.md)
│  3. Add [api-reference/render.md](api-reference/render.md) if rendering
│  4. Use [api-reference/database.md](api-reference/database.md) for persistence
│  5. Handle errors from [errors.md](errors.md)
│
├─ Writing a Plugin
│  1. Read [api-reference/plugin.md](api-reference/plugin.md) thoroughly
│  2. Check type signatures in [types.md](types.md)
│  3. Implement each callback
│  4. Test error conditions from [errors.md](errors.md)
│
└─ Configuring Zathura
   1. Read [configuration.md](configuration.md)
   2. Copy example, customize for your needs
   3. Place in ~/.config/zathura/zathurarc
```

--------------------------------

### Create a new link object

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/links.md

Defines the function signature for initializing a new link and provides a usage example for creating a GOTO_DEST link.

```c
zathura_link_t* zathura_link_new(zathura_link_type_t type, 
                                 zathura_rectangle_t position,
                                 zathura_link_target_t target);
```

```c
zathura_rectangle_t position = {100, 200, 300, 220};
zathura_link_target_t target = {
    .destination_type = ZATHURA_LINK_DESTINATION_XYZ,
    .page_number = 5,
    .zoom = 1.0
};

zathura_link_t* link = zathura_link_new(ZATHURA_LINK_GOTO_DEST, position, target);
```

--------------------------------

### Map key bindings with modifiers

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

Examples of mapping key bindings using Alt (A) and Control (C) modifiers.

```default
map <A-a> shortcut_function
map <C-a> shortcut_function
```

--------------------------------

### Plugin Implementation Error Handling

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/errors.md

Example of how plugin implementations should validate arguments and return appropriate error codes.

```c
// In plugin implementation
static zathura_error_t pdf_document_open(zathura_document_t* document) {
    if (document == NULL) {
        return ZATHURA_ERROR_INVALID_ARGUMENTS;
    }
    
    const char* path = zathura_document_get_path(document);
    if (path == NULL || strlen(path) == 0) {
        return ZATHURA_ERROR_INVALID_ARGUMENTS;
    }
    
    // Try to open file
    FILE* file = fopen(path, "rb");
    if (file == NULL) {
        return ZATHURA_ERROR_UNKNOWN;  // I/O error
    }
    
    // Parse PDF
    pdf_t* pdf = parse_pdf(file);
    if (pdf == NULL) {
        fclose(file);
        return ZATHURA_ERROR_UNKNOWN;  // Corrupt or invalid
    }
    
    // Success
    zathura_document_set_number_of_pages(document, pdf->page_count);
    zathura_document_set_data(document, pdf);
    return ZATHURA_ERROR_OK;
}
```

--------------------------------

### Get and set plugin data

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Handles storage and retrieval of opaque pointers for plugin-specific private data.

```c
void* zathura_document_get_data(zathura_document_t* document);
```

```c
void zathura_document_set_data(zathura_document_t* document, 
                               void* data);
```

--------------------------------

### Initialize and open a document

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/README.md

Sets up the plugin manager and opens a document file. Requires valid paths and a Zathura instance.

```c
#include <zathura/document.h>
#include <zathura/plugin.h>

// Initialize plugin system
zathura_plugin_manager_t* pm = zathura_plugin_manager_new();
zathura_plugin_manager_set_dir(pm, "/usr/lib/zathura");
zathura_plugin_manager_load(pm);

// Open document
zathura_error_t error;
zathura_document_t* doc = zathura_document_open(
    zathura_instance, 
    "/path/to/document.pdf",
    "/path/to/document.pdf",
    NULL,  // no password
    &error
);

if (error == ZATHURA_ERROR_OK) {
    unsigned int pages = zathura_document_get_number_of_pages(doc);
    printf("Opened document with %u pages\n", pages);
}
```

--------------------------------

### Get Page Images

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Retrieves all embedded images on a page.

```c
girara_list_t* zathura_page_images_get(zathura_page_t* page, 
                                       zathura_error_t* error);
```

--------------------------------

### Retrieve page label in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Gets the human-readable label for a page, returning NULL if no specific label is defined.

```c
const char* zathura_page_get_label(zathura_page_t* page, 
                                   zathura_error_t* error);
```

--------------------------------

### Get document attachments

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Retrieves a list of embedded file attachment names.

```c
girara_list_t* zathura_document_attachments_get(zathura_document_t* document,
                                               zathura_error_t* error);
```

--------------------------------

### zathura_bookmarks_init

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Initializes the bookmark system for a Zathura session.

```APIDOC
## zathura_bookmarks_init

### Description
Initializes the bookmark system. Must be called once per session before using bookmarks.

### Signature
`bool zathura_bookmarks_init(zathura_t* zathura);`

### Parameters
- **zathura** (zathura_t*) - Required - Zathura session

### Returns
- **bool** - true on success
```

--------------------------------

### Get Document Page Count

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Retrieves the total number of pages in the document.

```c
unsigned int zathura_document_get_number_of_pages(zathura_document_t* document);
```

--------------------------------

### Load and restore bookmarks

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Initializes the bookmark system and loads bookmarks from the database for a specific document.

```c
// Initialize bookmark system
zathura_bookmarks_init(zathura);

// Load bookmarks for document
const char* filepath = zathura_document_get_path(doc);
if (zathura_bookmarks_load(zathura, filepath)) {
    // Bookmarks are now available in session
    
    // Get a specific bookmark
    zathura_bookmark_t* bm = zathura_bookmark_get(zathura, "section1");
    if (bm != NULL) {
        // Auto-navigate to it or show in UI
    }
}
```

--------------------------------

### Basic rendering with caching

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/render.md

Initializes a renderer and iterates through document pages to request rendering with priority timestamps.

```c
ZathuraRenderer* renderer = zathura_renderer_new(16);

for (unsigned int i = 0; i < zathura_document_get_number_of_pages(doc); i++) {
    zathura_page_t* page = zathura_document_get_page(doc, i);
    
    ZathuraRenderRequest* req = zathura_render_request_new(renderer, page);
    
    // Request rendering with current timestamp for priority
    gint64 now = g_get_monotonic_time();
    zathura_render_request(req, now);
}
```

--------------------------------

### Get Page Form Fields

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Retrieves all interactive form fields on a page.

```c
girara_list_t* zathura_page_form_fields_get(zathura_page_t* page, 
                                            zathura_error_t* error);
```

--------------------------------

### Get Page Data

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Retrieves plugin-specific data attached to a page object.

```c
void* zathura_page_get_data(zathura_page_t* page);
```

--------------------------------

### Create a link in a plugin in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/links.md

Demonstrates how to define a clickable rectangle and a target destination to instantiate a new link object.

```c
// In PDF plugin: create link to page 3, fit to width
zathura_rectangle_t clickable = {50.5, 100.3, 150.8, 110.5};

zathura_link_target_t target = {
    .destination_type = ZATHURA_LINK_DESTINATION_FITH,
    .page_number = 2,    // 0-indexed
    .top = 0,
};

zathura_link_t* link = zathura_link_new(ZATHURA_LINK_GOTO_DEST, 
                                        clickable, target);

// Add to page's link list
```

--------------------------------

### Launch Zathura with SyncTeX support

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathura.1.md

Use this command to launch Zathura with the necessary arguments to support backward synchronization with gvim.

```bash
zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file
```

--------------------------------

### Get and set page zoom

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Functions to manage the magnification level of a page.

```c
double zathura_page_get_zoom(zathura_page_t* page);
```

```c
void zathura_page_set_zoom(zathura_page_t* page, 
                           double zoom);
```

--------------------------------

### Get page index

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Returns the zero-based index of the page within its document.

```c
unsigned int zathura_page_get_index(zathura_page_t* page);
```

--------------------------------

### Get parent document

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Retrieves the parent document associated with the given page.

```c
zathura_document_t* zathura_page_get_document(zathura_page_t* page);
```

--------------------------------

### Get device factors

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Retrieves the current HiDPI scaling factors as a zathura_device_factors_t structure.

```c
zathura_device_factors_t zathura_document_get_device_factors(zathura_document_t* document);
```

--------------------------------

### Get viewport PPI

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Retrieves the current display resolution in pixels per inch.

```c
double zathura_document_get_viewport_ppi(zathura_document_t* document);
```

--------------------------------

### Open a document

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/00-START-HERE.md

Initializes a document object from a file path. Check the error pointer for success before proceeding.

```c
zathura_error_t error;
zathura_document_t* doc = zathura_document_open(
    zathura, filepath, filepath, NULL, &error
);
if (error != ZATHURA_ERROR_OK) {
    // Handle error (see errors.md)
}
```

--------------------------------

### Get viewport size

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Retrieves the current viewport dimensions via output parameters.

```c
void zathura_document_get_viewport_size(zathura_document_t* document, 
                                        unsigned int* height,
                                        unsigned int* width);
```

--------------------------------

### Get and set page height

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Functions to retrieve or update the page height in pixels.

```c
double zathura_page_get_height(zathura_page_t* page);
```

```c
void zathura_page_set_height(zathura_page_t* page, 
                             double height);
```

--------------------------------

### Apply Global Configuration

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/configuration.md

Configure display, colors, and behavior settings in the zathurarc file.

```ini
# Page display
set adjust-open best-fit
set pages-per-row 1
set continuous-scroll false

# Colors (dark theme)
set foreground-color "#e0e0e0"
set background-color "#1a1a1a"
set highlight-color "#ffaa0080"

# Dark mode rendering
set recolor true
set recolor-lightness 5
set recolor-hue true

# Fonts
set font "Monospace 11"

# Behavior
set auto-reload true
set zoom-step 10
set cache-size 32

# Keyboard shortcuts
map j scroll down
map k scroll up
map <ctrl>+ zoom in
map <ctrl>- zoom out
map r rotate clockwise
map R rotate counter-clockwise
map h previous
map l next
```

--------------------------------

### Get and set page width

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Functions to retrieve or update the page width in pixels.

```c
double zathura_page_get_width(zathura_page_t* page);
```

```c
void zathura_page_set_width(zathura_page_t* page, 
                            double width);
```

--------------------------------

### Load plugins from directories

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Scans configured directories and loads available plugins. Returns true if at least one plugin is successfully loaded.

```c
bool zathura_plugin_manager_load(zathura_plugin_manager_t* plugin_manager);
```

```c
zathura_plugin_manager_set_dir(pm, "/usr/lib/zathura:/usr/local/lib/zathura");
if (!zathura_plugin_manager_load(pm)) {
    fprintf(stderr, "No plugins found\n");
}
```

--------------------------------

### Create a new file monitor

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Initializes a new monitor instance for a specific file path using a chosen monitor type.

```c
ZathuraFileMonitor* zathura_filemonitor_new(const char* file_path, 
                                           zathura_filemonitor_type_t filemonitor_type);
```

--------------------------------

### Get Effective Scale

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Returns the scaling factor adjusted for monitor DPI and device scale.

```c
double zathura_document_get_scale(zathura_document_t* document);
```

--------------------------------

### Get Zoom Level

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Returns the current magnification factor, where 1.0 represents 100% zoom.

```c
double zathura_document_get_zoom(zathura_document_t* document);
```

--------------------------------

### Create a quick mark

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Saves the current document state as a Vim-style mark.

```c
// Save current position as mark 'a'
zathura_mark_t mark = {
    .key = 'a',
    .page = zathura_document_get_current_page_number(doc),
    .position_x = zathura_document_get_position_x(doc),
    .position_y = zathura_document_get_position_y(doc),
    .zoom = zathura_document_get_zoom(doc),
};

// Add to session and save
// (typically done through girara shortcut system)
```

--------------------------------

### Get and set page visibility

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Functions to check or modify whether a page is visible in the viewport.

```c
bool zathura_page_get_visibility(zathura_page_t* page);
```

```c
void zathura_page_set_visibility(zathura_page_t* page, 
                                 bool visibility);
```

--------------------------------

### Get monitored file path

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Retrieves the path string currently associated with the monitor instance.

```c
const char* zathura_filemonitor_get_filepath(ZathuraFileMonitor* file_monitor);
```

--------------------------------

### Define document open callback

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Initializes a document instance. Called once per file opening.

```c
typedef zathura_error_t (*zathura_plugin_document_open_t)(
    zathura_document_t* document);
```

--------------------------------

### Stop file monitoring

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Deactivates the monitoring process. Monitoring can be resumed later by calling start again.

```c
void zathura_filemonitor_stop(ZathuraFileMonitor* file_monitor);
```

--------------------------------

### Include External Configuration

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/configuration.md

Load additional configuration files using the include directive.

```text
include ~/.config/zathura/zathurarc.local
```

--------------------------------

### Create a bookmark

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Adds a bookmark to the current session and persists it to the database.

```c
// Add bookmark named "introduction" at current position
zathura_bookmark_t* bm = zathura_bookmark_add(zathura, "introduction", 0);
if (bm != NULL) {
    printf("Bookmark created at page %d\n", bm->page);
}

// Save to database
const char* file = zathura_document_get_path(doc);
zathura_db_add_bookmark(db, file, bm);
```

--------------------------------

### Create a URI link

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/links.md

Initializes a link target with a URL and creates a new link object.

```c
zathura_link_target_t target = {
    .value = "https://github.com/pwmt/zathura"
};
zathura_link_t* link = zathura_link_new(ZATHURA_LINK_URI, position, target);
```

--------------------------------

### Use Configuration Variables

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/configuration.md

Define variables with the set command to reuse values in commands.

```text
set $terminal urxvt
map <C-l> exec $terminal -e ranger
```

--------------------------------

### Get and set adjust mode

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Functions to retrieve or update the current page fit mode for the document.

```c
zathura_adjust_mode_t zathura_document_get_adjust_mode(zathura_document_t* document);
```

```c
void zathura_document_set_adjust_mode(zathura_document_t* document, 
                                      zathura_adjust_mode_t mode);
```

--------------------------------

### Load document bookmarks in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Populates the session with saved bookmarks associated with the provided file path.

```c
bool zathura_bookmarks_load(zathura_t* zathura, 
                           const gchar* file);
```

--------------------------------

### Get Page Rotation

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Returns the current page rotation in degrees (0, 90, 180, or 270).

```c
unsigned int zathura_document_get_rotation(zathura_document_t* document);
```

--------------------------------

### Configure File Handling

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/configuration.md

Settings for document reloading, database backends, and memory caching.

```zathurarc
set auto-reload true
```

```zathurarc
set monitor-reload-policy delayed
```

```zathurarc
set database-backend sqlite
```

```zathurarc
set cache-size 32
```

--------------------------------

### Get recolor colors in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/render.md

Retrieves the current light and dark recoloring colors from the renderer instance.

```c
void zathura_renderer_get_recolor_colors(ZathuraRenderer* renderer, 
                                        GdkRGBA* light, 
                                        GdkRGBA* dark);
```

--------------------------------

### Include external configuration file

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

Syntax for including another configuration file, with relative paths resolved against the current file.

```default
include another-config
```

--------------------------------

### Get Page Links

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Retrieves all interactive links on a page. Use zathura_page_links_free to release the returned list.

```c
girara_list_t* zathura_page_links_get(zathura_page_t* page, 
                                      zathura_error_t* error);
```

--------------------------------

### Load quick marks for a document

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/database.md

Retrieves a list of quick marks associated with a specific file path.

```c
girara_list_t* zathura_db_load_quickmarks(ZathuraDatabase* db, 
                                         const char* file);
```

--------------------------------

### Create a new plugin manager instance

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Initializes a new zathura_plugin_manager_t instance. Returns NULL if the allocation fails.

```c
zathura_plugin_manager_t* zathura_plugin_manager_new(void);
```

```c
zathura_plugin_manager_t* pm = zathura_plugin_manager_new();
if (pm == NULL) {
    fprintf(stderr, "Failed to create plugin manager\n");
    return;
}
```

--------------------------------

### Create a new renderer instance

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/render.md

Initializes a new ZathuraRenderer with a specified cache size.

```c
ZathuraRenderer* zathura_renderer_new(size_t cache_size);
```

```c
ZathuraRenderer* renderer = zathura_renderer_new(16);
if (renderer == NULL) {
    fprintf(stderr, "Failed to create renderer\n");
    return;
}
```

--------------------------------

### Open a document with zathura_document_open

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Initializes a document object from a file path. Returns NULL on failure and populates the error parameter.

```c
zathura_document_t* zathura_document_open(zathura_t* zathura, 
                                         const char* path, 
                                         const char* uri, 
                                         const char* password,
                                         zathura_error_t* error);
```

```c
zathura_error_t error;
const char* file = "/home/user/document.pdf";
zathura_document_t* doc = zathura_document_open(zathura, file, file, NULL, &error);
if (doc == NULL) {
    fprintf(stderr, "Failed to open document: %d\n", error);
    return;
}
```

--------------------------------

### Meson Build Configuration

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/README.md

Integrate Zathura into a Meson project using dependency lookup.

```meson
zathura_dep = dependency('zathura')
executable('myapp', 'main.c', dependencies: zathura_dep)
```

--------------------------------

### Get and set page offset

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Manages the page numbering offset, useful for distinguishing between 0-indexed and 1-indexed display.

```c
int zathura_document_get_page_offset(zathura_document_t* document);
```

```c
void zathura_document_set_page_offset(zathura_document_t* document, 
                                      unsigned int page_offset);
```

--------------------------------

### Get plain render mode status in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/render.md

Checks if the render request is currently set to plain mode.

```c
bool zathura_render_request_get_render_plain(ZathuraRenderRequest* request);
```

--------------------------------

### Select monitor type by platform

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Determines the appropriate monitor implementation based on the operating system.

```c
zathura_filemonitor_type_t type = ZATHURA_FILEMONITOR_NOOP;

#if defined(__linux__)
    type = ZATHURA_FILEMONITOR_GLIB;  // inotify available
#elif defined(__APPLE__)
    type = ZATHURA_FILEMONITOR_GLIB;  // FSEvents available
#else
    type = ZATHURA_FILEMONITOR_SIGNAL; // Fallback to signal-based
#endif

ZathuraFileMonitor* monitor = zathura_filemonitor_new(filepath, type);
```

--------------------------------

### Free bookmark resources in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Releases all session bookmarks; should be called before closing the session.

```c
void zathura_bookmarks_free(zathura_t* zathura);
```

--------------------------------

### zathura_filemonitor_start

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Activates the file change detection mechanism for the monitor instance.

```APIDOC
## zathura_filemonitor_start

### Description
Activates file change detection. Must be called to enable watching after monitor creation.

### Signature
`void zathura_filemonitor_start(ZathuraFileMonitor* file_monitor)`

### Parameters
- **file_monitor** (ZathuraFileMonitor*) - Required - Monitor instance

### Signals
- Emits `reload-file` signal when monitored file is modified
```

--------------------------------

### Configure plugin search directories

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Sets the colon-separated list of directories to search for plugins. Must be called before zathura_plugin_manager_load.

```c
void zathura_plugin_manager_set_dir(zathura_plugin_manager_t* plugin_manager, 
                                   const char* dir);
```

--------------------------------

### Get Vertical Scroll Position

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Returns the vertical scroll position as a normalized value between 0.0 (top) and 1.0 (bottom).

```c
double zathura_document_get_position_y(zathura_document_t* document);
```

--------------------------------

### Configure Colors and Appearance

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/configuration.md

Settings for UI colors, search highlights, and dark mode recoloring options.

```zathurarc
set foreground-color "#000000"
set background-color "#ffffff"
```

```zathurarc
set highlight-color "#ffff0080"
```

```zathurarc
set highlight-transparency 0.3
```

```zathurarc
set recolor true
```

```zathurarc
set recolor-lightness -10
```

```zathurarc
set recolor-hue false
```

```zathurarc
set recolor-keep-transparency false
```

--------------------------------

### Get Horizontal Scroll Position

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Returns the horizontal scroll position as a normalized value between 0.0 (left) and 1.0 (right).

```c
double zathura_document_get_position_x(zathura_document_t* document);
```

--------------------------------

### Get selection character positions in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Returns a list of rectangles corresponding to character positions within a selection region.

```c
girara_list_t* zathura_page_get_selection(zathura_page_t* page, 
                                          zathura_rectangle_t rectangle,
                                          zathura_error_t* error);
```

--------------------------------

### Manage Quick Marks

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/database.md

Save and restore document positions using quick mark keys.

```c
// Save current position as mark 'a'
zathura_mark_t mark = {
    .key = 'a',
    .page = zathura_document_get_current_page_number(doc),
    .position_x = zathura_document_get_position_x(doc),
    .position_y = zathura_document_get_position_y(doc),
    .zoom = zathura_document_get_zoom(doc),
};

girara_list_t* marks = girara_list_new2(NULL);
girara_list_append(marks, &mark);
zathura_db_save_quickmarks(db, filepath, marks);

// Later: restore mark 'a'
girara_list_t* saved_marks = zathura_db_load_quickmarks(db, filepath);
for (girara_list_iterator_t* it = girara_list_iterator(saved_marks);
     it != NULL; it = girara_list_iterator_next(it)) {
    zathura_mark_t* m = girara_list_iterator_data(it);
    if (m->key == 'a') {
        zathura_document_set_current_page_number(doc, m->page);
        zathura_document_set_position_x(doc, m->position_x);
        zathura_document_set_position_y(doc, m->position_y);
        zathura_document_set_zoom(doc, m->zoom);
        break;
    }
}
```

--------------------------------

### Get Page Image as Cairo Surface

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Retrieves a specific image as a Cairo surface. The caller must destroy the surface with cairo_surface_destroy.

```c
cairo_surface_t* zathura_page_image_get_cairo(zathura_page_t* page, 
                                              zathura_image_t* image,
                                              zathura_error_t* error);
```

--------------------------------

### Save bookmarks

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/00-START-HERE.md

Creates a bookmark object and persists it to the database.

```c
zathura_bookmark_t* bm = zathura_bookmark_add(zathura, "chapter1", 5);
zathura_db_add_bookmark(db, filepath, bm);
```

--------------------------------

### Map shortcut syntax

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

General syntax for mapping key bindings to shortcut functions.

```default
map [mode] <binding> <shortcut function> <argument>
```

--------------------------------

### Retrieve plugin version

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Returns the version string of the plugin. Returns NULL if the version information is unavailable.

```c
const char* zathura_plugin_get_version(const zathura_plugin_t* plugin);
```

--------------------------------

### Load document bookmarks

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/database.md

Populates a list with all bookmarks for a specific document.

```c
bool zathura_db_load_bookmarks(zathura_database_t* db, 
                              const char* file, 
                              girara_list_t* target_list);
```

```c
girara_list_t* bookmarks = girara_list_new2(g_free);
if (zathura_db_load_bookmarks(db, "/path/to/document.pdf", bookmarks)) {
    for (girara_list_iterator_t* it = girara_list_iterator(bookmarks);
         it != NULL; it = girara_list_iterator_next(it)) {
        zathura_bookmark_t* bm = girara_list_iterator_data(it);
        printf("Bookmark '%s' on page %d\n", bm->id, bm->page);
    }
}
```

--------------------------------

### List all loaded plugins

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Returns a list of all currently loaded zathura_plugin_t instances.

```c
girara_list_t* zathura_plugin_manager_get_plugins(
    const zathura_plugin_manager_t* plugin_manager);
```

--------------------------------

### Pkg-config Build Command

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/README.md

Compile a Zathura-dependent application using pkg-config flags.

```bash
gcc main.c $(pkg-config --cflags --libs zathura) -o app
```

--------------------------------

### zathura_plugin_manager_get_plugins

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Returns a list of all loaded plugins.

```APIDOC
## zathura_plugin_manager_get_plugins

### Description
Returns a list of all loaded plugins.

### Signature
`girara_list_t* zathura_plugin_manager_get_plugins(const zathura_plugin_manager_t* plugin_manager);`

### Parameters
- **plugin_manager** (zathura_plugin_manager_t*) - Required - Plugin manager

### Returns
- **girara_list_t*** - List of zathura_plugin_t pointers, NULL if no plugins loaded
```

--------------------------------

### Load quick marks

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Loads quick marks from the database for a specific document file.

```c
bool zathura_quickmarks_load(zathura_t* zathura, 
                            const gchar* file);
```

--------------------------------

### zathura_plugin_manager_load

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Scans and loads all available plugins from configured directories.

```APIDOC
## zathura_plugin_manager_load

### Description
Scans and loads all available plugins from configured directories.

### Signature
`bool zathura_plugin_manager_load(zathura_plugin_manager_t* plugin_manager);`

### Parameters
- **plugin_manager** (zathura_plugin_manager_t*) - Required - Plugin manager

### Returns
- **bool** - true if at least one plugin was loaded, false otherwise
```

--------------------------------

### Save document as

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/document.md

Saves a copy of the document to a specified file path.

```c
zathura_error_t zathura_document_save_as(zathura_document_t* document, 
                                         const char* path);
```

--------------------------------

### Define page initialization callback

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Initializes a page object when first accessed.

```c
typedef zathura_error_t (*zathura_plugin_page_init_t)(
    zathura_page_t* page);
```

--------------------------------

### Create a new render request in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/render.md

Initializes a new render request object for a specific page.

```c
ZathuraRenderRequest* zathura_render_request_new(ZathuraRenderer* renderer, 
                                                zathura_page_t* page);
```

--------------------------------

### Project Directory Structure

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/MANIFEST.md

Visual representation of the project file hierarchy and documentation modules.

```text
/workspace/home/output/
├── 00-START-HERE.md          ← Begin here
├── INDEX.md                  ← Complete navigation
├── README.md                 ← Overview & quick start
├── types.md                  ← Type definitions
├── errors.md                 ← Error reference
├── configuration.md          ← Settings reference
└── api-reference/
    ├── document.md           ← 19 document functions
    ├── page.md               ← 17 page functions
    ├── plugin.md             ← 26+ plugin functions
    ├── render.md             ← 11 renderer functions
    ├── database.md           ← 10 database functions
    ├── links.md              ← 5 link functions
    ├── bookmarks-marks.md    ← 8 bookmark functions
    └── file-monitor.md       ← 4 monitor functions
```

--------------------------------

### Handle ZATHURA_ERROR_INVALID_PASSWORD

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/errors.md

Demonstrates how to handle encrypted documents by attempting an initial open, prompting for a password upon failure, and retrying the operation.

```c
// First attempt without password
zathura_error_t error;
zathura_document_t* doc = zathura_document_open(
    zathura, filepath, filepath, NULL, &error
);

if (error == ZATHURA_ERROR_INVALID_PASSWORD) {
    // Prompt user for password
    const char* password = prompt_user_for_password();
    
    if (password != NULL) {
        doc = zathura_document_open(
            zathura, filepath, filepath, password, &error
        );
        if (error != ZATHURA_ERROR_OK) {
            fprintf(stderr, "Password incorrect or document corrupted\n");
        }
    }
}
```

--------------------------------

### Submit a render request in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/render.md

Adds a render request to the queue. Lower last_view_time values result in higher rendering priority.

```c
void zathura_render_request(ZathuraRenderRequest* request, 
                           gint64 last_view_time);
```

--------------------------------

### Retrieve a bookmark in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Fetches a bookmark object from the current session using its ID.

```c
zathura_bookmark_t* zathura_bookmark_get(zathura_t* zathura, 
                                        const gchar* id);
```

--------------------------------

### Define a GOTO_DEST link target

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/links.md

Configures a target structure for navigating to a specific page within the same document using FITH positioning.

```c
// Link to page 10, fit to width
zathura_link_target_t target = {
    .destination_type = ZATHURA_LINK_DESTINATION_FITH,
    .page_number = 9,  // 0-indexed
    .top = 0,
};
```

--------------------------------

### Retrieve plugin file path

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Returns the absolute file path from which the plugin was loaded. Returns NULL if the path is unknown.

```c
const char* zathura_plugin_get_path(const zathura_plugin_t* plugin);
```

--------------------------------

### Configure Page Display Settings

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/configuration.md

Directives for controlling document scaling, layout, and scrolling behavior.

```zathurarc
set adjust-open best-fit
```

```zathurarc
set pages-per-row 2
```

```zathurarc
set continuous-scroll true
```

```zathurarc
set first-page-column 2
```

```zathurarc
set zoom-step 15
```

```zathurarc
set zoom-min 50
set zoom-max 800
```

--------------------------------

### Configure Search and Selection

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/configuration.md

Directives for search result navigation and clipboard integration.

```zathurarc
set search-hadjust true
```

```zathurarc
set search-vadjust true
```

```zathurarc
set selection-clipboard true
```

```zathurarc
set increment-search true
```

--------------------------------

### Set configuration option syntax

Source: https://github.com/pwmt/zathura/blob/develop/doc/man/zathurarc.5.md

General syntax for defining a configuration option in zathurarc.

```default
set <option> <new value>
```

--------------------------------

### Render a page to Cairo in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/page.md

Draws the page content into a Cairo context. The printing parameter should be set to true for print output and false for screen rendering.

```c
zathura_error_t zathura_page_render(zathura_page_t* page, 
                                    cairo_t* cairo, 
                                    bool printing);
```

```c
cairo_t* cr = cairo_create(surface);
zathura_error_t error = zathura_page_render(page, cr, false);
cairo_destroy(cr);
if (error != ZATHURA_ERROR_OK) {
    fprintf(stderr, "Render failed: %d\n", error);
}
```

--------------------------------

### Evaluate a mark

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Shortcut handler for jumping to a previously saved marked position.

```c
bool sc_mark_evaluate(girara_session_t* session, 
                     girara_argument_t* argument, 
                     girara_event_t* event, 
                     unsigned int t);
```

```c
// This is called when user presses a quote then mark key to navigate
girara_argument_t arg = {.data = "a"};
sc_mark_evaluate(session, &arg, NULL, 1);  // Jump to mark 'a'
```

--------------------------------

### Add a bookmark in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Creates a bookmark at the current scroll position for the specified page.

```c
zathura_bookmark_t* zathura_bookmark_add(zathura_t* zathura, 
                                        const gchar* id, 
                                        unsigned int page);
```

--------------------------------

### Save quick marks for a document

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/database.md

Persists a list of quick marks for a given document file.

```c
bool zathura_db_save_quickmarks(ZathuraDatabase* db, 
                               const char* file, 
                               girara_list_t* quickmarks);
```

--------------------------------

### Add page to cache

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/render.md

Hints to the renderer to perform background prerendering for the specified page index.

```c
void zathura_renderer_page_cache_add(ZathuraRenderer* renderer, 
                                    unsigned int page_index);
```

--------------------------------

### Set plain render mode in C

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/render.md

Configures whether to render in plain mode, bypassing scaling and recoloring.

```c
void zathura_render_request_set_render_plain(ZathuraRenderRequest* request, 
                                            bool render_plain);
```

--------------------------------

### Project File Structure

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/00-START-HERE.md

The directory layout of the Zathura documentation and source files.

```text
/output/
  00-START-HERE.md          ← You are here
  INDEX.md                  ← Navigation and overview
  README.md                 ← Quick start and architecture
  types.md                  ← All type definitions
  errors.md                 ← Error reference
  configuration.md          ← Runtime settings
  api-reference/
    document.md             ← Document API (19 functions)
    page.md                 ← Page API (17 functions)
    plugin.md               ← Plugin system (26 functions + 18 callbacks)
    render.md               ← Rendering engine (11 functions)
    database.md             ← Persistence (10 functions)
    links.md                ← Links API (5 functions)
    bookmarks-marks.md      ← Bookmarks/marks (8 functions)
    file-monitor.md         ← File monitoring (4 functions)
```

--------------------------------

### Add a mark

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/bookmarks-marks.md

Shortcut handler for creating a mark at the current position.

```c
bool sc_mark_add(girara_session_t* session, 
                girara_argument_t* argument, 
                girara_event_t* event, 
                unsigned int t);
```

```c
// This is typically called by Zathura's command system when user presses 'm' then a key
girara_argument_t arg = {.data = "a"};
sc_mark_add(session, &arg, NULL, 1);  // Sets mark 'a' at current position
```

--------------------------------

### Render a document page

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/README.md

Retrieves a page and renders it to a Cairo surface. Ensure the renderer is stopped after use.

```c
#include <zathura/page.h>
#include <zathura/render.h>
#include <cairo.h>

// Get page
zathura_page_t* page = zathura_document_get_page(doc, 0);

// Create renderer
ZathuraRenderer* renderer = zathura_renderer_new(16);

// Render synchronously
cairo_surface_t* surface = zathura_renderer_render_page(renderer, page);
if (surface != NULL) {
    // Use surface for drawing
    cairo_surface_destroy(surface);
}

// Cleanup
zathura_renderer_stop(renderer);
```

--------------------------------

### Handle Not Implemented Errors

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/errors.md

Recovery pattern for features unsupported by the current document format or plugin.

```c
zathura_error_t error;
girara_list_t* links = zathura_page_links_get(page, &error);
if (error == ZATHURA_ERROR_NOT_IMPLEMENTED) {
    printf("Document format does not support links\n");
    // Hide link UI, skip link processing
}
```

--------------------------------

### Check hash query support

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/database.md

Verifies if the current database backend supports hash-based lookups.

```c
bool zathura_db_supports_hash_queries(zathura_database_t* db);
```

--------------------------------

### Manage monitor lifecycle

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/file-monitor.md

Temporarily pauses and resumes file monitoring.

```c
// Stop watching during manual edits
zathura_filemonitor_stop(monitor);

// ... user manually reloads document or edits file ...

// Resume watching
zathura_filemonitor_start(monitor);
```

--------------------------------

### Retrieve plugin function table

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Returns the callback function table containing pointers for document operations like opening, initialization, and rendering.

```c
const zathura_plugin_functions_t* zathura_plugin_get_functions(
    const zathura_plugin_t* plugin);
```

--------------------------------

### Define Keyboard Shortcuts

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/configuration.md

Use map directives to bind keys to specific actions or modes.

```text
map <key> <shortcut> <argument>
map [<mode>] <keys> <shortcut> [<argument>]
```

```text
map j scroll down
map k scroll up
map [normal] <C-f> eval zathura_eval
map <ctrl>+ zoom in 5
```

--------------------------------

### zathura_plugin_manager_free

Source: https://github.com/pwmt/zathura/blob/develop/_autodocs/api-reference/plugin.md

Releases the plugin manager and all loaded plugins.

```APIDOC
## zathura_plugin_manager_free

### Description
Releases the plugin manager and all loaded plugins.

### Signature
`void zathura_plugin_manager_free(zathura_plugin_manager_t* plugin_manager);`

### Parameters
- **plugin_manager** (zathura_plugin_manager_t*) - Required - Manager to release
```