Chapter 8. Example Document Structures

For any particular citation, the basic principle for deciding the appropriate bibliography to insert the associated biblioentry data into and then to link to, is that it will the first bibliography child of its closest ancestor. The following examples should therefore demonstrate plausible DocBook document structures where RefDB-lite would operate in a perfectly logical and consistent manner.

Example 8.1. A perfectly valid book

    <book>
      <chapter>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
        <bibliography id="bib1"/>
      </chapter>
      <chapter>
        <para><citation/></para> <!-- definitely pointing to bib2 -->
        <bibliography id="bib2"/>
      </chapter>
      <appendix>
        <para><citation/></para> <!-- definitely pointing to bib3 -->
        <bibliography id="bib3"/>
      </appendix>
    </book>

Example 8.2. Another perfectly valid book

    <book>
      <chapter>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </chapter>
      <chapter>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </chapter>
      <appendix>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </appendix>
      <bibliography id="bib1"/>
    </book>

Example 8.3. A third perfectly valid book

    <book>
      <bibliography id="bib1"/>
      <chapter>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </chapter>
      <chapter>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </chapter>
      <appendix>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </appendix>
    </book>

Example 8.4. A perfectly valid part

    <part>
      <chapter>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </chapter>
      <chapter>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </chapter>
      <bibliography id="bib1"/>
      <appendix>
        <para><citation/></para> <!-- definitely pointing to bib2 -->
        <bibliography id="bib2"/> <!-- but if bib2 was missing, then also to bib1 -->
      </appendix>
    </part>

Example 8.5. A perfectly valid article

    <article>
      <section>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </section>
      <section>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </section>
      <appendix>
        <para><citation/></para> <!-- definitely pointing to bib1 -->
      </appendix>
      <bibliography id="bib1"/>
    </part>

Example 8.6. A wierd concoction that should still be valid

    <article>
      <articleinfo>
        <para><!-- a citation here would have no target bibliography --></para>
      </articleinfo>
      <section>
        <para><citation/></para> <!-- definitely pointing to bib3 -->
        <section>
          <para><citation/></para> <!-- definitely pointing to bib1 -->
          <bibliography id="bib1"/>
        </section>
        <section>
          <para><citation/></para> <!-- definitely pointing to bib2 -->
          <bibliography id="bib2"/>
        </section>
        <section>
          <para><citation/></para> <!-- definitely pointing to bib3 -->
        </section>
        <section>
          <para><citation/></para> <!-- definitely pointing to bib3 -->
        </section>
        <bibliography id="bib3"/>
      </section>
    </part>