(eplain.info)General hyperlinks

---

Next: URL hyperlinks Up: Implicit hyperlinks

---

Enter node , (file) or (file)node

5.3.1 General hyperlinks: hrefint, hrefext
------------------------------------------

'\href{URL}{TEXT}' typesets TEXT as a link to URL. It basically does
what the explicit hyperlink macros do (Note: Explicit hyperlinks), but
is more convenient (at the expense of flexibility).

   If URL starts with '#', the rest of URL is assumed to be a local
hyperlink destination name (destination within the same document).
Parameters for these links can be set by customizing the 'hrefint'
linkgroup. For example:

     See \href{#intro}{Introduction}

will make 'Introduction' into an internal link, which might have been
created, e.g., with '\xrdef{intro}'.

   If URL does not start with '#', it is assumed to be a URL link.
Parameters for these links can be set by customizing the 'hrefext'
linkgroup. The special characters (such as '#' and '~') in the URL don't
need to be escaped. For example:

     \href{http://tug.org/eplain/doc/eplain.html#Hyperlinks}{Hyperlinks
       in Eplain}
     \href{mailto:tex-eplain@tug.org}{Eplain mailing list}

Note: URL hyperlinks, for another way to create URL hyperlinks.

   The TEXT argument of '\href' can contain verbatim text (Note:
Verbatim listing) or other macros which manipulate character catcodes.
For example:

     \href{#WeirdChars}{The weird chars \verbatim #&%$~|endverbatim}

   '\href' does not currently handle other link types, such as 'file:'
and 'run:' links.