entrytbl
entrytbl — A subtable appearing in place of an entry in a table.
Synopsis
entrytbl ::=
- Sequence of:
Attributes
Common attributes and common linking attributes.
Additional attributes:
- align (enumeration)
- “center”
- “char”
- “justify”
- “left”
- “right”
- char
- charoff (decimal)
- At most one of:
- colname
- namest
- spanname
- All or none of:
- namest
- nameend
- cols (positiveInteger)
- colsep (enumeration)
- “0”
- “1”
- rowsep (enumeration)
- “0”
- “1”
- tgroupstyle
Description
The entrytbl element allows for a single level
of nesting within CALS tables.
An entry table may occur in a row instead of an
entry. An entrytbl has most of the
elements of a table but may not include itself, thus limiting nesting to
a single level.
Note
An entrytbl can span horizontally (across
columns), but it cannot span across rows. Whether this is by accident
or by design is unclear, but it has always been that way in
CALS.
Processing expectations
This element is expected to obey the semantics of the CALS Table Model Document Type Definition [calsdtd].
The content of entrytbl is formatted,
as a table, to fit within the table cell that it
occupies. Horizontal and vertical spanning may allow an
entrytbl to occupy several physical cells in the
table that contains it.
If multiple entrytbls occur in a single row,
formatters that support entrytbl are not required
to ensure that subrows within the various tables are vertically
aligned.
Many formatters are incapable of supporting
entrytbls. This is an interchange issue. See Appendix C, Interchanging DocBook Documents.
Attributes
Common attributes and common linking attributes.
- align
Specifies the horizontal alignment of text in an entry.
Enumerated values: “center” Centered.
“char” Aligned on a particular character.
“justify” Left and right justified.
“left” Left justified.
“right” Right justified.
- char
Specifies the alignment character when
alignis set to “char” .- charoff
Specifies the percentage of the column's total width that should appear to the left of the first occurance of the character identified in
charwhenalignis set to “char” .- colname
Specifies a column specification by name.
- cols
The number of columns in the entry table. Must be an integer greater than zero.
- colsep
Specifies the presence or absence of the column separator
Enumerated values: “0” No column separator rule.
“1” Provide a column separator rule on the right
- nameend
Specifies an ending column by name.
- namest
Specifies a starting column by name.
- rowsep
Specifies the presence or absence of the row separator
Enumerated values: “0” No row separator rule.
“1” Provide a row separator rule below
- spanname
Specifies a span by name.
- tgroupstyle
Additional style information for downstream processing; typically the name of a style.
Examples
<article xmlns='http://docbook.org/ns/docbook'>
<title>Example entrytbl</title>
<informaltable frame='all'>
<tgroup cols='3'>
<tbody>
<row>
<entry>a1</entry>
<entry>b1</entry>
<entry>c1</entry>
</row>
<row>
<entry>a2</entry>
<entrytbl cols='3'>
<tbody>
<row>
<entry>b2a1</entry>
<entry>b2b1</entry>
<entry>b2c1</entry>
</row>
<row>
<entry>b2a2</entry>
<entry>b2b2</entry>
<entry>b2c2</entry>
</row>
<row>
<entry>b2a3</entry>
<entry>b2b3</entry>
<entry>b2c3</entry>
</row>
</tbody>
</entrytbl>
<entry>c2</entry>
</row>
<row>
<entry>a3</entry>
<entry>b3</entry>
<entry>c3</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</article>
| a1 | b1 | c1 | |||||||||
| a2 |
| c2 | |||||||||
| a3 | b3 | c3 |