zathura.1 6.83 KB
Newer Older
1 2
.\" Man page generated from reStructuredText.
.
3
.TH "ZATHURA" "1" "April 13, 2015" "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] <files>
37 38 39 40 41
.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.
42 43 44
.SH OPTIONS
.INDENT 0.0
.TP
45
.BI \-e\fP,\fB  \-\-reparent\fB= xid
46 47
Reparents to window specified by xid
.TP
48
.BI \-c\fP,\fB  \-\-config\-dir\fB= path
49 50
Path to the config directory
.TP
51
.BI \-d\fP,\fB  \-\-data\-dir\fB= path
52 53
Path to the data directory
.TP
54
.BI \-p\fP,\fB  \-\-plugins\-dir\fB= path
55 56
Path to the directory containing plugins
.TP
57 58 59 60
.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 .
61
.TP
62 63 64 65
.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.
66
.TP
67
.BI \-l\fP,\fB  \-\-debug\fB= level
68 69
Set log debug level (debug, info, warning, error)
.TP
70
.BI \-x\fP,\fB  \-\-synctex\-editor\-command\fB= command
71
Set the synctex editor command. Overrides the synctex\-editor\-command setting.
72
.TP
73
.BI \-\-synctex\-forward\fB= input
74 75
Jump to the given position. The switch expects the same format as specified
for synctex\(aqs view \-i.
76
.TP
77 78
.B \-\-fork
Fork into background
79
.TP
80 81
.B \-\-version
Display version string and exit
82
.TP
83 84
.B \-\-help
Display help and exit
85 86
.UNINDENT
.SH MOUSE AND KEY BINDINGS
87 88 89 90
.sp
General
.INDENT 0.0
.INDENT 3.5
91 92
.INDENT 0.0
.TP
93 94 95 96 97
.B J, PgDn
Go to the next page
.TP
.B K, PgUp
Go to the previous page
98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113
.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
114 115 116
.B H, L
Goto top or bottom of the current page
.TP
117 118 119
.B ^o, ^i
Move backward and forward through the jump list
.TP
120 121 122
.B ^j, ^k
Bisect forward and backward between the last two jump points
.TP
123 124 125 126 127 128 129 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 158
.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
Recolor
.TP
.B R
Reload document
.TP
.B Tab
Show index and switch to \fBIndex mode\fP
.TP
159 160 161
.B d
Toggle dual page view
.TP
162
.B F5
163 164 165
Switch to presentation mode
.TP
.B F11
166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191
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
.B \(aqX
Goto quickmark saved at letter or number X
.TP
.B q
Quit
.UNINDENT
192 193 194 195 196 197
.UNINDENT
.UNINDENT
.sp
Fullscreen mode
.INDENT 0.0
.INDENT 3.5
198 199 200 201 202 203 204 205 206 207 208 209 210 211
.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
212
.B F11
213 214 215 216 217 218 219 220 221 222 223 224 225 226
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
227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252
.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
253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272
.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
273 274 275 276 277 278
.UNINDENT
.UNINDENT
.sp
Mouse bindings
.INDENT 0.0
.INDENT 3.5
279 280 281 282 283 284 285 286 287 288 289 290 291 292
.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
293 294
.UNINDENT
.UNINDENT
295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318
.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
.B help
Show help page
.TP
319
.B open
320 321 322 323 324 325 326 327
Open a document
.TP
.B offset
Set page offset
.TP
.B print
Print document
.TP
328
.B write(!)
329 330 331 332
Save document (and force overwriting)
.TP
.B export
Export attachments
333 334 335
.TP
.B dump
Write values, descriptions, etc. of all current settings to a file.
336 337 338 339 340 341
.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).
342 343 344 345
.SH SYNCTEX SUPPORT
.sp
Both synctex forward and backwards synchronization are supported by zathura, To
enable synctex forward synchronization, please look at the \fI\-\-syntex\fP and
346 347 348 349 350 351 352
\fI\-\-synctex\-editor\fP options. zathura will also emit a signal via the D\-Bus
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
pass the arguments to \fIsynctex view\fP\(aqs \fI\-i\fP option to zathura via
\fI\-\-syntex\-forward\fP and zathura will pass the information to the correct
instance.
353 354 355 356
.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
357 358
properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The same issue may
appear, if overlay\-scrollbar is enabled in GTK_MODULES.
359 360
.SH SEE ALSO
.sp
361
\fIzathurarc(5)\fP
362 363
.SH AUTHOR
pwmt.org
364
.SH COPYRIGHT
365
2009-2015, pwmt.org
366 367
.\" Generated by docutils manpage writer.
.