manual.tex

latex学习例子

Firstly, the options to specify general behavior and page size.

\medskip
\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}ll}
draft          & boolean & false & all hypertext options are turned off \\
final          & boolean & true  & all hypertext options are turned on \\
debug          & boolean & false & extra diagnostic messages are printed in \\
               &         &       & the log file \\
verbose        & boolean & false & same as debug \\
implicit       & boolean & true  & redefines \LaTeX\ internals \\
hypertexnames  & boolean & true  & use guessable names for links \\
naturalnames   & boolean & false & use \LaTeX-computed names for links \\
a4paper        & boolean & true  & sets paper size to 210mm $\times$ 297mm \\
a5paper        & boolean & false & sets paper size to 148mm $\times$ 210mm \\
b5paper        & boolean & false & sets paper size to 176mm $\times$ 250mm \\
letterpaper    & boolean & false & sets paper size to 8.5in $\times$ 11in \\
legalpaper     & boolean & false & sets paper size to 8.5in $\times$ 14in \\
executivepaper & boolean & false & sets paper size to 7.25in $\times$ 10.5in \\
setpagesize    & boolean & true  & sets page size by special driver commands
\end{longtable}

\subsection{Configuration options}

\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{7cm}}
raiselinks & boolean & true  & In the hypertex driver, the height of links is normally calculcated by the driver as
                               simply the base line of contained text; this options forces \verb|\special| commands to
                               reflect the real height of the link (which could contain a graphic) \\
breaklinks & boolean & false & Allows link text to break across lines; since this cannot be accommodated in PDF, it is
                               only set true by default if the pdftex driver is used. This makes links on multiple lines
                               into different PDF links to the same target. \\
pageanchor & boolean & true  & Determines whether every page is given an implicit anchor at the top left corner. If this
                               is turned off, \verb|\tableofcontents| will not contain hyperlinks. \\
plainpages & boolean & true  & Forces page anchors to be named by the arabic form of the page number, rather than the
                               formatted form. \\
nesting    & boolean & false & Allows links to be nested; no drivers currently support this.
\end{longtable}

\subsection{Backend drivers}

If no driver is specified, the package defaults to loading the
\textsf{hypertex} driver.  All of these are boolean options.

\noindent\begin{longtable}{>{\ttfamily}lp{.8\hsize}}
dvips       & Sets up \textsf{hyperref} for use with the \textsf{dvips} driver. \\
dvipsone    & Sets up \textsf{hyperref} for use with the \textsf{dvipsone} driver. \\
dviwindo    & Sets up \textsf{hyperref} for use with the \textsf{dviwindo} Windows previewer. \\
hypertex    & Sets up \textsf{hyperref} for use with the Hyper\TeX-compliant drivers. \\
latex2html  & Redefines a few macros for compatibility with \textsf{latex2html}. \\
nativepdf   & an alias for \textsf{dvips} \\
pdfmark     & an alias for \textsf{dvips} \\
pdftex      & Sets up \textsf{hyperref} for use with the \textsf{pdftex} program.\\
ps2pdf      & Redefines a few macros for compatibility with
              Ghostscript's PDF writer, otherwise identical to
              \textsf{dvips}. \\
tex4ht      & for use with \textsf{\TeX4ht} \\
textures    & for use with \textsf{Textures} \\
vtex        & For use with MicroPress' \textsf{VTeX}; the PDF
                       and HTML backends are detected automatically. \\
vtexpdfmark & for use with \textsf{VTeX}'s PostScript backend. \\
\end{longtable} \smallskip

If you use \textsf{dviwindo}, you may need to redefine the macro
\ci{wwwbrowser} (the default is \verb|C:\netscape\netscape|) to tell
\textsf{dviwindo} what program to launch. Thus, users of Internet
Explorer might add something like this to hyperref.cfg:

\begin{verbatim}
\renewcommand{wwwbrowser}{C:\string\Program\space
  Files\string\Plus!\string\Microsoft\space
  Internet\string\iexplore.exe}
\end{verbatim}

\subsection{Extension options}
\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{6cm}}
extension    & text    &         & Set the file extension (e.g.\ \textsf{dvi}) which will be appended to file links
                                   created if you use the \textsf{xr} package. \\
