Next Up Previous Contents
Next: C.1.17 Element copyright
Up: C.1 Element listing
Previous: C.1.15 Element coderef
[ID index][Keyword index]

C.1.16 Element colspec

C.1.16.1 Description

The colspec element controls the default layout of a column in a table. The attributes here take their defaults from attributes with the same names in tabular and tgroup, and provide the default for individual entry elements.

You do not have to have a colspec element for each column in the table. If all of the columns in a table are to be left-aligned except the third one, say, then you would specify left alignment in the tgroup start-tag, and give a colspec element like <colspec colnum=3 align=center>.

C.1.16.2 Parents

tgroup

C.1.16.3 Content

EMPTY

colspec
 |_EMPTY

C.1.16.4 Attribute colspec/rowsep

The default value of the rowsep attribute for entries in this tgroup.

C.1.16.5 Attribute colspec/align

Default alignment of entries in cells. Possible values are `left', `right', `center', `justify' (`char' not supported).

C.1.16.6 Attribute colspec/colwidth

The width of this column. You specify the width as a length like `<number><dimension>', where `<number>' is a positive integer or floating point number, and `<dimension>' is one of the units `pt' (points), `cm', `mm', `pi' (picas), `in' or `*'. The unit `*' is a proportional measure which corresponds to the length `pagewidth/numcols' in the case of a table with `numcols' columns. If there is a number but no unit, the unit is taken to be `pt'; and the specifications "" (the empty string) and "*" are both taken to be `1*'.

NOTE: The OASIS spec has a rather elaborate definition of the `proportional measure'. The definition of this measure implemented in the current version of the software and described above is broadly consistent in spirit with this, but different in details, so you should not rely too much on these details, in case the implementation is tightened at some point in future. In any case, the appearance of tables will tend to be rather different in the HTML and LaTeX versions of the output. The main present practical effect of the colspec attribute is that, if it is present, then the corresponding column is line-wrapped in the LaTeX output, which does not otherwise happen.

C.1.16.7 Attribute colspec/colname

A name for this column. An entry element may refer to a column by name in a `colname' or `namest' attribute.

C.1.16.8 Attribute colspec/colnum

This column's number. If this is omitted, the column's number is taken to be one greater than the previous column, with the first column being taken to be number 1.

C.1.16.9 Attribute colspec/char

Alignment character (not supported).

C.1.16.10 Attribute colspec/colsep

The default value of the colsep attribute for entries in this tgroup.

C.1.16.11 Attribute colspec/charoff

Alignment character (not supported).


Next Up Previous Contents
Next: C.1.17 Element copyright
Up: C.1 Element listing
Previous: C.1.15 Element coderef
[ID index][Keyword index]
The Starlink SGML Set
Starlink System Note 70
Norman Gray, Mark Taylor
21 April 1999. Release DR-0.7-13. Last updated 24 August 2001