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: 4460ecff4b65268b558037cbda9fadcfb9e3e09a 7c5a17532e372309975fdbdf572c92cf383a8b5d d8336abc499f0c937e6dbe0a81964bf398e6987d)