1 .\" Man page generated from reStructuredText.
3 .TH "ZATHURA" "1" "2019-09-08" "0.4.4" "zathura"
5 zathura \- a document viewer
7 .nr rst2man-indent-level 0
11 level \\n[rst2man-indent-level]
12 level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
19 .\" .rstReportMargin pre:
21 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
22 . nr rst2man-indent-level +1
23 .\" .rstReportMargin post:
27 .\" indent \\n[an-margin]
28 .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
29 .nr rst2man-indent-level -1
30 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
31 .in \\n[rst2man-indent\\n[rst2man-indent-level]]u
35 zathura [\-e XID] [\-c PATH] [\-d PATH] [\-p PATH] [\-w PASSWORD] [\-P NUMBER]
36 [\-\-fork] [\-l LEVEL] [\-s] [\-x CMD] [\-\-synctex\-forward INPUT] [\-\-synctex\-pid PID]
40 \fBzathura\fP displays the given files. If a single hyphen\-minus (\-) is given as
41 file name, the content will be read from the standard input. If no files are
42 given, an empty \fBzathura\fP instance launches.
46 .BI \-e\fP,\fB \-\-reparent\fB= xid
47 Reparents to window specified by xid
49 .BI \-c\fP,\fB \-\-config\-dir\fB= path
50 Path to the config directory
52 .BI \-d\fP,\fB \-\-data\-dir\fB= path
53 Path to the data directory
55 .BI \-p\fP,\fB \-\-plugins\-dir\fB= path
56 Path to the directory containing plugins
58 .BI \-w\fP,\fB \-\-password\fB= password
59 The documents password. If multiple documents are opened at once, the
60 password will be used for the first one and zathura will ask for the
61 passwords of the remaining files if needed.
63 .BI \-P\fP,\fB \-\-page\fB= number
64 Opens the document at the given page number. Pages are numbered starting
65 with 1, and negative numbers indicate page numbers starting from the end
66 of the document, \-1 being the last page.
68 .BI \-l\fP,\fB \-\-log\-level\fB= level
69 Set log level (debug, info, warning, error)
71 .BI \-x\fP,\fB \-\-synctex\-editor\-command\fB= command
72 Set the synctex editor command. Overrides the synctex\-editor\-command setting.
74 .BI \-\-synctex\-forward\fB= input
75 Jump to the given position. The switch expects the same format as specified
76 for synctex\(aqs view \-i. If no instance is running for the specified document,
77 a new instance will be launched (only if \-\-synctex\-pid is not specified).
79 .BI \-\-synctex\-pid\fB= pid
80 Instead of looking for an instance having the correct file opened, try only
81 the instance with the given PID. Note that if the given PID does not have the
82 correct file open or does not exist, no new instance will be spanned.
85 Start in a non\-default mode
91 Display version string and exit
96 .SH ENVIRONMENT VARIABLES
99 .B ZATHURA_PLUGINS_PATH
100 Path to the directory containing plugins. This directory is only considered if
101 no other directory was specified using \-\-plugins\-dir.
103 .SH MOUSE AND KEY BINDINGS
114 Go to the previous page
117 Scroll to the left, down, up or right direction
119 .B Left, Down, Up, Right
120 Scroll to the left, down, up or right direction
123 Scroll a half page left, down, up or right
125 .B t, ^f, ^b, space, <S\-space>, y
126 Scroll a full page left, down, up or right
129 Goto to the first, the last or to the nth page
132 Goto top or bottom of the current page
135 Move backward and forward through the jump list
138 Bisect forward and backward between the last two jump points
144 Adjust window in best\-fit or width mode
150 Search for the next or previous result
168 Recolor (grayscale and invert colors)
174 Show index and switch to \fBIndex mode\fP
177 Toggle dual page view
180 Switch to presentation mode
183 Switch to fullscreen mode
192 Zoom in, out or to the original size
195 Zoom in, out or to the original size
201 Set a quickmark to a letter or number X
204 Goto quickmark saved at letter or number X
218 Go to the next or previous page
220 .B space, <S\-space>, <BackSpace>
221 Scroll a full page down or up
224 Goto to the first, the last or to the nth page
230 Switch to normal mode
233 Zoom in, out or to the original size
236 Zoom in, out or to the original size
252 .B space, <S\-space>, <BackSpace>
253 Scroll a full page down or up
259 Switch to normal mode
273 Move to upper or lower entry
288 Select and open entry
328 Execute an external command
331 Show document information
343 Save document (and force overwriting)
349 Write values, descriptions, etc. of all current settings to a file.
353 The default appearance and behaviour of zathura can be overwritten by modifying
354 the \fIzathurarc\fP file (default path: ~/.config/zathura/zathurarc). For a detailed
355 description please consult zathurarc(5).
358 Both synctex forward and backwards synchronization are supported by zathura, To
359 enable synctex forward synchronization, please look at the \fI\-\-synctex\-forward\fP
360 and \fI\-\-synctex\-editor\fP options. zathura will also emit a signal via the D\-Bus
361 interface. To support synctex backwards synchronization, zathura provides a
362 D\-Bus interface that can be called by the editor. For convince zathura also
363 knows how to parse the output of the \fIsynctex view\fP command. It is enough to
364 pass the arguments to \fIsynctex view\fP\(aqs \fI\-i\fP option to zathura via
365 \fI\-\-synctex\-forward\fP and zathura will pass the information to the correct
368 For gvim forward and backwards synchronization support can be set up as follows:
369 First add the following to the vim configuration:
376 execute "silent !zathura \-\-synctex\-forward " . line(\(aq.\(aq) . ":" . col(\(aq.\(aq) . ":" . bufname(\(aq%\(aq) . " " . g:syncpdf
379 map <C\-enter> :call Synctex()<cr>
385 Then launch \fIzathura\fP with
391 zathura \-x "gvim \-\-servername vim \-c \e"let g:syncpdf=\(aq$1\(aq\e" \-\-remote +%{line} %{input}" $file
397 Some editors support zathura as viewer out of the box:
400 LaTeXTools for SublimeText
401 (\fI\%https://latextools.readthedocs.io/en/latest/available\-viewers/#zathura\fP)
403 LaTeX for Atom (\fI\%https://atom.io/packages/latex\fP)
407 If GDK_NATIVE_WINDOWS is enabled you will experience problems with large
408 documents. In this case zathura might crash or pages cannot be rendered
409 properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The same issue may
410 appear, if overlay\-scrollbar is enabled in GTK_MODULES.
418 .\" Generated by docutils manpage writer.