Whole document tree
Table
Content Model
(
(Title, TitleAbbrev?),
(Graphic+ | TGroup+)
)
-(InformalTable | Equation | Example | Figure | Table)Exclusions
Table excludes these elements at every level:
InformalTable | Equation | Example | Figure | Table
Description
Table in a document. Table is derived from the SGML Open full CALS table model (cal-tbl.dtd); changes are documented in the tables.txt file in the distribution. The present Table element has a required Title, an optional TitleAbbrev, and either one or more Graphics or one or more TGroups. Tables may not contain either Tables or InformalTables. Table has common, Colsep, Frame, Label, Orient, Pgwide, Rowsep, ShortEntry, Tabstyle, and Tocentry attributes. Elements that may be contained within TGroup are specified as having omissible end tags, except for EntryTbl.
Usage
Be aware that the ShortEntry mechanism duplicates the DocBook element TitleAbbrev. It would be better, for any given work, to choose one mechanism or the other, rather than mix them.
CALS Customization Summary
Summary of entity redeclarations made to CALS full table model (attributes are listed only by name, not by full declaration):
============================================================================ Entity Name Original CALS DocBook Override ============================================================================ bodyatt "" (Nothing) Label secur "" (Nothing) common attributes yesorno "NUMBER" (Same) titles "title?" (Same; unused) paracon "#PCDATA" (Same; unused) tbl.table.name "(table|chart)" "Table" tbl.table-titles.mdl "%titles," (Same; unused) tbl.table-main.mdl "(tgroup+|graphic+)" (Same; unused) tbl.table.mdl "%tbl.table-titles.mdl; "((%formalobject.title. %tbl.table-main.mdl;" content);, (Graphic+ |TGroup+))" tbl.table.excep "-(table|chart|figure)" "-(InformalTable |%formal.class;)" tbl.table.att tabstyle, tocentry, shortentry, (Same) orient, and pgwide tbl.tgroup.mdl "colspec*,spanspec*,thead?, (Same) tfoot?,tbody" tbl.tgroup.att tgroupstyle (Same) tbl.hdft.name "(thead|tfoot)" (Same) tbl.hdft.mdl "colspec*,row+" (Same) tbl.row.mdl "(entry|entrytbl)+) (Same) tbl.row.excep "-(pgbrk)" "" (Nothing) tbl.entrytbl.mdl "colspec*,spanspec*,thead?, (Same) tbody" tbl.entrytbl.excep "-(entrytbl|pgbrk)" "-(EntryTbl)" tbl.entry.mdl "(para|warning|caution|note "((%tabentry.mix;) |legend|%paracon;)*" | (%para.char.mix;)+)" tbl.entry.excep "-(pgbrk)" "" (Nothing)
Parents
These elements contain Table: Appendix, Article, BiblioDiv, Bibliography, BlockQuote, Callout, Caution, Chapter, GlossDef, GlossDiv, Glossary, Important, Index, ListItem, MsgExplan, MsgText, Note, Para, PartIntro, Preface, Procedure, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, Sect1, Sect2, Sect3, Sect4, Sect5, SetIndex, Sidebar, SimpleSect, Step, Tip, Warning.
Children
Table contains these elements: Graphic, TGroup, Title, TitleAbbrev.
In some contexts, additional elements may be allowed by inclusions in parent elements. Similarly, in some contexts, some of these elements may be invalid due to exclusions in parent elements.
Attributes
- frame
Frame specifies how the table is to be framed.
- colsep
For EntryTbl, if the value of Colsep is 1 (yes), display the internal column rulings to the right of the EntryTbl, except if the EntryTbl falls in the the last column, where the side rule setting applies; if 0 (no), do not display it. There is no default. The value is inherited from the enclosing TGroup.
- rowsep
Rowsep controls the occurance of horizontal rules between table rows. A value of 1 (yes) specifies that a rule should occur. A value of 0 (no) specifies that it should not. Rowsep is inherited from enclosing table elements.
- tabstyle
Name of a table style defined in the FOSI.
- tocentry
ToCEntry indicates whether the table is to be included in a generated List of Tables. The default is 0 (no).
- shortentry
Determines whether the value of the Table's TitleAbbrev is to be used in an Index or ToC or LoT. If the value is 0 (no), the TitleAbbrev is not used; if 1 (yes), the TitleAbbrev is used.
- orient
Orient determines the orientation of the Table. The allowed values are Port (the orientation of the rest of the text of the Book, that is, upright) and Land (90 degrees counterclockwise from the orientation of the rest of the text of the Book). If you assume that the page is taller than it is wide, tables that take up a whole page and are wider than they are tall should be given the Land value. There is no default; the value may be inherited from the FOSI.
- pgwide
Pgwide indicates whether the table should be rendered within the current text flow (no, the value 0) or within the full text page width (yes, the value 1). There is no default.
- Label
Label holds an identifying number or string to be output in some manner when the element it is applied to is rendered.
Examples
<TABLE COLSEP="1" FRAME="all" ROWSEP="0" SHORTENTRY="0" TOCENTRY="1" TABSTYLE="decimalstyle" ORIENT="land" PGWIDE="0"> <TITLE>Sample Decimal-Aligned Table</TITLE> <TITLEABBREV>Decimal-Aligned Table</TITLEABBREV> <TGROUP ALIGN="char" CHAROFF="50" CHAR="." COLS="4"> <COLSPEC ALIGN="left" COLNUM="1" COLSEP="0" COLWIDTH="7pc"> <THEAD> <ROW> <ENTRY>Gas Ball</ENTRY> <ENTRY>1940</ENTRY> <ENTRY>1960</ENTRY> <ENTRY>1980</ENTRY> </ROW> </THEAD> <TFOOT> <ROW> <ENTRY>Rating</ENTRY> <ENTRY>3</ENTRY> <ENTRY>1</ENTRY> <ENTRY>2</ENTRY> </ROW> </TFOOT> <TBODY> <ROW> <ENTRY>Diameter</ENTRY> <ENTRY>345.021</ENTRY> <ENTRY>211.02</ENTRY> <ENTRY>221.3</ENTRY> </ROW> <ROW> <ENTRY>Color</ENTRY> <ENTRY>blue</ENTRY> <ENTRY>red</ENTRY> <ENTRY>yellow</ENTRY> </ROW> </TBODY> </TGROUP> </TABLE>
<TABLE FRAME="all"> <TITLE>Table With SpanSpec</TITLE> <TGROUP COLS="5" COLSEP="1" ROWSEP="1"> <COLSPEC COLWIDTH="91*"> <COLSPEC COLNAME="col2" COLWIDTH="91*"> <COLSPEC COLNAME="col3" COLWIDTH="91*"> <COLSPEC COLNAME="col4" COLWIDTH="91*"> <COLSPEC COLNAME="col5" COLWIDTH="92*"> <SPANSPEC NAMEEND="col5" NAMEST="col4" SPANNAME="4to5"> <TBODY> <ROW> <ENTRY ALIGN="center" COLNAME="col2" VALIGN="middle">Software 1</ENTRY> <ENTRY ALIGN="center" VALIGN="middle">Software 2</ENTRY> <ENTRY ALIGN="center" VALIGN="middle">Software 3</ENTRY> <ENTRY ALIGN="center" VALIGN="middle">Software 4</ENTRY></ROW> <ROW> <ENTRY ALIGN="center" VALIGN="middle">Platform 1</ENTRY> <ENTRY ALIGN="center" MOREROWS="1" VALIGN="middle">25 MB</ENTRY> <ENTRY ALIGN="center" VALIGN="middle">10 MB</ENTRY> <ENTRY ALIGN="center" SPANNAME="4to5" VALIGN="middle">34 MB</ENTRY></ROW> <ROW> <ENTRY ALIGN="center" VALIGN="middle">Platform 2</ENTRY> <ENTRY ALIGN="center" COLNAME="col3" VALIGN="middle">12 MB</ENTRY> <ENTRY ALIGN="center" VALIGN="middle">30 MB</ENTRY> <ENTRY ALIGN="center" VALIGN="middle">35 MB</ENTRY></ROW></TBODY></TGROUP> </TABLE>