id       = "zathura"
name     = "zathura"
homepage = "https://pwmt.org/projects/zathura/"
description = "zathura is a highly customizable and functional document viewer."
# The icon zathura ships (data/org.pwmt.zathura.svg), as the PNG Flathub
# renders from it — the SVG itself names only white and would be invisible.
icon     = "https://dl.flathub.org/repo/appstream/x86_64/icons/128x128/org.pwmt.zathura.png"
executables   = ["zathura"]
# Packaged for Linux and the BSDs; pwmt.org ships no macOS build and Homebrew
# has no zathura formula (checked with `brew info zathura`), so macOS is left
# out rather than claimed on the strength of source builds.
platforms = ["linux"]

[dotfiles]

# zathura(1), CONFIGURATION: "The default appearance and behaviour of zathura
# can be overwritten by modifying the zathurarc file (default path:
# ~/.config/zathura/zathurarc)", and the documentation on pwmt.org gives the
# pair as "/etc/zathurarc [and] $XDG_CONFIG_HOME/zathura/zathurarc (default:
# ~/.config/zathura/zathurarc)". zathura/zathura.c builds it that way —
# `config_dir = g_build_filename(girara_get_xdg_path(XDG_CONFIG), "zathura")`,
# and girara/utils.c returns `g_get_user_config_dir()` for XDG_CONFIG, which is
# $XDG_CONFIG_HOME with ~/.config as the fallback. That is [configHome]. The
# /etc copy is system-wide and left out.
paths = ["[configHome]/zathura/zathurarc"]

# The same zathura.c line pair puts the *data* directory at
# `girara_get_xdg_path(XDG_DATA)/zathura`, i.e. $XDG_DATA_HOME/zathura with
# ~/.local/share as the fallback, and that is where the bookmark and history
# database lives — `g_build_filename(zathura->config.data_dir,
# "bookmarks.sqlite", NULL)` for the sqlite backend, plain `bookmarks` and
# `history` files for the plain one. Per-document reading positions and a
# recently-opened list are state, and the sqlite form is a binary file.
exclude = ["[xdgData]/zathura/"]

# A document viewer with no accounts. A zathurarc is `set`, `map` and
# `include` lines; nothing zathura writes there is a credential.
secret = []

# No machine_lines: the fonts, colours, `recolor` palette and key mappings in a
# zathurarc are precisely what a user wants on every machine.