Reference. Reference for the DocBook DTD

[Prev] [Next]


Table

Name

Table---Table in a document

Synopsis

Content Model
  (
    (Title, TitleAbbrev?),
    (Graphic+ | TGroup+)
  )
  -(InformalTable | Equation | Example | Figure | Table)

Exclusions

Table excludes these elements at every level:

  InformalTable | Equation | Example | Figure | Table

Attributes

This element has common and Role attributes.

Name Value(s) Type Default Value
colsep NUMBER #IMPLIED  
frame (top|bottom|topbot|all|sides|none) #IMPLIED  
Label CDATA #IMPLIED  
orient (port|land) #IMPLIED  
pgwide NUMBER #IMPLIED  
rowsep NUMBER #IMPLIED  
shortentry NUMBER #IMPLIED  
tabstyle NMTOKEN #IMPLIED  
tocentry NUMBER #IMPLIED  

Tag Minimization

Both the start- and end-tags are required for this element.

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, and Warning.

Children

Table contains these elements: Graphic, TGroup, Title, and 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>


[Prev] SystemItem
[Next] tabentry.mix
[Reference Home] [Davenport Group Home]