| 1 |
.TH PSBOOK "1" "2025\-09\-08" "psutils 3.3.14" "User Commands" |
| 2 |
.SH NAME |
| 3 |
psbook |
| 4 |
.SH SYNOPSIS |
| 5 |
.B psbook |
| 6 |
[OPTION...] [INFILE [OUTFILE]] |
| 7 |
.SH DESCRIPTION |
| 8 |
.PP |
| 9 |
.B psbook |
| 10 |
uses |
| 11 |
.B pstops |
| 12 |
to rearrange pages from a PDF or PostScript document into \[oq]signatures\[cq] for |
| 13 |
printing books or booklets, creating a new file. |
| 14 |
A \[oq]signature\[cq], often called a \[oq]section\[cq] in bookbinding, is a |
| 15 |
series of sheets that are folded together to be stitched into the book's |
| 16 |
binding. Each sheet has two pages per side; the number of pages in a |
| 17 |
signature must therefore be a multiple of four. |
| 18 |
Extra blank sides will be added if the file does not contain a multiple of |
| 19 |
four pages. |
| 20 |
.PP |
| 21 |
The output should be printed 2-up (this can be achieved with \fBpsnup\fR(1)) |
| 22 |
and duplex, as for short-edge binding. Alternatively, the output of |
| 23 |
.B psnup |
| 24 |
can be passed through the following command: |
| 25 |
.sp |
| 26 |
pstops '2:0(0,0),1U(1w,1h)' |
| 27 |
.sp |
| 28 |
to rotate the verso page upside-down, and the result can be printed duplex |
| 29 |
as for long-edge binding. |
| 30 |
Rearrange pages in a PDF or PostScript document into signatures. |
| 31 |
|
| 32 |
.TP |
| 33 |
\fBINFILE\fR |
| 34 |
`\-' or no INFILE argument means standard input |
| 35 |
|
| 36 |
.TP |
| 37 |
\fBOUTFILE\fR |
| 38 |
`\-' or no OUTFILE argument means standard output |
| 39 |
|
| 40 |
.SH OPTIONS |
| 41 |
.TP |
| 42 |
\fB\-s\fR \fI\,SIGNATURE\/\fR, \fB\-\-signature\fR \fI\,SIGNATURE\/\fR |
| 43 |
number of pages per signature; |
| 44 |
0 = all pages in one signature [default]; |
| 45 |
1 = do not rearrange the pages; |
| 46 |
otherwise, a multiple of 4 |
| 47 |
|
| 48 |
.TP |
| 49 |
\fB\-v\fR, \fB\-\-version\fR |
| 50 |
show program's version number and exit |
| 51 |
|
| 52 |
.TP |
| 53 |
\fB\-q\fR, \fB\-\-quiet\fR |
| 54 |
don't show progress |
| 55 |
|
| 56 |
.SH COMMENTS |
| 57 |
PAGES is a comma\-separated list of pages and page ranges; see pstops(1) |
| 58 |
for more details. |
| 59 |
|
| 60 |
.SH AUTHOR |
| 61 |
.nf |
| 62 |
Reuben Thomas <[email protected]> |
| 63 |
.fi |