Linux Certif

Toute la documentation sur la certification Linux LPI

pdfnup

NAME

pdfnup - n-up PDF files

SYNOPSIS

pdfnup [ --nup nupspec ] [ --pages pages ] [ --paper papersize ] [ --orient orientation ] [ --frame frame ] [ --trim trimspec ] [ --offset offset ] [ --delta delta ] [ --openright openright ] [ --turn turn ] [ --noautoscale noautoscale ] [ --column column ] [ --columnstrict columnstrict ] [ --outfile out.pdf ] [ --tidy tidy ] source.pdf

DESCRIPTION

This manual page documents briefly the pdfnup command.

This manual page was written for the Debian distribution because the original program does not have a manual page. Instead, it has inline documentation accessible with pdfnup --help.

pdfnup is a program which allows PDF files to be "n-upped" in roughly the way that psnup does for PostScript files, i.e. multiple pages can be put together on one physical page at a reduced size. It depends on a working installation of (pdf)LaTeX.

OPTIONS

A summary of options is included below.

--nup nupspec

A specification of how to divide the n-upped pages between original pages, such as 2x1 (two pages side by side), 1x2 (two pages stacked vertically), etc. In general, the specification is of the form nxm where n and m are single-digit integers. The default value is 2x1.

--pages pages

A list of range of pages to be included, for example "3-6", "2,8,4,5" or "all" (without the quoting) The default value is "all".

--paper papersize

A LaTeX papersize, for example a4paper or letterpaper. The default is a4paper.

--orient orientation

The output page orientation; one of landscape, portrait or auto. The auto option guesses the orientation so as to minimize paper consumption. The default is auto.

--frame frame

True or false according to whether a thin line is to be drawn around pages or not. The default is false.

--trim trimspec

A page-trimming specification such as "1cm 1cm 1cm 1cm" (including the quoting). The default is "0 0 0 0", i.e. no trimming at all. Note that trimming does not mix well with using --frame true.

--offset offset

The offset of the position of output pages, such as "1cm 0.5cm" (including the quoting). The default is "0 0", i.e. no offset at all. See the manual for the pdfLaTeX pdfpages package for further details.

--delta delta

The amount of space to put between logical pages, such as "1cm 1cm" (including the quoting). The default is "0 0", i.e. no space between logical pages at all. See the manual for the pdfLaTeX pdfpages package for further details.

--openright openright

True or false according to whether or not a blank page should be inserted before the first logical page. The default is false.

--turn turn

True or false according to whether or not landscape pages should be displayed in landscape orientation. The default is true.

--noautoscale noautoscale

True or false according to whether or not logical pages should not be scaled to fit. The default is false.

--column column

True or false according to whether or not column-major order should be used. The default is false.

--columnstrict columnstrict

True or false according to whether or not the last page should be column-major ordered no matter how full it is. The default is false.

--outfile out.pdf

The name of the output file. If none is specified, the program comes up with a file name that is a derivative of the input file name, such as myinfile-2x2.pdf.

--tidy tidy

True or false according to whether or ot temporary files should be deleted immediately. If this is set to false, the temporary files are left in /var/tmp. The default is true.

CONFIGURATION FILES

Configuration of pdfnup involves specifying the location of pdflatex, the location of temporary files, specification of default page size, etc. This is done in a block of lines at the top of the pdfnup shell script itself; settings made there are over-ridden by any that are found at a site-wide configuration file (at /etc/pdfnup.conf, /usr/share/etc/pdfnup.conf, /usr/local/share/pdfnup.conf, or /usr/local/etc/pdfnup.conf), which in turn are over-ridden by any that are found in a user-defaults file at ~/.pdfnup.conf.

SEE ALSO

psnup (1), pdfLaTeX pdfpages package manual.

AUTHOR

pdfnup is written by David Firth.

This manual page was written by Matti Peltomaki (<ppv@fyslab.hut.fi>) for the Debian system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.