/usr/share/doc/texlive-doc/latex/pdfpages/pdf-hyp.tex is in texlive-latex-recommended-doc 2013.20140215-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 | %%
%% This is file `pdf-hyp.tex',
%% generated with the docstrip utility.
%%
%% The original source files were:
%%
%% pdfpages.dtx (with options: `example2')
%%
%% This file demonstrates how to use the pdfpages package.
%%
%% Please send error reports and suggestions for improvements to
%% Andreas MATTHIAS <andreas.matthias@gmail.com>.
%%
\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'.
|