article

article — An article.

Synopsis

article ::= [-]

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • At most one of:
    • class (enumeration)
      • “faq”
      • “journalarticle”
      • “productsheet”
      • “specification”
      • “techreport”
      • “whitepaper”
    • All or none of:
      • class (enumeration)
        • “other”
      • otherclass (NMTOKEN)
  • 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

otherclass

Identifies the nature of the non-standard article

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>
Last revised by Norman Walsh on (git hash: c3457cab689d8fd89ba4252de204cf9a14e40acd 6a501344525f32f9834f0e4a5c3c3f8131803fa4 47fe34b28bad7941a61b9c1c17d47f6eed36cd04)