article

article — An article.

Synopsis

Attributes

Common attributes and common linking attributes.

Additional attributes:

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

Additional Constraints

  • The root element 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.

Children [+]

This element contains 75 elements.

Examples

  1 <article xmlns='http://docbook.org/ns/docbook'>
  2 <info>
      <title>A World Wide Web Interface to CTAN</title>
  4   <titleabbrev>CTAN-Web</titleabbrev>
      <author><personname>
  6     <firstname>Norman</firstname><surname>Walsh</surname>
      </personname></author>
  8   <authorinitials>ndw</authorinitials>
      <artpagenums>339-343</artpagenums>
 10   <volumenum>15</volumenum>
      <issuenum>3</issuenum>
 12   <publisher><publishername>The TeX User's Group</publishername></publisher>
      <pubdate>1994</pubdate>
 14   <revhistory>
         <revision>
 16         <revnumber>1.0</revnumber>
            <date>1994-03-28</date>
 18         <revremark>Submitted.</revremark>
         </revision>
 20      <revision>
            <revnumber>0.5</revnumber>
 22         <date>1994-02-15</date>
            <revremark>First draft for review.</revremark>
 24      </revision>
      </revhistory>
 26 </info>
    
 28 <para>The body of the article …</para>
    
 30 </article>
Last revised by Norman Walsh on 6 Jun 2011 (git hash: 6ffcc7640bbc5f852a318e452c9f210f03292cb9)