Description
This element holds a single entry of the table grid, though a single entry can span down into lower rows or across into later columns.
<row>
<entry>first entry</entry>
<entry>second entry</entry>
<entry>third entry</entry>
</row>
When an entry in one row spans down into the next row, there must be no entry in that row for the cell position affected:
<row>
<entry morerows="1">span down entry</entry>
<entry>second</entry>
<entry>third</entry>
</row>
<row>
<!-- NO ENTRY HERE -->
<entry>entry 2</entry>
<entry>entry 3</entry>
</row>
|----------------------------------------|
| span down | second | third |
| entry |-----------|--------------|
| | entry 2 | entry 3 |
|----------------------------------------|
If the first entry in the row does not start at the first column it must refer to the column it does start at:
<row>
<!-- NO ENTRY HERE -->
<entry namest="col-2">first entry (second column)</entry>
<entry>second entry (third column)</entry>
</row>
When a cell straddles columns, it must refer to the names of the first and last columns to span over:
<row>
<entry namest="col-1" nameend="col-2">span across entry</entry>
<!-- NO ENTRY HERE -->
<entry>second entry</entry>
</row>
<row>
<entry>entry</entry>
<entry>entry</entry>
<entry>entry</entry>
</row>
|----------------------------------------|
| span across entry | second entry |
|----------------------------------------|
| entry | entry | entry |
|----------------------------------------|
This is the only element in the CALS model that is customisable to specific DTD requirements, and in this case may contain most of the TFJA block and inline elements.
Parent Elements
The elements listed below may directly contain this element.
They are "parent" elements. Elements in referenced groups are included, up to two levels of group nesting.
Model Diagram
The DTD model for this element:
--+(choice of TEXT with elements repeated)
|
|--+(choice) [Paragraph Content]
| |
| |-- trademark -- TEXT
| |
| |-- footnote -- (elements)
| |
| |--+(choice) [Links from Text]
| | |
| | |-- xref -- (TEXT and elements)
| | |
| | |-- chemeqnref -- (TEXT and elements)
| | |
| | |-- chemformref -- (TEXT and elements)
| | |
| | |-- matheqnref -- (TEXT and elements)
| | |
| | |-- tableref -- (TEXT and elements)
| | |
| | |-- citationref -- (TEXT and elements)
| | |
| | |-- figureref -- (TEXT and elements)
| | |
| | |-- suppmatref -- (TEXT and elements)
| | |
| | |-- listref -- (TEXT and elements)
| | |
| | |-- listitemref -- (TEXT and elements)
| | |
| | |-- chemstructureref -- (TEXT and elements)
| | |
| | |-- footnoteref -- (TEXT and elements)
| | |
| | |-- endnoteref -- (TEXT and elements)
| | |
| | |-- textref -- (TEXT and elements)
| | |
| | |-- enunciationref -- (TEXT and elements)
| |
| |--+(choice) [Objects in Text]
| | |
| | |-- inlinematheqn -- (elements)
| | |
| | |-- inlinechemeqn -- (elements)
| | |
| | |-- inlinegraphic
| |
| |--+(choice) [Mail and Web Links in Text]
| | |
| | |-- email -- (TEXT and elements)
| | |
| | |-- webaddress -- (TEXT and elements)
| |
| |--+(choice) [Names in Text]
| | |
| | |-- famousname -- TEXT
| | |
| | |-- companyname -- (TEXT and elements)
| | |
| | |-- institutionname -- (TEXT and elements)
| | |
| | |-- citation -- TEXT
| |
| |--+(choice) [Acronyms and Terms in Text]
| | |
| | |-- acronym -- TEXT
| | |
| | |-- terminology -- (TEXT and elements)
| |
| |--+(choice) [Formatting in Text]
| | |
| | |-- sub -- (TEXT and elements)
| | |
| | |-- sup -- (TEXT and elements)
| | |
| | |-- b -- (TEXT and elements)
| | |
| | |-- i -- (TEXT and elements)
| | |
| | |-- smallcaps -- (TEXT and elements)
| | |
| | |-- u -- (TEXT and elements)
| | |
| | |-- box -- (TEXT and elements)
| | |
| | |-- roman -- (TEXT and elements)
| | |
| | |-- script -- (TEXT and elements)
| | |
| | |-- tt -- (TEXT and elements)
| | |
| | |-- strikethrough -- (TEXT and elements)
| | |
| | |-- overline -- (TEXT and elements)
| | |
| | |-- newpage
| | |
| | |-- query -- TEXT
| |
| |--+(choice) [Formatting Objects in Text]
| | |
| | |-- br
| | |
| | |-- refrange -- (elements)
|
|-- para -- (TEXT and elements)
|
|-- figure -- (elements)
|
|-- formaltable -- (elements)
|
|-- graphic
|
|-- informaltable -- (elements)
|
|-- chemeqn -- (elements)
|
|-- unnumchemeqn -- (elements)
|
|-- formula -- (TEXT and elements)
|
|-- compound -- (elements)
|
|-- structure
|
|-- matheqn -- (elements)
|
|-- unnummatheqn -- (elements)
|
|-- simplelist -- (elements)
|
|-- itemizedlist -- (elements)
|
|-- orderedlist -- (elements)
|
|-- deflist -- (elements)
|
|-- extract -- (elements)
|
|-- poem -- (elements)
|
|-- computertext -- (TEXT and elements)
|
|-- address-text -- (TEXT and elements)
DTD Definition
The DTD contains the following element and attribute definitions
(note that embedded links are to definitions within the DTD page of this guide):
<!ELEMENT entry (#PCDATA | %ParagraphContent;
| para
| figure | formaltable | graphic | informaltable
| chemeqn | unnumchemeqn | formula | compound | structure
| matheqn | unnummatheqn
| simplelist | itemizedlist | orderedlist | deflist
| extract | poem | computertext | address-text)*>
<!ATTLIST entry
colname NMTOKEN #IMPLIED
namest NMTOKEN #IMPLIED
nameend NMTOKEN #IMPLIED
morerows NMTOKEN #IMPLIED
colsep NMTOKEN #IMPLIED
rowsep NMTOKEN #IMPLIED
align (left | right | center | justify |
char) #IMPLIED
char CDATA #IMPLIED
charoff NMTOKEN #IMPLIED
valign (top | middle | bottom) #IMPLIED
%a-group-CommonIDAttrs;>
.
Defined in DTD section
Block-level Content : Tables
General Attributes (shared with other elements)
Local Attributes (defined for this element alone)
Description
This attribute is used when the entry is not to be placed in the next column to the right of the previously filled column. Instead, it is to be placed in the column whose name in the
<colspec> element is the same.
Specification
This attribute is not required. It holds a single name token (initial character must be a letter, '_' or ':', and remaining characters must be letters or digits or '_', ':', '-', or '.').
DTD Definition
colname NMTOKEN #IMPLIED
.
Attribute:
namest (
Name Start)
Description
This attribute is used in column-straddling cells to name the first column to start straddling from. In theory, it is still not needed if the entry would start in this column anyway, but it is safer to include it. The cell straddles across to the column referenced from the
nameend attribute.
Note that a different mechanism, using the
morerows attribute is used for row-straddling.
Specification
This attribute is not required. It holds a single name token (initial character must be a letter, '_' or ':', and remaining characters must be letters or digits or '_', ':', '-', or '.').
DTD Definition
namest NMTOKEN #IMPLIED
.
Description
This attribute is used in column-straddling cells to name the column to end the straddling from the column indicated by the
namest attribute.
Note that a different mechanism, using the
morerows attribute is used for row-straddling.
Specification
This attribute is not required. It holds a single name token (initial character must be a letter, '_' or ':', and remaining characters must be letters or digits or '_', ':', '-', or '.').
DTD Definition
nameend NMTOKEN #IMPLIED
.
Description
This attribute allows an entry to occupy the rows below the row it is in. The implied (or explicit) value of "0" indicates "zero more rows". A value of "1" means the entry will occupy the next row as well as this one.
Note that a very different mechanism is used for column-straddling that uses the
namest and
nameend attributes.
Specification
This attribute is not required. It holds a single name token (initial character must be a letter, '_' or ':', and remaining characters must be letters or digits or '_', ':', '-', or '.').
DTD Definition
morerows NMTOKEN #IMPLIED
.
Attribute:
colsep (
Column Separator)
Description
This attribute specifies whether or not a line needs to be drawn to the right of the entry ("0" means no, "1" means yes). By default, a line should not be drawn. Values larger than "1" should be treated as if it were "1". This attribute overrides the attributes with the same name in higher level structures.
Note that these lines should not be drawn to the right of entries in the final column. The
frame attribute should be used instead.
Specification
This attribute is not required. It holds a single name token (initial character must be a letter, '_' or ':', and remaining characters must be letters or digits or '_', ':', '-', or '.').
DTD Definition
colsep NMTOKEN #IMPLIED
.
Attribute:
rowsep (
Row Separator)
Description
This attribute specifies whether or not a line needs to be drawn beneath the entry ("0" means no, "1" means yes). By default, lines should not be drawn. Values larger than "1" should be treated as if it were "1". This attribute overrides the attributes with the same name in higher level structures.
Note that these lines should not be drawn beneath entries in the final row. The
frame attribute should be used instead.
Specification
This attribute is not required. It holds a single name token (initial character must be a letter, '_' or ':', and remaining characters must be letters or digits or '_', ':', '-', or '.').
DTD Definition
rowsep NMTOKEN #IMPLIED
.
Attribute:
align (
Alignment)
Description
This attribute specifies the default horizontal alignment of text within the cell. When the value is "char", the
char and
charoff attributes become significant. This setting overrides the settings for the same attribute at higher levels in the table structure.
Specification
This attribute is not required. The allowed values are "left", "right", "center", "justify" and "char".
DTD Definition
align (left | right | center | justify |
char) #IMPLIED .
Attribute:
char (
Character)
Description
This attribute holds the character that is deemed to be significant when there is a need to align cells in a column on a particular character. Typically, it holds a full-point or comma. It is only applied when the
align attribute is given the value "char". This setting overrides the settings for the same attribute at higher levels in the table structure.
Specification
This attribute is not required. It has text content.
DTD Definition
char CDATA #IMPLIED
.
Attribute:
charoff (
Character Offset)
Description
This attribute is used when the
align attribute is given the value "char" to specify the percentage from the left edge of the column that the character specified in the
charoff attribute is to be placed. If this character should appear in the middle of the column, then a value of "50" would be used. This setting overrides the settings for the same attribute at higher levels in the table structure.
Specification
This attribute is not required. It holds a single name token (initial character must be a letter, '_' or ':', and remaining characters must be letters or digits or '_', ':', '-', or '.').
DTD Definition
charoff NMTOKEN #IMPLIED
.
Attribute:
valign (
Vertical Alignment)
Description
This attribute specifies a vertical alignment for the cell, overriding all such settings in higher level constructs.
Specification
This attribute is not required. The allowed values are "top", "middle" and "bottom".
DTD Definition
valign (top | middle | bottom) #IMPLIED
.