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”

Additional Constraints

  • If this element is the root element, it must have a version attribute.

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 

Last revised by Norman Walsh on (git hash: 4a070f84c9fc7bc85cf9f71d71fa54f4db18f973 a835fdf61c7f87ce1038e2869080d80ea67d3696)