article
article — An article.
Synopsis
article ::= ![[-]](figs/web/nav/down.gif)
![[+]](figs/web/nav/right.gif)
- Sequence of:
- One of:
- Zero or more of:
- One of:
- Sequence of:
- One or more of:
bridgeheaddialoguedramapoetryremarkrevhistory- Indexing inlines
- Admonition elements
- Formal elements
- Graphic elements
- Informal elements
- List elements
- Paragraph elements
- Publishing elements
- Technical elements
- Verbatim elements
- Optionally one of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- One or more of:
- Sequence of:
- One or more of:
- Zero or more of:
- One or more of:
- Sequence of:
- Zero or more of:
- One of:
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
Children
The following elements occur in article: acknowledgements, address, anchor, appendix, bibliography, bibliolist, blockquote, bridgehead, calloutlist, colophon, dialogue, drama, epigraph, equation, example, figure, formalpara, glossary, glosslist, index, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titlereq.info), informalequation, informalexample, informalfigure, informaltable, itemizedlist, literallayout, mediaobject, note, orderedlist, para, poetry, procedure, qandaset, remark, revhistory, section, sidebar, simpara, simplelist, simplesect, subtitle, table, task, title, titleabbrev, toc, variablelist.
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>