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

tgroup

tgroup — A wrapper for the main content of a table, or part of a table.

Synopsis

tgroup ::=

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • align (enumeration)
    • “center”
    • “char”
    • “justify”
    • “left”
    • “right”
  • char
  • charoff (decimal)
  • cols (positiveInteger)
  • colsep (enumeration)
    • “0”
    • “1”
  • rowsep (enumeration)
    • “0”
    • “1”
  • tgroupstyle

Required attributes are shown in bold.

Description

A tgroup surrounds a logically complete portion of a table. Most tables consist of a single tgroup, but complex tables with widely varying column specifications may be easier to code using multiple tgroups.

The tgroup specifies the number of columns in the table, and contains all of the header, body, and footer rows, along with any additional column or span specifications necessary to express the geometry of the table.

Most of the properties of rows, columns, and cells inherit their default characteristics from the enclosing tgroup.

Processing expectations

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

cols

The number of columns in the table. Must be an integer greater than zero.

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

rowsep

Specifies the presence or absence of the row separator

Enumerated values:
“0”

No row separator rule.

“1”

Provide a row separator rule below

tgroupstyle

Additional style information for downstream processing; typically the name of a style.

Parents

These elements contain tgroup: informaltable, table.

Children

The following elements occur in tgroup: colspec, spanspec, tbody (db.cals.tbody), tfoot, thead (db.cals.thead).