07.01.2013 Views

Hypertext marks in LaTeX: a manual for hyperref - TUG

Hypertext marks in LaTeX: a manual for hyperref - TUG

Hypertext marks in LaTeX: a manual for hyperref - TUG

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

7 DEFINING A NEW DRIVER 24<br />

the value is a character or \d<strong>in</strong>g{number},<br />

see package pifont from bundle psnfss<br />

readonly boolean false field is readonly<br />

rotation number 0 rotation of the widget annotation<br />

(degree, counterclockwise, multiple of 90)<br />

tabkey (as per HTML)<br />

validate JavaScript code to validate the entry<br />

value <strong>in</strong>itial value<br />

width dimen width of field box<br />

7 Def<strong>in</strong><strong>in</strong>g a new driver<br />

A <strong>hyperref</strong> driver has to provide def<strong>in</strong>itions <strong>for</strong> eight macros:<br />

1. \hyper@anchor<br />

2. \hyper@l<strong>in</strong>k<br />

3. \hyper@l<strong>in</strong>kfile<br />

4. \hyper@l<strong>in</strong>kurl<br />

5. \hyper@anchorstart<br />

6. \hyper@anchorend<br />

7. \hyper@l<strong>in</strong>kstart<br />

8. \hyper@l<strong>in</strong>kend<br />

The draft option def<strong>in</strong>es the macros as follows<br />

\let\hyper@@anchor\@gobble<br />

\gdef\hyper@l<strong>in</strong>k##1##2##3{##3}%<br />

\def\hyper@l<strong>in</strong>kurl##1##2{##1}%<br />

\def\hyper@l<strong>in</strong>kfile##1##2##3{##1}%<br />

\let\hyper@anchorstart\@gobble<br />

\let\hyper@anchorend\@empty<br />

\let\hyper@l<strong>in</strong>kstart\@gobbletwo<br />

\let\hyper@l<strong>in</strong>kend\@empty<br />

8 Special support <strong>for</strong> other packages<br />

Package <strong>hyperref</strong> aims to cooperate with other packages, but there are several possible sources <strong>for</strong><br />

conflict, such as<br />

• Packages that manipulate the bibliographic mechanism. Peter William’s harvard package is<br />

supported. However, the recommended package is Patrick Daly’s natbib package that has<br />

specific <strong>hyperref</strong> hooks to allow reliable <strong>in</strong>teraction. This package covers a very wide variety<br />

of layouts and citation styles, all of which work with <strong>hyperref</strong>.<br />

• Packages that typeset the contents of the \label and \ref macros, such as showkeys. S<strong>in</strong>ce the<br />

<strong>hyperref</strong> package redef<strong>in</strong>es these commands, you must set implicit=false <strong>for</strong> these packages<br />

to work.<br />

• Packages that do anyth<strong>in</strong>g serious with the <strong>in</strong>dex.<br />

The <strong>hyperref</strong> package is distributed with variants on two useful packages designed to work<br />

especially well with it. These are xr and m<strong>in</strong>itoc, which support crossdocument l<strong>in</strong>ks us<strong>in</strong>g L ATEX’s<br />

normal \label/\ref mechanisms and per-chapter tables of contents, respectively.

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!