Name

row — A row in a table

Synopsis

row (db.row) ::= (entry | entrytbl)+

Attribute synopsis

Common attributes and common linking attributes.

Additional attributes:

  • rowsep (enumeration) = “0” | “1”

  • valign (enumeration) = “bottom” | “middle” | “top”

Description

A row is a row in a table. It contains all of the cells (entrys or entrytbls) that appear in that row.

Processing expectations

This element is expected to obey the semantics of the CALS Table Model Document Type Definition [calsdtd].

Within a row, cells are arranged horizontally from the start of the row to the end. Cells can, but are not required to, specify the column in which they occur, so it is possible for a row to contain fewer cells than there are columns in the table. This introduces missing cells, which are assumed to be empty. These missing cells can occur anywhere in the row.

Once a cell has been allocated to a column, subsequent cells may not fill preceding columns. In other words, while three cells can specify that they occur in columns 1, 3, and 5, they cannot specify that they occur in columns 1, 5, and 3. Once a column is passed, you can never go back.

If cells do not specify the column in which they occur, they are placed in the next available column. Calculation of the next available column is complicated by horizontal and vertical spanning. Cells from preceding rows can have a vertical span that causes them to extend into the current row, thus occupying space in the current row. These logically occupied cells are skipped ...

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.