7.2.6. The hyperref package

The hyperref package by Sebastian Rahtz und Heiko Oberdiek expands the cross-referencing capabilities of LaTeX introducing \special commands that can be interpreted by a driver (like pdfjadetex) to produce hypertext links to places in the same document (cross-references), other PDF documents, or even WWW pages.

We pass options to the hyperref package in the jadetex.cfg configuration file. Either the classic \usepackage, or the new \ hypersetup command can be used for this purpose. I use the latter. If you use the \ usepackage method, you should always specify the driver like in

\usepackage[pdftex]{hyperref}

In addition to the base URL, author, title, subject and keywords (which you have already set up correctly in Section 4.4), there are a lot of other options that can be set in jadetex.cfg (see Erstellung von pdf-Dokumenten mit LaTeX (in german) ):

• open settings:

  • pdfpagemode: Determines how the document will open in Acrobat®. If no mode is explicitly chosen, but the bookmarks option is set, UseOutlines is used.

    • None

    • UseThumbs: show thumbnails.

    • UseOutlines: show bookmarks.

    • FullScreen

  • pdfstartpage: Determines on which page the PDF document is opened.

  • pdfstartview: FitB or FitH: Set the startup page view.

• paper size settings: The keywords for paper size may directly appear in the hypersetup command, since they are boolean variables. (draft=true is equivalent to draft.) . An overview of the possible settings is presented in Table 7-1.

  Table 7-1. Paper sizes with hyperref

  Paper size option	Meaning
  draft	all hypertext options are turned off
  debug	extra diagnostic messages are printed in the log file
  a4paper	210mm x 297mm
  a5paper	148mm x 210mm
  b5paper	176mm x 250mm
  letterpaper	8.5in x 11in
  legalpaper	8.5in x 14in
  executivepaper	7.25in x 10.5in

The breaklinks option enables breaking of long hypertext links across lines, the linktopage option has the effect that only the page number (and not the chapter/section text) links to the relevant chapter or section. All possible link colour options are shown in Table 7-2. The frenchlinks option differentiates links from the rest of the text not through colours, but through small caps instead.

See Erstellung von pdf-Dokumenten mit LaTeX for more PDF options.