hyperfigures & boolean &         & \\
backref      & boolean & false   & Adds `backlink' text to the end of each item in the bibliography, as a list of
                                   section numbers. This can only work properly \emph{if} there is a blank line after
                                   each \verb|\bibitem|. \\
pagebackref  & boolean & false   & Adds `backlink' text to the end of each item in the bibliography, as a list of page
                                   numbers. \\
hyperindex   & boolean & false   & Makes the text of index entries into hyperlinks. Easily broken \ldots \\
encap        &         &         & Sets encap character for hyperindex \\
linktocpage  & boolean & false   & make page number, not text, be link on TOC, LOF and LOT \\
breaklinks   & boolean & false   & allow links to break over lines by making links over multiple lines into PDF links to
                                   the same target \\
colorlinks   & boolean & false   & Colors the text of links and anchors. The colors chosen depend on the the type of
                                   link. At present the only types of link distinguished are citations, page references,
                                   URLs, local file references, and other links. \\
linkcolor    & color   & red     & Color for normal internal links. \\
anchorcolor  & color   & black   & Color for anchor text. \\
citecolor    & color   & green   & Color for bibliographical citations in text. \\
filecolor    & color   & magenta & Color for URLs which open local files. \\
menucolor    & color   & red     & Color for Acrobat menu items. \\
pagecolor    & color   & red     & Color for links to other pages. \\
urlcolor     & color   & cyan    & Color for linked URLs. \\
frenchlinks  & boolean & false   & use small caps instead of color for links
\end{longtable} \smallskip

Note that all color names must be defined before use, following the
normal system of the standard \LaTeX\ \textsf{color} package.

\subsection{PDF-specific display options}
\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{5cm}}
bookmarks          & boolean   & false   & A set of Acrobat bookmarks are written, in a manner similar to the
                                           table of contents, requiring two passes of \LaTeX. Some postprocessing
                                           of the bookmark file (file extension \texttt{.out}) may be needed to
                                           translate \LaTeX\ codes, since bookmarks must be written in  PDFEncoding.
                                           To aid this  process, the \texttt{.out} file is not rewritten by \LaTeX\
                                           if it is edited to contain a line \verb|\let\WriteBookmarks\relax| \\
bookmarksopen      & boolean   & false   & If Acrobat bookmarks are requested, show them with all the subtrees
                                           expanded. \\
bookmarksopenlevel & parameter &         & level (\ci{maxdimen}) to which bookmarks are open \\
bookmarksnumbered  & boolean   & false   & If Acrobat bookmarks are requested, include section numbers. \\
bookmarkstype      & text      & toc     & to specify which `toc' file to mimic \\
pdfhighlight       & name      & /I      & How link buttons behave when selected; /I is for inverse (the default);
                                           the other possibilities are /N (no effect), /O (outline), and /P (inset
                                           highlighting). \\
citebordercolor    & RGB color & 0 1 0   & The color of the box around citations \\
filebordercolor    & RGB color & 0 .5 .5 & The color of the box around links to files \\
linkbordercolor    & RGB color & 1 0 0   & The color of the box around normal links \\
menubordercolor    & RGB color & 1 0 0   & The color of the box around Acrobat menu links \\
pagebordercolor    & RGB color & 1 1 0   & The color of the box around links to pages \\
urlbordercolor     & RGB color & 0 1 1   & The color of the box around links to URLs \\
runbordercolor     & RGB color & 0 .7 .7 & color of border around `run' links \\
pdfborder          &           & 0 0 1   & The style of box around links; defaults to a box with lines of 1pt thickness,
                                           but the colorlinks option resets it to produce no border.
\end{longtable}

Note that the color of link borders can be specified \emph{only} as 3
numbers in the range 0..1, giving an RGB color. You cannot use colors
defined in \TeX.

The bookmark commands are stored in a file called
\textit{jobname}\texttt{.out}. The files is not processed by \LaTeX\ so
any markup is passed through. You can postprocess this file as needed;
as an aid for this, the \texttt{.out} file is not overwritten on the
next \TeX\ run if it is edited to contain the line \\

\begin{verbatim}
\let\WriteBookmarks\relax
\end{verbatim}

