DocBook Publishers: The Definitive Guide  (Version 1.2.1 for DocBook 5.1)

entrytbl

entrytbl — A subtable appearing in place of an entry in a table.

Synopsis

entrytbl ::=

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 itself, 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 by 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 [calsdtd].

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 C, 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.

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

Examples

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

<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>
a1b1c1
a2
b2a1b2b1b2c1
b2a2b2b2b2c2
b2a3b2b3b2c3
c2
a3b3c3