DocBook: The Definitive GuideBy Norman Walsh & Leonard Muellner
1st Edition October 1999
1-56592-580-7, Order Number: 5807
652 pages, $36.95 , Includes CD-ROM
Nameentrytbl -- A subtable appearing in place of an Entry in a table
rowsep NUMBER None colsep NUMBER None namest NMTOKEN None align
None cols NUMBER Required tgroupstyle NMTOKEN None spanname NMTOKEN None nameend NMTOKEN None charoff NUTOKEN None char CDATA None colname NMTOKEN None
Both the start- and end-tags are required for this element.
%tbl.entrytbl.excep; %tbl.hdft.excep; %tbl.row.mdl;
The EntryTbl element allows for a single level of nesting within tables. This element is expected to obey the semantics of the CALS Table Model Document Type Definition, as specified by OASIS Technical Memorandum TM 9502:1995.
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.
These elements contain entrytbl: row.
Align specifies the horizontal alignment of the EntryTbl in the cell in which it occurs. If no alignment is specified, it is inherited from the ColSpec for the current column, or the SpanSpec if this entry occurs in a span.
Char specifies the alignment character when the Align attribute is 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 Char when the Align attribute is set to Char. This attribute is inherited from the relevant ColSpec or SpanSpec.
ColName identifies the column in which this entry table should appear; it must have been previously defined in a ColSpec. EntryTbls cannot be given out of order, the column referenced must be to the right of the last Entry or EntryTbl placed in the current row. It is an error to specify both a ColName and a SpanName.
Cols specifies the number of columns in the EntryTbl.
If ColSep has the value 1 (true), then a rule will be drawn to the right of this EntryTbl. A value of 0 (false) suppresses the rule. The rule to the right of the last column in the table is controlled by the Frame attribute of the enclosing Table or InformalTable and the ColSep of an entry in the last column in the table is ignored. If unspecified, this attribute is inherited from the the corresponding ColSpec or SpanSpec and enclosing elements.
NameSt ("name start") is the name (defined in a ColSpec) of the leftmost column of a span. On EntryTbl, specifying both NameSt and NameEnd defines a horizontal span for the current EntryTbl. (See also SpanName.)
If RowSep has the value 1 (true), then a rule will be drawn below the EntryTbl. A value of 0 (false) suppresses the rule. The rule below the last row in the table is controlled by the Frame attribute of the enclosing Table or InformalTable and the RowSep of the last row is ignored. If unspecified, this attribute is inherited from enclosing elements.
SpanName is the name (defined in a SpanSpec) of a span. This cell will be rendered with the specified horizontal span.
TGroupstyle holds the name of a table group style defined in a stylesheet that will be used to process this document.
Examples<!DOCTYPE informaltable PUBLIC "-//OASIS//DTD DocBook V3.1//EN"> <!-- entrytbl not supported, fake it in descrip.1 --> <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>
The preceding table would look something like this when formatted:
a1 b1 c1 a2 b2a1 b2b1 b2c1 c2 b2a2 b2b2 b2c2 b2a3 b2b3 b2c3 a3 b3 c3
Back to: DocBook: The Definitive Guide
© 2001, O'Reilly & Associates, Inc.