Name

seglistitem — A list item in a segmented list

Synopsis

seglistitem ::= seg+

Attribute synopsis

Common attributes and common linking attributes.

Additional constraints

  • The number of seg elements must be the same as the number of segtitle elements in the parent segmentedlist.

Description

A segmentedlist consists of a set of headings (segtitles) and a list of parallel sets of elements. Each set of elements is stored in a seglistitem.

Processing expectations

Segmented lists can be formatted in a number of ways. Two popular formats are tabular and as a list of repeated headings and elements. In a tabular presentation, each seglistitem is a row in the table. In the list presentation, each seglistitem contains a block of heading/element pairs.

DocBook cannot detect errors caused by too many or too few segs in a seglistitem. You will have to rely on external processes to find those errors.

Examples

See segmentedlist for an example that uses this element.

Get DocBook 5: The Definitive Guide now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.

Start your free trial