variablelist

variablelist — A list in which each entry is composed of a set of one or more terms and an associated description.

Synopsis

variablelist ::= [-]

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • spacing (enumeration)
    • “compact”
    • “normal”
  • termlength

Description

A variablelist is a list consisting of terms and their definitions or descriptions.

Processing expectations

Formatted as a displayed block.

There are many ways to present a variable list. DocBook does not mandate any particular presentation. The termlength attribute may influence the presentation of terms. The termlength attribute is often specified as a number of characters, but other forms are possible. This is an interchange issue.

Attributes

Common attributes and common linking attributes.

spacing

Specifies (a hint about) the spacing of the content

Enumerated values:
“compact”

The spacing should be "compact".

“normal”

The spacing should be "normal".

termlength

Indicates a length beyond which the presentation system may consider a term too long and select an alternate presentation for that term, item, or list

Children

The following elements occur in variablelist: address, anchor, bibliolist, blockquote, bridgehead, calloutlist, caution, danger, db:stagedir, dialogue, drama, epigraph, equation, example, figure, formalpara, glosslist, important, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titleonly.info), informalequation, informalexample, informalfigure, informaltable, itemizedlist, literallayout, mediaobject, note, orderedlist, para, poetry, procedure, qandaset, remark, revhistory, sidebar, simpara, simplelist, table, task, tip, title, titleabbrev, variablelist, varlistentry, warning.

Examples

<article xmlns='http://docbook.org/ns/docbook'>
  <title>Example variablelist</title>

 <variablelist><title>Font Filename Extensions</title>
  <varlistentry>
    <term><filename>TTF</filename></term>
    <listitem>
      <para>TrueType fonts.</para>
    </listitem>
  </varlistentry>
  <varlistentry>
    <term><filename>PFA</filename></term>
    <term><filename>PFB</filename></term>
    <listitem>
      <para>
        PostScript fonts. <filename>PFA</filename> files are common
        on <acronym>UNIX</acronym> systems, <filename>PFB</filename>
        files are more common on Windows systems.
      </para>
    </listitem>
  </varlistentry>
 </variablelist>

</article>
Font Filename Extensions
TTF

TrueType fonts.

PFA, PFB

PostScript fonts. PFA files are common on UNIX systems, PFB files are more common on Windows systems.

Last revised by Norman Walsh on (git hash: c3457cab689d8fd89ba4252de204cf9a14e40acd 6a501344525f32f9834f0e4a5c3c3f8131803fa4 47fe34b28bad7941a61b9c1c17d47f6eed36cd04)