mirror of
https://git.pwmt.org/pwmt/zathura.git
synced 2024-12-27 12:26:00 +01:00
317 lines
7 KiB
ReStructuredText
317 lines
7 KiB
ReStructuredText
Manpage
|
|
=======
|
|
|
|
Synopsis
|
|
--------
|
|
|
|
zathura [-e XID] [-c PATH] [-d PATH] [-p PATH] [-w PASSWORD] [-P NUMBER]
|
|
[--fork] [-l LEVEL] [-s] [-x CMD] [--synctex-forward INPUT] [--synctex-pid PID]
|
|
[-find STRING]
|
|
<files>
|
|
|
|
Description
|
|
-----------
|
|
|
|
**zathura** 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 **zathura** instance launches.
|
|
|
|
Options
|
|
-------
|
|
|
|
-e, --reparent=xid
|
|
Reparents to window specified by xid
|
|
|
|
-c, --config-dir=path
|
|
Path to the config directory
|
|
|
|
-d, --data-dir=path
|
|
Path to the data directory
|
|
|
|
-p, --plugins-dir=path
|
|
Path to the directory containing plugins
|
|
|
|
-w, --password=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.
|
|
|
|
-P, --page=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.
|
|
|
|
-f, --find=string
|
|
Opens the document and searches for the given string.
|
|
|
|
-l, --log-level=level
|
|
Set log level (debug, info, warning, error)
|
|
|
|
-x, --synctex-editor-command=command
|
|
Set the synctex editor command. Overrides the synctex-editor-command setting.
|
|
|
|
--synctex-forward=input
|
|
Jump to the given position. The switch expects the same format as specified
|
|
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).
|
|
|
|
--synctex-pid=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.
|
|
|
|
--mode=mode
|
|
Start in a non-default mode
|
|
|
|
--fork
|
|
Fork into background
|
|
|
|
--version
|
|
Display version string and exit
|
|
|
|
--help
|
|
Display help and exit
|
|
|
|
Mouse and key bindings
|
|
----------------------
|
|
|
|
General
|
|
|
|
J, PgDn
|
|
Go to the next page
|
|
K, PgUp
|
|
Go to the previous page
|
|
h, k, j, l
|
|
Scroll to the left, down, up or right direction
|
|
Left, Down, Up, Right
|
|
Scroll to the left, down, up or right direction
|
|
^t, ^d, ^u, ^y
|
|
Scroll a half page left, down, up or right
|
|
t, ^f, ^b, space, <S-space>, y
|
|
Scroll a full page left, down, up or right
|
|
gg, G, nG
|
|
Goto to the first, the last or to the nth page
|
|
P
|
|
Snaps to the current page
|
|
H, L
|
|
Goto top or bottom of the current page
|
|
^o, ^i
|
|
Move backward and forward through the jump list
|
|
^j, ^k
|
|
Bisect forward and backward between the last two jump points
|
|
^c, Escape
|
|
Abort
|
|
a, s
|
|
Adjust window in best-fit or width mode
|
|
/, ?
|
|
Search for text
|
|
n, N
|
|
Search for the next or previous result
|
|
o, O
|
|
Open document
|
|
f
|
|
Follow links
|
|
F
|
|
Display link target
|
|
c
|
|
Copy link target into the clipboard
|
|
\:
|
|
Enter command
|
|
r
|
|
Rotate by 90 degrees
|
|
^r
|
|
Recolor (grayscale and invert colors)
|
|
R
|
|
Reload document
|
|
Tab
|
|
Show index and switch to **Index mode**
|
|
d
|
|
Toggle dual page view
|
|
F5
|
|
Switch to presentation mode
|
|
F11
|
|
Switch to fullscreen mode
|
|
^m
|
|
Toggle inputbar
|
|
^n
|
|
Toggle statusbar
|
|
+, -, =
|
|
Zoom in, out or to the original size
|
|
zI, zO, z0
|
|
Zoom in, out or to the original size
|
|
n=
|
|
Zoom to size n
|
|
mX
|
|
Set a quickmark to a letter or number X
|
|
'X
|
|
Goto quickmark saved at letter or number X
|
|
q
|
|
Quit
|
|
|
|
|
|
Fullscreen mode
|
|
|
|
J, K
|
|
Go to the next or previous page
|
|
space, <S-space>, <BackSpace>
|
|
Scroll a full page down or up
|
|
gg, G, nG
|
|
Goto to the first, the last or to the nth page
|
|
^c, Escape
|
|
Abort
|
|
F11
|
|
Switch to normal mode
|
|
+, -, =
|
|
Zoom in, out or to the original size
|
|
zI, zO, z0
|
|
Zoom in, out or to the original size
|
|
n=
|
|
Zoom to size n
|
|
q
|
|
Quit
|
|
|
|
Presentation mode
|
|
|
|
space, <S-space>, <BackSpace>
|
|
Scroll a full page down or up
|
|
^c, Escape
|
|
Abort
|
|
F5
|
|
Switch to normal mode
|
|
q
|
|
Quit
|
|
|
|
Index mode
|
|
|
|
k, j
|
|
Move to upper or lower entry
|
|
l
|
|
Expand entry
|
|
L
|
|
Expand all entries
|
|
h
|
|
Collapse entry
|
|
H
|
|
Collapse all entries
|
|
space, Return
|
|
Select and open entry
|
|
|
|
|
|
Mouse bindings
|
|
|
|
Scroll
|
|
Scroll up or down
|
|
^Scroll
|
|
Zoom in or out
|
|
Hold Button2
|
|
Pan the document
|
|
Button1
|
|
Follow link
|
|
Hold Button1
|
|
Select text
|
|
Hold ^Button1
|
|
Highlight region
|
|
|
|
|
|
Commands
|
|
---------
|
|
|
|
bmark
|
|
Save a bookmark
|
|
|
|
bdelete
|
|
Delete a bookmark
|
|
|
|
blist
|
|
List bookmarks
|
|
|
|
close
|
|
Close document
|
|
|
|
exec
|
|
Execute an external command. ``$FILE`` expands to the current document path,
|
|
``$PAGE`` to the current page number, and ``$DBUS`` to the bus name of the
|
|
D-Bus interface
|
|
|
|
info
|
|
Show document information
|
|
|
|
open
|
|
Open a document
|
|
|
|
offset
|
|
Set page offset
|
|
|
|
print
|
|
Print document
|
|
|
|
write(!)
|
|
Save document (and force overwriting)
|
|
|
|
export
|
|
Export attachments
|
|
|
|
dump
|
|
Write values, descriptions, etc. of all current settings to a file.
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
The default appearance and behaviour of zathura can be overwritten by modifying
|
|
the *zathurarc* file (default path: ~/.config/zathura/zathurarc). For a detailed
|
|
description please consult zathurarc(5).
|
|
|
|
Synctex support
|
|
---------------
|
|
|
|
Both synctex forward and backwards synchronization are supported by zathura, To
|
|
enable synctex forward synchronization, please look at the *--synctex-forward*
|
|
and *--synctex-editor* 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 *synctex view* command. It is enough to
|
|
pass the arguments to *synctex view*'s *-i* option to zathura via
|
|
*--synctex-forward* and zathura will pass the information to the correct
|
|
instance.
|
|
|
|
For gvim forward and backwards synchronization support can be set up as follows:
|
|
First add the following to the vim configuration:
|
|
|
|
::
|
|
|
|
function! Synctex()
|
|
execute "silent !zathura --synctex-forward " . line('.') . ":" . col('.') . ":" . bufname('%') . " " . g:syncpdf
|
|
redraw!
|
|
endfunction
|
|
map <C-enter> :call Synctex()<cr>
|
|
|
|
Then launch *zathura* with
|
|
|
|
::
|
|
|
|
zathura -x "gvim --servername vim -c \"let g:syncpdf='$1'\" --remote +%{line} %{input}" $file
|
|
|
|
Some editors support zathura as viewer out of the box:
|
|
|
|
* LaTeXTools for SublimeText
|
|
(https://latextools.readthedocs.io/en/latest/available-viewers/#zathura)
|
|
* LaTeX for Atom (https://atom.io/packages/latex)
|
|
|
|
Environment variables
|
|
---------------------
|
|
|
|
ZATHURA_PLUGINS_PATH
|
|
Path to the directory containing plugins. This directory is only considered if
|
|
no other directory was specified using --plugins-dir.
|
|
|
|
Known bugs
|
|
----------
|
|
|
|
If GDK_NATIVE_WINDOWS is enabled you will experience problems with large
|
|
documents. In this case zathura might crash or pages cannot be rendered
|
|
properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The same issue may
|
|
appear, if overlay-scrollbar is enabled in GTK_MODULES.
|
|
|
|
See Also
|
|
--------
|
|
`zathurarc(5)`
|