<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 ispgwide.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 thanpgwideon 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. Thecolsattribute is required, and should be completed with the number of columns the table is to hold. No other attributes used in KDE Documentation.A
tgroupmust contain atbody<tbody>A
tbodyis a required element in a table. There are no attributes. Thetbodycontains rows.<row>A
rowcorresponds directly with the rows of the table. Rows contain<entry>tags, one for each column in the table, as specified by thecolsattribute 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 thecolsattribute 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 thetbodyelement, and should normally contain onerowand as manyentryelements 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.
Example A.4. An <informaltable>
template
<informaltable>
<tgroup cols="2">
<tbody>
<row>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</informaltable>
Example A.5. A <table> template
<table>
<title></title>
<tgroup cols="2">
<tbody>
<row>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>