Revision as of 09:07, 1 September 2012
|These pages are being transferred from UserBase. Please don't work on them until the transfer is complete, and the old UserBase pages have been removed.|
- 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.
- 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>.
- 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
- A tbody is a required element in a table. There are no attributes. The tbody contains rows.
- 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.
- 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> 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> is not currently used in KDE Documentation. If you want to use it, please see the Duck book for information.
Example: An <informaltable> template
Example: A <table> template