Difference between revisions of "Aide:Tableaux"

From Gramps
Jump to: navigation, search
m
(→‎Résumé des balises tableau du wiki)
Line 3: Line 3:
 
La règle générale est que l'on évite les tableaux tant que l'on n'a pas besoins d'eux. La balise du tableau complique souvent l'édition de la page page.
 
La règle générale est que l'on évite les tableaux tant que l'on n'a pas besoins d'eux. La balise du tableau complique souvent l'édition de la page page.
  
−
== Résumé des balises tableau du wiki ==
+
== Résumé des marqueurs de table Wiki ==
  
−
{|cellpadding="5" cellspacing="0" border="1" width="600"
+
{|cellpadding="5" cellspacing="0" border="1"
−
|<nowiki>{|</nowiki> || start '''table'''
+
|'''<nowiki>{|</nowiki>''' || début de '''table'''
 
|-
 
|-
−
|<nowiki>|+</nowiki> || table '''caption,''' ''optional;'' only one per table and between table start and first row
+
|'''<nowiki>|+</nowiki>''' || '''descriptif''' du contenu, ''optionnel;'' un seul par table positionné entre le début de la table et la première ligne
 
|-
 
|-
−
|<nowiki>|-</nowiki> || '''table row,''' ''optional on first row'' -- wiki engine assumes the first row
+
|'''<nowiki>|-</nowiki>''' || '''début de ligne''', ''optionnel sur la première ligne'' -- le moteur de wiki prend en charge la première ligne
 
|-
 
|-
−
|<nowiki>!</nowiki>  || '''table header''' cell, ''optional.'' Consecutive table headers may be added on same line separated by double marks (!!) or start on new lines, each with its own single mark (!).
+
|'''<nowiki>!</nowiki>''' || cellule '''entête''', ''optionnel.'' Les entêtes peuvent être mises soit sur la même ligne séparées par des doubles points d'exclamations (!!), soit sur des lignes séparées, chacune ayant son unique point d'exclamation (!).
 
|-  
 
|-  
−
|<nowiki>|</nowiki>  || '''table data''' cell, ''required!'' Consecutive table data cells may be added on same line separated by double marks (<nowiki>||</nowiki>) or start on new lines, each with its own single mark (<nowiki>|</nowiki>).
+
|'''<nowiki>|</nowiki>''' || cellule de '''donnée''' , ''requis!'' Les cellules de données consécutives d'une table peuvent être soit mises sur la même ligne séparées par une double barre verticale (<nowiki>||</nowiki>), soit sur des lignes séparées, chacune ayant son unique barre verticale (<nowiki>|</nowiki>).
 
|-
 
|-
−
|<nowiki>|}</nowiki> || end '''table'''
+
|'''<nowiki>|}</nowiki>''' || '''fin de table'''
 
|}
 
|}
−
*The above marks must '''start on a new line''' except the double || and !! for optionally adding consecutive cells to a line.
+
*Les marqueurs ci-dessus sont '''sur des ligne séparées''' sauf les doubles || et !! pour écrire plusieurs cellules consécutives sur une même ligne.
−
*'''XHTML attributes.''' Each mark, except table end, optionally accepts one or more XHTML attributes. Attributes must be on the same line as the mark. Separate attributes from each other with a single space.  
+
*'''Attributs XHTML''' : Chaque marqueur, hormis celui de fin de table, peut accepter un ou plusieurs attributs XHTML. Les attributs doivent être sur le même ligne que le marqueur. Séparez les attributs l'un de l'autre avec un simple espace.  
−
**Cells and caption (<nowiki>| or ||, ! or !!, and |+</nowiki>) hold content. So separate any attributes from content with a single pipe (|). Cell content may follow on same line or on following lines.
+
**Les cellules et les résumés (<nowiki>| ou ||, ! ou !!, et |+</nowiki>) sont des contenants. Il faut séparer les attributs du contenu avec une barre verticale (|). Le contenu d'une cellule peut suivre sur la même ligne ou des lignes consécutives.
−
**Table and row marks (<nowiki>{| and |-</nowiki>) do not directly hold content. Do ''not'' add pipe (|) after their optional attributes. If you erroneously add a pipe after attributes for the table mark or row mark the parser will delete it ''and'' your final attribute if it was touching the erroneous pipe!
+
**Les marqueurs de tables et de lignes (<nowiki>{| et |-</nowiki>) ne sont à proprement parler des contenants. ''Ne pas ajouter'' de barre verticale (|) après leurs attributs éventuels. Si par erreur vous ajoutez une barre verticale après les attributs d'un marquer de table ou de ligne, le parseur va supprimer celui-ci ''et'' le dernier attribut si il touchait la barre verticale en trop.
−
*'''Content''' may (a) follow its cell mark on the same line after any optional XHTML attributes or (b) on lines below the cell mark. Content that uses wiki markup that itself needs to start on a new line, such as lists, headers, or nested tables, must of course be on its own new line.
+
*'Le ''Contenu''' peut
 +
** soit suivre le marqueur de cellule sur la même ligne après les attributs XHTML éventuels
 +
** soit être sur les lignes suivant le marqueur de cellule. Un contenu qui utilise un marqueur wiki ayant besoin d'être placé sur une nouvelle ligne (ex. : nouvelle ligne, liste, entête ou table incluse) devrait bien sûr figurer sur sa propre ligne.
  
 
==Tableau simple==
 
==Tableau simple==

Revision as of 09:34, 1 June 2009

Les tableaux peuvent être inclus dans des pages wiki pages soit en utilisant les éléments tableaux HTML directement, soit en utilisant le format wiki pour définir un tableau. Les éléments du tableau HTML et leur utilisation sont bien décrit sur les différentes pages internet et ne sera pas discuté ici. Le bénéfice du code wiki étant que les tableaux sont une construction de symboles qui rendent la perception de la structure de ce dernier plus accessible qu'avec les éléments HTML.

La règle générale est que l'on évite les tableaux tant que l'on n'a pas besoins d'eux. La balise du tableau complique souvent l'édition de la page page.

Résumé des marqueurs de table Wiki

{| début de table
|+ descriptif du contenu, optionnel; un seul par table positionné entre le début de la table et la première ligne
|- début de ligne, optionnel sur la première ligne -- le moteur de wiki prend en charge la première ligne
! cellule entête, optionnel. Les entêtes peuvent être mises soit sur la même ligne séparées par des doubles points d'exclamations (!!), soit sur des lignes séparées, chacune ayant son unique point d'exclamation (!).
| cellule de donnée , requis! Les cellules de données consécutives d'une table peuvent être soit mises sur la même ligne séparées par une double barre verticale (||), soit sur des lignes séparées, chacune ayant son unique barre verticale (|).
|} fin de table
  • Les marqueurs ci-dessus sont sur des ligne séparées sauf les doubles || et !! pour écrire plusieurs cellules consécutives sur une même ligne.
  • Attributs XHTML : Chaque marqueur, hormis celui de fin de table, peut accepter un ou plusieurs attributs XHTML. Les attributs doivent être sur le même ligne que le marqueur. Séparez les attributs l'un de l'autre avec un simple espace.
    • Les cellules et les résumés (| ou ||, ! ou !!, et |+) sont des contenants. Il faut séparer les attributs du contenu avec une barre verticale (|). Le contenu d'une cellule peut suivre sur la même ligne ou des lignes consécutives.
    • Les marqueurs de tables et de lignes ({| et |-) ne sont à proprement parler des contenants. Ne pas ajouter de barre verticale (|) après leurs attributs éventuels. Si par erreur vous ajoutez une barre verticale après les attributs d'un marquer de table ou de ligne, le parseur va supprimer celui-ci et le dernier attribut si il touchait la barre verticale en trop.
  • 'Le Contenu' peut
    • soit suivre le marqueur de cellule sur la même ligne après les attributs XHTML éventuels
    • soit être sur les lignes suivant le marqueur de cellule. Un contenu qui utilise un marqueur wiki ayant besoin d'être placé sur une nouvelle ligne (ex. : nouvelle ligne, liste, entête ou table incluse) devrait bien sûr figurer sur sa propre ligne.

Tableau simple

Plaine

The following table lacks borders and good spacing but shows the simplest wiki markup table structure

Orange Apple
Bread Pie
Butter Ice cream 
{|
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Alternative

For more table-ish looking wiki markup cells can be listed on one line separated by ||. This does not scale well for longer cell content such as paragraphs. It works well for short bits of content however, such as our example table.

Extra spaces within cells in the wiki markup can be added, as I have done in the wiki markup below, to make the wiki markup itself look better but they do not effect the actual table rendering.

HTML attributes can be added to this table following the examples in other tables on this page but have been left out of the following example for simplicity.

Orange Apple more
Bread Pie more
Butter Ice cream and more 
{|
|  Orange    ||   Apple   ||   more
|-
|   Bread    ||   Pie     ||   more
|-
|   Butter   || Ice cream ||  and more
|}

Avec les attributs HTML

You can add HTML attributes to make your table look better

border="1"

Orange Apple
Bread Pie
Butter Ice cream 
{| border="1"
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

align="center" border="1"

Orange Apple
Bread Pie
Butter Ice cream 
{| align="center" border="1"
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

align="right" border="1"

You can put attributes on individual cells. Numbers for example may look better aligned right

Orange Apple 12,333.00
Bread Pie 500.00
Butter Ice cream 1.00 
{| border="1"
|Orange
|Apple
|align="right"|12,333.00
|-
|Bread
|Pie
|align="right"|500.00
|-
|Butter
|Ice cream
|align="right"|1.00
|}


You can put attributes on individual rows, too.

Orange Apple 12,333.00
Bread Pie 500.00
Butter Ice cream 1.00 
{| border="1"
|Orange
|Apple
|align="right"|12,333.00
|-
|Bread
|Pie
|align="right"|500.00
|- style="font-style:italic;color:green;"
|Butter
|Ice cream
|align="right"|1.00
|}

cellspacing="0" border="1"

Orange Apple
Bread Pie
Butter Ice cream 
{| cellspacing="0" border="1"
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

cellpadding="20" cellspacing="0" border="1"

Orange Apple
Bread Pie
Butter Ice cream 
{| cellpadding="20" cellspacing="0" border="1"
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Avec les attributs HTML et feuilles de style CSS

CSS style attributes can be added with or without other HTML attributes

style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"

Orange Apple
Bread Pie
Butter Ice cream 
{| style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Table with TH headings

TH (HTML table headings) can be created by using ! instead of |. Headings usually show up bold and centered by default.

En-têtes

Chaque colonne

Yummy Yummier
Orange Apple
Bread Pie
Butter Ice cream 
{| border="1" cellpadding="20" cellspacing="0"
!Yummy
!Yummier
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Colspan="2"

Yummies
Orange Apple
Bread Pie
Butter Ice cream 
{| border="1" cellpadding="20" cellspacing="0"
! colspan="2"|Yummies
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Side headings

Default

Fruit Orange Apple
Dish Bread Pie
Complement Butter Ice cream 
{| border="1" cellpadding="20" cellspacing="0"
!Fruit
|Orange
|Apple
|-
!Dish
|Bread
|Pie
|-
!Complement
|Butter
|Ice cream 
|}

Right justify

Right justified side headings can be done as follows

Fruit Orange Apple
Dish Bread Pie
Complement Butter Ice cream 
{| border="1" cellpadding="20" cellspacing="0"
!align="right" |Fruit
|Orange
|Apple
|-
!align="right" |Dish
|Bread
|Pie
|-
!align="right" |Complement
|Butter
|Ice cream 
|}

Caption

A table caption can be added to the top of any table as follows

Food complements
Orange Apple
Bread Pie
Butter Ice cream 
{| border="1" cellpadding="20" cellspacing="0"
|+Food complements
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Attributes can be added to the caption as follows

Food complements
Orange Apple
Bread Pie
Butter Ice cream 
{| border="1" cellpadding="20" cellspacing="0"
|+align="bottom" style="color:#e76700;"|''Food complements''
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Table with H1, H2, H3 etc. headings

HTML H1, H2, H3, H4 etc. headings can be created the standard wiki markup way with ==equal== signs and must be on a line all by themselves to work.

Preview the whole table. If you click on an edit tab for a heading within a table, edit, and preview, the parent table will display erroneously broken because part of it will be missing.

Keep the heading hierarchy consistent with the rest of the page so that the table of contents at page top works correctly.

Yummiest

Orange Apple
Bread Pie
Butter Ice cream 
{| border="1" cellpadding="20" cellspacing="0"
|colspan="2"|
===Yummiest===
|-
|Orange
|Apple
|-
|Bread
|Pie
|-
|Butter
|Ice cream 
|}

Lien externe

MediaWiki

Retrieved from "https://ftp.gramps-project.org/wiki/index.php?title=Aide:Tableaux&oldid=15800"