informaltable
Prev | DocBook Element Reference | Next

This is an alpha version of this book.

# informaltable

## Name

informaltable — A table without a title

##

# Synopsis

### Content Model

    informaltable ::=
    (graphic+|mediaobject+|tgroup+)

### Attributes

Common attributes

Name | Type | Default
pgwide | CDATA | None
label | CDATA | None
rowsep | CDATA | None
shortentry | CDATA | None
colsep | CDATA | None
tabstyle | CDATA | None
frame | Enumeration:
all
bottom
none
sides
top
topbot
| None
orient | Enumeration:
land
port
| None
tocentry | CDATA | None

### Parameter Entities

The following parameter entities contain informaltable:

Parameter Entities
`%admon.mix;` | `%bookcomponent.content;` | `%component.mix;`
`%divcomponent.mix;` | `%example.mix;` | `%figure.mix;`
`%footnote.mix;` | `%glossdef.mix;` | `%indexdivcomponent.mix;`
`%informal.class;` | `%para.mix;` | `%qandaset.mix;`
`%refcomponent.mix;` | `%revdescription.mix;` | `%sidebar.mix;`

## Description

An `InformalTable` element identifies an informal table (one without a `Title`). DocBook uses the CALS table model, which describes tables geometrically using rows, columns, and cells.

Tables may include column headers and footers, but there is no provision for row headers.

### Processing expectations

Formatted as a displayed block. 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 .

### Future Changes

The OASIS Exchange Table Model will replace the full OASIS Table Model.

### Parents

These elements contain informaltable: `answer`, `appendix`, `article`, `bibliodiv`, `bibliography`, `blockquote`, `callout`, `caution`, `chapter`, `constraintdef`, `example`, `figure`, `footnote`, `glossary`, `glossdef`, `glossdiv`, `important`, `index`, `indexdiv`, `informalexample`, `informalfigure`, `listitem`, `msgexplan`, `msgtext`, `note`, `para`, `partintro`, `preface`, `procedure`, `qandadiv`, `qandaset`, `question`, `refsect1`, `refsect2`, `refsect3`, `refsynopsisdiv`, `revdescription`, `sect1`, `sect2`, `sect3`, `sect4`, `sect5`, `section`, `setindex`, `sidebar`, `simplesect`, `step`, `tip`, `warning`.

### Children

The following elements occur in informaltable: `graphic`, `mediaobject`, `tgroup`.

## Attributes

colsep

  If `ColSep` has the value 1 (true), then a rule will be drawn to the right of all columns in this table. A value of 0 (false) suppresses the rule. The rule to the right of the last column in the table is controlled by the `Frame` attribute, not the `ColSep`.

frame

  `Frame` specifies how the table is to be framed.

label

  `Label` specifies an identifying string for presentation purposes.

  Generally, an explicit `Label` attribute is used only if the processing system is incapable of generating the label automatically. If present, the `Label` is normative; it will used even if the processing system is capable of automatic labelling.

orient

  `Orient` specifies the orientation of the `InformalTable`. An orientation of `Port` is the ‘upright’, the same orientation as the rest of the text flow. An orientation of `Land` is 90 degrees counterclockwise from the upright orientation.

pgwide

  If `Pgwide` has the value 0 (false), then the `InformalTable` is rendered in the current text flow (with flow column width). A value of 1 (true) specifies that the table should be rendered across the full text page.

rowsep

  If `RowSep` has the value 1 (true), then a rule will be drawn below all the rows in the `InformalTable` (unless other, interior elements, suppress some or all of the rules). A value of 0 (false) suppresses the rule. The rule below the last row in the table is controlled by the `Frame` attribute and the `RowSep` of the last row is ignored.

shortentry

  This attribute is meaningless on `InformalTable`..

tabstyle

  `TabStyle` holds the name of a table style defined in a stylesheet (e.g., a FOSI) that will be used to process this document.

tocentry

  This attribute is meaningless on `InformalTable`.

## See Also

`colspec`, `entry`, `entrytbl`, `equation`, `example`, `figure`, `informalequation`, `informalexample`, `informalfigure`, `row`, `spanspec`, `table`, `tbody`, `tfoot`, `tgroup`, `thead`.

## Examples

    <!DOCTYPE informaltable PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
              "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
    <informaltable frame='none'>
    <tgroup cols='2'>
    <colspec colwidth='0.5in'/>
    <colspec colwidth='0.5in'/>
    <tbody>
    <row><entry>1</entry><entry>1</entry></row>
    <row><entry>2</entry><entry>4</entry></row>
    <row><entry>3</entry><entry>9</entry></row>
    </tbody>
    </tgroup>
    </informaltable>

1 | 1
2 | 4
3 | 9

For additional examples, see also `entrytbl`, `footnoteref`, `refentry` .

Prev | Home | Next
informalfigure | Up | initializer

Copyright © 1999, 2000, 2001 O'Reilly & Associates, Inc.