entrytbl

entrytbl — A subtable appearing in place of an Entry in a table

Synopsis

entrytbl ::=

  • Sequence of:

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • align (enumeration)
    • “center”
    • “char”
    • “justify”
    • “left”
    • “right”
  • char
  • charoff (decimal)
  • At most one of:
    • colname
    • namest
    • spanname
    • All or none of:
      • namest
      • nameend
  • cols (positiveInteger)
  • colsep (enumeration)
    • “0”
    • “1”
  • rowsep (enumeration)
    • “0”
    • “1”
  • tgroupstyle

Description

The entrytbl element allows for a single level of nesting within CALS tables.

An entry table may occur in a row instead of an entry. An entrytbl has most of the elements of a table but may not include themselves, thus limiting nesting to a single level.

Note

An entrytbl can span horizontally (across columns) but it cannot span across rows. Whether this is by accident or design is unclear, but it has always been that way in CALS.

Processing expectations

This element is expected to obey the semantics of the CALS Table Model Document Type Definition, as specified by OASIS Technical Memorandum TM 9502:1995.

The content of entrytbl is formatted, as a table, to fit within the table cell that it occupies. Horizontal and vertical spanning may allow an entrytbl to occupy several physical cells in the table that contains it.

If multiple entrytbls occur in a single row, formatters that support entrytbl are not required to ensure that subrows within the various tables are vertically aligned.

Many formatters are incapable of supporting entrytbls. This is an interchange issue. See Appendix E, Interchanging DocBook Documents.

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

colname

Specifies a column specification by name.

cols

The number of columns in the entry 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

nameend

Specifies an ending column by name.

namest

Specifies a starting column by name.

namest

Specifies a starting column by name.

rowsep

Specifies the presence or absence of the row separator

Enumerated values:
“0”

No row separator rule.

“1”

Provide a row separator rule below

spanname

Specifies a span by name.

tgroupstyle

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

Parents

These elements contain entrytbl: row (db.row).

Children

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

See Also

colspec, entry, informaltable, row, spanspec, table, tbody, tfoot, tgroup, thead

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example entrytbl</title>

<!-- entrytbl not supported, fake it in descrip.1 -->
<informaltable frame='all'>
<tgroup cols='3'>
<tbody>
<row>
  <entry>a1</entry>
  <entry>b1</entry>
  <entry>c1</entry>
</row>
<row>
  <entry>a2</entry>
  <entrytbl cols='3'>
    <tbody>
      <row>
        <entry>b2a1</entry>
        <entry>b2b1</entry>
        <entry>b2c1</entry>
      </row>
      <row>
        <entry>b2a2</entry>
        <entry>b2b2</entry>
        <entry>b2c2</entry>
      </row>
      <row>
        <entry>b2a3</entry>
        <entry>b2b3</entry>
        <entry>b2c3</entry>
      </row>
    </tbody>
  </entrytbl>
  <entry>c2</entry>
</row>
<row>
  <entry>a3</entry>
  <entry>b3</entry>
  <entry>c3</entry>
</row>
</tbody>
</tgroup>
</informaltable>

</article>
a1 b1 c1
a2
b2a1 b2b1 b2c1
b2a2 b2b2 b2c2
b2a3 b2b3 b2c3
c2
a3 b3 c3

ChangeLog

This alpha reference page is $Revision: 7120 $ published Sun, 22 Jul 2007.