git.sur5r.net Git - pdfstitch/blob - README.md

   1 # pdfstitch
   2
   3 `pdfstitch` does a similar job to `pdfnup` but incorporates the following additional features:
   4
   5 * Crop pages to a certain size
   6 * Adjust the crop position per page
   7
   8 ## Dependencies
   9
  10 `pdfstitch` makes use of the following Perl modules:
  11
  12 * File::Basename (part of perl base)
  13 * PDF::API2
  14 * YAML
  15
  16 On Debian, you can installed them with:
  17
  18 `# apt install libpdf-api2-perl libyaml-perl`
  19
  20 ## Usage
  21
  22 1. Run `genmeta` on your input PDF like so:
  23
  24    `./genmeta foobar.pdf`
  25
  26    This will generate a YAML file called `foobar.pdf.stitch`. Edit this file according to the desired output.
  27 2. Optional: Run `genpreview` on that YAML file like so:
  28
  29    `./genpreview foobar.pdf.stitch`
  30
  31    This will generate a new PDF called `foobar-preview.pdf` containing only the pages you selected
  32    in the YAML file with each page being overlayed with a transparent box showing the area the
  33    page will be cropped to.
  34
  35 3. Optional: Run `gencropped` on the YAML file. This will generate a new PDF called `foobar-cropped.pdf` containing
  36    only the pages you selected in the YAML file with each page being cropped as specified.
  37 4. Run `pdfstitch` on the YAML file. This will generated a single-page PDF called `foobar-stitched.pdf` with all
  38    selected pages being as specified in the YAML file.
  39