1
2
3
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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
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
159
160
161
162
163
164
165
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
192
193
194
195
196
197
198
199
200
|
katarakt(1)
===========
:doctype: manpage
:man source: Katarakt
:man manual: Katarakt Manual
NAME
----
katarakt - a simple PDF viewer with three layouts
SYNOPSIS
--------
*katarakt* (['OPTIONS'] 'FILE'|(-u 'URL'))*
DESCRIPTION
-----------
It's a PDF viewer. It views PDFs.
There are currently three layouts. The 'presentation layout' is very simple and
only supports scrolling on a per page basis. As the name suggests the current
page is displayed in the center and zoomed to fit the window. It is active by
default.
The 'grid layout' is much more advanced and offers continuous (smooth, per
pixel) scrolling, zooming and adjusting the column count. Pages keep their
correct relative size and are shown in a grid.
The 'presenter layout' is for giving a presentation. It opens a second window,
to be viewed on the beamer, and shows the current and next slide in the main
window.
For every file passed on the command line a separate process is spawned.
OPTIONS
-------
*-u*, *--url* ::
Instead of opening a local document, download it from the given URL.
*-p*, *--page* 'NUM' ::
Start on page 'NUM'.
*-f*, *--fullscreen* ::
Start in fullscreen mode.
*-q*, *--quit* ::
Quit on initialization failure.
*-h*, *--help* ::
Print help and exit.
*--single-instance* 'true'|'false'::
Sets *single_instance_per_file* for the present katarakt instance only.
CONFIGURATION
-------------
Variables and key bindings can be changed by modifying the katarakt.ini file.
By default it is read from '$XDG_CONFIG_HOME'.
Variables must be listed under the section "[Settings]", keys under section
"[Keys]". For a list of all variables with a short explanation see below.
KEY BINDINGS
------------
*q* ::
Quit *katarakt*.
*1* ::
Switch to 'presentation layout'. Views a single page at a time, scaled to
fit the screen.
*2* ::
Switch to 'grid layout'. Views pages in a continuous fashion, scaled to fit
the width. Supports columns.
*3* ::
Switch to 'presenter layout'. Views the current page and a smaller preview
of the next page. Also, opens a second window that shows only the current
page for displaying on a beamer.
*Up*, *Down*, *Left*, *Right*, *k*, *j*, *h*, *l* ::
Move around (up/down/left/right).
*\^u*, *^d* ::
Scroll up/down half the screen.
*BackSpace*, *Space*, *\^b*, *^f* ::
Scroll up/down the screen. By default scrolls 90% to create an overlapping region.
*PgUp*, *PgDown* ::
Scroll up/down one page. Kind of swaps the pages in place.
*Home*, *End*, *g*, *G* ::
Go to the first/last page.
*^g* ::
Show 'goto page' bar.
*f* ::
Toggle fullscreen.
*t* ::
Toggle the page number display in the bottom right corner.
*r* ::
Reload the document. This can also be achieved by sending SIGUSR1 to the
process. *katarakt* reloads automatically if the opened file has changed.
*o* ::
Open a different document; shows a file dialog.
*s* ::
Show a file dialog to save the current document.
*F9* ::
Toggle the table of contents.
*-*, *+*, *=* ::
Adjust zoom level ('grid layout' only).
*z* ::
Reset zoom level to default, i.e. fit width ('grid layout' only).
*[*, *]* ::
Adjust column count ('grid layout' only).
*{*, *}* ::
Adjust the column the first page will be displayed in. Useful for reading
in a book layout with a cover page ('grid layout' only).
*/* ::
Show the search bar. Hitting *Esc* will hide the results, searching for an
empty string will clear them. If the search term contains an uppercase
letter the search is case sensitive ("smartcase").
*?* ::
Show the search bar. This next search will be backwards.
*n*, *N* ::
Focus next/previous search hit.
*\^n*, *^N* ::
Focus next/previous search hit that is currently not visible.
*,*, *.* ::
Rotate pages left/right.
*\^o*, *^i*, *Alt-Left*, *Alt-Right* ::
Move backward/forward through the jump list. Entries are added automatically when jumping.
*^c* ::
Copy the current selection to the global clipboard.
*m* ::
Manually add the current page to the jump list.
*i* ::
Toggle between normal and inverted color rendering.
*v* ::
Swap the mouse buttons for selection and panning.
VARIABLES
---------
'string' *background_color* ::
0xDF000000: Background color in ARGB Format. Alpha only works when using a compositor.
'string' *background_color_fullscreen* ::
0xFF000000: Fullscreen background color in ARGB Format.
'string' *default_layout* ::
presentation: The layout on startup. Possible values: 'presentation', 'grid'.
'int' *mouse_wheel_factor* ::
120: QT delta for turning the mouse wheel 1 click.
'int' *smooth_scroll_delta* ::
30: Pixel offset when moving around.
'float' *screen_scroll_factor* ::
0.9: Factor for scrolling the screen. Should be \<= 1 to create an overlapping region.
'int' *useless_gap* ::
2: Gap between two pages in 'grid layout' in pixels.
'int' *min_page_width* ::
150: Pages can not be smaller than this.
'int' *min_zoom* ::
-14: Smallest zoom value.
'int' *max_zoom* ::
30: Biggest zoom value.
'float' *zoom_factor* ::
0.05: Influences the number of steps between min and max.
'int' *prefetch_count* ::
3: Number of pages exceeding the currently visible ones to render, back- and forwards respectively.
'float' *search_padding* ::
0.2: Factor of the area on the screen to display search hits in. Moves search hits towards the center.
'bool' *smooth_downscaling* ::
true: Enables the higher quality downsampling filter.
'int' *thumbnail_size* ::
32: One dimension of square thumbnails saved at run-time for every page that was once rendered.
'int' *rect_expansion* ::
2: Number of pixels search rects are expanded by.
'bool' *quit_on_init_fail* ::
false: Quit katarakt if the document fails to open.
'bool' *single_instance_per_file* ::
If set and katarakt is called with a file that is already shown in another
katarakt instance, then the other katarakt window is activated instead.
'string' *icon_theme* ::
The name of your icon theme. Fill in if auto detection fails.
'int' *click_link_button* ::
1: The mouse button used for clicking links. Buttons 1-5 are supported.
'int' *drag_view_button* ::
2: The mouse button used for scrolling the view. Double-clicking this
button centers the view around the location of the click.
'int' *select_text_button* ::
1: The mouse button used for text selection. Double- and triple-clicking
are supported to select with word/line granularity.
COMMUNITY
---------
Feel free to join the IRC channel '#katarakt' on freenode.
AUTHOR
------
*katarakt* is written by Philipp Erhardt.
RESOURCES
---------
Gitweb: <http://git.cs.fau.de/?p=katarakt>
Homepage: <http://git.cs.fau.de/~go18gomu/katarakt/>
|
