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

  • 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 is composed of a header and a body. The body may include a table of contents and multiple lists of tables, figures, and so on, before the main text of the article and may include a number of common end-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.

See Also

appendix, book, chapter, colophon, dedication, part, partintro, preface, 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>

ChangeLog

This alpha reference page is $Revision: 7120 $ published Sun, 22 Jul 2007.