Modèle:Arbre généalogique/Documentation

Ceci est la page de documentation de Modèle:Arbre généalogique [modifier] [purger].
Cette sous-page contient les instructions, les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

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 {{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

Tous les tracés élémentaires possibles (à gauche le caractère utilisé, dans le cadre le rendu) : 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 le 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 :

Modèle:Saut

Contenu

Modèle:Saut