Voir la source de Modèle:Arbre généalogique/Documentation

{{Sous-page de documentation}}<includeonly>{{Protection}}</includeonly>

Ce modèle sert à afficher un [[arbre généalogique]], ou plus généralement un [[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 ==
De façon générale :
* l'arbre débute par le modèle <code><nowiki>{{Arbre généalogique/début}}</nowiki></code> ;
* chaque génération (ou niveau) fait l'objet d'une ligne sous la forme <code><nowiki>{{Arbre généalogique}}</nowiki></code> complété des paramètres décrivant la ligne (voir ci-dessous) ;
* l'arbre se clôt par le modèle <code><nowiki>{{Arbre généalogique/fin}}</nowiki></code>.

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 [[#Tableau récapitulatif des tracés élémentaires|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 <u>ni des caractères représentant les tracés élémentaires</u> (A, C, D, F, é, è, etc.), <u>ni les nombres de 1 à 150</u> qui constituent les ''keys'' du modèle, ceux-ci créant des bugs d'affichage.

== Tableau récapitulatif des tracés élémentaires ==
Tous les tracés élémentaires possibles (à gauche le caractère utilisé, dans le cadre le rendu) :
{{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 le modèle {{m|Arbre généalogique/Documentation/Liens familiaux}} ;
* les paramètres des cadres par défaut sont <code><nowiki><div style="text-align:center; border:2px solid black; padding:0.2em; margin:0 auto;">{{{1}}}</div></nowiki></code>, ce qui donne : 
{{saut|1em}}
<center><div style="width:200px; text-align:center; border:2px solid black; padding:0.2em; margin:0 auto;">Contenu</div></center>
{{saut|1em}}
* on peut cependant personnaliser l'apparence des cases de l'arbre via les paramètres <code>border</code> et <code>boxstyle</code>. Voir [[Modèle:Arbre généalogique/Test#Exemple 3|l'exemple 3]].

== Exemples ==
Voir la page suivante pour différents modèles d'arbres.

{{Article détaillé|Modèle:Arbre généalogique/Test}}

;Exemples d'usage généalogique sur le projet
* [[Arbre généalogique des Bourbons]]

;Exemples hors généalogie sur le projet
* [[Conservation de la viande#Possibilités de traitements|Conservation de la viande]]
* [[Armée belge]]
* [[Union mondiale de billard]]
* [[Portail:Croisades/Catégories/texte]]
* [[Stockage des céréales#Typologie des modes de stockage à moyen et long terme|Stockage des céréales]]
<includeonly>
[[Catégorie:Modèle généalogie]]
</includeonly>