summaryrefslogtreecommitdiff
path: root/support/pdfbook2/README
blob: e27738188bc8cbdb935ce35de08b1abed29b1910 (plain)
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
pdfbook2 - transform pdf files to booklets
==========================================

    pdfbook2 v1.4 (https://github.com/jenom/pdfbook2)
    (c) 2015 - 2020 Johannes Neumann (http://www.neumannjo.de)
    licensed under GPLv3 (http://www.gnu.org/licenses/gpl-3.0)
    based on pdfbook by David Firth with help from Marco Pessotto

DESCRIPTION

    Create print-ready PDF files from some INPUT 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. 
    
    Before the pdf is composed the INPUT 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.
    
    The OUTPUT is written to INPUT-book.pdf. Existing files will be overwritten.
    All input files are processed seperatly.

LICENSE      
             
    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.

    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/>.
    
INSTALLATION

    Simply copy the file to any convenient location preferably covered by the 
    PATH variable of your shell. Make sure it is set as executable like
        
        chmod +x pdfbook2
    
    for unix like systems.
    
REQUIREMENTS

    python 3.6, pdfjam, pdfcrop and their dependencies.
    
EXAMPLES

    To simply create a booklet from input.pdf you can use
        
        pdfbook2 input.pdf
        
    to create input-book.pdf. To select a special type of paper you can do
        
        pdfbook2 --paper=letter input.pdf
    
    for letter or
        
        pdfbook2 --paper=a4paper input.pdf
        
    for standard A4. To increase the inner margin for binding use
    
        pdfbook2 --inner-margin=200 input.pdf
        
    to increase the default value of 150. You can submit multiple files to the 
    script for processing like
        
        pdfbook2 input1.pdf input2.pdf
        
    which will result in input1-book.pdf and input2-book.pdf.
    
USAGE

    pdfbook2 [options] file1 [file2 ...]

OPTIONS

    --version   show program's version number and exit
    --help, -h  show this help message and exit

    GENERAL

        --paper=STR, -p STR
                Format of the output paper dimensions as latex keyword (e.g.
                a4paper, letterpaper, legalpaper, ...)
        --short-edge, -s
                Format the booklet for short-edge double-sided printing
        --no-crop, -n
                Prevent the cropping to the content area

    MARGINS

        --outer-margin=INT, -o INT
                Defines the outer margin in the booklet (default: 40)
        --inner-margin=INT, -i INT
                Defines the inner margin between the pages in the booklet
                (default: 150)
        --top-margin=INT, -t INT
                Defines the top margin in the booklet (default: 30)
        --bottom-margin=INT, -b INT
                Defines the bottom margin in the booklet (default: 30)

    ADVANCED

        --signature=INT
                Define the signature for the booklet handed to pdfjam, needs to 
                be multiple of 4 (default: 4)
        --signature*=INT
                Same as --signature
        --resolution=INT
                Resolution used by ghostscript in bp (default: 72)

CHANGELOG

    1.4 2020/01/20
    
        -   migration to Python 3
        -   fixed bug if the input document had only one page
        -   fix for signature option not working

    1.3 2019/08/12

        -    removed wait after popen to prevent deadlock with very large documents

    1.2 2015/06/03
        
        -   added man page

    1.1 2015/06/01
        
        -   added resolution, signature, no-crop options
        -   better handling of input files with different margins on odd and 
            even pages
        -   added short options
        -   speedup for bound calculations and cropping by setting ghostscript
            resolution to 72 (ref. --resolution option)

    1.0 2015/05/27 
        
        -   initial version