User:Martinvl/SimpleTree/doc

This is a documentation subpage for User:Martinvl/SimpleTree.
It may contain usage information, categories and other content that is not part of the original user template page.

Under development

This documentation page is still under development. When this article (and associated articles) are moved into Main Space, all that should be neccessary is to remove the text "User:Martinvl/" (and this banner!) from all files.

Please note that this file uses the notation "root", "first level branch", "second level branch" where the French version uses "branche de premier niveau" (1st level), "branche de second niveau" (2nd level) and "branche de troisième niveau" (3rd level)

The original French article can be found here.

Usage

The family of templates {{User:Martinvl/SimpleTree}}, {{User:Martinvl/SimpleTree/End}}, {{User:Martinvl/SimpleTree/Leaf}}, {{User:Martinvl/SimpleTree/Branch}} and {{User:Martinvl/SimpleTree/BranchTerminator}} can be used to create a simple tree with one item of text per line (for example, a genealogical list of descendants).

Syntax

Beginning and end of the treee

The templates {{User:Martinvl/SimpleTree}} and {{User:Martinvl/SimpleTree/End}} must be placed at the beginning and at the end of the tree. Entries in the tree are made on a series of lines, each entry preceeded by one or more "*" characters.

{{User:Martinvl/SimpleTree}}
* The detail of the tree is inserted here, one item per line, prefixed by an appropriate number of asterisks.
{{User:Martinvl/SimpleTree/End}}

Tree branches

Chaque branche de l’arbre est un élément de liste. Le code d’un arbre est donc finalement du type :

{{User:Martinvl/SimpleTree}}
* Root
** First level branch
*** Second level 
{{User:Martinvl/SimpleTree/End}}

Terminating a branch

The root element and dvery branch of the tree appear as a list. {{User:Martinvl/SimpleTree/Leaf}} :

{{User:Martinvl/SimpleTree}}
* Root text
** First level branch
*** Second level branch
*** Another second level branch
***{{User:Martinvl/SimpleTree/Leaf}} Terminate the second level branch
** Another first level branch
** {{User:Martinvl/SimpleTree/Leaf}} Terminate the first level branch
{{User:Martinvl/SimpleTree/End}}

Produces the following:

Root text
- First level branch
  - Second level branch
  - Another second level branch
  - User:Martinvl/SimpleTree/Leaf Terminate the second level branch
- Another first level branch
- User:Martinvl/SimpleTree/Leaf Terminate the first level branch

Lorsqu’un embranchement n’est pas nommé

Lorsqu’un embranchement n’est pas nommé, cela peut facilement se faire par le modèle [Template:M used with invalid code 'User:Martinvl/SimpleTree/Branch'. See documentation.], ou si c’est une branche finale par le modèle [Template:M used with invalid code 'User:Martinvl/SimpleTree/BranchTerminator'. See documentation.] :

{{User:Martinvl/SimpleTree}}
* La branche de premier niveau
** {{User:Martinvl/SimpleTree/Branch}}
*** Une branche de troisième niveau
*** Une autre branche de troisième niveau
***{{User:Martinvl/SimpleTree/Leaf}} La branche finale du troisième niveau
** Une autre branche de second niveau
** {{User:Martinvl/SimpleTree/BranchTerminator}}                 <!--- Un embranchement qui finit le second niveau --->
*** Une branche de troisième niveau
***{{User:Martinvl/SimpleTree/Leaf}} La branche finale du troisième niveau
{{User:Martinvl/SimpleTree/End}}

qui donne le résultat suivant.

La branche de premier niveau
- - Une branche de troisième niveau
  - Une autre branche de troisième niveau
  - User:Martinvl/SimpleTree/Leaf La branche finale du troisième niveau
- Une autre branche de second niveau
- - Une branche de troisième niveau
  - User:Martinvl/SimpleTree/Leaf La branche finale du troisième niveau

Practical example

A genealogical tree

Example Change

