Whole document tree
colspec
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.
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>