summaryrefslogtreecommitdiffstats
path: root/office/zathura/man/zathura.1
diff options
context:
space:
mode:
Diffstat (limited to 'office/zathura/man/zathura.1')
-rw-r--r--office/zathura/man/zathura.183
1 files changed, 71 insertions, 12 deletions
diff --git a/office/zathura/man/zathura.1 b/office/zathura/man/zathura.1
index fd49b0449b..dd5b216ebb 100644
--- a/office/zathura/man/zathura.1
+++ b/office/zathura/man/zathura.1
@@ -1,8 +1,5 @@
.\" Man page generated from reStructuredText.
.
-.TH "ZATHURA" "1" "2017-01-11" "0.2.7" "zathura"
-.SH NAME
-zathura \- a document viewer
.
.nr rst2man-indent-level 0
.
@@ -30,10 +27,14 @@ level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
+.TH "ZATHURA" "1" "2022-09-08" "0.5.1" "zathura"
+.SH NAME
+zathura \- a document viewer
.SH SYNOPSIS
.sp
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>
.SH DESCRIPTION
.sp
@@ -57,14 +58,17 @@ Path to the directory containing plugins
.TP
.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 .
+password will be used for the first one and zathura will ask for the
+passwords of the remaining files if needed.
.TP
.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.
.TP
+.BI \-f\fP,\fB \-\-find\fB= string
+Opens the document and searches for the given string.
+.TP
.BI \-l\fP,\fB \-\-log\-level\fB= level
Set log level (debug, info, warning, error)
.TP
@@ -81,13 +85,16 @@ 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.
.TP
-.B \-\-fork
+.BI \-\-mode\fB= mode
+Start in a non\-default mode
+.TP
+.B \-\-fork
Fork into background
.TP
-.B \-\-version
+.B \-\-version
Display version string and exit
.TP
-.B \-\-help
+.B \-\-help
Display help and exit
.UNINDENT
.SH MOUSE AND KEY BINDINGS
@@ -118,6 +125,9 @@ Scroll a full page left, down, up or right
.B gg, G, nG
Goto to the first, the last or to the nth page
.TP
+.B P
+Snaps to the current page
+.TP
.B H, L
Goto top or bottom of the current page
.TP
@@ -148,6 +158,9 @@ Follow links
.B F
Display link target
.TP
+.B c
+Copy link target into the clipboard
+.TP
.B :
Enter command
.TP
@@ -155,7 +168,7 @@ Enter command
Rotate by 90 degrees
.TP
.B ^r
-Recolor
+Recolor (grayscale and invert colors)
.TP
.B R
Reload document
@@ -315,7 +328,8 @@ List bookmarks
Close document
.TP
.B exec
-Execute an external command
+Execute an external command. \fB$FILE\fP expands to the current document path,
+and \fB$PAGE\fP to the current page number
.TP
.B info
Show document information
@@ -352,8 +366,53 @@ 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
+\fI\-\-synctex\-forward\fP and zathura will pass the information to the correct
instance.
+.sp
+For gvim forward and backwards synchronization support can be set up as follows:
+First add the following to the vim configuration:
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+function! Synctex()
+ execute "silent !zathura \-\-synctex\-forward " . line(\(aq.\(aq) . ":" . col(\(aq.\(aq) . ":" . bufname(\(aq%\(aq) . " " . g:syncpdf
+ redraw!
+endfunction
+map <C\-enter> :call Synctex()<cr>
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.sp
+Then launch \fIzathura\fP with
+.INDENT 0.0
+.INDENT 3.5
+.sp
+.nf
+.ft C
+zathura \-x "gvim \-\-servername vim \-c \e"let g:syncpdf=\(aq$1\(aq\e" \-\-remote +%{line} %{input}" $file
+.ft P
+.fi
+.UNINDENT
+.UNINDENT
+.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)
+.IP \(bu 2
+LaTeX for Atom (\fI\%https://atom.io/packages/latex\fP)
+.UNINDENT
+.SH ENVIRONMENT VARIABLES
+.INDENT 0.0
+.TP
+.B ZATHURA_PLUGINS_PATH
+Path to the directory containing plugins. This directory is only considered if
+no other directory was specified using \-\-plugins\-dir.
+.UNINDENT
.SH KNOWN BUGS
.sp
If GDK_NATIVE_WINDOWS is enabled you will experience problems with large
@@ -366,6 +425,6 @@ appear, if overlay\-scrollbar is enabled in GTK_MODULES.
.SH AUTHOR
pwmt.org
.SH COPYRIGHT
-2009-2015, pwmt.org
+2009-2018, pwmt.org
.\" Generated by docutils manpage writer.
.