DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

colspec

colspec — Specifications for a column in a table.

Synopsis

colspec ::=

  • empty

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • align (enumeration)
    • “center”
    • “char”
    • “justify”
    • “left”
    • “right”
  • char
  • charoff (decimal)
  • colname
  • colnum (positiveInteger)
  • colsep (enumeration)
    • “0”
    • “1”
  • colwidth
  • rowheader (enumeration)
    • “firstcol”
    • “headers”
    • “norowheader”
  • rowsep (enumeration)
    • “0”
    • “1”

Description

The attributes of this empty element specify the presentation characteristics of entries in a column of a table.

Each colspec refers to a single column. Columns are numbered sequentially from left to right in the table. If the colnum attribute is not specified, the colspec is for the next column after the preceding colspec or column 1 if it is the first colspec.

Processing expectations

Suppressed. This element is expected to obey the semantics of the CALS Table Model Document Type Definition [calsdtd].

Attributes

Common attributes and common linking attributes.

align

Specifies the horizontal alignment of text in an entry.

Enumerated values:
“center”

Centered.

“char”

Aligned on a particular character.

“justify”

Left and right justified.

“left”

Left justified.

“right”

Right justified.

char

Specifies the alignment character when align is set to “char” .

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 align is set to “char” .

colname

Provides a name for a column specification.

colnum

The number of the column to which this specification applies. Must be greater than any preceding column number. Defaults to one more than the number of the preceding column, if there is one, or one.

colsep

Specifies the presence or absence of the column separator

Enumerated values:
“0”

No column separator rule.

“1”

Provide a column separator rule on the right

colwidth

Specifies the width of the column.

rowheader

Indicates whether or not the entries in the first column should be considered row headers

Enumerated values:
“firstcol”

Indicates that entries in the first column of the table are functionally row headers (analogous to the way that a thead provides column headers).

“headers”

Indicates that row headers are identified by use of the headers attribute on entries in the table.

“norowheader”

Indicates that entries in the first column have no special significance with respect to column headers.

rowsep

Specifies the presence or absence of the row separator

Enumerated values:
“0”

No row separator rule.

“1”

Provide a row separator rule below

Parents

These elements contain colspec: entrytbl, tfoot, tgroup, thead (db.cals.entrytbl.thead), thead (db.cals.thead).