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>