Aide:Tableaux

From Gramps
Revision as of 03:33, 12 July 2009 by Romjerome (Talk | contribs) (Help:Tables/fr moved to Aide:Tableaux)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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

Brute

La table suivante manque de bordure, d'espacement correct mais montre la structure de table wiki la plus simple possible

Orange Pomme
Pain Tarte
Beurre Crème glacée
{|
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Alternative

Pour un look plus table, les marqueurs de cellule peuvent être sur le même ligne séparé par des ||. Ce n'est pas très approprié pour les contenus de cellule plutôt long comme des paragraphes. Cela marche mieux pour des contenus courts, comme dans notre exemple.

Des espaces supplémentaires peuvent être ajoutés autour des marqueurs, comme dans l'exemple ci-dessous, pour rendre la syntaxe wiki plus lisible mais cela n'affecte en rien le rendu de la table.

Des attributs HTML peuvent être ajoutés (voir d'autres exemple de cette page) mais n'ont pas été mis sur l'exemple suivant pour simplifier.

Orange Pomme autre
Pain Tarte autre
Beurre Crème glacée et plus
{|
|  Orange    ||   Pomme      ||   autre
|-
|   Pain     ||   Tarte      ||   autre
|-
|   Beurre   || Crème glacée ||  et plus
|}

Avec attributs HTML

Vous pouvez ajouter des attributs HTML pour améliorer le rendu visuel

border="1"

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

align="center" border="1"

Au niveau d'une table, l'attribut "align" concerne l'alignement de la table dans la page, et non pas l'alignement des cellules de la table.

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| align="center" border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée
|}

align="right" border="1"

Les attributs peuvent être mis au niveau cellule. Par exemple, les nombres sont plus lisibles si ils sont allgnés à droite.

Orange Pomme 12,333.00
Pain Tarte 500.00
Beurre Crème glacée 1.00
{| border="1"
|Orange
|Pomme
|align="right"|12,333.00
|-
|Pain
|Tarte
|align="right"|500.00
|-
|Beurre
|Crème glacée
|align="right"|1.00
|}


Les attributs peuvent aussi être positionnés au niveau ligne

Orange Pomme 12,333.00
Pain Tarte 500.00
Beurre Crème glacée 1.00
{| border="1"
|Orange
|Pomme
|align="right"|12,333.00
|-
|Pain
|Tarte
|align="right"|500.00
|- style="font-style:italic;color:green;"
|Beurre
|Crème glacée
|align="right"|1.00
|}

cellspacing="0" border="1"

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| cellspacing="0" border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

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

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| cellpadding="20" cellspacing="0" border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Attributs HTML et attributs de style CSS

Des attributs de style CSS peuvent être ajoutés avec ou sans autres attributs HTML.

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

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Tableau avec entête TH

TH (HTML Table Headings = entête de table HTML) peuvent être insérés en utilisant ! au lieu de |. Par défaut les entêtes sont en gras et centrées.

Titre

Titre de colonne

Délicieux Excellent
Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
!Délicieux
!Excellent
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Colspan="2"

Délices
Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
! colspan="2"|Délices
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Titre de ligne

Défaut

Fruit Orange Pomme
Plat Pain Tarte
Accompagnement Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
!Fruit
|Orange
|Pomme
|-
!Plat
|Pain
|Tarte
|-
!Accompagnement
|Beurre
|Crème glacée 
|}

Alignement à droite

L'alignement à droite des titres de ligne peut être réalisé comme suit

Fruit Orange Pomme
Plat Pain Tarte
Accompagnement Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
!align="right" |Fruit
|Orange
|Pomme
|-
!align="right" |Plat
|Pain
|Tarte
|-
!align="right" |Accompagnement
|Beurre
|Crème glacée 
|}

Légende

Une légende peut être ajoutée au dessus de la table comme suit

Compléments nutritionels
Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
|+Compléments nutritionels
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Des Attributs peuvent être ajoutés au résumé

Compléments nutritionels
Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
|+align="bottom" style="color:#e76700;"|''Compléments nutritionels''
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Tableau avec entête de type H1, H2, H3 etc.

Les types d'entête HTML H1, H2, H3, H4 etc. peuvent utilisés via les marqueurs wiki standards. Les signes ==égale== doivent être sur une même ligne pour être correctement interprétés.

Prévisualisez la table. Si vous cliquez sur la modification d'une entête situées dans une table, l'édition et la prévisualisation apparaitront incorrectement tronquées parce qu'une partie manquera.

Garder la hiérarchie des entêtes consistante avec le reste de la page pour que la table des matières en haut de la page fonctionne correctement.

Les plus fameux

Orange Pomme
Pain Tarte
Beurre Crème glacée
{| border="1" cellpadding="20" cellspacing="0"
|colspan="2"|
===Les plus fameux===
|-
|Orange
|Pomme
|-
|Pain
|Tarte
|-
|Beurre
|Crème glacée 
|}

Lien externe

MediaWiki