Reference. Reference for the DocBook DTD

[Prev] [Next]


colspec

Name

colspec---Formatting specification for a column in a Table

Synopsis

Content Model
  EMPTY

Attributes

This element has the Role attribute.

Name Value(s) Type Default Value
align (left|right|center|justify|char) #IMPLIED  
char CDATA #IMPLIED  
charoff NUTOKEN #IMPLIED  
colname NMTOKEN #IMPLIED  
colnum NUMBER #IMPLIED  
colsep NUMBER #IMPLIED  
colwidth CDATA #IMPLIED  
rowsep NUMBER #IMPLIED  

Tag Minimization

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

Description

"Column specifier," that is, formatting information for a column in a Table, part of TGroup, THead, or TGroup. ColSpec is an empty element, bearing common and Align, Char, Charoff, Colname, Colnum, Colsep, Colwidth, and Rowsep attributes. The default values come from the TGroup, THead, or TFoot that starts the current enclosing group. Each ColSpec is for a single column, so it properly has a column number, Colnum, implicitly in order starting from 1, and an optional Colname by which it is known when used in any SpanSpec or in Entry. A ColSpec set on THead or TFoot should be complete for all columns. It overrides those on the containing TGroup and applies to just the THead or TFoot. If there is no ColSpec used within THead or TFoot, then the ColSpec of the containing TGroup (or the prior TGroup) is used. ColSpecs from the containing TGroup apply to TBody.

Parents

These elements contain colspec: entrytbl, tfoot, tgroup, and thead.

Attributes

colnum

Colnum gives the number of the column, counting from 1 at left of the table. There is no default.

colname

Name of the column, which is used to specify the position in a row, or the start or end of a horizontal span of columns (SpanSpec). There is no default. For Entry, omit if SpanName is present; The implied value is either the first column of the Row, or, if already in a Row, the next column after the end of the prior Entry or EntryTbl.

colwidth

Colwidth is either a proportional measure of the form number*, such as "5*" for 5 times the proportion, or "*" (="1*"); or a fixed measure, such as 2pt for 2 points, 3pc for 3 picas; or a mixed measure, such as 2*+3pt. Coefficients are positive numbers with up to two decimal places. There is no default. If no value is given, the value should be obtained from the FOSI, or, if there is no FOSI value, the value 1 should be (Perhaps this means that you can vary the width of columns by stating their relative proportions, or you can give fixed widths. If you use a decimal number less than one, express it in the form 0.2, not .2.)

colsep

For EntryTbl, if the value of Colsep is 1 (yes), display the internal column rulings to the right of the EntryTbl, except if the EntryTbl falls in the the last column, where the side rule setting applies; if 0 (no), do not display it. There is no default. The value is inherited from the enclosing TGroup.

rowsep

Rowsep controls the occurance of horizontal rules between table rows. A value of 1 (yes) specifies that a rule should occur. A value of 0 (no) specifies that it should not. Rowsep is inherited from enclosing table elements.

align

Align controls the horizontal position of text within the column. The value of Align may be Left (quad flush left), Center (centered), Right (quad flush right), Justify (both quad left and right), or Char (align to the left of Char, positioned by Charoff). There is no default except for SpanSpec, where the default is Center. For Entry and EntryTbl, the value may be inherited from ColSpec or SpanSpec.

char

Specifies the alignment character

charoff

Charoff contributes with Char to Align. Charoff is the proportion of the current column width, expressed in percentage, to be allowed before the left edge of the first occurrence of the character given as the value of Char. For Entry, the default is inherited from ColSpec or SpanSpec. For ColSpec and EntryTbl, the default is inherited from the enclosing TGroup. For SpanSpec, the default is inherited from the ColSpec of the column named by Namest.

Examples

<TABLE COLSEP="1" FRAME="all" ROWSEP="0"
SHORTENTRY="0" TOCENTRY="1" TABSTYLE="decimalstyle"
ORIENT="land" PGWIDE="0">
<TITLE>Sample Decimal-Aligned Table</TITLE>
<TITLEABBREV>Decimal-Aligned Table</TITLEABBREV>
<TGROUP ALIGN="char" CHAROFF="50" CHAR="." COLS="4">
<COLSPEC ALIGN="left" COLNUM="1" COLSEP="0" COLWIDTH="7pc">
<THEAD>
<ROW>
<ENTRY>Gas Ball</ENTRY>
<ENTRY>1940</ENTRY>
<ENTRY>1960</ENTRY>
<ENTRY>1980</ENTRY>
</ROW>
</THEAD>
<TFOOT>
<ROW>
<ENTRY>Rating</ENTRY>
<ENTRY>3</ENTRY>
<ENTRY>1</ENTRY>
<ENTRY>2</ENTRY>
</ROW>
</TFOOT>
<TBODY>
<ROW>
<ENTRY>Diameter</ENTRY>
<ENTRY>345.021</ENTRY>
<ENTRY>211.02</ENTRY>
<ENTRY>221.3</ENTRY>
</ROW>
<ROW>
<ENTRY>Color</ENTRY>
<ENTRY>blue</ENTRY>
<ENTRY>red</ENTRY>
<ENTRY>yellow</ENTRY>
</ROW>
</TBODY>
</TGROUP>
</TABLE>
<TABLE FRAME="all">
<TITLE>Table With SpanSpec</TITLE>
<TGROUP COLS="5" COLSEP="1" ROWSEP="1">
<COLSPEC COLWIDTH="91*">
<COLSPEC COLNAME="col2" COLWIDTH="91*">
<COLSPEC COLNAME="col3" COLWIDTH="91*">
<COLSPEC COLNAME="col4" COLWIDTH="91*">
<COLSPEC COLNAME="col5" COLWIDTH="92*">
<SPANSPEC NAMEEND="col5" NAMEST="col4" SPANNAME="4to5">
<TBODY>
<ROW>
<ENTRY ALIGN="center" COLNAME="col2" VALIGN="middle">Software 1</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">Software 2</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">Software 3</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">Software 4</ENTRY></ROW>
<ROW>
<ENTRY ALIGN="center" VALIGN="middle">Platform 1</ENTRY>
<ENTRY ALIGN="center" MOREROWS="1" VALIGN="middle">25 MB</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">10 MB</ENTRY>
<ENTRY ALIGN="center" SPANNAME="4to5" VALIGN="middle">34 MB</ENTRY></ROW>
<ROW>
<ENTRY ALIGN="center" VALIGN="middle">Platform 2</ENTRY>
<ENTRY ALIGN="center" COLNAME="col3" VALIGN="middle">12 MB</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">30 MB</ENTRY>
<ENTRY ALIGN="center" VALIGN="middle">35 MB</ENTRY></ROW></TBODY></TGROUP>
</TABLE>


[Prev] CollabName
[Next] common.attrib
[Reference Home] [Davenport Group Home]