diff options
Diffstat (limited to 'office/zathura')
-rw-r--r-- | office/zathura/man/zathura.1 | 371 | ||||
-rw-r--r-- | office/zathura/man/zathurarc.5 | 1332 | ||||
-rw-r--r-- | office/zathura/slack-desc | 2 | ||||
-rw-r--r-- | office/zathura/zathura.SlackBuild | 21 | ||||
-rw-r--r-- | office/zathura/zathura.info | 10 |
5 files changed, 1729 insertions, 7 deletions
diff --git a/office/zathura/man/zathura.1 b/office/zathura/man/zathura.1 new file mode 100644 index 0000000000000..fd49b0449bd96 --- /dev/null +++ b/office/zathura/man/zathura.1 @@ -0,0 +1,371 @@ +.\" 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 +. +.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 +.. +.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] +<files> +.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. +.SH OPTIONS +.INDENT 0.0 +.TP +.BI \-e\fP,\fB \-\-reparent\fB= xid +Reparents to window specified by xid +.TP +.BI \-c\fP,\fB \-\-config\-dir\fB= path +Path to the config directory +.TP +.BI \-d\fP,\fB \-\-data\-dir\fB= path +Path to the data directory +.TP +.BI \-p\fP,\fB \-\-plugins\-dir\fB= path +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 . +.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 \-l\fP,\fB \-\-log\-level\fB= level +Set log level (debug, info, warning, error) +.TP +.BI \-x\fP,\fB \-\-synctex\-editor\-command\fB= command +Set the synctex editor command. Overrides the synctex\-editor\-command setting. +.TP +.BI \-\-synctex\-forward\fB= input +Jump to the given position. The switch expects the same format as specified +for synctex\(aqs view \-i. If no instance is running for the specified document, +a new instance will be launched (only if \-\-synctex\-pid is not specified). +.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. +.TP +.B \-\-fork +Fork into background +.TP +.B \-\-version +Display version string and exit +.TP +.B \-\-help +Display help and exit +.UNINDENT +.SH MOUSE AND KEY BINDINGS +.sp +General +.INDENT 0.0 +.INDENT 3.5 +.INDENT 0.0 +.TP +.B J, PgDn +Go to the next page +.TP +.B K, PgUp +Go to the previous page +.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 +.B H, L +Goto top or bottom of the current page +.TP +.B ^o, ^i +Move backward and forward through the jump list +.TP +.B ^j, ^k +Bisect forward and backward between the last two jump points +.TP +.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 +.B d +Toggle dual page view +.TP +.B F5 +Switch to presentation mode +.TP +.B F11 +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 +.UNINDENT +.UNINDENT +.sp +Fullscreen mode +.INDENT 0.0 +.INDENT 3.5 +.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 +.B F11 +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 +.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 +.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 +.UNINDENT +.UNINDENT +.sp +Mouse bindings +.INDENT 0.0 +.INDENT 3.5 +.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 +.UNINDENT +.UNINDENT +.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 open +Open a document +.TP +.B offset +Set page offset +.TP +.B print +Print document +.TP +.B write(!) +Save document (and force overwriting) +.TP +.B export +Export attachments +.TP +.B dump +Write values, descriptions, etc. of all current settings to a file. +.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). +.SH SYNCTEX SUPPORT +.sp +Both synctex forward and backwards synchronization are supported by zathura, To +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 +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. +.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 +properly. Disabling GDK_NATIVE_WINDOWS fixes this issue. The same issue may +appear, if overlay\-scrollbar is enabled in GTK_MODULES. +.SH SEE ALSO +.sp +\fIzathurarc(5)\fP +.SH AUTHOR +pwmt.org +.SH COPYRIGHT +2009-2015, pwmt.org +.\" Generated by docutils manpage writer. +. diff --git a/office/zathura/man/zathurarc.5 b/office/zathura/man/zathurarc.5 new file mode 100644 index 0000000000000..93b42be0a809b --- /dev/null +++ b/office/zathura/man/zathurarc.5 @@ -0,0 +1,1332 @@ +.\" Man page generated from reStructuredText. +. +.TH "ZATHURARC" "5" "2017-01-11" "0.2.7" "zathura" +.SH NAME +zathurarc \- zathura configuration file +. +.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 +.. +.SH SYNOPSIS +.sp +/etc/zathurarc, $XDG_CONFIG_HOME/zathura/zathurarc +.SH DESCRIPTION +.sp +The \fIzathurarc\fP file is a simple plain text file that can be populated with +various commands to change the behaviour and the look of zathura which we are +going to describe in the following subsections. Each line (besides empty lines +and comments (which start with a prepended #) is evaluated on its own, so it +is not possible to write multiple commands in one single line. +.SH COMMANDS +.SS set \- Changing options +.sp +In addition to the built\-in \fB:set\fP command zathura offers more options to be +changed and makes those changes permanent. To overwrite an option you just have +to add a line structured like the following +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +set <option> <new value> +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +The \fBoption\fP field has to be replaced with the name of the option that should be +changed and the \fBnew value\fP field has to be replaced with the new value the +option should get. The type of the value can be one of the following: +.INDENT 0.0 +.IP \(bu 2 +INT \- An integer number +.IP \(bu 2 +FLOAT \- A floating point number +.IP \(bu 2 +STRING \- A character string +.IP \(bu 2 +BOOL \- A boolean value ("true" for true, "false" for false) +.UNINDENT +.sp +In addition we advice you to check the options to get a more detailed view of +the options that can be changed and which values they should be set to. +.sp +The following example should give some deeper insight of how the \fBset\fP command +can be used +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +set option1 5 +set option2 2.0 +set option3 hello +set option4 hello\e world +set option5 "hello world" +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +If you want to use \fBcolor codes\fP for some options, make sure to quote them +accordingly or to escape the hash symbol. +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +set default\-fg "#CCBBCC" +set default\-fg \e#CCBBCC +.ft P +.fi +.UNINDENT +.UNINDENT +.SS map \- Mapping a shortcut +.sp +It is possible to map or remap new key bindings to shortcut functions which +allows a high level of customization. The \fB:map\fP command can also be used in +the \fIzathurarc\fP file to make those changes permanent: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +map [mode] <binding> <shortcut function> <argument> +.ft P +.fi +.UNINDENT +.UNINDENT +.SS include \- Including another config file +.sp +This commands allows one to include other configuration files. If a relative +path is given, the path will be resolved relative to the configuration file that +is currently processed. +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +include another\-config +.ft P +.fi +.UNINDENT +.UNINDENT +.SS Mode +.sp +The \fBmap\fP command expects several arguments where only the \fBbinding\fP as well as +the \fBshortcut\-function\fP argument is required. Since zathura uses several modes +it is possible to map bindings only for a specific mode by passing the \fBmode\fP +argument which can take one of the following values: +.INDENT 0.0 +.IP \(bu 2 +normal (default) +.IP \(bu 2 +fullscreen +.IP \(bu 2 +index +.UNINDENT +.sp +The brackets around the value are mandatory. +.SS Single key binding +.sp +The (possible) second argument defines the used key binding that should be +mapped to the shortcut function and is structured like the following. On the one +hand it is possible to just assign single letters, numbers or signs to it: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +map a shortcut_function +map b shortcut_function +map c shortcut_function +map 1 shortcut_function +map 2 shortcut_function +map 3 shortcut_function +map ! shortcut_function +map ? shortcut_function +.ft P +.fi +.UNINDENT +.UNINDENT +.SS Using modifiers +.sp +It is also possible to use modifiers like the Control or Alt button on the +keyboard. It is possible to use the following modifiers: +.INDENT 0.0 +.IP \(bu 2 +A \- Alt +.IP \(bu 2 +C \- Control +.IP \(bu 2 +S \- Shift +.UNINDENT +.sp +Now it is required to define the \fBbinding\fP with the following structure: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +map <A\-a> shortcut_function +map <C\-a> shortcut_function +.ft P +.fi +.UNINDENT +.UNINDENT +.SS Special keys +.sp +zathura allows it also to assign keys like the space bar or the tab button which +also have to be written in between angle brackets. The following special keys +are currently available: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +Identifier Description + +BackSpace Back space +CapsLock Caps lock +Esc Escape +Down Arrow down +Up Arrow up +Left Arrow left +Right Arrow right +F1 F1 +F2 F2 +F3 F3 +F4 F4 +F5 F5 +F6 F6 +F7 F7 +F8 F8 +F9 F9 +F10 F10 +F11 F11 +F12 F12 +PageDown Page Down +PageUp Page Up +Return Return +Space Space +Super Windows key +Tab Tab +Print Print key +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +Of course it is possible to combine those special keys with a modifier. The +usage of those keys should be explained by the following examples: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +map <Space> shortcut_function +map <C\-Space> shortcut_function +.ft P +.fi +.UNINDENT +.UNINDENT +.SS Mouse buttons +.sp +It is also possible to map mouse buttons to shortcuts by using the following +special keys: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +Identifier Description + +Button1 Mouse button 1 +Button2 Mouse button 2 +Button3 Mouse button 3 +Button4 Mouse button 4 +Button5 Mouse button 5 +.ft P +.fi +.UNINDENT +.UNINDENT +.sp +They can also be combined with modifiers: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +map <Button1> shortcut_function +map <C\-Button1> shortcut_function +.ft P +.fi +.UNINDENT +.UNINDENT +.SS Buffer commands +.sp +If a mapping does not match one of the previous definition but is still a valid +mapping it will be mapped as a buffer command: +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +map abc quit +map test quit +.ft P +.fi +.UNINDENT +.UNINDENT +.SS Shortcut functions +.sp +The following shortcut functions can be mapped: +.INDENT 0.0 +.IP \(bu 2 +\fBabort\fP +.sp +Switch back to normal mode. +.IP \(bu 2 +\fBadjust_window\fP +.sp +Adjust page width. Possible arguments are \fBbest\-fit\fP and \fBwidth\fP\&. +.IP \(bu 2 +\fBchange_mode\fP +.sp +Change current mode. Pass the desired mode as argument. +.IP \(bu 2 +\fBdisplay_link\fP: +.sp +Display link target. +.IP \(bu 2 +\fBfocus_inputbar\fP +.sp +Focus inputbar. +.IP \(bu 2 +\fBfollow\fP +.sp +Follow a link. +.IP \(bu 2 +\fBgoto\fP +.sp +Go to a certain page. +.IP \(bu 2 +\fBjumplist\fP +.sp +Move forwards/backwards in the jumplist. +.IP \(bu 2 +\fBnavigate\fP +.sp +Navigate to the next/previous page. +.IP \(bu 2 +\fBnavigate_index\fP +.sp +Navigate through the index. +.IP \(bu 2 +\fBprint\fP +.sp +Show the print dialog. +.IP \(bu 2 +\fBquit\fP +.sp +Quit zathura. +.IP \(bu 2 +\fBrecolor\fP +.sp +Recolor pages. +.IP \(bu 2 +\fBreload\fP +.sp +Reload the document. +.IP \(bu 2 +\fBrotate\fP +.sp +Rotate the page. Pass \fBrotate\-ccw\fP as argument for counterclockwise rotation +and \fBrotate\-cw\fP for clockwise rotation. +.IP \(bu 2 +\fBscroll\fP +.sp +Scroll. +.IP \(bu 2 +\fBsearch\fP +.sp +Search next/previous item. Pass \fBforward\fP as argument to search for the next +hit and \fBbackward\fP to search for the previous hit. +.IP \(bu 2 +\fBset\fP +.sp +Set an option. +.IP \(bu 2 +\fBtoggle_fullscreen\fP +.sp +Toggle fullscreen. +.IP \(bu 2 +\fBtoggle_index\fP +.sp +Show or hide index. +.IP \(bu 2 +\fBtoggle_inputbar\fP +.sp +Show or hide inputbar. +.IP \(bu 2 +\fBtoggle_page_mode\fP +.sp +Toggle between one and multiple pages per row. +.IP \(bu 2 +\fBtoggle_statusbar\fP +.sp +Show or hide statusbar. +.IP \(bu 2 +\fBzoom\fP +.sp +Zoom in or out. +.IP \(bu 2 +\fBmark_add\fP +Set a quickmark. +.IP \(bu 2 +\fBmark_evaluate\fP +Go to a quickmark. +.UNINDENT +.SS Pass arguments +.sp +Some shortcut function require or have optional arguments which influence the +behaviour of them. Those can be passed as the last argument: +.INDENT 0.0 +.INDENT 3.5 +map <C\-i> zoom in +map <C\-o> zoom out +.UNINDENT +.UNINDENT +.sp +Possible arguments are: +.INDENT 0.0 +.IP \(bu 2 +best\-fit +.IP \(bu 2 +bottom +.IP \(bu 2 +collapse +.IP \(bu 2 +collapse\-all +.IP \(bu 2 +default +.IP \(bu 2 +down +.IP \(bu 2 +expand +.IP \(bu 2 +expand\-all +.IP \(bu 2 +full\-down +.IP \(bu 2 +full\-up +.IP \(bu 2 +half\-down +.IP \(bu 2 +half\-up +.IP \(bu 2 +in +.IP \(bu 2 +left +.IP \(bu 2 +next +.IP \(bu 2 +out +.IP \(bu 2 +page\-bottom +.IP \(bu 2 +page\-top +.IP \(bu 2 +previous +.IP \(bu 2 +right +.IP \(bu 2 +rotate\-ccw +.IP \(bu 2 +rotate\-cw +.IP \(bu 2 +select +.IP \(bu 2 +specific +.IP \(bu 2 +toggle +.IP \(bu 2 +top +.IP \(bu 2 +up +.IP \(bu 2 +width +.UNINDENT +.SS unmap \- Removing a shortcut +.sp +In addition to mapping or remaping custom key bindings it is possible to remove +existing ones by using the \fB:unmap\fP command. The command is used in the +following way (the explanation of the parameters is described in the \fBmap\fP +section of this document +.INDENT 0.0 +.INDENT 3.5 +.sp +.nf +.ft C +unmap [mode] <binding> +.ft P +.fi +.UNINDENT +.UNINDENT +.SH OPTIONS +.SS girara +.sp +This section describes settings concerning the behaviour of libgirara and +zathura. The settings described here can be changed with \fBset\fP\&. +.SS n\-completion\-items +.sp +Defines the maximum number of displayed completion entries. +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 15 +.UNINDENT +.SS completion\-bg +.sp +Defines the background color that is used for command line completion +entries +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #232323 +.UNINDENT +.SS completion\-fg +.sp +Defines the foreground color that is used for command line completion +entries +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #DDDDDD +.UNINDENT +.SS completion\-group\-bg +.sp +Defines the background color that is used for command line completion +group elements +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #000000 +.UNINDENT +.SS completion\-group\-fg +.sp +Defines the foreground color that is used for command line completion +group elements +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #DEDEDE +.UNINDENT +.SS completion\-highlight\-bg +.sp +Defines the background color that is used for the current command line +completion element +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #9FBC00 +.UNINDENT +.SS completion\-highlight\-fg +.sp +Defines the foreground color that is used for the current command line +completion element +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #232323 +.UNINDENT +.SS default\-fg +.sp +Defines the default foreground color +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #DDDDDD +.UNINDENT +.SS default\-bg +.sp +Defines the default background color +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #000000 +.UNINDENT +.SS exec\-command +.sp +Defines a command the should be prepanded to any command run with exec. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: +.UNINDENT +.SS font +.sp +Defines the font that will be used +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: monospace normal 9 +.UNINDENT +.SS guioptions +.sp +Shows or hides GUI elements. +If it contains \(aqc\(aq, the command line is displayed. +If it contains \(aqs\(aq, the statusbar is displayed. +If it contains \(aqh\(aq, the horizontal scrollbar is displayed. +If it contains \(aqv\(aq, the vertical scrollbar is displayed. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: s +.UNINDENT +.SS inputbar\-bg +.sp +Defines the background color for the inputbar +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #131313 +.UNINDENT +.SS inputbar\-fg +.sp +Defines the foreground color for the inputbar +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #9FBC00 +.UNINDENT +.SS notification\-bg +.sp +Defines the background color for a notification +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #FFFFFF +.UNINDENT +.SS notification\-fg +.sp +Defines the foreground color for a notification +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #000000 +.UNINDENT +.SS notification\-error\-bg +.sp +Defines the background color for an error notification +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #FFFFFF +.UNINDENT +.SS notification\-error\-fg +.sp +Defines the foreground color for an error notification +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #FF1212 +.UNINDENT +.SS notification\-warning\-bg +.sp +Defines the background color for a warning notification +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #FFFFFF +.UNINDENT +.SS notification\-warning\-fg +.sp +Defines the foreground color for a warning notification +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #FFF712 +.UNINDENT +.SS tabbar\-fg +.sp +Defines the foreground color for a tab +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #FFFFFF +.UNINDENT +.SS tabbar\-bg +.sp +Defines the background color for a tab +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #000000 +.UNINDENT +.SS tabbar\-focus\-fg +.sp +Defines the foreground color for the focused tab +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #9FBC00 +.UNINDENT +.SS tabbar\-focus\-bg +.sp +Defines the background color for the focused tab +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #000000 +.UNINDENT +.SS show\-scrollbars +.sp +Defines if both the horizontal and vertical scrollbars should be shown or not. +Deprecated, use \(aqguioptions\(aq instead. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS show\-h\-scrollbar +.sp +Defines whether to show/hide the horizontal scrollbar. Deprecated, use +\(aqguioptions\(aq instead. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS show\-v\-scrollbar +.sp +Defines whether to show/hide the vertical scrollbar. Deprecated, use +\(aqguioptions\(aq instead. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS statusbar\-bg +.sp +Defines the background color of the statusbar +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #000000 +.UNINDENT +.SS statusbar\-fg +.sp +Defines the foreground color of the statusbar +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #FFFFFF +.UNINDENT +.SS statusbar\-h\-padding +.sp +Defines the horizontal padding of the statusbar and notificationbar +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 8 +.UNINDENT +.SS statusbar\-v\-padding +.sp +Defines the vertical padding of the statusbar and notificationbar +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 2 +.UNINDENT +.SS window\-icon +.sp +Defines the path for a icon to be used as window icon. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: +.UNINDENT +.SS window\-height +.sp +Defines the window height on startup +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 600 +.UNINDENT +.SS window\-width +.sp +Defines the window width on startup +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 800 +.UNINDENT +.SS zathura +.sp +This section describes settings concerning the behaviour of zathura. +.SS abort\-clear\-search +.sp +Defines if the search results should be cleared on abort. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS adjust\-open +.sp +Defines which auto adjustment mode should be used if a document is loaded. +Possible options are "best\-fit" and "width". +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: best\-fit +.UNINDENT +.SS advance\-pages\-per\-row +.sp +Defines if the number of pages per row should be honored when advancing a page. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS database +.sp +Defines the database backend to use for bookmarks and input history. Possible +values are "plain", "sqlite" (if built with sqlite support) and "null". If +"null" is used, bookmarks and input history will not be stored. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: plain +.UNINDENT +.SS dbus\-service +.sp +En/Disables the D\-Bus service. If the services is disabled, SyncTeX forward +synchronization is not available. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS filemonitor +.sp +Defines the filemonitor backend. Possible values are "glib" and "signal" (if +signal handling is supported). +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: glib +.UNINDENT +.SS incremental\-search +.sp +En/Disables incremental search (search while typing). +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS highlight\-color +.sp +Defines the color that is used for highlighting parts of the document (e.g.: +show search results) +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #9FBC00 +.UNINDENT +.SS highlight\-active\-color +.sp +Defines the color that is used to show the current selected highlighted element +(e.g: current search result) +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #00BC00 +.UNINDENT +.SS highlight\-transparency +.sp +Defines the opacity of a highlighted element +.INDENT 0.0 +.IP \(bu 2 +Value type: Float +.IP \(bu 2 +Default value: 0.5 +.UNINDENT +.SS page\-padding +.sp +The page padding defines the gap in pixels between each rendered page. +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 1 +.UNINDENT +.SS page\-cache\-size +.sp +Defines the maximum number of pages that could be kept in the page cache. When +the cache is full and a new page that isn\(aqt cached becomes visible, the least +recently viewed page in the cache will be evicted to make room for the new one. +Large values for this variable are NOT recommended, because this will lead to +consuming a significant portion of the system memory. +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 15 +.UNINDENT +.SS page\-thumbnail\-size +.sp +Defines the maximum size in pixels of the thumbnail that could be kept in the +thumbnail cache per page. The thumbnail is scaled for a quick preview during +zooming before the page is rendered. When the page is rendered, the result is +saved as the thumbnail only if the size is no more than this value. A larger +value increases quality but introduces longer delay in zooming and uses more +system memory. +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 4194304 (4M) +.UNINDENT +.SS pages\-per\-row +.sp +Defines the number of pages that are rendered next to each other in a row. +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 1 +.UNINDENT +.SS first\-page\-column +.sp +Defines the column in which the first page will be displayed. +This setting is stored separately for every value of pages\-per\-row according to +the following pattern <1 page per row>:[<2 pages per row>[: ...]]. The last +value in the list will be used for all other number of pages per row if not set +explicitly. +.sp +Per default, the first column is set to 2 for double\-page layout. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: 1:2 +.UNINDENT +.SS recolor +.sp +En/Disables recoloring +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS recolor\-keephue +.sp +En/Disables keeping original hue when recoloring +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS recolor\-darkcolor +.sp +Defines the color value that is used to represent dark colors in recoloring mode +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #FFFFFF +.UNINDENT +.SS recolor\-lightcolor +.sp +Defines the color value that is used to represent light colors in recoloring mode +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #000000 +.UNINDENT +.SS recolor\-reverse\-video +.sp +Defines if original image colors should be kept while recoloring. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS render\-loading +.sp +Defines if the "Loading..." text should be displayed if a page is rendered. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS render\-loading\-bg +.sp +Defines the background color that is used for the "Loading..." text. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #FFFFFF +.UNINDENT +.SS render\-loading\-fg +.sp +Defines the foreground color that is used for the "Loading..." text. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #000000 +.UNINDENT +.SS scroll\-hstep +.sp +Defines the horizontal step size of scrolling by calling the scroll command once +.INDENT 0.0 +.IP \(bu 2 +Value type: Float +.IP \(bu 2 +Default value: \-1 +.UNINDENT +.SS scroll\-step +.sp +Defines the step size of scrolling by calling the scroll command once +.INDENT 0.0 +.IP \(bu 2 +Value type: Float +.IP \(bu 2 +Default value: 40 +.UNINDENT +.SS scroll\-full\-overlap +.sp +Defines the proportion of the current viewing area that should be +visible after scrolling a full page. +.INDENT 0.0 +.IP \(bu 2 +Value type: Float +.IP \(bu 2 +Default value: 0 +.UNINDENT +.SS scroll\-wrap +.sp +Defines if the last/first page should be wrapped +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS show\-directories +.sp +Defines if the directories should be displayed in completion. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS show\-hidden +.sp +Defines if hidden files and directories should be displayed in completion. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS show\-recent +.sp +Defines the number of recent files that should be displayed in completion. +If the value is negative, no upper bounds are applied. If the value is 0, no +recent files are shown. +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 10 +.UNINDENT +.SS scroll\-page\-aware +.sp +Defines if scrolling by half or full pages stops at page boundaries. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS smooth\-scroll +.sp +Defines if scrolling via touchpad should be smooth(only available with gtk >= 3.4). +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS link\-zoom +.sp +En/Disables the ability of changing zoom when following links. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS link\-hadjust +.sp +En/Disables aligning to the left internal link targets, for example from the +index. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS search\-hadjust +.sp +En/Disables horizontally centered search results. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS window\-title\-basename +.sp +Use basename of the file in the window title. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS window\-title\-home\-tilde +.sp +Display a short version of the file path, which replaces $HOME with ~, in the window title. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS window\-title\-page +.sp +Display the page number in the window title. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS statusbar\-basename +.sp +Use basename of the file in the statusbar. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS statusbar\-home\-tilde +.sp +Display a short version of the file path, which replaces $HOME with ~, in the statusbar. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS zoom\-center +.sp +En/Disables horizontally centered zooming. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: false +.UNINDENT +.SS zoom\-max +.sp +Defines the maximum percentage that the zoom level can be. +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 1000 +.UNINDENT +.SS zoom\-min +.sp +Defines the minimum percentage that the zoom level can be. +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 10 +.UNINDENT +.SS zoom\-step +.sp +Defines the amount of percent that is zoomed in or out on each command. +.INDENT 0.0 +.IP \(bu 2 +Value type: Integer +.IP \(bu 2 +Default value: 10 +.UNINDENT +.SS selection\-clipboard +.sp +Defines the X clipboard into which mouse\-selected data will be written. When it +is "clipboard", selected data will be written to the CLIPBOARD clipboard, and +can be pasted using the Ctrl+v key combination. When it is "primary", selected +data will be written to the PRIMARY clipboard, and can be pasted using the +middle mouse button, or the Shift\-Insert key combination. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: primary +.UNINDENT +.SS selection\-notification +.sp +Defines if a notification should be displayed after selecting text. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS synctex +.sp +En/Disables SyncTeX backward synchronization support. +.INDENT 0.0 +.IP \(bu 2 +Value type: Boolean +.IP \(bu 2 +Default value: true +.UNINDENT +.SS synctex\-editor\-command +.sp +Defines the command executed for SyncTeX backward synchronization. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: +.UNINDENT +.SS index\-fg +.sp +Defines the foreground color of the index mode. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #DDDDDD +.UNINDENT +.SS index\-bg +.sp +Define the background color of the index mode. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #232323 +.UNINDENT +.SS index\-active\-fg +.sp +Defines the foreground color of the selected element in index mode. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #232323 +.UNINDENT +.SS index\-active\-bg +.sp +Define the background color of the selected element in index mode. +.INDENT 0.0 +.IP \(bu 2 +Value type: String +.IP \(bu 2 +Default value: #9FBC00 +.UNINDENT +.SH SEE ALSO +.sp +zathura(1) +.SH AUTHOR +pwmt.org +.SH COPYRIGHT +2009-2015, pwmt.org +.\" Generated by docutils manpage writer. +. diff --git a/office/zathura/slack-desc b/office/zathura/slack-desc index 82139db93a3cf..871551a92b9a1 100644 --- a/office/zathura/slack-desc +++ b/office/zathura/slack-desc @@ -14,6 +14,6 @@ zathura: zathura is an application that provides a minimalistic and space zathura: saving interface as well as an easy usage that mainly focuses on zathura: keyboard interaction. zathura: -zathura: Homepage: http://zathura.pwmt.org/projects/zathura +zathura: zathura: zathura: diff --git a/office/zathura/zathura.SlackBuild b/office/zathura/zathura.SlackBuild index 74a164ec780f0..b5cbf77734d70 100644 --- a/office/zathura/zathura.SlackBuild +++ b/office/zathura/zathura.SlackBuild @@ -22,6 +22,14 @@ # OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF # ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +# 20170711 bkw: +# - BUILD=2 +# - Include API docs in package +# - Switch to github URLs since upstream's site has been broken for 3-4 +# days now. Side effect is, it makes it easier for my update script to +# let me know when there's a new release. This means adding the built +# man pages to SBo git (otherwise I'd have Sphinx as a dep, yuck). + # 20170125 bkw: # - Updated for v0.3.7, poppler plugin v0.2.7 @@ -53,7 +61,7 @@ PRGNAM=zathura VERSION=${VERSION:-0.3.7} -BUILD=${BUILD:-1} +BUILD=${BUILD:-2} TAG=${TAG:-_SBo} if [ -z "$ARCH" ]; then @@ -135,6 +143,10 @@ patch -p1 < $CWD/dlopen_hack.diff sed -i "s/-pedantic/$SLKCFLAGS/" config.mk sed -i '/-fdiagnostics-color/d' colors.mk +# 20170711 bkw: git tarballs don't include prebuilt man pages, and I do NOT +# want Sphinx and its 15+ deps as a dep for this build. So: +cp -r $CWD/man doc/_build + make LIBDIR=/usr/lib$LIBDIRSUFFIX make install LIBDIR=/usr/lib$LIBDIRSUFFIX MANPREFIX=/usr/man DESTDIR=$PKG RSTTOMAN="" gzip $PKG/usr/man/man?/*.? @@ -143,6 +155,13 @@ mkdir -p $PKG/usr/doc/$PRGNAM-$VERSION cp -a AUTHORS LICENSE README $PKG/usr/doc/$PRGNAM-$VERSION cat $CWD/$PRGNAM.SlackBuild > $PKG/usr/doc/$PRGNAM-$VERSION/$PRGNAM.SlackBuild +# Include the API docs. Sphinx would be needed to build HTML or PDF docs, but +# the doc sources are RST, which are perfectly human-readable already (though +# less easy to navigate). +cd doc +rm -rf installation man _build [A-Z]* *.mk *.py *.txt +cp -a * $PKG/usr/doc/$PRGNAM-$VERSION + # Now build the plugin. cd $TMP diff --git a/office/zathura/zathura.info b/office/zathura/zathura.info index 366533853f525..7915208f0eaf9 100644 --- a/office/zathura/zathura.info +++ b/office/zathura/zathura.info @@ -1,10 +1,10 @@ PRGNAM="zathura" VERSION="0.3.7" -HOMEPAGE="https://www.pwmt.org/projects/zathura" -DOWNLOAD="https://www.pwmt.org/projects/zathura/download/zathura-0.3.7.tar.gz \ - https://www.pwmt.org/projects/zathura-pdf-poppler/download/zathura-pdf-poppler-0.2.7.tar.gz" -MD5SUM="b2c9e23e9f494e1ced5069f850dba673 \ - 6b2a4f71641b377730951be27ff176cf" +HOMEPAGE="https://github.com/pwmt/zathura" +DOWNLOAD="https://github.com/pwmt/zathura/archive/0.3.7/zathura-0.3.7.tar.gz \ + https://github.com/pwmt/zathura-pdf-poppler/archive/0.2.7/zathura-pdf-poppler-0.2.7.tar.gz" +MD5SUM="41ef7c51a4a74e3023a2e59b21c9dc88 \ + 536153f318c2a394b6160732365778e8" DOWNLOAD_x86_64="" MD5SUM_x86_64="" REQUIRES="girara" |