2011-04-26 17:09:39 +02:00
|
|
|
zathura - a document viewer
|
2012-09-10 00:18:57 +02:00
|
|
|
===========================
|
2018-02-20 22:41:53 +01:00
|
|
|
|
2011-04-26 17:09:39 +02:00
|
|
|
zathura is a highly customizable and functional document viewer based on the
|
|
|
|
|
girara user interface library and several document libraries.
|
2009-08-11 23:18:50 +02:00
|
|
|
|
|
|
|
|
Requirements
|
|
|
|
|
------------
|
2018-02-20 22:41:53 +01:00
|
|
|
|
2018-12-23 12:59:58 +01:00
|
|
|
The following dependencies are required:
|
|
|
|
|
|
2020-05-28 17:51:09 +02:00
|
|
|
* `gtk3` (>= 3.22)
|
|
|
|
|
* `glib` (>= 2.50)
|
2023-12-08 18:32:44 +01:00
|
|
|
* `girara` (>= 0.4.1)
|
2022-05-08 15:43:16 +02:00
|
|
|
* `libmagic` from file(1): for mime-type detection
|
2023-09-11 17:31:52 +02:00
|
|
|
* `json-glib`
|
2018-12-23 12:59:58 +01:00
|
|
|
|
|
|
|
|
The following dependencies are optional:
|
|
|
|
|
|
2022-11-05 02:38:41 +01:00
|
|
|
* `sqlite3` (>= 3.6.23): sqlite3 database backend
|
2020-05-28 17:51:09 +02:00
|
|
|
* `libsynctex` from TeXLive (>= 1.19): SyncTeX support
|
|
|
|
|
* `libseccomp`: sandbox support
|
2018-12-23 12:59:58 +01:00
|
|
|
|
|
|
|
|
For building zathura, the following dependencies are also required:
|
|
|
|
|
|
2023-09-07 19:18:01 +02:00
|
|
|
* `meson` (>= 0.61)
|
2020-05-28 17:51:09 +02:00
|
|
|
* `gettext`
|
2022-11-05 02:38:41 +01:00
|
|
|
* `pkgconf`
|
2018-12-23 12:59:58 +01:00
|
|
|
|
|
|
|
|
The following dependencies are optional build-time only dependencies:
|
|
|
|
|
|
2021-09-20 00:09:03 +02:00
|
|
|
* `check` (>= 0.11): for tests
|
2020-05-28 17:51:09 +02:00
|
|
|
* `librvsg-bin`: PNG icons
|
|
|
|
|
* `Sphinx`: manpages and HTML documentation
|
|
|
|
|
* `doxygen`: HTML documentation
|
|
|
|
|
* `breathe`: for HTML documentation
|
|
|
|
|
* `sphinx_rtd_theme`: for HTML documentation
|
2009-08-11 23:18:50 +02:00
|
|
|
|
2020-05-28 17:51:09 +02:00
|
|
|
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`.
|
2012-03-04 18:54:52 +01:00
|
|
|
|
2018-03-12 13:39:39 +01:00
|
|
|
If you don't want to build with support for sqlite databases, you can configure
|
2020-05-28 17:51:09 +02:00
|
|
|
the build system with `-Dsqlite=disabled` and sqlite support won't be available.
|
2011-05-19 12:46:12 +02:00
|
|
|
|
2018-03-12 13:39:39 +01:00
|
|
|
The use of magic to detect mime types is optional and can be disabled by
|
2020-05-28 17:51:09 +02:00
|
|
|
configuring the build system with `-Dmagic=disabled`.
|
2014-04-08 19:56:31 +02:00
|
|
|
|
2020-05-28 17:51:09 +02:00
|
|
|
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.
|
2014-04-08 19:56:31 +02:00
|
|
|
|
2009-08-11 23:18:50 +02:00
|
|
|
Installation
|
|
|
|
|
------------
|
|
|
|
|
|
2018-02-25 10:48:09 +01:00
|
|
|
To build and install zathura using meson's ninja backend:
|
2009-08-11 23:18:50 +02:00
|
|
|
|
2020-05-28 17:51:09 +02:00
|
|
|
meson build
|
|
|
|
|
cd build
|
|
|
|
|
ninja
|
|
|
|
|
ninja install
|
2013-11-04 20:55:54 +01:00
|
|
|
|
2018-02-25 10:48:09 +01:00
|
|
|
Note that the default backend for meson might vary based on the platform. Please
|
|
|
|
|
refer to the meson documentation for platform specific dependencies.
|
|
|
|
|
|
2013-11-04 20:55:54 +01:00
|
|
|
Bugs
|
|
|
|
|
----
|
2018-02-20 22:41:53 +01:00
|
|
|
|
2018-11-27 20:55:16 +01:00
|
|
|
Please report bugs at http://git.pwmt.org/pwmt/zathura.
|
