Debian Codegraph @

texmf-dist/doc/man/man1/pdfbook2.1

raw
1 .TH pdfbook2 1 "January 22, 2020" "" "pdfbook2 - transform pdf files to booklets"
2
3 .SH NAME
4 pdfbook2 \- transform pdf files into booklets for double-sided printing
5
6 .SH SYNOPSIS
7 \fBpdfbook2\fR [ \fIoptions\fR ] \fIINPUT\fR [ \fIINPUT\fR, ...]
8
9 .SH DESCRIPTION
10 Create print-ready PDF files from some \fIINPUT\fR PDF files for booklet printing. The resulting files need to be printed in landscape/long edge double sided printing. The default paper format depends on the locale and is choosen by pdfjam. It can be set with the --paper option.
11 .PP
12 Before the pdf is composed the \fIINPUT\fR file is cropped to the relevant area in order to discard unnecessary white spaces. In this process, all pages are cropped to the same dimensions. Extra margins can be defined at the edges of the booklet and in the middle where the binding occurs.
13 .PP
14 The \fIOUTPUT\fR is written to \fIINPUT\fR-book.pdf. Existing files will be overwritten. All input files are processed seperatly.
15
16 .SH EXAMPLE
17 To simply \fBcreate a booklet\fR from input.pdf you can use
18 .PP
19 .nf
20 .RS
21 pdfbook2 input.pdf
22 .RE
23 .fi
24 .PP
25 to create input-book.pdf. To select a special \fBtype of paper\fR you can do
26 .PP
27 .nf
28 .RS
29 pdfbook2 --paper=letter input.pdf
30 .RE
31 .fi
32 .PP
33 for letter or
34 .PP
35 .nf
36 .RS
37 pdfbook2 --paper=a4paper input.pdf
38 .RE
39 .fi
40 .PP
41 for standard A4. To increase the \fBinner margin for binding\fR use
42 .PP
43 .nf
44 .RS
45 pdfbook2 --inner-margin=200 input.pdf
46 .RE
47 .fi
48 .PP
49 to increase the default value of 150. You can submit \fBmultiple files\fR to the
50 script for processing like
51 .PP
52 .nf
53 .RS
54 pdfbook2 input1.pdf input2.pdf
55 .RE
56 .fi
57 .PP
58 which will result in input1-book.pdf and input2-book.pdf.
59
60 .SH OPTIONS
61 .TP
62 .BR \-\-version
63 show program's version number and exit
64 .TP
65 .BR -h ", " --help
66 show help message and exit
67
68 .SS GENERAL
69 .TP
70 .BR -p ", " --paper = \fISTR\fR
71 Format of the output paper dimensions as latex keyword (e.g. a4paper, letterpaper, legalpaper, ...)
72 .TP
73 .BR -s ", " --short-edge
74 Format the booklet for short-edge double-sided printing
75 .TP
76 .BR -n ", " --no-crop
77 Prevent the cropping to the content area
78
79 .SS MARGINS
80 .TP
81 .BR -o ", " --outer-margin = \fIINT\fR
82 Defines the outer margin in the booklet (default: 40)
83 .TP
84 .BR -i ", " --inner-margin = \fIINT\fR
85 Defines the inner margin between the pages in the booklet (default: 150)
86 .TP
87 .BR -t ", " --top-margin = \fIINT\fR
88 Defines the top margin in the booklet (default: 30)
89 .TP
90 .BR -b ", " --bottom-margin = \fIINT\fR
91 Defines the bottom margin in the booklet (default: 30)
92
93 .SS ADVANCED
94 .TP
95 .BR --signature = \fIINT\fR
96 Define the signature for the booklet handed to pdfjam, needs to be multiple of 4 (default: 4)
97 .TP
98 .BR --signature* = \fIINT\fR
99 Same as --signature
100 .TP
101 .BR --resolution = \fIINT\fR
102 Resolution used by ghostscript in bp (default: 72)
103
104 .SH "SEE ALSO"
105 .BR pdfbook (1),
106 .BR pdfjam (1),
107 .BR pdfcrop (1)
108
109 .SH ABOUT
110 pdfbook2 v1.4 (https://github.com/jenom/pdfbook2)
111 .br
112 (c) 2015 - 2020 Johannes Neumann (http://www.neumannjo.de)
113 .br
114 licensed under GPLv3 (http://www.gnu.org/licenses/gpl-3.0)
115 .br
116 based on pdfbook by David Firth with help from Marco Pessotto
117
118 .SH LICENSE
119 This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
120
121 This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.