1
.\" Process this file with
2
.\" groff -man -Tascii qpdfview.1
4
.TH QPDFVIEW 1 "March 2012"
3
.\" Copyright 2012 Benjamin Eltzner
4
.\" Copyright 2012 Adam Reichold
6
.\" This file is part of qpdfview.
8
.\" qpdfview is free software: you can redistribute it and/or modify
9
.\" it under the terms of the GNU General Public License as published by
10
.\" the Free Software Foundation, either version 2 of the License, or
11
.\" (at your option) any later version.
13
.\" qpdfview is distributed in the hope that it will be useful,
14
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
15
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16
.\" GNU General Public License for more details.
18
.\" You should have received a copy of the GNU General Public License
19
.\" along with qpdfview. If not, see <http://www.gnu.org/licenses/>.
21
.\" 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
24
.TH QPDFVIEW 1 "July 2012"
6
26
qpdfview \- tabbed PDF viewer
9
.I [options] [file(s)[#page[#top]]]
29
.I [options] [file[#page]] ...
12
is a simple document viewer for PDF documents. It uses the poppler library for rendering.
32
is a simple viewer for document files in the portable document format (PDF). It uses the Poppler library for rendering and the Qt toolkit for its interface.
15
If an instance of qpdfview is started with this option, any files that are opened using this option afterwards, are opened as tabs in this same window. If a file is already opened in a tab of the respective window, it is merely reloaded using this option.
16
.IP [file(s)[#page[#top]]]
17
Specifies the files to open when qpdfview starts. If this is not specified, qpdfview will open a blank window. Multiple files can be loaded in separate tabs if the file names are separated by spaces. The optional parameter
19
opens the file at the given page. The optional parameter
21
can take values between 0 and 1 and opens the page with the given position aligned to the top of the tab. (See examples.)
35
If an instance of qpdfview is started with this option, any files that are opened using this option afterwards, are opened as tabs in the original window. If a file is already opened in a tab of the original window, it is merely reloaded.
38
specifies the file to open. The optional parameter
40
opens the file at the given page. Multiple files will be opened in separate tabs.
22
41
.SH CONFIGURATION FILE
23
42
qpdfview uses a configuration file usually located at
25
"~/.config/qpdfview/qpdfview.conf",
27
which allows configuration of the toolbars and thumbnails.
29
The keys "fileToolBar", "editToolBar" and "viewToolBar" are added to the section "mainWindow". Their values are comma-separated lists. The default (available) entries are:
31
fileToolBar: openInNewTab, refresh (open, saveCopy, print)
34
editToolBar: currentPage, numberOfPages, previousPage, nextPage (firstPage, lastPage, jumpToPage, search)
37
viewToolBar: scaleFactor, zoomIn, zoomOut (onePage, twoPages, oneColumn, twoColumns, fitToPage, fitToPageWidth, doNotScale, rotateLeft, rotateRight, fullscreen, presentation)
39
The order of the items in the list defines the order of the items in the toolbar. (See examples.)
41
Setting the keys "thumbnailWidth" and "thumbnailHeight" in the section "documentView" specifies the size of the thumbnails.
43
The icon theme used by Qt can be overridden by setting the key "iconTheme" in the section "mainWindow".
44
"~/.config/qpdfview/qpdfview.conf".
47
The icon theme used by Qt can be changed by setting the key "iconTheme" in the section "mainWindow". The application-wide Qt style sheet can be changed by setting the key "styleSheet" in the section "mainWindow".
49
.B qpdfview foo.pdf#3#0.5 bar.pdf
52
.B qpdfview foo.pdf#3 bar.pdf
51
opens foo.pdf in the first tab with the middle of page 3 aligned to the top of the tab and bar.pdf in the second tab at the beginning of the document.
54
opens "foo.pdf" in the first tab displaying the third page of the document and "bar.pdf" in the second tab displaying the beginning of the document.
53
Subsequent execution of the following commands
56
Subsequent execution of the commands
55
58
.B qpdfview --unique foo.pdf bar.pdf
58
62
.B qpdfview --unique foo.pdf#5
60
opens foo.pdf and bar.pdf, then reloads foo.pdf and displays its page 5.
64
opens "foo.pdf" and "bar.pdf", then reloads "foo.pdf" and displays its fifth page.
62
Subsequent execution of the following commands
66
Subsequent execution of the commands
64
68
.B qpdfview --unique foo.pdf
67
72
.B qpdfview bar.pdf
70
76
.B qpdfview --unique foo1.pdf bar1.pdf
72
opens foo.pdf in the first window, bar.pdf in a second window and then foo1.pdf and bar1.pdf in additional tabs in the first window.
76
.B fileToolBar=openInNewTab, refresh, saveCopy, print
79
.B editToolBar=firstPage, previousPage, currentPage, numberOfPages, nextPage, lastPage, search
82
.B viewToolBar=zoomOut, scaleFactor, zoomIn, oneColumn, twoColumns, rotateLeft, rotateRight
84
in section "mainWindow" of the configuration file leads to the corresponding items being displayed in the given order in the toolbars.
78
opens "foo.pdf" in the first window, "bar.pdf" in a second window and then "foo1.pdf" and "bar1.pdf" in additional tabs in the first window.
87
80
If you find a bug, please report it at
88
https://launchpad.net/qpdfview.
82
"https://launchpad.net/qpdfview".
90
85
Benjamin Eltzner <b.eltzner@gmx.de>
added
removed
miscellaneous/qpdfview.1
