manual.tex

latex学习例子

pdfcreator         & \textit{LaTeX with}    & text for PDF Creator field \\
                   & \textit{hyperref}      & \\
                   & \textit{package}       & \\
pdffitwindow       & \textit{false}         & resize document window to fit document size \\
pdfhighlight       & \textit{/I}            & set highlighting of PDF links \\
pdfkeywords        & \textit{empty}         & text for PDF Keywords field \\
pdfmark            & \textit{false}         & an alias for \textsf{dvips} \\
pdfmenubar         & \textit{true}          & make PDF viewer's menu bar visible \\
pdfnewwindow       & \textit{false}         & make links that open another PDF \\
                   &                        & file start a new window \\
pdfpagelayout      & \textit{empty}         & set layout of PDF pages \\
pdfpagemode        & \textit{empty}         & set default mode of PDF display \\
pdfpagelabels      & \textit{false}         & set PDF page labels \\
pdfpagescrop       & \textit{empty}         & set crop size of PDF document \\
pdfpagetransition  & \textit{empty}         & set PDF page transition style \\
pdfproducer        & \textit{empty}         & text for PDF Producer field \\
pdfstartpage       & \textit{1}             & page at which PDF document opens \\
pdfstartview       & \textit{/Fit}          & starting view of PDF document \\
pdfsubject         & \textit{empty}         & text for PDF Subject field \\
pdftex             &                        & use \textsf{pdf\TeX} backend \\
pdftitle           & \textit{empty}         & text for PDF Title field \\
pdftoolbar         & \textit{true}          & make PDF toolbar visible \\
pdfview            & \textit{empty}         & PDF `view' when on link traversal \\
pdfwindowui        & \textit{true}          & make PDF user interface elements visible \\
plainpages         & \textit{true}          & do page number anchors as plain arabic \\
ps2pdf             &                        & use \textsf{ps2pdf} backend \\
raiselinks         & \textit{false}         & raise up links (for \textsf{Hyper\TeX} backend) \\
runbordercolor     & \textit{0 .7 .7}       & color of border around `run' links \\
setpagesize        & \textit{true}          & set page size by special driver commands \\
tex4ht             &                        & use \textsf{\TeX4ht} backend \\
textures           &                        & use \textsf{Textures} backend \\
unicode            &                        & Unicode encoded pdf strings \\
urlbordercolor     & \textit{0 1 1}         & color of border around URL links \\
urlcolor           & \textit{magenta}       & color of URL links \\
verbose            & \textit{false}         & be chatty \\
vtex               &                        & use \textsf{VTeX} backend\\
\end{longtable}

\section{Additional user macros}

If you need to make references to URLs, or write explicit links, the
following low-level user macros are provided:

\begin{cmdsyntax}
\ci{href}\verb|{|\emph{URL}\verb|}{|\emph{text}\verb|}|
\end{cmdsyntax}

\noindent The \emph{text} is made a hyperlink to the \emph{URL}; this
must be a full URL (relative to the base URL, if that is defined). The
special characters \# and \~{} do \emph{not} need to be escaped in any
way.

\begin{cmdsyntax}
\ci{url}\verb|{|\emph{URL}\verb|}|
\end{cmdsyntax}

\noindent Equivalent to
\ci{href}\verb|{|\emph{URL}\verb|}{|\emph{URL}\verb|}|.

\begin{cmdsyntax}
\ci{nolinkurl}\verb|{|\emph{URL}\verb|}|
\end{cmdsyntax}

\noindent Write \emph{URL} as plain text, without creating a hyperlink.

\begin{cmdsyntax}
\ci{hyperbaseurl}\verb|{|\emph{URL}\verb|}|
\end{cmdsyntax}

\noindent A base \emph{URL} is established, which is prepended to other
specified URLs, to make it easier to write portable documents.

\begin{cmdsyntax}
\ci{hyperimage}\verb|{|\emph{imageURL}\verb|}|
\end{cmdsyntax}

\noindent The image referenced by the \emph{URL} is inserted.

\begin{cmdsyntax}
\ci{hyperdef}\verb|{|\emph{category}\verb|}{|\emph{name}\verb|}{|\emph{text}\verb|}|
\end{cmdsyntax}

\noindent A target area of the document (the \emph{text}) is marked, and
given the name \emph{category.name}

\begin{cmdsyntax}
\ci{hyperref}\verb|{|\emph{URL}\verb|}{|\emph{category}\verb|}{|\emph{name}\verb|}{|\emph{text}\verb|}|
\end{cmdsyntax}

