Documentation Primer/Manual/DocBook Reference/Tables - Revision history

Claus chr: Corrected links

2012-09-09T10:30:34Z

Corrected links

Claus chr at 08:29, 2 September 2012

2012-09-02T08:29:45Z

Claus chr at 09:07, 1 September 2012

2012-09-01T09:07:07Z

Claus chr: 1 revision: Moving Docbook Primer from UserBase to TechBase

2012-09-01T08:47:34Z

1 revision: Moving Docbook Primer from UserBase to TechBase

Annew: Marked this version for translation

2011-11-30T14:36:08Z

Marked this version for translation

New page

<translate>

=== Tables === 


{{Tag|informaltable}}
</translate><span id="informaltable"></span><translate>


: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 {{Tag|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 <tt>pgwide</tt>.


: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.


{{Tag|table}}
</translate><span id="table"></span><translate>


: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 {{Tag|informaltable}}.


{{Tag|1=tgroup cols=""}}
</translate><span id="tgroup"></span><translate>


:A {{Tag|tgroup}} is a required element in a table. The <tt>cols</tt> 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 <tt>tgroup</tt> must contain a <tt>tbody</tt>


{{Tag|tbody}}
</translate><span id="tbody"></span><translate>


:A <tt>tbody</tt> is a required element in a table. There are no attributes. The <tt>tbody</tt> contains rows.


{{Tag|row}}
</translate><span id="row"></span><translate>


: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.


{{Tag|entry}}
</translate><span id="entry"></span><translate>


: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.


{{Tag|thead}}
</translate><span id="thead"></span><translate>


:{{Tag|thead}} can be used to create a heading row for the table. It must appear before the <tt>tbody</tt> element, and should normally contain one <tt>row</tt> and as many <tt>entry</tt> elements as the rest of the table.


{{Tag|tfoot}}
</translate><span id="tfoot"></span><translate>


:{{Tag|tfoot}} is not currently used in KDE Documentation. If you want to use it, please see the Duck book for information.


'''Example: An {{Tag|informaltable}} template'''


{{Input|1=<nowiki>
<informaltable>
<tgroup cols="2">
<tbody>
<row>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</informaltable>
</nowiki>}}


'''Example: A {{Tag|table}} template'''


{{Input|1=<nowiki>
<table>
<title></title>
<tgroup cols="2">
<tbody>
<row>
<entry></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</nowiki>}}


{{Prevnext2
| prevpage=Documentation Primer/Manual/DocBook Reference/Lists
| prevtext=Lists
| nextpage=Documentation Primer/Manual/DocBook Reference/GUI elements
| nexttext=The GUI elements, menus, toolbars and shortcuts
| index=Documentation Primer/Manual
| indextext=Back to Menu
}}

</translate>

← Older revision		Revision as of 08:29, 2 September 2012
Line 1:		Line 1:
	<languages />		<languages />
−	~~{{Transferring}}~~
	<translate>		<translate>

← Older revision		Revision as of 09:07, 1 September 2012
Line 1:		Line 1:
		+	<languages />
		+	{{Transferring}}
	<translate>		<translate>

@@ Line 12: / Line 12: @@
 <!--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-->
@@ Line 43: / Line 43: @@
 <!--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-->
@@ Line 50: / Line 50: @@
 <!--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-->
@@ Line 103: / Line 103: @@
 <!--T:24-->
 {{Prevnext2
-| prevpage=Documentation Primer/Manual/DocBook Reference/Lists
+| prevpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/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
-| index=Documentation Primer/Manual
+| index=Special:myLanguage/Documentation Primer/Manual
 | indextext=Back to Menu
 }}
 </translate>