CALS Table Model Parameter Entities

Name

CALS Table Model Parameter Entities -- Parameter entities which control the CALS Table Model

Synopsis

The CALS Table Model is incorporated into DocBook by reference to the standard CALS Table Model DTD. The CALS Table Model DTD, like DocBook, can be customized by defining a number of parameter entities before including it. The parameter entities in the following sections are the table-model related parameter entities defined by DocBook for use in the CALS Table Model.

%bodyatt;

Parameterizes additional attributes (unrelated to table formatting) on the table body (see also %secur;. In DocBook, the label attribute (%label.attrib;) is passed to Table and InformalTable this way.

Parameter Entity

Name

Type

Default

LabelCDATANone

%bodyatt; contributes to the declaration of the following elements:

InformalTableTable

%calstbls;

Points to the CALS Table Model DTD via its public identifier:

External Entity

Public identifier: -//USA-DOD//DTD Table Model 951010//EN

%paracon;

Theoretically defines the "text" part of the content model of table cells. This entity is defined in the CALS Table Model DTD, but is unused in DocBook because it is not included in the %tbl.entry.mdl;. DocBook has its own set of parameter entities for defining table cell content.

Parameter Entity

#PCDATA

%secur;

Defines additional attributes (unrelated to table formatting) on table elements: TGroup TBody THead TFoot Row EntryTbl Entry. See also %bodyatt;.

Replacement text is empty.

Parameter Entity

Name

Type

Default

IdIDNone
LangCDATANone
RemapCDATANone
XRefLabelCDATANone
RevisionFlag

Enumerated:

Changed
Added
Deleted
Off

None
ArchCDATANone
ConformanceNMTOKENSNone
OSCDATANone
RevisionCDATANone
UserLevelCDATANone
VendorCDATANone
RoleCDATANone

%secur; contributes to the declaration of the following elements:

entryentrytblInformalTable
rowTabletbody
tfoottgroupthead

%tabentry.mix;

This parameter entity defines the mixture of block elements that may occur in a table cell. This is not strictly a parameter entity used in the CALS Table Model DTD, but it is used in DocBook as part of the content of %tbl.entry.mdl;.

Parameter Entity

CalloutList|GlossList|ItemizedList|OrderedList|SegmentedList
		|SimpleList|VariableList 		|Caution|Important|Note|Tip|Warning 
		|LiteralLayout|ProgramListing|ProgramListingCO|Screen
		|ScreenCO|ScreenShot 
		|FormalPara|Para|SimPara 		|Graphic|MediaObject
		

%tabentry.mix; contributes to the declaration of the following element:

entry

%tbl.entry.excep;

Defines the exceptions (exclusions) to the table entry content model.

Replacement text is empty.

Parameter Entity

The replacement text for this entity is empty.

%tbl.entry.mdl;

Defines the content model of table cells.

Note that this content model is the source of the pernicious mixed content problem. An Entry can contain either a collection of block elements, or a collection of inline elements.

Parameter Entity

((CalloutList|GlossList|ItemizedList|OrderedList|SegmentedList
		|SimpleList|VariableList 		|Caution|Important|Note|Tip|Warning 
		|LiteralLayout|ProgramListing|ProgramListingCO|Screen
		|ScreenCO|ScreenShot 
		|FormalPara|Para|SimPara 		|Graphic|MediaObject
		)+ | (#PCDATA
		|FootnoteRef|XRef 	|Abbrev|Acronym|Citation|CiteRefEntry|CiteTitle|Emphasis
		|FirstTerm|ForeignPhrase|GlossTerm|Footnote|Phrase
		|Quote|Trademark|WordAsWord 
		|Link|OLink|ULink 	|Action|Application|ClassName|Command|ComputerOutput
		|Database|Email|EnVar|ErrorCode|ErrorName|ErrorType|Filename
		|Function|GUIButton|GUIIcon|GUILabel|GUIMenu|GUIMenuItem
		|GUISubmenu|Hardware|Interface|InterfaceDefinition|KeyCap
		|KeyCode|KeyCombo|KeySym|Literal|Constant|Markup|MediaLabel
		|MenuChoice|MouseButton|MsgText|Option|Optional|Parameter
		|Prompt|Property|Replaceable|ReturnValue|SGMLTag|StructField
		|StructName|Symbol|SystemItem|Token|Type|UserInput|VarName
		
		|Anchor 	|Author|AuthorInitials|CorpAuthor|ModeSpec|OtherCredit
		|ProductName|ProductNumber|RevHistory
		
		|Comment|Subscript|Superscript 	|InlineGraphic|InlineMediaObject|InlineEquation 
		|Synopsis|CmdSynopsis|FuncSynopsis 
		|IndexTerm 
		)+)

%tbl.entry.mdl; contributes to the declaration of the following element:

entry

%tbl.entrytbl.excep;

Defines the exceptions to the EntryTbl content model. EntryTbls are a mechanism defined by the CALS Table Model to allow limited nesting of tables within tables.

In DocBook, EntryTbls are excluded from themselves, limiting the nesting of tables to a single level.

Parameter Entity

-(EntryTbl)

%tbl.entrytbl.mdl;

Defines the content model of EntryTbls.

Parameter Entity

colspec*,spanspec*,thead?,tbody

%tbl.entrytbl.mdl; contributes to the declaration of the following element:

entrytbl

%tbl.hdft.excep;

Defines the exclusions to the content model of table headers and footers. By excluding EntryTbl, DocBook prevents a composition system from being required to allow nested tables on repeating headers and footers.

Parameter Entity

-(entrytbl)

%tbl.hdft.mdl;

Defines the content model of table headers and footers.

Parameter Entity

colspec*,row+

%tbl.hdft.mdl; contributes to the declaration of the following elements:

tfootthead

%tbl.hdft.name;

Defines the names of the table header and footer elements.

Parameter Entity

(thead|tfoot)

%tbl.row.excep;

Defines the exclusions to the content model of table rows.

Replacement text is empty.

Parameter Entity

The replacement text for this entity is empty.

%tbl.row.mdl;

Defines the content model of table rows.

Parameter Entity

(entry|entrytbl)+

%tbl.row.mdl; contributes to the declaration of the following element:

row

%tbl.table-main.mdl;

Defines the content model of the body of a table.

Parameter Entity

(tgroup+|graphic+)

%tbl.table-titles.mdl;

Theoretically defines what constitutes a table title. This entity is defined in the CALS Table Model DTD, but is unused in DocBook because DocBook redefines %tbl.table.mdl; in terms of its own parameter entities.

Parameter Entity

title?,

%tbl.table.att;

Defines the attributes of a table.

Parameter Entity

Name

Type

Default

tabstyleNMTOKENNone
tocentryNUMBERNone
shortentryNUMBERNone
orient

Enumerated:

port
land

None
pgwideNUMBERNone

%tbl.table.att; contributes to the declaration of the following elements:

InformalTableTable

%tbl.table.excep;

Defines the exceptions to the content model of tables. DocBook prevents most formal objects from occuring within tables. (Note that this exclusion is required in DocBook because most of them can appear in Paras and Paras are allowed in table cells.)

Parameter Entity

-(InformalTable|Equation|Example|Figure|Table )

%tbl.table.mdl;

Defines the content model of a table. This is done in terms of %tbl.table-titles.mdl; and %tbl.table-main.mdl; which produces the expansion shown here:

Parameter Entity

((Title, TitleAbbrev?),
          (IndexTerm )*,
          (Graphic+|MediaObject+|TGroup+))

%tbl.table.mdl; contributes to the declaration of the following element:

Table

%tbl.table.name;

Defines the name of the table element.

Parameter Entity

Table

%tbl.tgroup.att;

Defines the attributes on a table group (TGroup).

Parameter Entity

Name

Type

Default

tgroupstyleNMTOKENNone

%tbl.tgroup.att; contributes to the declaration of the following elements:

entrytbltgroup

%tbl.tgroup.mdl;

Defines the content model of a table group (TGroup).

Parameter Entity

colspec*,spanspec*,thead?,tfoot?,tbody

%tbl.tgroup.mdl; contributes to the declaration of the following element:

tgroup

%titles;

Theoretically defines the "titles" portion the content model of tables. This entity is defined in the CALS Table Model DTD, but is unused in DocBook because DocBook redefines %tbl.table.mdl; in terms of its own parameter entities.

Parameter Entity

title?

%yesorno;

Provides the definition of "boolean" attributes in the CALS Table Model DTD.

This parameter entity occurs in the replacement text of %tbl.table.att;.

Parameter Entity

NUMBER

%yesorno; contributes to the declaration of the following elements:

colspecentryentrytbl
InformalTablerowspanspec
Tabletgroup

Copyright © 1999 O'Reilly & Associates, Inc. All rights reserved.