zathura.1 7.43 KB
Newer Older
1 2
.\" Man page generated from reStructuredText.
.
3
.TH "ZATHURA" "1" "2017-12-20" "0.2.7" "zathura"
4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32
.SH NAME
zathura \- a document viewer
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
33
.SH SYNOPSIS
34
.sp
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]
37
<files>
38 39 40 41 42
.SH DESCRIPTION
.sp
\fBzathura\fP displays the given files. If a single hyphen\-minus (\-) is given as
file name, the content will be read from the standard input. If no files are
given, an empty \fBzathura\fP instance launches.
43 44 45
.SH OPTIONS
.INDENT 0.0
.TP
46
.BI \-e\fP,\fB  \-\-reparent\fB= xid
47 48
Reparents to window specified by xid
.TP
49
.BI \-c\fP,\fB  \-\-config\-dir\fB= path
50 51
Path to the config directory
.TP
52
.BI \-d\fP,\fB  \-\-data\-dir\fB= path
53 54
Path to the data directory
.TP
55
.BI \-p\fP,\fB  \-\-plugins\-dir\fB= path
56 57
Path to the directory containing plugins
.TP
58 59 60 61
.BI \-w\fP,\fB  \-\-password\fB= password
The documents password. If multiple documents are opened at once, the
password will be  used for the first one and zathura will ask for the
passwords of the remaining files if needed .
62
.TP
63 64 65 66
.BI \-P\fP,\fB  \-\-page\fB= number
Opens the document at the given page number. Pages are numbered starting
with 1, and negative numbers indicate page numbers starting from the end
of the document, \-1 being the last page.
67
.TP
68 69
.BI \-l\fP,\fB  \-\-log\-level\fB= level
Set log level (debug, info, warning, error)
70
.TP
71
.BI \-x\fP,\fB  \-\-synctex\-editor\-command\fB= command
72
Set the synctex editor command. Overrides the synctex\-editor\-command setting.
73
.TP
74
.BI \-\-synctex\-forward\fB= input
75
Jump to the given position. The switch expects the same format as specified
76 77
for synctex’s view \-i. If no instance is running for the specified document,
a new instance will be launched (only if –synctex\-pid is not specified).
78 79 80 81 82
.TP
.BI \-\-synctex\-pid\fB= pid
Instead of looking for an instance having the correct file opened, try only
the instance with the given PID. Note that if the given PID does not have the
correct file open or does not exist, no new instance will be spanned.
83
.TP
84 85
.B \-\-fork
Fork into background
86
.TP
87 88
.B \-\-version
Display version string and exit
89
.TP
90 91
.B \-\-help
Display help and exit
92 93
.UNINDENT
.SH MOUSE AND KEY BINDINGS
94 95 96 97
.sp
General
.INDENT 0.0
.INDENT 3.5
98 99
.INDENT 0.0
.TP
100 101 102 103 104
.B J, PgDn
Go to the next page
.TP
.B K, PgUp
Go to the previous page
105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120
.TP
.B h, k, j, l
Scroll to the left, down, up or right direction
.TP
.B Left, Down, Up, Right
Scroll to the left, down, up or right direction
.TP
.B ^t, ^d, ^u, ^y
Scroll a half page left, down, up or right
.TP
.B t, ^f, ^b, space, <S\-space>, y
Scroll a full page left, down, up or right
.TP
.B gg, G, nG
Goto to the first, the last or to the nth page
.TP
121 122 123
.B H, L
Goto top or bottom of the current page
.TP
124 125 126
.B ^o, ^i
Move backward and forward through the jump list
.TP
127 128 129
.B ^j, ^k
Bisect forward and backward between the last two jump points
.TP
130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157
.B ^c, Escape
Abort
.TP
.B a, s
Adjust window in best\-fit or width mode
.TP
.B /, ?
Search for text
.TP
.B n, N
Search for the next or previous result
.TP
.B o, O
Open document
.TP
.B f
Follow links
.TP
.B F
Display link target
.TP
.B :
Enter command
.TP
.B r
Rotate by 90 degrees
.TP
.B ^r
158
Recolor (grayscale and invert colors)
159 160 161 162 163 164 165
.TP
.B R
Reload document
.TP
.B Tab
Show index and switch to \fBIndex mode\fP
.TP
166 167 168
.B d
Toggle dual page view
.TP
169
.B F5
170 171 172
Switch to presentation mode
.TP
.B F11
173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192
Switch to fullscreen mode
.TP
.B ^m
Toggle inputbar
.TP
.B ^n
Toggle statusbar
.TP
.B +, \-, =
Zoom in, out or to the original size
.TP
.B zI, zO, z0
Zoom in, out or to the original size
.TP
.B n=
Zoom to size n
.TP
.B mX
Set a quickmark to a letter or number X
.TP
193
.B ‘X
194 195 196 197 198
Goto quickmark saved at letter or number X
.TP
.B q
Quit
.UNINDENT
199 200 201 202 203 204
.UNINDENT
.UNINDENT
.sp
Fullscreen mode
.INDENT 0.0
.INDENT 3.5
205 206 207 208 209 210 211 212 213 214 215 216 217 218
.INDENT 0.0
.TP
.B J, K
Go to the next or previous page
.TP
.B space, <S\-space>, <BackSpace>
Scroll a full page down or up
.TP
.B gg, G, nG
Goto to the first, the last or to the nth page
.TP
.B ^c, Escape
Abort
.TP
219
.B F11
220 221 222 223 224 225 226 227 228 229 230 231 232 233
Switch to normal mode
.TP
.B +, \-, =
Zoom in, out or to the original size
.TP
.B zI, zO, z0
Zoom in, out or to the original size
.TP
.B n=
Zoom to size n
.TP
.B q
Quit
.UNINDENT
234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259
.UNINDENT
.UNINDENT
.sp
Presentation mode
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B space, <S\-space>, <BackSpace>
Scroll a full page down or up
.TP
.B ^c, Escape
Abort
.TP
.B F5
Switch to normal mode
.TP
.B q
Quit
.UNINDENT
.UNINDENT
.UNINDENT
.sp
Index mode
.INDENT 0.0
.INDENT 3.5
260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279
.INDENT 0.0
.TP
.B k, j
Move to upper or lower entry
.TP
.B l
Expand entry
.TP
.B L
Expand all entries
.TP
.B h
Collapse entry
.TP
.B H
Collapse all entries
.TP
.B space, Return
Select and open entry
.UNINDENT
280 281 282 283 284 285
.UNINDENT
.UNINDENT
.sp
Mouse bindings
.INDENT 0.0
.INDENT 3.5
286 287 288 289 290 291 292 293 294 295 296 297 298 299
.INDENT 0.0
.TP
.B Scroll
Scroll up or down
.TP
.B ^Scroll
Zoom in or out
.TP
.B Hold Button2
Pan the document
.TP
.B Button1
Follow link
.UNINDENT
300 301
.UNINDENT
.UNINDENT
302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322
.SH COMMANDS
.INDENT 0.0
.TP
.B bmark
Save a bookmark
.TP
.B bdelete
Delete a bookmark
.TP
.B blist
List bookmarks
.TP
.B close
Close document
.TP
.B exec
Execute an external command
.TP
.B info
Show document information
.TP
323
.B open
324 325 326 327 328 329 330 331
Open a document
.TP
.B offset
Set page offset
.TP
.B print
Print document
.TP
332
.B write(!)
333 334 335 336
Save document (and force overwriting)
.TP
.B export
Export attachments
337 338 339
.TP
.B dump
Write values, descriptions, etc. of all current settings to a file.
340 341 342 343 344 345
.UNINDENT
.SH CONFIGURATION
.sp
The default appearance and behaviour of zathura can be overwritten by modifying
the \fIzathurarc\fP file (default path: ~/.config/zathura/zathurarc). For a detailed
description please consult zathurarc(5).
346 347 348
.SH SYNCTEX SUPPORT
.sp
Both synctex forward and backwards synchronization are supported by zathura, To
349 350
enable synctex forward synchronization, please look at the \fI–synctex\-forward\fP
and \fI–synctex\-editor\fP options. zathura will also emit a signal via the D\-Bus
351 352 353
interface. To support synctex backwards synchronization, zathura provides a
D\-Bus interface that can be called by the editor. For convince zathura also
knows how to parse the output of the \fIsynctex view\fP command. It is enough to
354 355
pass the arguments to \fIsynctex view\fP’s \fI\-i\fP option to zathura via
\fI–syntex\-forward\fP and zathura will pass the information to the correct
356
instance.
357 358 359 360 361 362 363
.sp
Some editors support zathura as viewer out of the box:
.INDENT 0.0
.IP \(bu 2
LaTeXTools for SublimeText
(\fI\%https://latextools.readthedocs.io/en/latest/available\-viewers/#zathura\fP)
.UNINDENT
364 365 366 367
.SH KNOWN BUGS
.sp
If GDK_NATIVE_WINDOWS is enabled you will experience problems with large
documents. In this case zathura might crash or pages cannot be rendered
368 369
properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The same issue may
appear, if overlay\-scrollbar is enabled in GTK_MODULES.
370 371
.SH SEE ALSO
.sp
372
\fIzathurarc(5)\fP
373 374
.SH AUTHOR
pwmt.org
375
.SH COPYRIGHT
376
2009-2015, pwmt.org
377 378
.\" Generated by docutils manpage writer.
.