This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Markup for bibliography and citation
- To: docbook at lists dot oasis-open dot org
- Subject: DOCBOOK: Markup for bibliography and citation
- From: "M. Wroth" <mark at astrid dot upland dot ca dot us>
- Date: Sun, 22 Jul 2001 10:00:23 -0700
I've been having trouble getting what I would consider correct output
from several elements related to bibliography and citation, and I believe
the issue is that I don't really understand how to use the relevant
DocBook markup.
The basic issue is that I have a <bibliography>, composed of a
number of <bibliographyelements>. In the text of the document
(which is an <article>, if that's significant), I want to refer to
specific locations within the cited work. My processing expectation for
this would be something like
- We can see from this example (Roesdahl, figure 27) that the use of
morticed backs...
although I'm not hung up on details.
<xref> by itself does not seem to have any place to provide
the specific location, so my immediate inclination is to use something
like
- We can see from this example <citation><xref
linkend-"roesdahl">, figure 27</citation> that the use
of morticed backs...
Given the style sheets I'm using (which include some customization),
this is not producing what I expect. Before I start mucking with
the customization layer, I would like to be sure I understand the
underlying markup correctly. Is this the right markup for this
situation?
The second issue is the markup of some of the bibliography
elements; specifically, I have a book that has a single author, but
credits the illustrator as well. My first cut at the markup looked
like this
<biblioentry id="simpson">
<authorgroup>
<author>
<firstname>Jacqueline</firstname>
<surname>Simpson</surname>
</author>
<othercredit>
<contrib>Drawings by</contrib>
<firstname>Eva</firstname>
<surname>Wilson</surname>
<contrib>Drawings</contrib>
</othercredit>
</authorgroup>
<title>Everyday Life in the Viking
Age</title>
<publisher>
<publishername>Dorset</publishername>
<address>New
York</address>
</publisher>
<pubdate>1967</pubdate>
</biblioentry>
However, the author/illustrator pair is coming out oddly; by changing the
first part of the bibliographyentry to
<biblioentry id="simpson">
<author>
<firstname>Jacqueline</firstname>
<surname>Simpson</surname>
</author>
<authorgroup>
<othercredit>
<contrib>Drawings by</contrib>
<firstname>Eva</firstname>
<surname>Wilson</surname>
<contrib>Drawings</contrib>
</othercredit>
</authorgroup>
<title>Everyday Life in the Viking
Age</title>
<publisher>
<publishername>Dorset</publishername>
<address>New
York</address>
</publisher>
<pubdate>1967</pubdate>
</biblioentry>
(that is, moving the primary author out of the authorgroup), I get an
output that seems reasonable. Is this what is expected?
The markup is DocBook 4.1.
Mark B. Wroth
<mark@astrid.upland.ca.us>