summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.tex
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/pdf-hyp.tex
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/pdf-hyp.tex')
-rw-r--r--Master/texmf-dist/doc/latex/pdfpages/pdf-hyp.tex142
1 files changed, 142 insertions, 0 deletions
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'.