DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

article

article — An article.

Synopsis

article ::= [-]

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • class (enumeration)
    • “faq”
    • “journalarticle”
    • “productsheet”
    • “specification”
    • “techreport”
    • “whitepaper”
  • label
  • status

Additional Constraints

  • If this element is the root element, it must have a version attribute.

Description

The article element is a general-purpose container for articles. The content model is both quite complex and rather loose in order to accommodate the wide range of possible article structures. Although changes to the article element have been discussed on several occasions, no better model has been presented.

An article may include a table of contents and multiple lists of tables, figures, and so on before the main text of the article. It may also include a number of common back matter components at the end.

Processing expectations

Formatted as a displayed block. Frequently causes a forced page break in print media. May be numbered separately and presented in the table of contents.

Attributes

Common attributes and common linking attributes.

class

Identifies the nature of the article

Enumerated values:
“faq”

A collection of frequently asked questions.

“journalarticle”

An article in a journal or other periodical.

“productsheet”

A description of a product.

“specification”

A specification.

“techreport”

A technical report.

“whitepaper”

A white paper.

label

Specifies an identifying string for presentation purposes

status

Identifies the editorial or publication status of the element on which it occurs

Parents

These elements contain article: book, part, set.

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<info>
  <title>A World Wide Web Interface to CTAN</title>
  <titleabbrev>CTAN-Web</titleabbrev>
  <author><personname>
    <firstname>Norman</firstname><surname>Walsh</surname>
  </personname></author>
  <authorinitials>ndw</authorinitials>
  <artpagenums>339-343</artpagenums>
  <volumenum>15</volumenum>
  <issuenum>3</issuenum>
  <publisher><publishername>The TeX User's Group</publishername></publisher>
  <pubdate>1994</pubdate>
  <revhistory>
     <revision>
        <revnumber>1.0</revnumber>
        <date>1994-03-28</date>
        <revremark>Submitted.</revremark>
     </revision>
     <revision>
        <revnumber>0.5</revnumber>
        <date>1994-02-15</date>
        <revremark>First draft for review.</revremark>
     </revision>
  </revhistory>
</info>

<para>The body of the article …</para>

</article>