diff options
Diffstat (limited to 'Master/texmf-dist/doc/support')
-rw-r--r-- | Master/texmf-dist/doc/support/pdfbook2/README | 133 |
1 files changed, 133 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/support/pdfbook2/README b/Master/texmf-dist/doc/support/pdfbook2/README new file mode 100644 index 00000000000..fd7dfa406f1 --- /dev/null +++ b/Master/texmf-dist/doc/support/pdfbook2/README @@ -0,0 +1,133 @@ +pdfbook2 - transform pdf files to booklets +========================================== + + pdfbook2 v1.2 + (c) 2015 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 2.7, 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.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 |