mirror of https://git.pwmt.org/pwmt/zathura.git synced 2024-09-20 23:41:20 +02:00

Document viewer

Go to file

Viktor Walter 6d66bc88af Fixing the issue of the 'best-fit' zoom being way too low if one page is larger that the rest. The zoom was trying to accomodate for the large page, but it should instead accomodate for the most frequent size. This is still not ideal, since as it is now Zathura crops the larger pages to the size of the most frequent size, but this typically only affects things like larger first pages in scans. I am building this on thop of the Ailrk-fork, since that version already implemented a way how to estimate the most frequent page size, from the first 32 pages.		2021-11-29 19:12:45 +01:00
data	Fix SVG icon install path	2020-07-19 08:37:03 +00:00
doc	Refactor manpages	2020-07-24 11:30:43 +02:00
po	Update translations	2020-09-03 21:35:01 +02:00
subprojects	Switching the girara repo, since the original seems inaccessible	2021-11-29 15:31:57 +01:00
tests	Build sandbox test only if seccomp enabled	2020-07-27 18:44:52 +02:00
zathura	Fixing the issue of the 'best-fit' zoom being way too low if one page is larger that the rest. The zoom was trying to accomodate for the large page, but it should instead accomodate for the most frequent size. This is still not ideal, since as it is now Zathura crops the larger pages to the size of the most frequent size, but this typically only affects things like larger first pages in scans. I am building this on thop of the Ailrk-fork, since that version already implemented a way how to estimate the most frequent page size, from the first 32 pages.	2021-11-29 19:12:45 +01:00
.gitignore	pinned	2021-02-04 16:16:02 -08:00
.gitlab-ci.yml	Cache CI	2020-01-05 14:28:04 +01: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
meson.build	Version 0.4.7	2020-09-03 21:42:47 +02:00
README.md	Nicer markdown	2020-05-28 17:51:09 +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.2)

The following dependencies are optional:

sqlite3 (>= 3.6.23): splite3 database backend
libmagic from file(1): for mime-type detection
libsynctex from TeXLive (>= 1.19): SyncTeX support
libseccomp: sandbox support

For building zathura, the following dependencies are also required:

meson (>= 0.47)
gettext

The following dependencies are optional build-time only dependencies:

check: 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.