docbook-apps

  • 1.  Biblioentry markup standards -- identifying the type of entry

    Posted 06-10-2020 21:51
    I’m posting this to the DocBook mailing list, but double posting do DocBook-apps because the discussion started on that list.

    Background: I’ve been using bibliomixed for XML Press publications. I would like to move to using biblioentry, so I can cover more than one output style. We primarily use the Chicago Manual of Style as our guide, but I would like to be able to easily use other styles.

    My objective is to create (over time) customizations that would take a biblioentry in a consistent format and generate output that conforms to Chicago, APA, and other styles.

    As part of that effort, I decided first to look for and create test examples for a variety of cases and begin creating guidelines.

    This first issue I’ve uncovered is the question of how to identify what kind of entry an instance is (e.g., book, article, etc.).

    I can find no standard method for doing that in DocBook, including the Publisher’s schema..

    The ISO690 extension uses the role attribute on the biblioentry element.

    Certain types can be guessed at by looking at biblioset (if it’s used) or the pubwork attribute on citetitle (if citetitle is used rather than title).

    Both of these apply only if you use those elements. However, there are plenty of examples where biblioset is not needed and would just add complexity. And citetitle seems not to be the best choice for expressing a title in this context (especially if you want to separate out a subtitle).

    So, am I missing something here, or is there no standard method for defining the type of a biblioentry?

    If there isn’t an established method, does anyone have any ideas on how best to do this?

    Best regards,
    Dick Hamilton
    -------
    XML Press
    XML for Technical Communicators
    http://xmlpress.net
    hamilton@xmlpress.net






  • 2.  Re: [docbook-apps] Biblioentry markup standards -- identifying the type of entry

    Posted 06-11-2020 08:12
    Richard Hamilton <hamilton@xmlpress.net> writes:
    > I’m posting this to the DocBook mailing list, but double posting do
    > DocBook-apps because the discussion started on that list.
    >
    > Background: I’ve been using bibliomixed for XML Press publications. I
    > would like to move to using biblioentry, so I can cover more than one
    > output style. We primarily use the Chicago Manual of Style as our
    > guide, but I would like to be able to easily use other styles.

    The bibliography stuff is a bit of a mess. It was originally cribbed
    from the Majour[1] standard in the very early 90’s, I believe, on the
    assumption that reuse was better than reinvention. I’m not sure what
    happened to Majour after that.

    > My objective is to create (over time) customizations that would take a
    > biblioentry in a consistent format and generate output that conforms
    > to Chicago, APA, and other styles.

    I’m going to repeat myself and say that I think adopting a mechanism for
    generating them that reuses BibTeX or the open citation work I pointed
    to before or something else is better than one-offing it. There’s *A
    LOT* of variation in how citations are published.

    > This first issue I’ve uncovered is the question of how to identify
    > what kind of entry an instance is (e.g., book, article, etc.).
    >
    > I can find no standard method for doing that in DocBook, including the
    > Publisher’s schema..

    I think your best bet is:

    <biblioentry>
    <citetitle pubwork="book">DocBook: The Definitive Guide</citetitle>

    > Certain types can be guessed at by looking at biblioset (if it’s used)
    > or the pubwork attribute on citetitle (if citetitle is used rather
    > than title).

    I think the title in a bibliography entry is more semantically a title
    citation than a title, so that’s my preference anyway. (In DocBook, a


  • 3.  Re: [docbook-apps] Biblioentry markup standards -- identifying the type of entry

    Posted 06-11-2020 09:24
    (This will bounce for docbook@lists.oasis-open.org.)

    On 11/06/2020 09:12, Norman Tovey-Walsh wrote:
    > Richard Hamilton <hamilton@xmlpress.net> writes:
    ...
    >> Background: I’ve been using bibliomixed for XML Press publications. I
    >> would like to move to using biblioentry, so I can cover more than one
    >> output style. We primarily use the Chicago Manual of Style as our
    >> guide, but I would like to be able to easily use other styles.
    >
    > The bibliography stuff is a bit of a mess. It was originally cribbed
    > from the Majour[1] standard in the very early 90’s, I believe, on the

    It was, IIRC. Everybody cribbed from MAJOUR at the time.

    > assumption that reuse was better than reinvention. I’m not sure what
    > happened to Majour after that.

    I haven't thought about MAJOUR for decades. I probably saw the DTD, but
    I don't know that I ever saw that book.

    The CoverPages has a few articles about MAJOUR [2]. If you want to see
    the DTD (and you have a time machine), you can send an email to a server
    on the BITNET network and get back an email with a UUencoded PKZip file
    [3]. Sometimes the past really is a foreign country.

    Regards,


    Tony Graham.
    --
    Senior Architect
    XML Division
    Antenna House, Inc.
    ----
    Skerries, Ireland
    tgraham@antenna.co.jp

    > [1]
    https://www.abebooks.com/MAJOUR-DTD-Article-Headers-Modular-Application/3384898287/bd
    [2] https://duckduckgo.com/?t=palemoon&q=majour+site%3Acoverpages.org&ia=web
    [3] http://xml.coverpages.org/ews.html