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

---

spanspec

Name

spanspec -- Formatting information for a spanned column in a table

Synopsis

Content Model

spanspec ::=
EMPTY

Attributes

Name	Type	Default
rowsep	NUMBER	None
spanname	NMTOKEN	Required
colsep	NUMBER	None
namest	NMTOKEN	Required
nameend	NMTOKEN	Required
charoff	NUTOKEN	None
align	Enumeration: center char justify left right	None
char	CDATA	None

Tag Minimization

The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.

Parameter Entities

%tbl.entrytbl.mdl;

%tbl.tgroup.mdl;

Description

A SpanSpec associates a name with a span between two columns in a table. In the body of the table, cells can refer to the span by name. Cells that refer to a span will span horizontally from the first column to the last column, inclusive.

Cells can also form spans directly, by naming the start and end columns themselves. The added benefit of a SpanSpec is that it can associate formatting information (such as alignment and table rule specifications) with the span. This information does not need to be repeated then, on each spanning cell.

Processing expectations

Suppressed. 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 NameSt and NameEnd attributes of a SpanSpec must refer to named ColSpecs in the same table. In other words, if the SpanSpec

<spanspec spanname="fullyear" namest="jan" nameend="dec">

exists in a table, ColSpecs named "jan" and "dec" must also exist in the same table.

Parents

These elements contain spanspec: entrytbl, tgroup.

Children

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

Attributes

align

Align specifies the horizontal alignment of Entrys (or EntryTbls) in the span. The default alignment is inherited from the enclosing TGroup. If Char is specified, see also Char and CharOff. Individual Entrys and EntryTbls can specify an alternate alignment.

char

Char specifies the alignment character when the Align attribute is set to Char.

charoff

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 ColSpec of the column specified in Namest or from the enclosing TGroup.

colsep

If ColSep has the value 1 (true), then a rule will be drawn to the right of the spanning column described by this SpanSpec. 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 the last column in the table is ignored. If unspecified, this attribute is inherited from enclosing elements.

nameend

NameEnd is the name (defined in a ColSpec) of the rightmost column of the span.

namest

NameSt is the name (defined in a ColSpec) of the leftmost column of the span.

rowsep

If RowSep has the value 1 (true), then a rule will be drawn below all the cells in this Span. 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

SpanName specifies a name by which subsequent Entry and EntryTbls can refer to the span defined in this SpanSpec.

See Also

colspec, entry, entrytbl, InformalTable, row, Table, tbody, tfoot, tgroup, thead

Examples

For examples, see RefEntry, Table.

---

Prev	Home	Next
SimpleSect	Up	State

Back to: DocBook: The Definitive Guide