\subsection{PDF display and information options}
\noindent\begin{longtable}{>{\ttfamily}ll>{\itshape}lp{6cm}}
baseurl            & URL     &       & Sets the base URL of the PDF document \\
pdfpagemode        & text    & None  & Determines how the file is opening in Acrobat; the possibilities are
                                       \texttt{None}, \texttt{UseThumbs} (show thumbnails), \texttt{UseOutlines} (show
                                       bookmarks), and \texttt{FullScreen}. If no mode if explicitly chosen, but the
                                       bookmarks option is set, \texttt{UseOutlines} is used. \\
pdftitle           & text    &       & Sets the document information Title field \\
pdfauthor          & text    &       & Sets the document information Author field \\
pdfsubject         & text    &       & Sets the document information Subject field \\
pdfcreator         & text    &       & Sets the document information Creator field \\
pdfproducer        & text    &       & Sets the document information Producer field \\
pdfkeywords        & text    &       & Sets the document information Keywords field \\
pdfview            & text    & FitBH & Sets the default PDF `view' for each link \\
pdfstartpage       & text    & 1     & Determines on which page the PDF file is opened. \\
pdfstartview       & text    & FitB  & Set the startup page view \\
pdfpagescrop       & n n n n &       & Sets the default PDF crop box for pages. This should be a set of four numbers \\
pdfcenterwindow    & boolean & false & position the document window in the center of the screen \\
pdffitwindow       & boolean & false & resize document window to fit document size \\
pdfmenubar         & boolean & true  & make PDF viewer's menu bar visible \\
pdfnewwindow       & boolean & false & make links that open another PDF file start a new window \\
pdfpagelayout      & text    & empty & set layout of PDF pages \\
pdfpagelabels      & boolean & false & set PDF page labels \\
pdfpagetransition  & text    & empty & set PDF page transition style \\
pdftoolbar         & boolean & true  & make PDF toolbar visible \\
pdfwindowui        & boolean & true  & make PDF user interface elements visible \\
unicode            &         &       & Unicode encoded PDF strings
\end{longtable}

Each link in Acrobat carries its own magnification level, which is set
using PDF coordinate space, which is not the same as \TeX's. pdf\TeX\
works by supplying default values for \texttt{XYZ} (horizontal $\times$
vertical $\times$ zoom) and \texttt{FitBH}. However, drivers using
\texttt{pdfmark} do not supply defaults, so \textsf{hyperref} passes in
a value of -32768, which causes Acrobat to set (usually) sensible
defaults. The following are possible values for the \texttt{pdfview} and
\texttt{pdfstartview} parameters.

\noindent\begin{longtable}{>{\ttfamily}l>{\itshape}lp{7cm}}
XYZ   & left top zoom         & Sets a coordinate and a zoom factor. If any one is null, the source link value is used.
                                \textit{null null null} will give the same values as the current page. \\
Fit   &                       & Fits the page to the window. \\
FitH  & top                   & Fits the width of the page to the window. \\
FitV  & left                  & Fits the height of the page to the window. \\
FitR  & left bottom right top & Fits the rectangle specified by the four coordinates to the window. \\
FitB  &                       & Fits the page bounding box to the window. \\
FitBH & top                   & Fits the width of the page bounding box to the window. \\
FitBV & left                  & Fits the height of the page bounding box to the window. \\
\end{longtable}

The \texttt{pdfpagelayout} can be one of the following values.

\noindent\begin{longtable}{>{\ttfamily}lp{10cm}}
SinglePage     & Displays a single page; advancing flips the page \\
OneColumn      & Displays the document in one column; continuous scrolling. \\
TwoColumnLeft  & Displays the document in two columns, odd-numbered pages to the left. \\
TwoColumnRight & Displays the document in two columns, odd-numbered pages to the right.
\end{longtable}

Finally, the \texttt{pdfpagetransition} can be one of the following
values, where \textit{/Di} stands for direction of motion in degrees,
generally in 90$^{\circ}$\ steps, \textit{/Dm} is a horizontal
(\texttt{/H}) or vertical (\texttt{/V}) dimension (e.g.\ \texttt{Blinds
/Dm /V}), and \textit{/M} is for motion, either in (\texttt{/I}) or out
(\texttt{/O}).

\noindent\begin{longtable}{>{\ttfamily}llp{8.5cm}}
Blinds   & /Dm    & Multiple lines distributed evenly across the screen sweep in the same direction to reveal the new
                    page. \\
Box      & /M     & A box sweeps in or out. \\
Dissolve &        & The page image dissolves in a piecemeal fashion to reveal the new page. \\
Glitter  & /Di    & Similar to Dissolve, except the effect sweeps across the screen. \\
Split    & /Dm /M & Two lines sweep across the screen to reveal the new page. \\
Wipe     & /Di    & A single line sweeps across the screen to reveal the new page.
\end{longtable}

\subsection{Big alphabetical list}

The following is a complete listing of available options for
\textsf{hyperref}, arranged alphabetically.

\noindent\begin{longtable}{>{\ttfamily}llp{6cm}}
a4paper            &                        & use A4 paper \\
a5paper            &                        & use A5 paper \\
anchorcolor        & \textit{black}         & set color of anchors \\
b5paper            &                        & use B5 paper \\
backref            & \textit{false}         & do bibliographical back references \\
baseurl            & \textit{empty}         & set base URL for document \\
bookmarks          & \textit{true}          & make bookmarks \\
bookmarksnumbered  & \textit{false}         & put section numbers in bookmarks \\
bookmarksopen      & \textit{false}         & open up bookmark tree \\
bookmarksopenlevel & \ttfamily\ci{maxdimen} & level to which bookmarks are open \\
bookmarkstype      & \textit{toc}           & to specify which `toc' file to mimic \\
breaklinks         & \textit{false}         & allow links to break over lines \\
citebordercolor    & \textit{0 1 0}         & color of border around cites \\
citecolor          & \textit{green}         & color of citation links \\
colorlinks         & \textit{false}         & color links \\
                   & \textit{true}          & (\textsf{tex4ht}, \textsf{dviwindo}) \\
