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

spanspec

spanspec — Formatting information for a spanned column in a table.

Synopsis

spanspec ::=

  • empty

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • align (enumeration)
    • “center”
    • “char”
    • “justify”
    • “left”
    • “right”
  • char
  • charoff (decimal)
  • colsep (enumeration)
    • “0”
    • “1”
  • nameend
  • namest
  • rowsep (enumeration)
    • “0”
    • “1”
  • spanname

Required attributes are shown in bold.

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 [calsdtd].

The namest and nameend attributes of a spanspec must refer to named colspecs in the same table. In other words, if the spanspec:

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

exists in a table, colspecs named “jan” and “dec” must also exist in the same table.

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

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

nameend

Specifies an ending column by name.

namest

Specifies a starting column by name.

rowsep

Specifies the presence or absence of the row separator

Enumerated values:
“0”

No row separator rule.

“1”

Provide a row separator rule below

spanname

Provides a name for a span specification.

Parents

These elements contain spanspec: entrytbl, tgroup.