summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pdfpages
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
committerKarl Berry <karl@freefriends.org>2006-01-09 00:49:07 +0000
commit007f67a693e4d031fd3d792df8e4d5f43e2cb2e7 (patch)
tree90d17e00e572ecb1e24764b6f29c80e098b08d29 /Master/texmf-dist/doc/latex/pdfpages
parent950209b26f70aa87ed07c54f82a95b6f03b7c3a0 (diff)
doc/latex
git-svn-id: svn://tug.org/texlive/trunk@84 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/pdfpages')
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/dummy-l.pdfbin0 -> 12470 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/dummy.pdfbin0 -> 17192 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/pdf-ex.pdfbin0 -> 72702 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/pdf-ex.tex170
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.pdfbin0 -> 65363 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.tex142
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/pdf-toc.pdfbin0 -> 64786 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/pdf-toc.tex56
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/pdfpages.pdfbin0 -> 167950 bytes
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/pic.tex75
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/readme28
11 files changed, 471 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/pdfpages/dummy-l.pdf b/Master/texmf-dist/doc/latex/pdfpages/dummy-l.pdf
new file mode 100644
index 00000000000..5d4ad9de0b4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/dummy-l.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/pdfpages/dummy.pdf b/Master/texmf-dist/doc/latex/pdfpages/dummy.pdf
new file mode 100644
index 00000000000..95b4dc7ae7f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/dummy.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.pdf b/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.pdf
new file mode 100644
index 00000000000..787260d25a2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.tex b/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.tex
new file mode 100644
index 00000000000..2dbfdc5a32e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-ex.tex
@@ -0,0 +1,170 @@
+%%
+%% This is file `pdf-ex.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% pdfpages.dtx (with options: `example1')
+%%
+%% This file is a demonstration of the pdfpages package.
+%% Run it through pdfLaTeX.
+%%
+%% Please send error reports and suggestions for improvements to
+%% Andreas MATTHIAS <amat@kabsi.at>.
+%%
+
+\documentclass[a4paper,12pt]{article}
+\usepackage[final]{pdfpages}
+\usepackage{verbatim}
+%% Uncomment the following lines, if you want to produce thumbnails.
+%%\usepackage{pdflscape}
+%%\usepackage{thumbpdf}
+
+\newcounter{example}
+\setcounter{example}{1}
+
+\newenvironment{example}
+ {\par\vskip\topsep%
+ \noindent\textbf{Example \arabic{example}:}%
+ \stepcounter{example}%
+ \par\vskip\topsep%
+ \minipage{.9\linewidth}%
+ \verbatim}
+ {\endverbatim%
+ \endminipage\par\vskip\topsep}
+
+\begin{document}
+
+\title{A Demonstration of the \texttt{pdfpages} Package}
+\author{Andreas MATTHIAS}
+\maketitle
+
+This is a demonstration of the \texttt{pdfpages} package.
+It is \textit{not} the documentation of the package.
+To get the documentation run: `latex pdfpages.dtx'
+
+\tableofcontents
+
+\section{Inserting Pages:}
+\begin{example}
+\includepdf[pages=3-5]{dummy.pdf}
+\end{example}
+\includepdf[pages=3-5]{dummy.pdf}
+
+\section{Using the \texttt{nup} Option}
+Arranging several logical pages on one sheet of paper.
+
+\begin{example}
+\includepdf[nup=1x2, landscape, pages=4-7]{dummy.pdf}
+\end{example}
+\includepdf[nup=1x2, landscape, pages=4-7]{dummy.pdf}
+
+Use the option \texttt{turn=false}, if the pages
+should not be displayed in landscape orientation.
+(If the last two pages were not displayed in
+landscape orientation, you use a PDF viewer that
+does not support this option.)
+
+\begin{example}
+\includepdf[nup=1x2, landscape,
+ pages=4-7, turn=false]{dummy.pdf}
+\end{example}
+\includepdf[nup=1x2, landscape,
+ pages=4-7, turn=false]{dummy.pdf}
+
+\begin{example}
+\includepdf[nup=1x2, pages=1-4]{dummy-l.pdf}
+\end{example}
+\includepdf[nup=1x2, pages=1-4]{dummy-l.pdf}
+
+\noindent
+With the option \texttt{pages} special pages and
+ranges of pages can be selected.
+
+\begin{example}
+\includepdf[nup=3x2, pages={1,4-6,8,10}]{dummy.pdf}
+\end{example}
+\includepdf[nup=3x2, pages={1,4-6,8,10}]{dummy.pdf}
+
+\noindent
+A column-major layout can be achieved with the
+option \texttt{column}.
+
+\begin{example}
+\includepdf[nup=2x2, pages=1-4, column]{dummy.pdf}
+\end{example}
+\includepdf[nup=2x2, pages=1-4, column]{dummy.pdf}
+
+\noindent
+Sometimes it might be useful to put an empty page
+at the beginning.
+\begin{example}
+\includepdf[nup=2x2, pages={{},5-7}]{dummy.pdf}
+\end{example}
+\includepdf[nup=2x2, pages={{},5-7}]{dummy.pdf}
+
+\section{Changing Layout}
+
+To put some space between the logical pages, use the option
+\texttt{delta}.
+
+Any options of \verb|\includegraphics| are allowed in
+\verb|\includepdf| as well. See the \texttt{scale}
+option in the next example.
+\begin{example}
+\includepdf[nup=2x2, pages=3-6, scale=.8,
+ delta=8mm 11mm, frame]{dummy.pdf}
+\end{example}
+\includepdf[nup=2x2, pages=3-6, scale=.8,
+ delta=8mm 11mm, frame]{dummy.pdf}
+
+\noindent
+By default the output is centered, as you could see in
+the last examples. With the \texttt{offset} option it is
+possible to displace the output.
+
+\begin{example}
+\includepdf[nup=2x2, pages=3-6, scale=.8,
+ offset=5mm 7mm, frame]{dummy.pdf}
+\end{example}
+\includepdf[nup=2x2, pages=3-6, scale=.8,
+ offset=5mm 7mm, frame]{dummy.pdf}
+
+\noindent
+To remove the header and the footer of the inserted
+document use the \texttt{trim} and \texttt{clip}
+options of the \texttt{graphicx} package.
+
+\begin{example}
+\includepdf[nup=2x2, pages=1-4,
+ trim=0 40mm 0 40mm,
+ clip, pagecommand={}]{dummy.pdf}
+\end{example}
+
+\noindent The option
+\verb|pagecommand={\thispagestyle{empty}}|
+is set by default. If you don't want the page style
+to be set to empty, you can remove this default
+setting by using the \texttt{pagecommand} option
+as follows:
+\verb|pagecommand={}|.
+
+\includepdf[nup=2x2, pages=1-4,
+ trim=0 40mm 0 40mm,
+ clip, pagecommand={}]{dummy.pdf}
+
+\noindent
+You like the crazy way? Then try this one \texttt{;-)}
+\begin{example}
+\includepdf[pages={3,4}, nup=1x2,
+ landscape, scale=1.1,
+ angle=30, delta=0 -85mm]{dummy.pdf}
+\end{example}
+\includepdf[pages={3,4}, nup=1x2,
+ landscape, scale=1.1,
+ angle=30, delta=0 -85mm]{dummy.pdf}
+
+\end{document}
+\endinput
+%%
+%% End of file `pdf-ex.tex'.
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.pdf b/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.pdf
new file mode 100644
index 00000000000..6703e24d0e4
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.tex b/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.tex
new file mode 100644
index 00000000000..1d737651a18
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.tex
@@ -0,0 +1,142 @@
+%%
+%% This is file `pdf-hyp.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% pdfpages.dtx (with options: `example2')
+%%
+%% This file is a demonstration of the pdfpages package.
+%% Run it through pdfLaTeX.
+%%
+%% Please send error reports and suggestions for improvements to
+%% Andreas MATTHIAS <amat@kabsi.at>.
+%%
+
+\documentclass[a4paper,12pt]{article}
+\usepackage[final]{pdfpages}
+\usepackage{verbatim}
+%% Uncomment the following lines, if you want to produce thumbnails.
+%%\usepackage{pdflscape}
+%%\usepackage{thumbpdf}
+\usepackage[bookmarksopen]{hyperref}
+
+\newcounter{example}
+\setcounter{example}{1}
+
+\newenvironment{example}
+ {\par\vskip\topsep%
+ \noindent\textbf{Example \arabic{example}:}%
+ \stepcounter{example}%
+ \par\vskip\topsep%
+ \minipage{.9\linewidth}%
+ \verbatim}
+ {\endverbatim%
+ \endminipage\vskip\topsep}
+
+\newcommand{\meta}[1]{\ensuremath\langle\texttt{#1}\ensuremath\rangle}
+\newcommand{\link}[2]{\meta{#1}.\meta{#2}}
+
+\newcommand*{\bookmark}[3][0]{%
+ \pdfoutline user {<< /S /GoTo /D (#3) >>} count #1 {#2}}
+
+\begin{document}
+
+\title{A Demonstration of the Hypertext Operations\\
+ of the \texttt{pdfpages} Package}
+\author{Andreas MATTHIAS}
+\maketitle
+
+This is a demonstration of the \texttt{pdfpages} package.
+It is \textit{not} the documentation of the package.
+To get the documentation run: `latex pdfpages.dtx'
+
+\tableofcontents
+
+\section{Hyperlinks}
+\subsection{Links to the inserted Pages}
+
+Hyperlinks are created by using the option \texttt{link}
+of the \verb|\includepdf| command. Each inserted page
+gets a link name consisting of the filename and
+the page number: \link{filename}{page number}
+
+\begin{example}
+\includepdf[pages=1-2, link]{dummy.pdf}
+\end{example}
+
+In this example the two pages have the link names
+`\texttt{dummy.pdf.1}' and `\texttt{dummy.pdf.2}'.
+Setting links to these
+pages, can be done easily with the \verb|\hyperlink|
+macro from the \texttt{hyperref.sty} package:
+
+\bigskip
+\verb|\hyperlink{dummy.pdf.1}{Page 1}|\hskip10pt \hyperlink{dummy.pdf.1}{Page 1}\par
+\verb|\hyperlink{dummy.pdf.2}{Page 2}|\hskip10pt \hyperlink{dummy.pdf.2}{Page 2}
+\bigskip
+
+This way you can refer to the \hyperlink{dummy.pdf.1}{first}
+and the \hyperlink{dummy.pdf.2}{second page}.
+
+\includepdf[pages=1-2, link]{dummy.pdf}
+
+Inserting the same page twice would result in two
+identical link names. To prevent this use the option
+\texttt{linkname} to specify another name for the links.
+
+\begin{example}
+\includepdf[pages=1-2, nup=1x2, landscape,
+ link, linkname=mylink]{dummy.pdf}
+\end{example}
+
+\noindent
+Now the links are called `\texttt{mylink.1}' and
+`\texttt{mylink.2}'.
+
+\bigskip
+\verb|\hyperlink{mylink.1}{Page 1}|\hskip10pt \hyperlink{mylink.1}{Page 1}\par
+\verb|\hyperlink{mylink.2}{Page 2}|\hskip10pt \hyperlink{mylink.2}{Page 2}
+
+\includepdf[pages=1-2, nup=1x2, landscape,
+ link, linkname=mylink]{dummy.pdf}
+
+\subsection{Links to the original Document}
+
+Each page can be a hyperlink to the document from
+which it was extracted. This can be done with the
+option \texttt{linktodoc}.
+
+Click on the inserted pages and see what happens.
+
+\begin{example}
+\includepdf[pages=1-4, nup=2x2, linktodoc]{dummy.pdf}
+\end{example}
+\includepdf[pages=1-4, nup=2x2, linktodoc]{dummy.pdf}
+
+\section{Article Threads}
+
+In a PDF document one or more article threads may be defined.
+An article thread is a logical connected sequence of content
+items.
+
+With the option \texttt{thread} the inserted pages become
+an article thread.
+
+\begin{example}
+\includepdf[pages=1-4, nup=2x2, column,
+ landscape, thread]{dummy-l.pdf}
+\end{example}
+
+In Acrobat Reader the mouse pointer changes to a hand with
+a little arrow in it when moved over an article thread.
+By clicking on the page you can easily follow the logical
+structure of the article thread.
+
+\includepdf[pages=1-4, nup=2x2, column,
+ landscape, thread]{dummy-l.pdf}
+
+\end{document}
+\endinput
+%%
+%% End of file `pdf-hyp.tex'.
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.pdf b/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.pdf
new file mode 100644
index 00000000000..fbce61ae48b
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.tex b/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.tex
new file mode 100644
index 00000000000..ac07ed3040a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdf-toc.tex
@@ -0,0 +1,56 @@
+%%
+%% This is file `pdf-toc.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% pdfpages.dtx (with options: `example3')
+%%
+%% This file is a demonstration of the pdfpages package.
+%% Run it through pdfLaTeX.
+%%
+%% Please send error reports and suggestions for improvements to
+%% Andreas MATTHIAS <amat@kabsi.at>.
+%%
+
+\documentclass[a4paper]{book}
+\usepackage{pdfpages}
+\usepackage{verbatim}
+\usepackage[plainpages=false, pdfpagelabels,
+ bookmarksopen]{hyperref}
+
+\begin{document}
+\tableofcontents
+
+\chapter{How to create a toc}
+
+The next pages were inserted using the following command:
+
+\begin{verbatim}
+\includepdf[pages=1-6,
+ pagecommand={},
+ addtotoc={1, chapter, 0, Main chapter, cha:main,
+ 1, section, 1, First section, sec:first,
+ 3, section, 1, Second section, sec:second},
+ trim=0 120 0 120, clip]{dummy.pdf}
+\end{verbatim}
+
+\noindent
+See Chapter \ref{cha:main} (\nameref{cha:main}) on page
+\pageref{cha:main}.\par\noindent
+See Section \ref{sec:first} (\nameref{sec:first}) on page
+\pageref{sec:first}.\par\noindent
+See Section \ref{sec:second} (\nameref{sec:second}) on page
+\pageref{sec:second}.
+
+\includepdf[pages=1-6,
+ pagecommand={},
+ addtotoc={1, chapter, 0, Main chapter, cha:main,
+ 1, section, 1, First section, sec:first,
+ 3, section, 1, Second section, sec:second},
+ trim=0 120 0 120, clip]{dummy.pdf}
+
+\end{document}
+\endinput
+%%
+%% End of file `pdf-toc.tex'.
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pdfpages.pdf b/Master/texmf-dist/doc/latex/pdfpages/pdfpages.pdf
new file mode 100644
index 00000000000..b4e224e7976
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pdfpages.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/pdfpages/pic.tex b/Master/texmf-dist/doc/latex/pdfpages/pic.tex
new file mode 100644
index 00000000000..26a448743c5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/pic.tex
@@ -0,0 +1,75 @@
+\setlength{\unitlength}{.7mm}
+\def\thick{.7pt}
+\def\thin{.2pt}
+%^^A\fbox{
+\begin{picture}(145,238)
+ \small
+\put(0,33){
+ \linethickness{\thick}
+ \put(0,0){\framebox(145,205){}}
+ \linethickness{\thin}
+ \put(10,15){\dashbox(35,49){}}
+ \put(55,15){\dashbox(35,49){}}
+ \put(100,15){\dashbox(35,49){}}
+ \put(10,78){\dashbox(35,49){}}
+ \put(55,78){\dashbox(35,49){}}
+ \put(100,78){\dashbox(35,49){}}
+ \put(10,141){\dashbox(35,49){}}
+ \put(55,141){\dashbox(35,49){}}
+ \put(100,141){\dashbox(35,49){}}
+ \put(5,7){
+ \put(10,15){\framebox(35,49){}}
+ \put(55,15){\framebox(35,49){}}
+ \put(100,15){\framebox(35,49){}}
+ \put(10,78){\framebox(35,49){}}
+ \put(55,78){\framebox(35,49){}}
+ \put(100,78){\framebox(35,49){}}
+ \put(10,141){\framebox(35,49){}}
+ \put(55,141){\framebox(35,49){}}
+ \put(100,141){\framebox(35,49){}}
+ \put(45,36){\vector(1,0){10}}
+ \put(55,36){\vector(-1,0){10}}
+ \put(44.5,38){\textit{delx}}
+ \put(90,36){\vector(1,0){10}}
+ \put(100,36){\vector(-1,0){10}}
+ \put(89.5,38){\textit{delx}}
+ \put(27,64){\vector(0,1){14}}
+ \put(27,78){\vector(0,-1){14}}
+ \put(15,70){\textit{dely}}
+ \put(27,127){\vector(0,1){14}}
+ \put(27,141){\vector(0,-1){14}}
+ \put(15,133){\textit{dely}}
+ }
+ \put(10,15){\vector(1,0){5}}
+ \put(15,15){\vector(0,1){7}}
+ \put(8,8){\textit{offx}}
+ \put(17,17){\textit{offy}}
+}
+%
+%^^A legend
+%
+\setlength{\fboxsep}{4pt}
+\put(72.5,10){
+ \makebox(0,0){
+ \fbox{
+ \begin{tabular}{l@{\hskip20pt}l}
+ \linethickness{\thick}^^A
+ \raisebox{.8ex}{\line(1,0){5}} physical sheet of paper
+ &
+ |delta=|\meta{delx} \meta{dely}
+ \\
+ \linethickness{\thin}^^A
+ \raisebox{.8ex}{\line(1,0){5}} logical pages
+ &
+ |offset=|\meta{offx} \meta{offy}
+ \\
+ \raisebox{.8ex}{\line(1,0){1}\hskip.55mm\line(1,0){1}
+ \hskip.55mm\line(1,0){1}} centered position
+ &
+ \\
+ \end{tabular}
+ }}
+}
+
+\end{picture}
+%^^A} \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/pdfpages/readme b/Master/texmf-dist/doc/latex/pdfpages/readme
new file mode 100644
index 00000000000..8645c32904c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/pdfpages/readme
@@ -0,0 +1,28 @@
+
+The pdfpages Package
+--------------------
+
+This package makes it easy to insert pages of external PDF
+documents. It is possible to arrange several logical
+pages on each sheet of paper. (Like `psnup'.)
+
+This package supports pdfLaTeX and VTeX but does not work
+with LaTeX.
+
+Run `latex pdfpages.ins' to produce pdfpages.sty and the
+driver files pppdftex.def and ppvtex.def. Move these files
+into a directory searched by LaTeX.
+
+Run `latex pdfpages.dtx' to produce the documentation.
+
+Run `pdflatex pdf-ex.tex', `pdflatex pdf-hyp.tex',
+and `pdflatex pdf-toc.tex' to produce some examples.
+
+
+This program may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.2
+of this license or (at your option) any later version.
+
+ Andreas MATTHIAS
+ amat@kabsi.at
+