<citation>

Citation Reference

A citation to an external source, either informal (inline) or by means of a cross-reference (to a Bibliographic Entry element).

Remarks

The preferred way to make a reference to a citation in the bibliography is with an ordinary Cross-Reference (<xref>) element. But this element, which is primarily included so that citations can be made in line (i.e., without a target in the bibliography), can also be used for the same purpose.

If a cross-reference is wanted, use the @linkend attribute. If the attribute is present, the text contents of the Citation Reference are ignored and the text displayed from the target Bibliographic Entry element (its @xreflabel). If no @linkend is given, no reference to the bibliography is made and the content of the Citation Reference is displayed.

If neither contents nor a @linkend is given, expect a warning flag in the output.

Attribute

linkend Linkend

Expanded Content Model

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

Description

Any combination of:

This element may be contained in:

<attribution>, <emphasis>, <mathphrase>, <para>, <quote>, <subscript>, <subtitle>, <superscript>, <td>, <term>, <th>, <title>

Example

<article xmlns="http://docbook.org/ns/docbook" version="5.0-subset Balisage-1.3"
  xml:id="HR-23632987-8973" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Raleigh's Discoveries in the New World</title>
  ...
  <appendix xml:id="mul83">
    <title>The First Expeditionary Force’s Colony, 1585-1586<footnote xml:id="mul5">
        <para>This Appendix contains an actual list of the individuals who sailed to the Roanoke
          Colony in 1585. (<emphasis role="ital">See</emphasis>
          <citation>Durant, David N., “Raleigh’s Lost Colony”, Appendix I, Atheneum, NY:
            1981.</citation>)</para>
      </footnote>
    </title>
    <itemizedlist>
      <listitem>
        <para>Master Philip Amades, Admirall of the countrie</para>
      </listitem>
      <listitem>
        <para>Master Hariot</para>
      </listitem>
      ...
    </itemizedlist>
  </appendix>
  <appendix xml:id="mul88">
    ...
  </appendix>
  <bibliography>
    ...
  </bibliography>
</article>

Module

balisage-1-3.dtd