5.4.3.3 Link types for pdftex and dvipdfm

Link types are the same for the pdftex and dvipdfm drivers, except that the pdftex driver provides one additional link type num (link to a numbered destination). dvipdfm does not support numbered destinations, therefore it does not have this link type. Note that all destinations created by Eplain hyperlink macros are named destinations; to define a numbered destination, you have to use low-level pdfTeX commands.

Common link types

name

Go to a “named destination”. The label is the destination name. All destinations created with \hldest are named destinations (see Explicit hyperlinks). This is the default type.

Example: \hlstart{name}{}{dest123}Link to dest123\hlend

url

Go to a URL. The label is the URL.

Example: \hlstart{url}{}{http://tug.org/eplain/}Eplain home\hlend

page

Go to a page. The label is the page number (counting from 1). Page fitting is specified by the pagefit option.

Example:

          \hlstart{page}{pagefit=/FitH 600}{123}
            Link to page~123\hlend

filename

Go to a named destination in another file. The label is the destination name. The file name is specified by the file option. Page fitting is specified by the pagefit option. The newwin option specifies whether the destination document is opened in the same window or in a new window.

Example:

          \hlstart{filename}{file=book.pdf,newwin=1}{dest123}
            Link to dest123 in file `book.pdf'\hlend

filepage

Go to a page in another file. The label is the page number (counting from 1). The file name is specified by the file option. Page fitting is specified by the pagefit option. The newwin option specifies whether the destination document is opened in the same window or in a new window.

Example:

          \hlstart{filepage}{file=book.pdf,newwin=,
                             pagefit=/FitR 50 100 300 500}{1}
            Link to page~1 in file `book.pdf'\hlend

raw

The link specification (in the form of a pdfTeX command or a dvipdfm \special primitive) is taken from the command sequence \cs, where cs is the value of the cmd option. In the definition of \cs, use \@hllabel to refer to the hyperlink label. This option is intended to be used with linkgroups (see Setting hyperlink types and options), as it does not make sense in a direct call to \hlstart—you can just call the raw command.

Example for pdftex:

          % Redirect all \url links to the first page
          \def\mycmd{\pdfstartlink goto page 1 {/Fit}}
          \hltype[url]{raw}
          \hlopts[url]{cmd=mycmd}

Example for dvipdfm:

          % Redirect all \url links to the first page
          \def\mycmd{\special{pdf: beginann <</Type/Annot /Subtype/Link
                                              /Dest[0 /Fit]>>}}
          \hltype[url]{raw}
          \hlopts[url]{cmd=mycmd}

pdftex-specific link types

num

Go to a “numbered destination”. The label is the destination number.

Example: \hlstart{num}{}{123}Link to 123\hlend