1man(1)                          pdfxup man page                         man(1)
2
3
4

NAME

6       pdfxup - n-up tool with reduced margins
7

SYNOPSIS

9       pdfxup [OPTIONS] [FILE]
10

DESCRIPTION

12       pdfxup  creates a PDF document where each page is obtained by combining
13       several pages of a PDF file given as output. The important  feature  of
14       pdfxup,  compared  to similar programs, is that it tries to compute the
15       (global) bounding box of the input PDF file, in  order  to  remove  the
16       margins  and  to  keep  the  text only. Instead of having the font size
17       divided by 2 (for the case of 2-up output), in some case you may end up
18       with  almost  the same font size as in the original document (as is the
19       case for a default 'article' document produced by LaTeX).
20
21       pdfxup uses ghostscript for computing the maximal bounding box of (some
22       of)  the  pages  of the document, and then uses pdflatex (with graphicx
23       package) in order to produce the new document.
24

OPTIONS

26       pdfxup accepts numerous options. The most important ones are:
27
28       -x n, --columns n
29              sets the number of columns in the output file (default 2);
30
31       -y n, --rows n
32              sets the number of lines in the output file (default 1);
33
34       -l, --landscape
35              sets orientation of paper (of final document) landscape;
36
37       -b (le|se), --booklet (le|se)
38              configure for printing as a booklet. Value 'le'  (which  is  the
39              default  value when -b is used with no argument) means that two-
40              sided printing is in 'long-edge' mode (you turn from one page to
41              the  next along the long edge of the paper). 'se' is the 'short-
42              edge' option.
43
44       -c, --clip
45              clip pages to the computed bounding box. By default, content  is
46              not  clipped, which may result in overlap of neighbouring pages.
47              With this option, anything outside the bounding box will not  be
48              displayed.
49
50       -o file, --output file
51              name of output file;
52
53       -i     ask before overwriting output file;
54
55       -fw d, --framewidth d
56              width  of the frame around each page (default 0.4pt). Set to 0pt
57              to have no frame at all;
58
59       -im d, --innermargins d
60              inner margin between frame and page (default 5pt);
61
62       -m d, --margins d
63              margin of pages of the new document (default 5pt);
64
65       -is d, --intspaces d
66              space between different pages (default 1pt);
67
68       -p list, --pages list
69              only consider sublist of pages of  input  document.  List  is  a
70              comma-separated list of pages or ranges pages of the form a-b; a
71              can be omitted to start from first page, and b can be omitted to
72              end  at  the last page. Therefore, "-p -" (which is the default)
73              includes all pages. Also allows modulo, so that "-p  0%2"  would
74              include only even-numbered pages.
75
76       -bb list, --bb list
77              only  consider  sublist of pages of input document for computing
78              bounding box;
79
80       -nobb list, --no-bb list
81              omit list of pages of input document from computation of  bound‐
82              ing box;
83
84       -g, --get-bb
85              only compute (and output) bounding box;
86
87       -s x y W H, --set-bb x y W H
88              set the bounding box to the given values;
89
90       -w file, --watermark file
91              use  file  as  background  watermark.  file  can  be  any format
92              accepted by pdflatex (e.g. png or pdf). If file is  a  multipage
93              PDF  file,  page  n of the watermark file is used with page n of
94              the input file, and the last  page  of  the  watermark  file  is
95              repeated if the input file has more pages;
96
97       -wp p, --watermark-period p
98              repeat  the  last  p pages of the watermark file instead of only
99              the last one;
100
101       -d, --debug
102              debug mode: keep intermediary files;
103
104       -V [0-3], --verbose [0-3]
105              select verbosity (default: 1);
106
107       -q, --quiet
108              run quietly (equiv. '-V=0');
109
110       -v, --version
111              print version number and exit;
112
113       -h, --help
114              print help message and exit.
115

EXAMPLES

117       # pdfxup file.pdf
118              produces 2-up pdf file from file.pdf
119
120       # pdfxup -bb 1-4 file.pdf
121              same behaviour, but computes the bounding  box  only  using  the
122              first 4 pages (this saves time when processing long documents)
123
124       # pdfxup -b -o booklet.pdf file.pdf
125              same behaviour, but creates a booklet (as booklet.pdf)
126
127       # pdfxup -kbb -x1 -y2 -l0 beamer-frames.pdf
128              arranges 2 beamer frames per page (not reducing margins)
129
130       # pdfxup -kbb -x2 -y2 -l beamer-frames.pdf:1-12,15-19
131              arranges  4  beamer  frames  per  page  (not  reducing margins),
132              including only frames 1 to 12 and 15 to 19.
133

SEE ALSO

135       gs(1), pdflatex(1)
136

AUTHOR

138       Nicolas Markey (pdfxup@markey.fr)
139
140
141
1421.51                            06 january 2020                         man(1)
Impressum