mirrors/zathura
1
0
Fork 0
mirror of https://git.pwmt.org/pwmt/zathura.git synced 2024-09-20 20:31:26 +02:00
Code Issues Packages Projects Releases Wiki Activity
Document viewer
2,792 Commits 8 Branches 52 Tags 4.2 MiB
C 98%
Meson 1.9%
Vim Script 0.1%
365521ed46
Go to file
Sebastian Ramacher 365521ed46 Merge branch 'develop' into 'develop' 
add ERRNO for fchmodat2

See merge request pwmt/zathura!82
2023-12-03 13:13:25 +01:00
data Add json-glib 2023-09-11 17:31:52 +02:00
doc Add $DBUS variable for exec 2023-09-25 14:00:29 +10:00
po Introduce new 'double-follow-click' option 2023-03-26 00:32:29 +03:00
subprojects Add CI 2020-01-05 14:21:51 +01:00
tests Move girara-gtk3 and cairo to requires 2023-09-14 21:04:47 +02:00
zathura Merge branch 'develop' into 'develop' 2023-12-03 13:13:25 +01:00
.clang-format Add clang-format configuration 2022-05-07 23:10:28 +02:00
.gitignore Add CI 2020-01-05 14:21:51 +01:00
.gitlab-ci.yml CI: reduce artifact lifetime 2023-09-15 09:21:32 +02:00
AUTHORS Acknowledge Jeremie Knuesel 2018-03-18 22:09:20 +01:00
LICENSE Bump copyright years 2020-01-06 09:00:44 +01:00
meson_options.txt Make magic a required dependency 2022-05-08 15:43:16 +02:00
meson.build Move girara-gtk3 and cairo to requires 2023-09-14 21:04:47 +02:00
README.md Add json-glib 2023-09-11 17:31:52 +02:00

README.md

zathura - a document viewer

zathura is a highly customizable and functional document viewer based on the girara user interface library and several document libraries.

Requirements

The following dependencies are required:

  • gtk3 (>= 3.22)
  • glib (>= 2.50)
  • girara (>= 0.3.7)
  • libmagic from file(1): for mime-type detection
  • json-glib

The following dependencies are optional:

  • sqlite3 (>= 3.6.23): sqlite3 database backend
  • libsynctex from TeXLive (>= 1.19): SyncTeX support
  • libseccomp: sandbox support

For building zathura, the following dependencies are also required:

  • meson (>= 0.61)
  • gettext
  • pkgconf

The following dependencies are optional build-time only dependencies:

  • check (>= 0.11): for tests
  • librvsg-bin: PNG icons
  • Sphinx: manpages and HTML documentation
  • doxygen: HTML documentation
  • breathe: for HTML documentation
  • sphinx_rtd_theme: for HTML documentation

Note that Sphinx is needed to build the manpages. If it is not installed, the man pages won't be built. For building the HTML documentation, doxygen, breathe and sphinx_rtd_theme are needed in addition to Sphinx.

If you don't want to build with support for sqlite databases, you can configure the build system with -Dsqlite=disabled and sqlite support won't be available.

The use of magic to detect mime types is optional and can be disabled by configuring the build system with -Dmagic=disabled.

The use of libseccomp to create a sandboxed environment is optional and can be disabled by configure the build system with -Dseccomp=disabled. The sandbox will by default be set to "normal" mode, which should not interfere with the normal operation of zathura. For strict sandbox mode set sandbox strict in zathurarc. Strict sandbox mode will reduce the available functionality of zathura and provide a read only document viewer.

Installation

To build and install zathura using meson's ninja backend:

meson build
cd build
ninja
ninja install

Note that the default backend for meson might vary based on the platform. Please refer to the meson documentation for platform specific dependencies.

Bugs

Please report bugs at http://git.pwmt.org/pwmt/zathura.