:table. (Table)

Formats information as a table.

Syntax

┌───────────────┬───────────────┬───────────────┬───────────────┐
│Tag            │Element        │Attributes     │End            │
├───────────────┼───────────────┼───────────────┼───────────────┤
│:table.        │Tables         │cols=' '       │:etable.       │
├───────────────┼───────────────┼───────────────┼───────────────┤
│               │               │rules=         │               │
├───────────────┼───────────────┼───────────────┼───────────────┤
│               │               │frame=         │               │
├───────────────┼───────────────┼───────────────┼───────────────┤
│:row.          │Rows           │None           │None           │
├───────────────┼───────────────┼───────────────┼───────────────┤
│:c.            │Columns        │None           │None           │
└───────────────┴───────────────┴───────────────┴───────────────┘

Attributes

cols=' '

Specifies the width, in character spaces, of each column; for example: cols='10 15 20'.
rules=
Specifies whether the table will have horizontal and vertical rules. Following are the possible values and meanings:

both

Horizontal and vertical rules
horiz
Horizontal rules only
vert
Vertical rules only
none
No rules
Note: The default is both.
frame=
Specifies whether the table will have borders. Following are the possible values and meanings:

rules

A horizontal line at the top and bottom of the table
box
A box around the table
none
No borders.
Note: The default is box.

The :row. tag specifies the start of each row in the table. The :c. tag specifies the text for each column entry in the table. The text provided with the :c. tag is formatted within the column. However, if a single word is longer than the specified width of the column, the word will be clipped.

Example

The following defines a table with three columns and two rows. The width of each column is 15, 20, and 25 character spaces.

:table cols='15 20 25' rules=both frame=box.:row.
:c.Row 1 Col 1
:c.Row 1 Col 2
:c.Row 1 Col 3
:row.
:c.Row 2 Col 1
:c.Row 2 Col 2
:c.Row 2 Col 3
:etable.

Output

┌───────────────┬────────────────────┬─────────────────────────┐
│Row 1 Col 1    │Row 1 Col 2         │Row 1 Col 3              │
├───────────────┼────────────────────┼─────────────────────────┤
│Row 2 Col 1    │Row 2 Col 2         │Row 2 Col 3              │
└───────────────┴────────────────────┴─────────────────────────┘

---

[Back: :sl. (Simple List)]
[Next: :title. (Title)]