Difference between revisions of "Documentation Primer/Manual/DocBook Reference/Tables"

Jump to: navigation, search
(Corrected links)
 
Line 12: Line 12:
  
 
<!--T:4-->
 
<!--T:4-->
:An {{Tag|informaltable}} must contain a {{Tag|1=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|{{Tag|table}}]].  Do not use any attributes other than <tt>pgwide</tt> on tables or informal tables for KDE documentation.
+
:An {{Tag|informaltable}} must contain a {{Tag|1=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 [[Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Tables#table|{{Tag|table}}]].  Do not use any attributes other than <tt>pgwide</tt> on tables or informal tables for KDE documentation.
  
 
<!--T:5-->
 
<!--T:5-->
Line 43: Line 43:
  
 
<!--T:13-->
 
<!--T:13-->
:A <tt>row</tt> corresponds directly with the rows of the table.  Rows contain {{Tag|entry}} tags, one for each column in the table, as specified by the <tt>cols</tt> attribute on the [[#tgroup|{{Tag|tgroup}}]] tag.
+
:A <tt>row</tt> corresponds directly with the rows of the table.  Rows contain {{Tag|entry}} tags, one for each column in the table, as specified by the <tt>cols</tt> attribute on the [[Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Tables#tgroup|{{Tag|tgroup}}]] tag.
  
 
<!--T:14-->
 
<!--T:14-->
Line 50: Line 50:
  
 
<!--T:15-->
 
<!--T:15-->
: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 {{Tag|entry}}  tags  in  each  row  as  the <tt>cols</tt>  attribute  on  the  [[#tgroup|{{Tag|tgroup}}]] tag. There are no attributes used in KDE Documentation.   
+
: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 {{Tag|entry}}  tags  in  each  row  as  the <tt>cols</tt>  attribute  on  the  [[Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Tables#tgroup|{{Tag|tgroup}}]] tag. There are no attributes used in KDE Documentation.   
  
 
<!--T:16-->
 
<!--T:16-->
Line 103: Line 103:
 
<!--T:24-->
 
<!--T:24-->
 
{{Prevnext2
 
{{Prevnext2
| prevpage=Documentation Primer/Manual/DocBook Reference/Lists
+
| prevpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Lists
 
| prevtext=Lists
 
| prevtext=Lists
| nextpage=Documentation Primer/Manual/DocBook Reference/GUI elements
+
| nextpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/GUI elements
 
| nexttext=The GUI elements, menus, toolbars and shortcuts
 
| nexttext=The GUI elements, menus, toolbars and shortcuts
| index=Documentation Primer/Manual
+
| index=Special:myLanguage/Documentation Primer/Manual
 
| indextext=Back to Menu
 
| indextext=Back to Menu
 
}}
 
}}
  
 
</translate>
 
</translate>

Latest revision as of 11:30, 9 September 2012

Other languages:English 100%

[edit] 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.

Example: An <informaltable> template

<informaltable>
<tgroup cols="2">
<tbody>
<row>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</informaltable>

Example: A <table> template

<table>
<title></title>
<tgroup cols="2">
<tbody>
<row>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>

This page was last modified on 9 September 2012, at 11:30. This page has been accessed 1,164 times. Content is available under Creative Commons License SA 3.0 as well as the GNU Free Documentation License 1.2.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V.Legal