(eplain.info)Link types for pdftex and dvipdfm

---

Next: Link options for pdftex and dvipdfm Prev: Destination options for pdftex and dvipdfm Up: Hyperlink drivers pdftex and dvipdfm

---

Enter node , (file) or (file)node

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 (Note:
     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 (Note: 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'