pdfbook2 (4jun15)

git-svn-id: svn://tug.org/texlive/trunk@37537 c570f23f-e606-0410-a88d-b1316a301751

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