This example will be replaced by one that is more appropriate to an English reader - possibly Queen Victoria's children and grandchildren.

Code :

{{User:Martinvl/SimpleTree}}
* [[Gérard Ier de Paris|Gérard I<sup>er</sup> de Paris]] († 779), [[comte de Paris]]
** [[Étienne de Paris]] († v. 815), comte de Paris  
** [[Leuthard Ier de Paris|Leuthard I<sup>er</sup> de Paris]] († v. 813/816), [[comté de Fézensac|comte de Fézensac]] puis comte de Paris.
*** Engeltrude de Fézensac, épouse [[Eudes d’Orléans]], mère d’[[Ermentrude d'Orléans (fille d'Eudes d'Orléans)|Ermentrude d’Orléans]] qui épouse [[Charles le Chauve]] 
*** [[Girart de Roussillon]] († 874), fils de Leuthard I<sup>er</sup>, comte de Paris, duc de Viennois.
***{{User:Martinvl/SimpleTree/Leaf}} [[Adalard le Sénéchal]] († ap. 865), fils de Leuthard I<sup>er</sup>.
**** Étienne († 882)
**** Une fille, fiancée en 865 à [[Louis III de Germanie|Louis le Jeune]], fils de [[Louis le Germanique]]  
****{{User:Martinvl/SimpleTree/Leaf}} Adalhard, [[liste des comtes de Metz|comte de Metz]] († 890)
***** Étienne, comte de Chaumont
***** [[Gérard Ier de Metz|Gérard I<sup>er</sup> de Metz]] († 910), [[comté de Metz|comte de Metz]], marié à Oda de Saxe, veuve de [[Zwentibold]], roi de Lotharingie
******{{User:Martinvl/SimpleTree/Leaf}} [[Godefroy de Basse-Lotharingie]] († ap. 949), marié à Ermentrude, fille de [[Charles le Simple]]
*******{{User:Martinvl/SimpleTree/Leaf}} [[Gérard II de Metz|Gérard II]], comte de Metz ([[944]]-[[963]])
********{{User:Martinvl/SimpleTree/Leaf}} [[Richard de Metz|Richard]], comte de Metz ([[963]]-[[982]])
********* [[Gérard III de Metz|Gérard III]] († 1021/1033), fils du précédent, marié à Éva, fille de [[Sigefroy de Luxembourg|Sigefroy]], [[Liste des comtes de Luxembourg|comte de Luxembourg]].
*********{{User:Martinvl/SimpleTree/Leaf}} [[Adalbert II de Metz|Adalbert II]], comte de Metz ([[1022]]-[[1033]]), marié à Judith von Öhningen.
**********{{User:Martinvl/SimpleTree/Leaf}} [[Gérard IV de Metz|Gérard IV]] ( † 1045), comte de Metz ([[1033]]-[[1045]])  
*********** [[Adalbert de Lorraine|Adalbert III]] († 1048), comte de Metz ([[1045]]-[[1047]]), [[Liste des ducs de Lorraine|duc de Lorraine]] (1047-1048).
***********{{User:Martinvl/SimpleTree/Leaf}} [[Gérard Ier de Lorraine|Gérard V]] († 1070), comte de Metz ([[1047]]-[[1070]]),  [[Liste des ducs de Lorraine|duc de Lorraine]] (1048-1070) 
***** [[Richer (évêque)|Richer de Liège]] († 945), fils d’Adalhard († 890). [[Évêque de Liège]] 
*****{{User:Martinvl/SimpleTree/Leaf}} [[Matfried Ier de Metz|Matfried I<sup>er</sup> de Metz]] († 930), frère du précédent, comte de Metz. Marié à Lantsint.
******{{User:Martinvl/SimpleTree/Leaf}} [[Adalbert Ier de Metz|Adalbert I<sup>er</sup> de Metz]] († 944), fils du précédent, comte de Metz marié à Luitgarde, fille de [[Wigéric de Bidgau]]
**{{User:Martinvl/SimpleTree/Leaf}} [[Bégon|Bégon de Paris]] († 816), comte de Paris, frère de Leuthard I<sup>er</sup>
*** Suzanne de Paris, épouse du comte Wulfhard de [[Flavigny]]
****{{User:Martinvl/SimpleTree/Leaf}} [[Adalhard de Paris]] (v. 830-† ap. 890), comte palatin, comte de Paris
*****{{User:Martinvl/SimpleTree/Leaf}} [[Wulfhard de Flavigny|Wulfhard]], [[chancelier (Empire carolingien)|chancelier d’Empire]]
***{{User:Martinvl/SimpleTree/Leaf}} [[Leuthard II de Paris|Leuthard II de Paris]] (806-858), comte de Paris
{{User:Martinvl/SimpleTree/End}}

Résultat :

Gérard I^er de Paris († 779), comte de Paris
- Étienne de Paris († v. 815), comte de Paris
- Leuthard I^er de Paris († v. 813/816), comte de Fézensac puis comte de Paris.
  - Engeltrude de Fézensac, épouse Eudes d’Orléans, mère d’Ermentrude d’Orléans qui épouse Charles le Chauve
  - Girart de Roussillon († 874), fils de Leuthard I^er, comte de Paris, duc de Viennois.
  - User:Martinvl/SimpleTree/Leaf Adalard le Sénéchal († ap. 865), fils de Leuthard I^er.
    - Étienne († 882)
    - Une fille, fiancée en 865 à Louis le Jeune, fils de Louis le Germanique
    - User:Martinvl/SimpleTree/Leaf Adalhard, comte de Metz († 890)
      - Étienne, comte de Chaumont
      - Gérard I^er de Metz († 910), comte de Metz, marié à Oda de Saxe, veuve de Zwentibold, roi de Lotharingie
        User:Martinvl/SimpleTree/Leaf Godefroy de Basse-Lotharingie († ap. 949), marié à Ermentrude, fille de Charles le Simple
        User:Martinvl/SimpleTree/Leaf Gérard II, comte de Metz (944-963)
        User:Martinvl/SimpleTree/Leaf Richard, comte de Metz (963-982)
        [[Gérard III de Metz|Gérard [[]] []]] († 1021/1033), fils du précédent, marié à Éva, fille de Sigefroy, comte de Luxembourg.
        
        User:Martinvl/SimpleTree/Leaf Adalbert II, comte de Metz (1022-1033), marié à Judith von Öhningen.
        User:Martinvl/SimpleTree/Leaf Gérard IV ( † 1045), comte de Metz (1033-1045)
        [[Adalbert de Lorraine|Adalbert [[]] []]] († 1048), comte de Metz (1045-1047), duc de Lorraine (1047-1048).
        
        User:Martinvl/SimpleTree/Leaf Gérard V († 1070), comte de Metz (1047-1070), duc de Lorraine (1048-1070)
      - Richer de Liège († 945), fils d’Adalhard († 890). Évêque de Liège
      - User:Martinvl/SimpleTree/Leaf Matfried I^er de Metz († 930), frère du précédent, comte de Metz. Marié à Lantsint.
        User:Martinvl/SimpleTree/Leaf Adalbert I^er de Metz († 944), fils du précédent, comte de Metz marié à Luitgarde, fille de Wigéric de Bidgau
- User:Martinvl/SimpleTree/Leaf Bégon de Paris († 816), comte de Paris, frère de Leuthard I^er
  - Suzanne de Paris, épouse du comte Wulfhard de Flavigny
    - User:Martinvl/SimpleTree/Leaf Adalhard de Paris (v. 830-† ap. 890), comte palatin, comte de Paris
      - User:Martinvl/SimpleTree/Leaf Wulfhard, chancelier d’Empire
  - User:Martinvl/SimpleTree/Leaf Leuthard II de Paris (806-858), comte de Paris

Un cladogramme