diff options
author | Karl Berry <karl@freefriends.org> | 2024-06-13 20:15:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2024-06-13 20:15:25 +0000 |
commit | 95e8a1f4641bd5dbb0a14bf499ddb18ef5efa6f8 (patch) | |
tree | dc59e62d1b8d655061d9c816d05156ce7980c76b /Master/texmf-dist/doc | |
parent | 7ba522a8344a0069fd4429fb2c929d8a3d63ae69 (diff) |
pdfxup (13jun24)
git-svn-id: svn://tug.org/texlive/trunk@71513 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/pdfxup.1 | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf | bin | 28280 -> 28364 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/pdfxup/README | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/pdfxup/RELEASES | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/pdfxup/doc/Makefile | 3 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.pdf (renamed from Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf) | bin | 90128 -> 94798 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.tex | 163 | ||||
-rw-r--r-- | Master/texmf-dist/doc/support/pdfxup/doc/pdfxup.pdf | bin | 0 -> 96697 bytes |
8 files changed, 173 insertions, 3 deletions
diff --git a/Master/texmf-dist/doc/man/man1/pdfxup.1 b/Master/texmf-dist/doc/man/man1/pdfxup.1 index 8ca0c2b394a..49851a17f0b 100644 --- a/Master/texmf-dist/doc/man/man1/pdfxup.1 +++ b/Master/texmf-dist/doc/man/man1/pdfxup.1 @@ -1,6 +1,6 @@ .\" Manpage for pdfxup. .\" Contact pdfxup@markey.fr to correct errors or typos. -.TH man 1 "24 april 2021" "2.10" "pdfxup man page" +.TH man 1 "11 june 2024" "2.12" "pdfxup man page" .SH NAME pdfxup \- n-up tool with reduced margins .SH SYNOPSIS diff --git a/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf Binary files differindex ee969aeab10..cb37cc77b65 100644 --- a/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdfxup.man1.pdf diff --git a/Master/texmf-dist/doc/support/pdfxup/README b/Master/texmf-dist/doc/support/pdfxup/README index 335ae71dd88..7bbb705d4c6 100644 --- a/Master/texmf-dist/doc/support/pdfxup/README +++ b/Master/texmf-dist/doc/support/pdfxup/README @@ -1,4 +1,4 @@ -PDFXUP -- v2.11 (2024/03/15) +PDFXUP -- v2.12 (2024/06/11) N. Markey <pdfxup@markey.fr> @@ -18,7 +18,7 @@ graphicx package) in order to produce the new document. -%% (c) 2024/03/15 Nicolas Markey <pdfxup at markey dot fr> +%% (c) 2024/06/11 Nicolas Markey <pdfxup at markey dot fr> %% %% This work may be distributed and/or modified under the conditions of %% the LaTeX Project Public License, either version 1.3 of this license diff --git a/Master/texmf-dist/doc/support/pdfxup/RELEASES b/Master/texmf-dist/doc/support/pdfxup/RELEASES index b6272603a33..f0e9b936432 100644 --- a/Master/texmf-dist/doc/support/pdfxup/RELEASES +++ b/Master/texmf-dist/doc/support/pdfxup/RELEASES @@ -65,3 +65,7 @@ v2.10 (2021/04/25) v2.11 (2024/03/15) - fixed a bug in testdim, which did not support fractional values (bug reported by Walt Tuvell) + +v2.12 (2024/06/11) + - fixed several bugs related with page ranges (bugs reported by + Sanjoy Mahajan) diff --git a/Master/texmf-dist/doc/support/pdfxup/doc/Makefile b/Master/texmf-dist/doc/support/pdfxup/doc/Makefile new file mode 100644 index 00000000000..ea9fe01b2fb --- /dev/null +++ b/Master/texmf-dist/doc/support/pdfxup/doc/Makefile @@ -0,0 +1,3 @@ +all: + pdflatex pdfxup-doc.tex + pdfxup -o pdfxup.pdf pdfxup-doc.pdf diff --git a/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.pdf Binary files differindex 2c629a8b2ef..cf3f9af9365 100644 --- a/Master/texmf-dist/doc/support/pdfxup/pdfxup.pdf +++ b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.pdf diff --git a/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.tex b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.tex new file mode 100644 index 00000000000..c051d0483f5 --- /dev/null +++ b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup-doc.tex @@ -0,0 +1,163 @@ +\documentclass{article} +\usepackage[margin=6cm]{geometry} +\usepackage{tikz} +\usepackage{xspace} +\def\pdfxup{\texttt{pdfxup}\xspace} + +\begin{document} +\title{\pdfxup \\[2mm] + \normalsize + version 2.12 -- 2024/06/11} +\author{Nicolas Markey} +\date{} + +\maketitle + +\def\abstractname{} +\begin{abstract} +\pdfxup is a shell script that creates $n$-up PDF documents, while at +the same time removing as much white stripes as possible. This +document reviews the main features of \pdfxup. See the \verb+man+ page +for more details. +\end{abstract} + +\section{Basic usage} +Running \pdfxup with no options creates a 2-up document from the +original PDF file: +\begin{center} +\begin{tikzpicture}[scale=1.5] + \begin{scope} + \draw (0,0) |- (1.1,1.5) |- cycle; + \foreach \x in {.3,.4,...,.9} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0); + \end{scope} + \begin{scope}[xshift=1.2cm] + \draw (0,0) |- (1.1,1.5) |- cycle; + \foreach \x in {.3,.4,...,1.2} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + %\draw [line width=.5mm,black!50!white] (.3,1.2) -- +(.4,0); + \end{scope} + % + \draw[->] (2.6,.7) -- +(1,0);% node[midway,above] {scale=97\%}; + % + \begin{scope}[yshift=2mm,xshift=4cm] + \draw (0,0) |- (1.5,1.1) |- cycle; + \begin{scope}[yshift=-1.8mm,xshift=-1.5mm,scale=.97] + \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle; + \foreach \x in {.3,.4,...,.9} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0); + \begin{scope}[xshift=7.5mm] + \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle; + \foreach \x in {.3,.4,...,1.2} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + \end{scope} + \end{scope} + \end{scope} +\end{tikzpicture} +\end{center} + +It removes white strips around text, so that it does not need to scale +down the original document too much. All margins in the resulting PDF +can be adapted using various options. The number of rows and columns +of pages can be modified using options \verb+-x+ and \verb+-y+. By +default, the output file is in landscape mode, but this can be changed +using option \verb+-l=no+. + +Computing the boundig box is performed automatically using +GhostScript. This may take time for long documents, but it is often +sufficient to compute the bounding box on the first few pages, using +option \verb+-bb+. Bounding-box computation can be turned off (so that +original margins are kept) using \verb+-kbb+. + +It is possible to only include a subset of pages using option +\verb+-p+ (notice that if a page is listed twice, it will be included +twice). + +\section{Creating a booklet} +\pdfxup can create booklets: this is similar to the operation above, +but the pages are ordered and oriented in the adequate way. Booklet +mode is triggered with the \verb+-b+ option. +\begin{center} +\begin{tikzpicture}[scale=1.5] + \begin{scope} + \draw (0,0) |- (1.1,1.5) |- cycle; + \foreach \x in {.3,.4,...,.9} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0); + \end{scope} + \begin{scope}[xshift=1.2cm] + \draw (0,0) |- (1.1,1.5) |- cycle; + \foreach \x in {.3,.4,...,1.2} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + %\draw [line width=.5mm,black!50!white] (.3,1.2) -- +(.4,0); + \end{scope} + % + \draw[->] (2.6,.7) -- +(1,0);% node[midway,above] {scale=97\%}; + % + \begin{scope}[yshift=2mm,xshift=4cm] + \draw (0,0) |- (1.5,1.1) |- cycle; + \begin{scope}[yshift=-1.8mm,xshift=6mm,scale=.97] +% \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle; + \foreach \x in {.3,.4,...,.9} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0); + \end{scope} + \fill[white] (1.2,-.01) -| (1.51,.3) -- cycle; + \draw[fill=white] (1.2,0) .. controls +(40:2mm) and +(-60:2mm) .. (1.2,.35) -- (1.5,.3) -- cycle; + \begin{scope} + \draw[clip] (1.2,0) .. controls +(40:2mm) and +(-60:2mm) .. (1.2,.35) -- (1.5,.3) -- cycle; + \draw[line width=.5mm,black!50!white] (1.3,.3) .. controls +(-60:1mm) and +(90:2mm) .. ++(-80:3mm); + \draw[line width=.5mm,black!50!white] (1.38,.28) .. controls +(-69:1mm) and +(90:2mm) .. ++(-80:3mm); + \end{scope} + \end{scope} +\end{tikzpicture} +\end{center} + +\section{Watermarking} +Using option \verb+-w+, you can add watermarking to the original file: +\begin{center} +\begin{tikzpicture}[scale=1.5] + \begin{scope} + \draw (0,0) |- (1.1,1.5) |- cycle; + \foreach \x in {.3,.4,...,.9} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0); + \end{scope} + \begin{scope}[xshift=1.2cm] + \draw (0,0) |- (1.1,1.5) |- cycle; + \foreach \x in {.3,.4,...,1.2} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + %\draw [line width=.5mm,black!50!white] (.3,1.2) -- +(.4,0); + \end{scope} + % + \draw[->] (2.6,.7) -- +(1,0);% node[midway,above] {scale=97\%}; + % + \begin{scope}[yshift=2mm,xshift=4cm] + \draw (0,0) |- (1.5,1.1) |- cycle; + \begin{scope}[yshift=-1.8mm,xshift=-1.5mm,scale=.97] + \path (.178,.5) -- (.922,1) node[midway,sloped,opacity=.5] + {\bfseries\large draft}; + \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle; + \foreach \x in {.3,.4,...,.9} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + \draw [line width=.5mm,black!50!white] (.3,1.1) -- +(.5,0); + \begin{scope}[xshift=7.5mm] + \path (.178,.5) -- (.922,1) node[midway,sloped,opacity=.5] + {\bfseries\large draft}; + \draw[line width=.02pt] (.178,.25) |- (.922,1.25) |- cycle; + \foreach \x in {.3,.4,...,1.2} + {\draw [line width=.5mm,black!50!white] (.2,\x) -- +(.7,0);} + \end{scope} + \end{scope} + \end{scope} +\end{tikzpicture} +\end{center} + + +\pdfxup has many other options, setting up margins, frames, order of pages,~... +Please look at the \texttt{man} page for more details. + + +\end{document} diff --git a/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup.pdf b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup.pdf Binary files differnew file mode 100644 index 00000000000..7fda750bff7 --- /dev/null +++ b/Master/texmf-dist/doc/support/pdfxup/doc/pdfxup.pdf |