OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Subject: DOCBOOK: Markup for bibliography and citation


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>



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [Elist Home]


Powered by eList eXpress LLC