1
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
7
Copyright 2012 Benjamin Eltzner
8
Copyright 2012 Adam Reichold
10
This file is part of qpdfview.
12
qpdfview is free software: you can redistribute it and/or modify
13
it under the terms of the GNU General Public License as published by
14
the Free Software Foundation, either version 2 of the License, or
15
(at your option) any later version.
17
qpdfview is distributed in the hope that it will be useful,
18
but WITHOUT ANY WARRANTY; without even the implied warranty of
19
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20
GNU General Public License for more details.
22
You should have received a copy of the GNU General Public License
23
along with qpdfview. If not, see <http://www.gnu.org/licenses/>
26
This file is additionally licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported (CC-BY-SA) license. The full text of the license can be found at https://creativecommons.org/licenses/by-sa/3.0/legalcode
37
<h2><a name="top">راهنما</a></h2>
41
<li><a href="#mainmenu">منوی اصلی</a></li>
43
<li><a href="#file">فایل</a></li>
44
<li><a href="#edit">ویرایش</a></li>
45
<li><a href="#view">نما</a></li>
46
<li><a href="#tabs">برگهها</a></li>
47
<li><a href="#bookmarks">نشانها</a></li>
48
<li><a href="#help">راهنما</a></li>
50
<li><a href="#mainview">نمای اصلی</a></li>
51
<li><a href="#auxiliaryviews">Auxiliary views</a></li>
52
<li><a href="#settings">سامانش</a></li>
54
<li><a href="#behaviorsettings">Behavior settings</a></li>
55
<li><a href="#graphicssettings">Graphics settings</a></li>
56
<li><a href="#interfacesettings">Interface settings</a></li>
57
<li><a href="#shortcutsettings">Shortcut settings</a></li>
58
<li><a href="#modifiersettings">Modifier settings</a></li>
64
<p><em>qpdfview</em> is a tabbed document viewer. It uses Poppler for PDF
65
support, libspectre for PS support, DjVuLibre for DjVu support, CUPS for
66
printing support and the Qt toolkit for its interface.</p>
68
<p>Please refer to the manual page for information on command-line options and
69
configuration files.</p>
71
<h3><a name="mainmenu">Main menu</a> <a href="#top">↑</a></h3>
73
<h4><a name="file">File</a> <a href="#top">↑</a></h4>
76
<li><b>Open...</b> Opens a dialog to choose a file to open in the current
77
tab. If there is no tab, the file is opened in a new tab.</li>
78
<li><b>Open in new tab...</b> Opens a dialog to choose files to open in new
80
<li><b>Open containing folder</b> Opens the folder containing the file displayed
81
in the current tab.</li>
82
<li><b>Recently used</b> Contains a list of the most recently used files (if
83
enabled in the settings).</li>
84
<li><b>Refresh</b> Reloads the file displayed in the current tab.</li>
85
<li><b>Save copy...</b> Opens a dialog to save a copy of the file displayed in
87
<li><b>Save as...</b> Opens a dialog to save the file displayed in the current
88
tab including changes to annotations and form fields.</li>
89
<li><b>Print...</b> Opens a dialog to print the file displayed in the current
91
<li><b>Exit</b> Closes all tabs and ends the program.</li>
94
<h4><a name="edit">Edit</a> <a href="#top">↑</a></h4>
97
<li><b>Next/Previous/First/Last page</b> Skips to the next/previous/first/last
98
page of the document.</li>
99
<li><b>Jump to page...</b> Opens a dialog to enter a page to display in the
101
<li><b>Jump backward/forward</b> Jumps backward/forward in the history of
103
<li><b>Search...</b> Opens the search tool bar below the main view. The search
104
automatically starts two seconds after the last change of the search term or
105
is manually started by pressing the return key. If the Shift modifier is
106
held when the return key is pressed, the search starts in all tabs instead
107
of just the current tab.</li>
108
<li><b>Find previous/next</b> Jumps to the previous/next occurrence of the
109
search term in the document.</li>
110
<li><b>Cancel search</b> Cancels the currently running search and closes the
111
search tool bar.</li>
112
<li><b>Copy to clipboard</b> If checked, the program will wait for a frame to be
113
dragged to copy texts or images.</li>
114
<li><b>Add annotation</b> If checked, the program will wait for a frame to be
115
dragged to add annotations.</li>
116
<li><b>Settings...</b> Opens the settings dialog. The button labeled 'Defaults'
117
will revert all settings on all tabs to their default values. The button
118
labeled 'Defaults on current tab' will revert only the settings on the
119
current tab to their default values.</li>
122
<p>The <em>current page</em> can be changed by entering the desired page into
123
the text field in the edit tool bar, which can be focused using Ctrl+K, and
124
pressing the return key.</p>
126
<h4><a name="view">View</a> <a href="#top">↑</a></h4>
129
<li><b>Continuous</b> Determines whether all rows of the page layout are visible
131
<li><b>Two pages</b> Determines whether the page layout uses two columns.</li>
132
<li><b>Two pages with cover page</b> Determines whether the page layout uses two
133
columns with a break after the cover page.</li>
134
<li><b>Multiple pages</b> Determines whether the page layout uses multiple
135
columns. The number of columns can be changed in the settings dialog.</li>
136
<li><b>Right to left</b> Determines how pages are arranged in layouts with
137
multiple pages per row.</li>
138
<li><b>Zoom in</b> Increases the scale factor by 10 percent.</li>
139
<li><b>Zoom out</b> Decreases the scale factor by 10 percent.</li>
140
<li><b>Original size</b> Resets the scale factor to 100 percent.</li>
141
<li><b>Fit to page width</b> Determines the scale factor such that all pages
142
fully fit into the main view horizontally.</li>
143
<li><b>Fit to page size</b> Determines the scale factor such that all pages
144
fully fit into the main view horizontally and vertically.</li>
145
<li><b>Rotate left</b> Rotates the pages left/counterclockwise by 90 degrees.</li>
146
<li><b>Rotate right</b> Rotates the pages right/clockwise by 90 degrees.</li>
147
<li><b>Invert colors</b> Determines whether pages are rendered with inverted
149
<li><b>Tool bars</b> This menu contains a list of available tool bars for
150
accessing frequently used actions.</li>
151
<li><b>Docks</b> This menu contains a list of available docks for displaying
152
supplementary information.</li>
153
<li><b>Fonts...</b> Opens a dialog listing the fonts used in the document.</li>
154
<li><b>Fullscreen</b> Toggles the fullscreen mode, i.e. the window is shown
155
maximized and without decoration.</li>
156
<li><b>Presentation...</b> Enters presentation mode which can be left by
157
pressing F12 or escape. The home/end key is used to display the first/last
158
page. Arrow keys right and down, space and the page down key jump to the
159
next page. Arrow keys left and up, backspace and the page up key jump to the
160
previous page. Pressing control and return jumps back to the page before the
164
<p>The <em>scale factor</em> can be changed by entering the desired percentage
165
into the text field in the view tool bar, which can be focused using Ctrl+L,
166
and pressing the return key.</p>
168
<h4><a name="tabs">Tabs</a> <a href="#top">↑</a></h4>
171
<li><b>Previous/Next tab</b> Makes the previous/next tab the current tab. Cycles
172
to the last/first tab if the first/last tab is the current tab.</li>
173
<li><b>Close tab</b> Closes the current tab.</li>
174
<li><b>Close all tabs</b> Closes all tabs.</li>
175
<li><b>Close all tabs but current tab</b> Closes all tabs except for the current
177
<li><b>Recently closed</b> Contains a list of the most recently closed tabs (if
178
enabled in the settings).</li>
181
<p>This menu contains a list of all tabs which can be made the current tab by
182
clicking on the corresponding menu item. Tabs can also be closed by
183
middle-clicking. The first nine tabs can also be activated by holding the
184
Alt modifier and pressing keys one to nine.</p>
186
<h4><a name="bookmarks">Bookmarks</a> <a href="#top">↑</a></h4>
189
<li><b>Previous bookmark</b> Jumps to the closest bookmark before the current
191
<li><b>Next bookmark</b> Jumps to the closest bookmark after the current page.</li>
192
<li><b>Add bookmark</b> Adds a bookmark for the current file and page.</li>
193
<li><b>Remove bookmark</b> Removes the bookmark for the current file and page.</li>
194
<li><b>Remove all bookmarks</b> Removes all bookmarks.</li>
195
<li><b>Open</b> Opens the corresponding file in the current tab. If there is no
196
tab, the file is opened in a new tab.</li>
197
<li><b>Open in new tab</b> Opens the corresponding file in a new tab.</li>
198
<li><b>Jump to page</b> Jumps to the corresponding page if the corresponding
199
file is already open. Otherwise the corresponding file is opened in a new
203
<h4><a name="help">Help</a> <a href="#top">↑</a></h4>
206
<li><b>Contents</b> Displays this document.</li>
207
<li><b>About</b> Displays the program version.</li>
210
<h3><a name="mainview">Main view</a> <a href="#top">↑</a></h3>
212
<p>The backspace/space key skips to the previous/next page. The home/end key
213
skips to the first/last page. The arrow, page up and page down keys scroll
214
the viewport. Pressing control and return jumps to the page before the last
217
<p>Using the mouse wheel scrolls up and down. Holding <b>ALT</b> while using
218
the mouse wheel scrolls left and right. Holding <b>CTRL</b> while using the
219
mouse wheel scales the document. Holding <b>SHIFT</b> while using the mouse
220
wheel rotates the document. (Keyboard modifiers can be changed in the
221
settings dialog.) Click and hold the middle mouse button to select a
222
rectangle to zoom to.</p>
224
<p>Links are highlighted by red frames (if enabled in the settings). Left-click
225
on a link to show the linked page or open the linked URL in the default
226
browser (if enabled in the settings). Middle-click on a link to show the
227
linked page in a new tab. Hovering over a link displays its destination as a
230
<p>Form fields are highlighted by blue frames (if enabled in the
231
settings). Left-click on a form field to edit its contents. Hovering over a
232
form field displays its name as a tool tip.</p>
234
<p>The source of a position in the document is requested by double-clicking
235
which opens the first matching <em>SyncTeX</em> node using the source
238
<p>To <em>copy texts or images</em>, hold <b>SHIFT</b>, click and hold the left
239
mouse button to drag a frame around the area to copy. Once the mouse button
240
is released, a pop-up menu is displayed to select whether to copy texts or
241
images into the clipboard.</p>
243
<p>To <em>add annotations</em>, hold <b>CTRL</b>, click and hold the left mouse
244
button to drag a frame around the region of interest. Once the mouse button
245
is released, a pop-up menu is displayed to select whether to add text or
246
highlight annotations. Left-click to <em>edit annotations</em>. Right-click
247
to <em>remove annotations</em>. (Adding and removing annotations requires
248
version 0.20.1 or higher of the Poppler library.) Hovering over an
249
annotation displays its contents as a tool tip.</p>
251
<p>The <em>visibility of the tool and menu bars</em> can be toggled using
252
configurable keyboard shortcuts whose default values are "Shift+Alt+T" and
255
<h3><a name="auxiliaryviews">Auxiliary views</a> <a href="#top">↑</a></h3>
257
<p>The <em>outline</em> view displays an overview of the contents of the
258
document. A left click on an entry jumps to the respective page in the main
259
view. The context menu can be used to expand/collapse all items below the
262
<p>The <em>properties</em> view displays additional information contained in
265
<p>The <em>thumbnails</em> view displays smaller versions of the pages of the
266
document. A left click on an entry jumps to the respective page in the main
269
<h3><a name="settings">Settings</a> <a href="#top">↑</a></h3>
271
<h4><a name="behaviorsettings">Behavior settings</a> <a href="#top">↑</a></h4>
274
<li><b>Open URL</b> Determines whether links to URL are opened in the default
276
<li><b>Auto-refresh</b> Determines whether files are automatically reloaded if
277
changed on disk.</li>
278
<li><b>Track recently used</b> If enabled, a recently used menu is available and
279
lists as many recently used files as set in the "Recently used count"
280
option. (Effective after restart.)</li>
281
<li><b>Keep recently closed</b> If enabled, a recently closed menu is available
282
and lists as many recently closed tabs as set in the "Recently closed count"
283
option. Keeping the tabs available could increase memory usage
284
considerably. (Effective after restart.)</li>
285
<li><b>Restore tabs</b> If enabled, tabs and their properties are saved on
286
ending the program and restored on restart.</li>
287
<li><b>Restore bookmarks</b> If enabled, bookmarks are saved on ending the
288
program and restored on restart.</li>
289
<li><b>Restore per-file settings</b> If enabled, per-file settings are
290
saved/restored on opening/closing tabs.</li>
291
<li><b>Save database interval</b> The interval after which tabs, bookmarks or
292
per-file settings are saved to the database.</li>
293
<li><b>Synchronize presentation</b> If enabled, the main view can be used to
294
control the presentation view.</li>
295
<li><b>Presentation screen</b> The index of the screen to display the
296
presentation view on.</li>
297
<li><b>Synchronize outline view</b> If enabled, the outline view will highlight
298
the first entry pointing to the current page whenever the current page
300
<li><b>Zoom factor</b> The number by which the scale factor is multiplied
301
resp. divided upon zooming in resp. out.</li>
302
<li><b>Highlight color</b> Determines the color of highlights.</li>
303
<li><b>Highlight duration</b> Determines the duration of temporary highlights.</li>
304
<li><b>Annotation color</b> The color of annotations added by the program using
305
SVG color keywords or hexadecimal notation '#rrggbb'.</li>
306
<li><b>Source editor</b> The program which is started to edit sources. '%1' is
307
replaced by the absolute file path. '%2' resp. '%3' is replaced by line
308
resp. column number.</li>
311
<h4><a name="graphicssettings">Graphics settings</a> <a href="#top">↑</a></h4>
314
<li><b>Keep obsolete pixmaps</b> If enabled, then upon change of the zoom
315
factor, cached pixmaps will be used to draw approximations of final pixmaps
316
until these are available at the cost of increased memory usage.</li>
317
<li><b>Use device pixel ratio</b> If enabled, the highest available device pixel
318
ratio is used to render at physical and display at logical resolution.</li>
319
<li><b>Trim margins</b> Activates the automatic removal of empty page margins
320
after rendering.</li>
321
<li><b>Decorate pages</b> Determines whether pages are set apart from the
323
<li><b>Decorate links</b> Determines whether links are highlighted by red
325
<li><b>Decorate form fields</b> Determines whether form fields are highlighted
327
<li><b>Background color</b> Determines the color of the background using SVG
328
color keywords or hexadecimal notation '#rrggbb'.</li>
329
<li><b>Paper color</b> Determines the color of pages using SVG color keywords or
330
hexadecimal notation '#rrggbb'.</li>
331
<li><b>Presentation background color</b> Overrides the paper color in the
332
computation of the background color of the presentation view and is defined
333
using SVG color keywords or hexadecimal notation '#rrggbb'.</li>
334
<li><b>Pages per row</b> Number of pages per row in the 'multiple pages' layout
336
<li><b>Page spacing</b> Determines both vertical and horizontal space displayed
338
<li><b>Thumbnail spacing</b> Determines both vertical and horizontal space
339
displayed between thumbnails.</li>
340
<li><b>Thumbnail size</b> Determines the size of the thumbnails.</li>
341
<li><b>Cache size</b> The program will try to cache rendered pages within this
342
limit increasing rendering speed at the cost of increased memory usage.</li>
343
<li><b>Prefetch</b> The program will try to render pages that are not yet
344
visible increasing rendering speed at the cost of increased cache usage.</li>
345
<li><b>Prefetch distance</b> The number of rows beyond the current row and twice
346
the number of rows before the current row that are prefetched.</li>
347
<li><b>PDF settings</b>
349
<li><b>Overprint preview</b> If enabled, a preview of printing one layer of ink
350
on top of another is displayed.</li>
351
<li><b>Antialiasing</b> Improves display quality at the cost of performance</li>
352
<li><b>Text antialiasing</b> Improves text display quality at the cost of
354
<li><b>Text hinting</b> May improve text display quality for certain fonts.</li>
355
<li><b>Thin line mode</b> Chooses the optimization used to draw thin lines.</li>
356
<li><b>Backend</b> Chooses the backend used to render pages.</li>
359
<li><b>PS settings</b>
361
<li><b>Graphics antialias bits</b> Determines the amount of antialiasing for
363
<li><b>Text antialias bits</b> Determines the amount of antialiasing for text.</li>
368
<h4><a name="interfacesettings">Interface settings</a> <a href="#top">↑</a></h4>
371
<li><b>Tab position</b> Defines at which edge of the main view tabs will be
373
<li><b>Tab visibility</b> Determines whether tabs will be displayed if less than
374
two documents are opened.</li>
375
<li><b>Spread tabs</b> Determines if tabs will be spread out evenly over the
377
<li><b>New tab next to current tab</b> If enabled, new tabs are opened to the
378
right of the active tab.</li>
379
<li><b>Recently used count</b> Sets the number of files that are listed in the
380
recently used menu, if "Track recently used" is enabled. (Effective after
382
<li><b>Recently closed count</b> Sets the number of tabs that are listed in the
383
recently closed menu, if "Keep recently closed" is enabled. (Effective after
385
<li><b>Toggle tool and menu bars with fullscreen</b> Always toggles the
386
visibility of the tool and menu bars when toggling fullscreen mode.</li>
387
<li><b>File tool bar</b> Defines which actions are visible in the file tool
388
bar. Available actions are openInNewTab, open, refresh, saveCopy, saveAs,
389
print and separator. (Effective after restart.)</li>
390
<li><b>Edit tool bar</b> Defines which actions are visible in the edit tool
391
bar. Available actions are currentPage, previousPage, nextPage, firstPage,
392
lastPage, jumpToPage, jumpBackward, jumpForward, search,
393
copyToClipboardMode, addAnnotationMode and separator. (Effective after
395
<li><b>View tool bar</b> Defines which actions are visible in the view tool
396
bar. Available actions are scaleFactor, zoomIn, zoomOut, continuousMode,
397
twoPagesMode, twoPagesWithCoverPageMode, multiplePagesMode, originalSize,
398
fitToPageWidthMode, fitToPageSizeMode, rotateLeft, rotateRight, fullscreen,
399
presentation and separator. (Effective after restart.)</li>
400
<li><b>Use page label</b> Determines if document-supplied page label will be
401
used instead of page numbers when available.</li>
402
<li><b>Document title as tab title</b> Determines if the tab title as derived
403
from the meta-data instead of the file name.</li>
404
<li><b>Current page in window title</b> If enabled, the current page and number
405
of pages of the document in the active tab are displayed in the window
407
<li><b>Instance name in window title</b> If enabled and the current instance is
408
named, its name is displayed in the window title.</li>
409
<li><b>Highlight current thumbnail</b> If enabled, the current page is
410
highlighted in the thumbnails view.</li>
411
<li><b>Limit thumbnails to results</b> If this option is enabled and a search is
412
conducted, only the pages where the search term is found are displayed in
413
the thumbnails view.</li>
416
<h4><a name="shortcutsettings">Shortcut settings</a> <a href="#top">↑</a></h4>
418
<p>The shortcut settings allows the adjustment of keyboard shortcuts to
419
personal preference. Shortcuts are changed by double-clicking on the
420
shortcut to edit it and entering the new shortcut. Each action can have
421
several shortcuts by entering a semicolon-separated list of them. Names of
422
keys that are not single letters are written out explicitly (e.g. "Alt",
423
"Ctrl", "PgDown"), where the matching is not case sensitive. If the shortcut
424
contains modifier keys, the names of the keys are joined by a plus sign and
425
modifier keys must be listed first, e.g. "Ctrl+A" or "Ctrl++".</p>
427
<h4><a name="modifiersettings">Modifier settings</a> <a href="#top">↑</a></h4>
430
<li><b>Zoom</b> The keyboard modifiers to zoom using the mouse wheel in the main
432
<li><b>Rotate</b> The keyboard modifiers to rotate using the mouse wheel in the
434
<li><b>Scroll</b> The keyboard modifiers to scroll horizontally using the mouse
435
wheel in the main view.</li>
436
<li><b>Copy to clipboard</b> The keyboard modifiers to copy texts or images from
437
a page to the clipboard.</li>
438
<li><b>Add annotation</b> The keyboard modifiers to add annotations to a page.</li>