debug              & \textit{false}         & provide details of anchors defined; same as verbose \\
draft              & \textit{false}         & do not do any hyperlinking \\
dvipdf             &                        & use \textsf{dvipdf} backend \\
dvipdfm            &                        & use \textsf{dvipdfm} backend \\
dvips              &                        & use \textsf{dvips} backend \\
dvipsone           &                        & use \textsf{dvipsone} backend \\
dviwindo           &                        & use \textsf{dviwindo} backend \\
encap              &                        & to set encap character for hyperindex \\
executivepaper     &                        & use executivepaper \\
extension          & \textit{dvi}           & suffix of linked files \\
filebordercolor    & \textit{0 .5 .5}       & color of border around file links \\
filecolor          & \textit{cyan}          & color of file links \\
final              & \textit{true}          & opposite of option draft \\
frenchlinks        & \textit{false}         & use small caps instead of color for links \\
hyperfigures       & \textit{false}         & make figures hyper links \\
hyperindex         & \textit{true}          & set up hyperlinked indices \\
hypertex           &                        & use \textsf{Hyper\TeX} backend \\
hypertexnames      & \textit{true}          & use guessable names for links \\
implicit           & \textit{true}          & redefine \LaTeX\ internals \\
latex2html         &                        & use \textsf{\LaTeX2HTML} backend \\
legalpaper         &                        & use legalpaper \\
letterpaper        &                        & use letterpaper \\
linkbordercolor    & \textit{1 0 0}         & color of border around links \\
linkcolor          & \textit{red}           & color of links \\
linktocpage        & \textit{false}         & make page number, not text, be link on TOC, LOF and LOT \\
menubordercolor    & \textit{1 0 0}         & color of border around menu links \\
menucolor          & \textit{red}           & color for menu links \\
nativepdf          & \textit{false}         & an alias for \textsf{dvips} \\
naturalnames       & \textit{false}         & use \LaTeX-computed names for links \\
nesting            & \textit{false}         & allow nesting of links \\
pageanchor         & \textit{true}          & put an anchor on every page \\
pagebackref        & \textit{false}         & backreference by page number \\
pagebordercolor    & \textit{1 1 0}         & color of border around page links \\
pagecolor          & \textit{red}           & color of page links \\
pdfauthor          & \textit{empty}         & text for PDF Author field \\
pdfborder          & \textit{0 0 1}         & width of PDF link border \\
                   & \textit{0 0 0}         & (\texttt{colorlinks)} \\
pdfcenterwindow    & \textit{false}         & position the document window in the center of the screen \\