DocBook: The Definitive Guide By Norman Walsh & Leonard Muellner 1st Edition October 1999 1-56592-580-7, Order Number: 5807 652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide
Prev		Next

---

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.

Description

The following parameter entities are related to 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.

Name	Type	Default
Label	CDATA	None

%calstbls;

Points to the CALS Table Model DTD via its 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.

%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.

%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;.

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

%tbl.entry.excep;

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

Replacement text is empty.

%tbl.entry.mdl;

Defines the content model of table cells.

  (CalloutList | GlossList | ItemizedList | OrderedList
  | SegmentedList | SimpleList | VariableList | Caution
  | Important | Note | Tip | Warning | LiteralLayout
  | ProgramListing | ProgramListingCO | Screen | ScreenCO
  | ScreenShot | FormalPara | Para | SimPara
  | Graphic)+
  | (#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 | Markup | MediaLabel
  | MenuChoice | MouseButton | MsgText | Option | Optional
  | Parameter | Prompt | Property | Replaceable | ReturnValue
  | SGMLTag | StructField | StructName | Symbol | SystemItem
  | Token | Type | UserInput | Anchor | Author | AuthorInitials
  | CorpAuthor | ModeSpec | OtherCredit | ProductName
  | ProductNumber | RevHistory | Comment | Subscript
  | Superscript | InlineGraphic | InlineEquation | Synopsis
  | CmdSynopsis
  | FuncSynopsis)+

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.

%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.

  -(EntryTbl)

%tbl.entrytbl.mdl;

Defines the content model of EntryTbls.

  ColSpec*, SpanSpec*, THead?, TBody

%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.

  -(EntryTbl)

%tbl.hdft.mdl;

Defines the content model of table headers and footers.

  ColSpec*, Row+

%tbl.hdft.name;

Defines the names of the table header and footer elements.

  THead | TFoot

%tbl.row.excep;

Defines the exclusions to the content model of table rows.

Replacement text is empty.

%tbl.row.mdl;

Defines the content model of table rows.

  (Entry | EntryTbl)+

%tbl.table-main.mdl;

Defines the content model of the body of a table.

  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.

%tbl.table.att;

Defines the attributes of a table.

Name	Type	Default
Orient	Enumerated: port land	None
PgWide	NUMBER	None
ShortEntry	NUMBER	None
TabStyle	NMTOKEN	None
TocEntry	NUMBER	None

%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.)

  -(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:

  (Title, TitleAbbrev?),
  (Graphic+ | TGroup+)

%tbl.table.name;

Defines the name of the table element.

  Table

%tbl.tgroup.att;

Defines the attributes on a table group (TGroup).

Name	Type	Default
TGroupStyle	NMTOKEN	None

%tbl.tgroup.mdl;

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

  ColSpec*, SpanSpec*, THead?, TFoot?, TBody

%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.

%yesorno;

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

  NUMBER

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

---

Prev	Home	Next
%*.attval; Parameter Entities	Up	%*.class; Parameter Entities

Back to: DocBook: The Definitive Guide