Guide to the DocBook DTD
PrevNext

Article

Name

Article — Article

Content Model

  (ArtHeader, ToCchap?, LoT*, (((CalloutList | GlossList
  | ItemizedList | OrderedList | SegmentedList | SimpleList
  | VariableList | Caution | Important | Note | Tip | Warning
  | LiteralLayout | ProgramListing | ProgramListingCO
  | Screen | ScreenCO | ScreenShot | Synopsis | CmdSynopsis
  | FuncSynopsis | FormalPara | Para | SimPara | Address
  | BlockQuote | Graphic | GraphicCO | InformalEquation
  | InformalExample | InformalTable | Equation | Example
  | Figure | Table | MsgSet | Procedure | Sidebar | Anchor
  | BridgeHead | Comment | Highlights | Abstract
  | AuthorBlurb | Epigraph)+, (Sect1* | (RefEntry)*
  | SimpleSect*)) | (Sect1+ | (RefEntry)+ | SimpleSect+))
  , ((ToC | LoT | Index | Glossary | Bibliography) | (Appendix)
  | Ackno)*)+
  (IndexTerm | BeginPage)

Inclusions

Article includes these elements at every level:

  IndexTerm | BeginPage

Attributes

This element has common and Role attributes.

NameValue(s)TypeDefault Value
Class(JournalArticle |ProductSheet |WhitePaper |TechReport)#IMPLIED 
ParentBookIDREF#IMPLIED 
StatusCDATA#IMPLIED 

Tag Minimization

The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.

Description

An article, broadly construed. Book may be used to hold a collection of Articles. An Article has, in order, a required ArtHeader, main contents as for Chapter, then any number of Indexes, Glossaries, Bibliographies, Appendixes and Acknos, in any order. Article has Class, ParentBook, Status, and common attributes. Class indicates the type of a particular article, which may be JournalArticle, ProductSheet, WhitePaper, or TechReport. All articles have the same structure and general purpose; there is no default for Class.

Parents

These elements contain Article: Book, Part.

Children

Article contains these elements: Abstract, Ackno, Address, Anchor, Appendix, ArtHeader, AuthorBlurb, BeginPage, Bibliography, BlockQuote, BridgeHead, CalloutList, Caution, CmdSynopsis, Comment, Epigraph, Equation, Example, Figure, FormalPara, FuncSynopsis, GlossList, Glossary, Graphic, GraphicCO, Highlights, Important, Index, IndexTerm, InformalEquation, InformalExample, InformalTable, ItemizedList, LiteralLayout, LoT, MsgSet, Note, OrderedList, Para, Procedure, ProgramListing, ProgramListingCO, RefEntry, Screen, ScreenCO, ScreenShot, Sect1, SegmentedList, Sidebar, SimPara, SimpleList, SimpleSect, Synopsis, Table, Tip, ToC, ToCchap, VariableList, Warning.

In some contexts, additional elements may be allowed by inclusions in parent elements.

Attributes

Class

Class indicates the type of a particular article; there is no default.

ParentBook

ParentBook is the ID of the enclosing Book.

Status

Editorial or publication status ofthe element it applies to, such as "in review" or "approved for distribution." There is no default.

Examples

<ARTICLE>
<ARTHEADER>
<TITLE>HTML</TITLE>
<AUTHORGROUP>
<AUTHOR>
<FIRSTNAME>Terry</FIRSTNAME>
<SURNAME>Allen</SURNAME>
</AUTHOR>
</AUTHORGROUP>
<BOOKBIBLIO>
<TITLE>Online Publishing Report, April 1996</TITLE>
<AUTHORGROUP>
<AUTHOR>
<FIRSTNAME>Terry</FIRSTNAME>
<SURNAME>Allen</SURNAME>
</AUTHOR>
</AUTHORGROUP>
<ISSN>1087-4216</ISSN>
<VOLUMENUM>1</VOLUMENUM>
<ISSUENUM>4</ISSUENUM>
<PAGENUMS>25-32</PAGENUMS>
</BOOKBIBLIO>
<ARTPAGENUMS>1, 3-4</ARTPAGENUMS>
</ARTHEADER>
<PARA>If this were really an article, the content would be here.
</PARA>
<ACKNO>Thanks to everyone who made this short article possible.
</ACKNO>
</ARTICLE>

PrevHomeNext
ArtHeaderUpArtPageNums