\noindent \emph{text} is made into a link to \emph{URL\#category.name}

\begin{cmdsyntax}
\ci{hyperlink}\verb|{|\emph{name}\verb|}{|\emph{text}\verb|}|
\end{cmdsyntax}
\begin{cmdsyntax}
\ci{hypertarget}\verb|{|\emph{name}\verb|}{|\emph{text}\verb|}|
\end{cmdsyntax}

\noindent A simple internal link is created with \verb|\hypertarget|,
with two parameters of an anchor \emph{name}, and anchor
\emph{text}. \verb|\hyperlink| has two arguments, the name of a
hypertext object defined somewhere by \verb|\hypertarget|, and the
\emph{text} which be used as the link on the page.

Note that in HTML parlance, the \verb|\hyperlink| command inserts a
notional \# in front of each link, making it relative to the current
testdocument; \verb|\href| expects a full URL.


\begin{cmdsyntax}
\ci{autoref}\verb|{|\emph{label}\verb|}|
\end{cmdsyntax}

This is a replacement for the usual \verb|\ref| command that places a
contextual label in front of the reference. This gives your users a
bigger target to click for hyperlinks (e.g.\ `section 2' instead of
merely the number `2').

The label is worked out from the context of the original \verb|\label|
command by \textsf{hyperref} by using the macros listed below (shown
with their default values). The macros can be redefined in documents
using \verb|\renewcommand|; note that some of these macros are already
defined in the standard document classes. The mixture of lowercase and
uppercase initial letters is deliberate and corresponds to the author's
practice.

For each macro below, \textsf{hyperref} checks \ci{*autorefname} before
\ci{*name}.  For instance, it looks for \ci{figureautorefname} before
\ci{figurename}.

\noindent\begin{longtable}{lp{10cm}}
\textit{Macro}         & \textit{Default} \\
\ci{figurename}        & Figure \\
\ci{tablename}         & Table \\
\ci{partname}          & Part \\
\ci{appendixname}      & Appendix \\
\ci{equationname}      & Equation \\
\ci{Itemname}          & item \\
\ci{Chaptername}       & chapter \\
\ci{sectionname}       & section \\
\ci{subsectionname}    & subsection \\
\ci{subsubsectionname} & subsubsection \\
\ci{paragraphname}     & paragraph \\
\ci{Hfootnotename}     & footnote \\
\ci{AMSname}           & Equation \\
\ci{theoremname}       & Theorem
\end{longtable}

For instances where you want a reference to use the correct counter, but
not to create a link, there are two starred forms:

\begin{cmdsyntax}
\ci{ref*}\verb|{|\emph{label}\verb|}|
\end{cmdsyntax}

\begin{cmdsyntax}
\ci{pageref*}\verb|{|\emph{label}\verb|}|
\end{cmdsyntax}

A typical use would be to write
\begin{verbatim}
\hyperref[other]{that nice section (\ref*{other}) we read before}
\end{verbatim}

We want \verb|\ref*{other}| to generate the correct number, but not to
form a link, since we do this ourselves with \ci{hyperref}.

\begin{cmdsyntax}
\ci{pdfstringdef}\verb|{|\emph{macroname}\verb|}{|\emph{\TeX string}\verb|}|
\end{cmdsyntax}

\ci{pdfstringdef} returns a macro containing the PDF string. (Currently
this is done globally, but do not rely on it.) All the following tasks,
definitions and redefinitions are made in a group to keep them local:

\begin{itemize}
\item Switching to PD1 or PU encoding
\item Defining the \Quote{octal sequence commands} (\verb|\345|): \verb|\edef\3{\string\3}|
\item Special glyphs of \TeX: \verb|\{|, \verb|\%|, \verb|\&|, \verb|\space|, \verb|\dots|, etc.
\item National glyphs (\textsf{german.sty}, \textsf{french.sty}, etc.)
\item Logos: \verb|\TeX|, \verb|\eTeX|, \verb|\MF|, etc.
\item Disabling commands that do not provide useful functionality in bookmarks:
\verb|\label|, \verb|\index|, \verb|\glossary|, \verb|\discretionary|, \verb|\def|, \verb|\let|, etc.
\item \LaTeX's font commands like \verb|\textbf|, etc.
\item Support for \verb|\xspace| provided by the \textsf{xspace} package
\end{itemize}

In addition, parentheses are protected to avoid the danger of unsafe
unbalanced parentheses in the PDF string. For further details, see Heiko
Oberdiek's Euro\TeX\ paper distributed with \textsf{hyperref}.


\subsection{Replacement macros}

\textsf{hyperref} takes the text for bookmarks from the arguments of
commands like \ci{section}, which can contain things like math, colors,
or font changes, none of which will display in bookmarks as is.

\begin{cmdsyntax}
\ci{texorpdfstring}\verb|{|\emph{\TeX string}\verb|}{|\emph{PDFstring}\verb|}|
\end{cmdsyntax}

For example,
\begin{verbatim}
\section{Pythagoras:
\texorpdfstring{$ a^2 + b^2 = c^2 $}{%
a\texttwosuperior\ + b\texttwosuperior\ =
c\texttwosuperior}}
\section{\texorpdfstring{\textcolor{red}}{}{Red} Mars}
\end{verbatim}

\ci{pdfstringdef} executes the hook \pdfstringdefPreHook before it
expands the string. Therefore, you can use this hook to perform
additional tasks or to disable additional commands.

\begin{verbatim}
\expandafter\def\expandafter\pdfstringdefPreHook
\expandafter{%
\pdfstringdefPreHook
\renewcommand{\mycommand}[1]{}%
}
\end{verbatim}

However, for disabling commands, an easier way is via
\ci{pdfstringdefDisableCommands}, which adds its argument to the
definition of \ci{pdfstringdefPreHook} (`@' can here be used as letter in
command names):

\begin{verbatim}
\pdfstringdefDisableCommands{%
\let~\textasciitilde
\def\url{\pdfstringdefwarn\url}%
\let\textcolor\@gobble
}
\end{verbatim}


\section{Acrobat-specific behavior}
If you want to access the menu options of Acrobat Reader or Exchange, the following
macro is provided in the appropriate drivers:

\begin{cmdsyntax}
\ci{Acrobatmenu}\verb|{|\emph{menuoption}\verb|}{|\emph{text}\verb|}|
\end{cmdsyntax}

\noindent The \emph{text} is used to create a button which activates the appropriate \emph{menuoption}. The following table lists the option names you can use---comparison of this with the menus in Acrobat Reader or Exchange will show what they do. Obviously some are only appropriate to Exchange.

\medskip
\noindent\begin{longtable}{lp{9cm}}
File                          & Open, Close, Scan, Save, SaveAs, Optimizer:SaveAsOpt, Print, PageSetup, Quit \\
File$\rightarrow$Import       & ImportImage, ImportNotes, AcroForm:ImportFDF \\
File$\rightarrow$Export       & ExportNotes, AcroForm:ExportFDF \\
File$\rightarrow$DocumentInfo & GeneralInfo, OpenInfo, FontsInfo, SecurityInfo, Weblink:Base, AutoIndex:DocInfo \\
File$\rightarrow$Preferences  & GeneralPrefs, NotePrefs, FullScreenPrefs, Weblink:Prefs, AcroSearch:Preferences(Windows)
                                or, AcroSearch:Prefs(Mac), Cpt:Capture \\
Edit                          & Undo, Cut, Copy, Paste, Clear, SelectAll, Ole:CopyFile, TouchUp:TextAttributes,
                                TouchUp:FitTextToSelection, TouchUp:ShowLineMarkers, TouchUp:ShowCaptureSuspects,
                                TouchUp:FindSuspect, \\
                              & Properties \\
Edit$\rightarrow$Fields       & AcroForm:Duplicate, AcroForm:TabOrder \\
Document                      & Cpt:CapturePages, AcroForm:Actions, CropPages, RotatePages, InsertPages, ExtractPages,
                                ReplacePages, DeletePages, NewBookmark, SetBookmarkDest, CreateAllThumbs,
                                DeleteAllThumbs \\
View                          & ActualSize, FitVisible, FitWidth, FitPage, ZoomTo, FullScreen, FirstPage, PrevPage,
                                NextPage, LastPage, GoToPage, GoBack, GoForward, SinglePage, OneColumn, TwoColumns,
                                ArticleThreads, PageOnly, ShowBookmarks, ShowThumbs \\
Tools                         & Hand, ZoomIn, ZoomOut, SelectText, SelectGraphics, Note, Link, Thread, AcroForm:Tool,
                                Acro\_Movie:MoviePlayer, TouchUp:TextTool, Find, FindAgain, FindNextNote,
                                CreateNotesFile \\
Tools$\rightarrow$Search      & AcroSrch:Query, AcroSrch:Indexes, AcroSrch:Results, AcroSrch:Assist, AcroSrch:PrevDoc,
                                AcroSrch:PrevHit, AcroSrch:NextHit, AcroSrch:NextDoc \\
Window                        & ShowHideToolBar, ShowHideMenuBar, ShowHideClipboard, Cascade, TileHorizontal,
                                TileVertical, CloseAll \\
Help                          & HelpUserGuide, HelpTutorial, HelpExchange, HelpScan, HelpCapture, HelpPDFWriter,
                                HelpDistiller, HelpSearch, HelpCatalog, HelpReader, Weblink:Home \\
Help(Windows)                 & About
\end{longtable}

\section{PDF and HTML forms}
You must put your fields inside a \texttt{Form} environment (only one per file).