Modèle:Arbre généalogique/documentation
Cette page n’est pas destinée à être visualisée directement. Les liens utilisant des pseudo-variables peuvent paraître rompus (en rouge) ; ne pas les remplacer par des noms de pages codés en dur ni des URL.
Ce modèle sert à afficher un w:arbre généalogique, ou plus généralement un w:organigramme, dans un article. Il a été conçu de façon à ce que sa syntaxe soit pratique à éditer. Son utilisation demeure néanmoins un peu complexe et il est recommandé d'effectuer préalablement des tests sur un bac à sable.
Syntaxe
[modifier]De façon générale :
- l'arbre débute par le modèle
{{Arbre généalogique/début}}
; - chaque génération (ou niveau) fait l'objet d'une ligne sous la forme
{{Arbre généalogique}}
complété des paramètres décrivant la ligne (voir ci-dessous) ; - l'arbre se clôt par le modèle
{{Arbre généalogique/fin}}
.
Les paramètres du modèle, utilisés pour chaque ligne, décrivent la ligne de gauche à droite ; ils peuvent être :
- soit vides, si cet emplacement dans la ligne ne correspond à rien dans l'arbre ;
- soit un caractère représentant un tracé élémentaire (trait, angle de trait, etc. Voir la liste complète ci-dessous) ;
- soit un court identifiant, symbolisant une personne (ou une case). Le texte à afficher dans la case correspondante doit alors être renseigné en fin de ligne (voir l'exemple ci-dessous pour mieux comprendre).
Idéalement les paramètres vides seront représentés par une espace, et les identifiants de case seront composés de 3 caractères, et précédés et suivis d'une espace ; ainsi on garde une certaine apparence visuelle de l'arbre dans le texte source même (en fait, on peut disposer de 5 caractères, espaces éventuelles avant et après comprises, pour l'identifiant).
Note importante : pour des raisons de compatibilité avec le code, les identifiants des cases (ou des personnes) ne doivent être ni des caractères représentant les tracés élémentaires (A, C, D, F, é, è, etc.), ni les nombres de 1 à 150 qui constituent les keys du modèle, ceux-ci créant des bugs d'affichage.
Tableau récapitulatif des tracés élémentaires
[modifier]Tous les tracés élémentaires possibles (à gauche le caractère utilisé, dans le cadre le rendu) : w:modèle:Arbre généalogique/Documentation/Liens familiaux
- Notes
- vous pouvez placer le tableau récapitulatif ci-dessus en pense-bête dans votre espace utilisateur, via w:modèle:Arbre généalogique/Documentation/Liens familiaux ;
- les paramètres des cadres par défaut sont
<div style="text-align:center; border:2px solid black; padding:0.2em; margin:0 auto;">{{{1}}}</div>
, ce qui donne :
- on peut cependant personnaliser l'apparence des cases de l'arbre via les paramètres
border
etboxstyle
. Voir l'exemple 3.
Exemples
[modifier]Voir la page suivante pour différents modèles d'arbres.
w:Modèle:Arbre généalogique/Test
- Exemples d'usage généalogique sur le projet
- Exemples hors généalogie sur le projet