<!DOCTYPE book PUBLIC "-//Markus Hoenicka//DTD DocBook XML V4.1.2 extended citations//EN" "http://foo/bar/docbookxxc.dtd">
<book>
  <title>The Example Book</title>
  <chapter>
    <title>First chapter</title>
    <section>
      <title>Citation and Biblioref Elements</title>
      <para>First we have a simple citation <citation><biblioref
      linkend="Smith1999a"/></citation>. As we don't use the renderas attribute we expect this to be rendered as a full citation.</para>
      <para>Next we have a sentence that contains a <quote>quote with
      a page number attached <citation><biblioref linkend="Jones2000a"
      unit="page" start="33"/></citation>.</quote></para>
      <para>Now we make use of the rendereras attribute. According to
      <xref linkend="Jones2002a" xrefstyle="author"/> <citation renderas="year"><biblioref linkend="Jones2002a"/></citation> this is going to work somehow.</para>
      <para>Here we have an extreme case, that is nevertheless fairly
      common. In the author-date in-text style, we want output
      rendering something like (1999; see also Smith 2000; Doe
      2002). In essence, the first reference is the primary reference,
      while the two following the "see also" caption are grouped at a
      second order. The only way to properly code this structurally is
      to include a citation within another citation
      <citation>
	<biblioref renderas="year" linkend="Jones1999a"/>
	<citation caption="see also ">
	  <biblioref linkend="Smith2000a"/>
	  <biblioref linkend="Doe2002b"/>
	</citation>
      </citation>.</para>
    </section>
    <section>
      <title>Quotes and Blockquotes</title>
      <para>We also want to be able to embed citations within the
      quote, blockquote, and epigraph elements. For example, According
      to Jane Doe, <quote>the earth is flat <citation>
      <biblioref linkend="Doe2000a" renderas="year" unit="page" start="56"/>
      </citation></quote></para>
    </section>
  </chapter>
</book>
