DocBook 5: The Definitive Guide

Name

BiblioSet -- A "raw" container for related bibliographic information

Synopsis

Content Model

BiblioSet ::= ((Abbrev|Abstract|Address|ArtPageNums|Author|AuthorGroup| AuthorInitials|BiblioMisc|BiblioSet|Collab|ConfGroup| ContractNum|ContractSponsor|Copyright|CorpAuthor|CorpName|Date| Edition|Editor|InvPartNumber|ISBN|ISSN|IssueNum|OrgName| OtherCredit|PageNums|PrintHistory|ProductName|ProductNumber| PubDate|Publisher|PublisherName|PubsNumber|ReleaseInfo| RevHistory|SeriesVolNums|Subtitle|Title|TitleAbbrev|VolumeNum| CiteTitle|Honorific|FirstName|Surname|Lineage|OtherName| Affiliation|AuthorBlurb|Contrib|IndexTerm)+)

Attributes

Common attributes

Tag Minimization

Both the start- and end-tags are required for this element.

Parameter Entities

Description

BiblioSet is a "raw" wrapper for a collection of bibliographic information.

The purpose of this wrapper is to assert the relationship that binds the collection. For example, in a BiblioEntry for an article in a journal, you might use two BiblioSets to wrap the fields related to the article and the fields related to the journal.

Processing expectations

Formatted as a displayed block.

BiblioSets are "raw." They contain a database-like collection of named fields. It is the responsibility of the processing system to select elements from within a BiblioSet, present them in the correct order, and add all punctuation.

There is no expectation that a system will present all of the fields in a BiblioSet or that they will be displayed in the order in which they occur.

Correct formatting of BiblioSets is an interchange issue. See Appendix F.

 Future Changes

AuthorBlurb and Affiliation will be removed from the inline content of BiblioSet in DocBook V4.0. A new wrapper element will be created to associate this information with authors, editors, and other contributors.

Parents

These elements contain BiblioSet: ArtHeader, BiblioEntry, BiblioMixed, BiblioMSet, BiblioSet, BookBiblio, BookInfo, DocInfo, ObjectInfo, RefSect1Info, RefSect2Info, RefSect3Info, RefSynopsisDivInfo, Sect1Info, Sect2Info, Sect3Info, Sect4Info, Sect5Info, SectionInfo, SeriesInfo, SetInfo.

Children

The following elements occur in BiblioSet: Abbrev, Abstract, Address, Affiliation, ArtPageNums, Author, AuthorBlurb, AuthorGroup, AuthorInitials, BiblioMisc, BiblioSet, CiteTitle, Collab, ConfGroup, ContractNum, ContractSponsor, Contrib, Copyright, CorpAuthor, CorpName, Date, Edition, Editor, FirstName, Honorific, IndexTerm, InvPartNumber, ISBN, ISSN, IssueNum, Lineage, OrgName, OtherCredit, OtherName, PageNums, PrintHistory, ProductName, ProductNumber, PubDate, Publisher, PublisherName, PubsNumber, ReleaseInfo, RevHistory, SeriesVolNums, Subtitle, Surname, Title, TitleAbbrev, VolumeNum.

In some contexts, the following elements are excluded: IndexTerm.

Attributes

Relation

Relation identifies the relationship between the of the contents of the BiblioSet.

See Also

BiblioEntry, BiblioMisc, BiblioMixed, BiblioMSet, BookBiblio

Examples

<!DOCTYPE biblioentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <biblioentry> <abbrev>Walsh97</abbrev> <biblioset relation=journal> <title>XML: Principles, Tools, and Techniques</title> <publisher> <publishername>O'Reilly &amp; Associates, Inc.</publishername> </publisher> <issn>1085-2301</issn> <editor><firstname>Dan</firstname><surname>Connolly</surname></editor> </biblioset> <biblioset relation=article> <title>A Guide to XML</title> <author><surname>Walsh</surname><firstname>Norman</firstname></author> <copyright><year>1997</year><holder>ArborText, Inc.</holder></copyright> <pagenums>97-108</pagenums> </biblioset> </biblioentry>

For additional examples, see also Bibliography.

Back to: DocBook: The Definitive Guide