.\" Automatically generated by Pandoc 3.1.3
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "BOOKLETIMPOSER" "1" "2019" "bookletimposer user manual" ""
.hy
.SH NAME
.PP
\f[B]bookletimposer\f[R] - An utility to reorganize PDF pages
.SH SYNOPSIS
.PP
\f[B]bookletimposer\f[R] [\f[I]options\f[R]] [\f[I]input-file\f[R]]
.PP
\f[B]bookletimposer\f[R] \f[B]-a\f[R] [\f[I]options\f[R]]
\f[I]input-file\f[R]
.SH DESCRIPTION
.PP
bookletimposer is an utility to achieve some basic imposition on PDF
documents, especially designed to work on booklets.
.PP
It allows:
.IP \[bu] 2
to transform linear documents to booklets;
.IP \[bu] 2
to reduce a document to put many on one sheet (for handouts for
example);
.IP \[bu] 2
to transform booklets to linear documents.
.PP
It is a free software released under the GNU General Public License,
either version 3 or (at your option) any later version.
.SH OPTIONS
.SS \f[V]--version\f[R]
.PP
show program\[cq]s version number and exit.
.SS \f[V]-h\f[R], \f[V]--help\f[R]
.PP
show an help message and exit.
.SS \f[V]-o\f[R] \f[I]OUTFILE\f[R], \f[V]--output=\f[R]\f[I]OUTFILE\f[R]
.PP
set output PDF file to \f[I]OUTFILE\f[R].
.SS \f[V]-a\f[R], \f[V]--no-gui\f[R]
.PP
automatic conversion (don\[cq]t show the user interface).
In that mode, the input file must be defined.
.SS \f[V]-i\f[R], \f[V]--gui\f[R]
.PP
show the user interface (default).
.SS \f[V]-b\f[R], \f[V]--booklet\f[R]
.PP
produce a booklet out of a linear document (default).
.SS \f[V]-l\f[R], \f[V]--linearize\f[R]
.PP
produce a linear document out of a booklet.
.SS \f[V]-n\f[R], \f[V]--no-reorganisation\f[R]
.PP
don\[cq]t reorganize (will only scale and assemble pages).
.SS \f[V]-c\f[R], \f[V]--copy-pages\f[R]
.PP
copy the same group of input pages on one output page.
.SS \f[V]-p\f[R] \f[I]PAGES_PER_SHEET\f[R], \f[V]--pages-per-sheet=\f[R]\f[I]PAGES_PER_SHEET\f[R]
.PP
number of pages per sheet, in the format HORIZONTALxVERTICAL, e.g.\ 2x1.
.SS \f[V]-f\f[R] \f[I]OUTPUT_FORMAT\f[R], \f[V]--format=\f[R]\f[I]OUTPUT_FORMAT\f[R]
.PP
output page format, e.g.\ A4 or A3R.
.SS \f[V]-k\f[R], \f[V]--keep\f[R]
.PP
do not overwrite output file if it exists.
.SH EXAMPLES
.SS bookletimposer
.PP
Displays the GTK+ user interface.
.SS bookletimposer \[en]no-gui \[en]booklet \[en]pages-per-sheet=2x1 \[en]output=out.pdf in.pdf
.PP
Converts in.pdf into a booklet with two pages per sheet an saves the
result as out.pdf.
.SS bookletimposer \[en]no-gui \[en]linearise \[en]pages-per-sheet=2x1 in.pdf
.PP
Converts the two-pages-per-sheet booklet in.pdf into a page-by-page PDF.
As the output file name is not defined, it will default to in-conv.pdf.
.SH SEE ALSO
.PP
pdfshuffler(1)
.PP
BookletImposer source code and documentation can be found on the web at
<https://kjo.herbesfolles.org/bookletimposer/>
.SH KNOWN ISSUES
.PP
BookletImposer should be quite stable.
Thanks to report bugs to <kjo@a4nancy.net.eu.org> if you find some!
.SH AUTHORS
Kjö Hansi Glaz <kjo@a4nancy.net.eu.org>.