Tables
<informaltable>
This is the table type used most in KDE Documentation. Please be very
sure that what you are marking up as a table, is actually tabular data,
as in many cases a <variablelist> is
more appropriate. Please do not use any of the presentation attributes
to make tables “look nice”. The only attribute currently
allowed in KDE Documents is pgwide.
An <informaltable> must contain a
<tgroup cols=""> entry. Informal
tables have no specific title, if you wish the table to be titled and to
have an entry in the table of contents, you should use <table>. Do
not use any attributes other than pgwide on tables or informal tables for
KDE documentation.
<table>
A formal table with a title. Tables will have their own separate entry
in the table of contents. Other than the addition of a title, they are
marked up the same as an <informaltable>.
<tgroup
cols="">
A <tgroup> is a required element in a
table. The cols attribute is
required, and should be completed with the number of columns the table
is to hold. No other attributes used in KDE Documentation.
A tgroup must contain a tbody
<tbody>
A tbody is a required element in a
table. There are no attributes. The tbody contains rows.
<row>
A row corresponds directly with the
rows of the table. Rows contain <entry> tags, one for each column in the table,
as specified by the cols attribute
on the <tgroup> tag.
<entry>
The entry is the basic building block of a table. Each entry corresponds
to one “data cell” in the table. There must be as many
<entry> tags in each row as the
cols attribute on the <tgroup> tag.
There are no attributes used in KDE Documentation.
<thead>
<thead> can be used to create a
heading row for the table. It must appear before the tbody element, and should normally contain one
row and as many entry elements as the rest of the table.
<tfoot><tfoot> is not currently used in
KDE Documentation. If you want to use it, please see the Duck book
for information.
