DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

simplelist

simplelist — An undecorated list of single words or short phrases.

Synopsis

simplelist ::=

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • columns (integer)
  • type (enumeration) [default=“vert”]
    • “horiz”
    • “vert”
    • “inline”

Description

A simplelist is a list of words or phrases. It offers a convenient alternative to the other list elements for inline content.

Processing expectations

Ironically, the processing expectations of a simplelist are quite complex. The value of the type attribute determines if the list is presented inline, or in a row- or column-major table. In the table cases, the columns attribute determines the number of columns in the table.

Attributes

Common attributes and common linking attributes.

columns

Specifies the number of columns for horizontal or vertical presentation

type

Specifies the type of list presentation.

Enumerated values:
“horiz”

A tabular presentation in row-major order.

“vert”

A tabular presentation in column-major order.

“inline”

An inline presentation, usually a comma-delimited list.

Children

The following elements occur in simplelist: member.

Examples

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

<para>Here is a <tag>SimpleList</tag>, rendered inline: 
<simplelist type='inline'>
<member>A</member>
<member>B</member>
<member>C</member>
<member>D</member>
<member>E</member>
<member>F</member>
<member>G</member>
</simplelist>
</para>

</article>

Here is a SimpleList, rendered inline: A, B, C, D, E, F, G

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

<para>Here is the same <tag>SimpleList</tag> rendered horizontally with 
three columns:
<simplelist type='horiz' columns='3'>
<member>A</member>
<member>B</member>
<member>C</member>
<member>D</member>
<member>E</member>
<member>F</member>
<member>G</member>
</simplelist>
</para>

</article>

Here is the same SimpleList rendered horizontally with three columns:

ABC
DEF
G  

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

<para>Finally, here is the list rendered vertically:
<simplelist type='vert' columns='3'>
<member>A</member>
<member>B</member>
<member>C</member>
<member>D</member>
<member>E</member>
<member>F</member>
<member>G</member>
</simplelist>
</para>

</article>

Finally, here is the list rendered vertically:

ADG
BE 
CF