A hypertext link. Either @linkend is used for an internal link, or @xlink:href is used for an external link. Expect an error if both are used.


With @linkend, this element is an alternative to Cross-Reference for internal cross-references, when the linking text (anchor) is not to be generated or acquired from the target element of the reference, but instead taken from the element contents (like an HTML-style anchor).

If neither @linkend nor @xlink:href is used, the text content of the element itself is promoted to serve as the link target.

XLink attributes on this element are hard-coded to specify a simple link to an external resource.


linkend Linkend
xlink:actuate Actuating a Link
xlink:href Href (Linking Mechanism)
xlink:show Showing a Link
xlink:title Title of a Link
xlink:type Type of Link

Expanded Content Model

(#PCDATA | emphasis | trademark | code | superscript | subscript | quote)*


Any combination of:

This element may be contained in:

<attribution>, <author>, <bibliomixed>, <emphasis>, <jobtitle>, <mathphrase>, <orgname>, <para>, <quote>, <subscript>, <subtitle>, <superscript>, <td>, <term>, <th>, <title>, <trademark>


Ordinarily, a link carries an @xlink:href to indicate the resource to be linked:

<para>The <link xlink:href="http://www.balisage.net">Balisage</link> conference has
  been held since 2008...</para>

Sometimes it may be convenient to omit the @xlink:href and allow the contents of the element to be promoted to serve as the destination of the link:

<article xmlns="http://docbook.org/ns/docbook" version="5.0-subset Balisage-1.3"
  <title>Raleigh's Discoveries in the New World</title>
  <appendix xml:id="mul88">

    <bibliomixed xml:id="mul98" xreflabel="Prindle 1996b">Prindle, Tara. “Native American History of
      Corn”. [online]. Native American Technology and Art. © 1996 [cited 14 Apr 1998].

    <bibliomixed xml:id="mul99" xreflabel="Dickerson 1997">Dickerson, George. “Beyond Turkey: Corn
      Shaped History, Cuisines”. [online]. Ed. D’Lyn Ford. New Mexico State University College of
      Agriculture &amp; Home Economics, 11 Nov 1997 [cited 14 Apr 1998].