Voir la source de Modèle:Succession/Documentation

{{Sous-page de documentation}}

== Utilisation ==
Ces modèles servent à insérer des boîtes de succession.

Les explications ci-dessous concernent les modèles {{m|Succession/Début}}, {{m|Succession/Ligne}} et {{m|Succession/Fin}}.

== Syntaxe ==
=== Syntaxe simple ===
<pre>
{{Succession/Début}}
{{Succession/Ligne
 | nom     = 
 | avant   = 
 | après   = 
 | période = 
}}
{{Succession/Fin}}
</pre>
=== Syntaxe complexe ===
<pre>
{{Succession/Début|titre=|genre=|étatboîte=|dessus=|styledessus=}}
{{Succession/Ligne
 | couleur1      = 
 | couleur2      = 
 | couleur3      = 
 | icone         = 
 | iconeG        = 
 | iconeD        = 
 | nom           = 
 | nom note      = 
 | nbno          = 
 | avant         = 
 | avant note    = 
 | avant période = 
 | avant icone   = 
 | avant iconeG  = 
 | avant iconeD  = 
 | nbav          = 
 | après         = 
 | après note    = 
 | après période = 
 | après icone   = 
 | après iconeG  = 
 | après iconeD  = 
 | nbap          = 
 | période       = 
}}
[Possibilité d'insérer plusieurs boîtes de suite]
{{Succession/Fin|dessous=|styledessous=}}
</pre>

== Paramètres ==
Pour le modèle {{m|Succession/Début}}
* <code>titre</code> : nom de la personne. Par défaut le titre de la page.
* <code>genre</code> : genre de la personne (<code>masculin</code> ou <code>féminin</code>). Par défaut <code>masculin</code>.
* <code>étatboîte</code> : ce paramètre contrôle l’enroulement et le déroulement de la boîte lorsqu’elle s’affiche sur une page. 
** ''collapsed'' : la boîte sera fermée (enroulée) lors du chargement de la page.
** ''uncollapsed (par défaut)'' : la boîte sera ouverte (déroulée) lors du chargement de page.
** ''autocollapse'' : la boîte sera ouverte (déroulée), mais, si la page contient deux boîtes ou plus, elles seront fermées (enroulées) lors du chargement de la page.
* <code>dessus</code> : une cellule pleine largeur peut apparaître sous la barre de titre.
* <code>styledessus</code> : les styles CSS à appliquer à la cellule du haut (spécifiés par le paramètre ''dessus''). Souvent utilisés pour l’alignement du texte et la couleur de fond :
** <code>background:#''nnnnnn'';</code>
** <code>text-align:[''left/center/right''];</code>

{{Boîte déroulante/début|titre=Paramètres techniques}}
; ''modèle''
: À ne renseigner que pour les modèles. Vous pouvez entrer <code><nowiki>{{subst:PAGENAME}}</nowiki></code> comme valeur afin d’éviter les erreurs. Par défaut, les liens renverront vers le modèle Succession.

; ''styletitre''
: Les styles [[Feuilles de style en cascade|CSS]] à appliquer à la barre d’en-tête. Exemples : 
:* <code><nowiki>styletitre = background:</nowiki>''#nnnnnn'';</code>
:* <code><nowiki>styletitre = background:</nowiki>''nom'';</code>

; ''stylecorps''
: Les styles CSS à appliquer au corps du modèle. Le mot ''<code>style</code>'' (plus court) peut être utilisé lorsqu’aucun autre paramètre de style n’est spécifié. Cette option doit être utilisée avec parcimonie, car elle peut provoquer des contradictions visuelles. Exemples :
:* <code>stylecorps = background:#''nnnnnn'';</code>
:* <code>stylecorps = text-align:[''right/center/left/justified''];</code>
:* <code>stylecorps = width:''N''&nbsp;[em/%/px ou width:auto];</code>
:* <code>stylecorps = float:[''left/right/none''];</code>
:* <code>stylecorps = clear:[''right/left/both/none''];</code>

; ''styleentête''
: Les styles [[Feuilles de style en cascade|CSS]] à appliquer à l'en-tête des colonnes. Exemple : 
:* <code><nowiki>styletitre = background:</nowiki>''#f7f8ff'';</code>

; ''titre avant''
: Titre à afficher pour la colonne de gauche. Par défaut : ''Précédé par''. 

; ''titre nom''
: Titre à afficher pour la colonne du milieu. Par défaut : rien. 

; ''titre après''
: Titre à afficher pour la colonne de droite. Par défaut : ''Suivi par''. 

; ''palette''
: À renseigner obligatoirement à ''oui'' pour les palettes. Cela permet d'enlever le saut de ligne.
{{Boîte déroulante/fin}}

Pour le modèle {{m|Succession/Ligne}}
* <code>couleur1</code> : indique la couleur de la case de gauche (par défaut : #EEEEEE).
* <code>couleur2</code> : indique la couleur de la case centrale (par défaut : blanc).
* <code>couleur3</code> : indique la couleur de la case de droite (par défaut : #EEEEEE).
* <code>icone</code> : nom de l'image (sans « Fichier: ») utilisée pour l'icône au-dessus du nom. Par défaut la taille en px est de 40 et peut être modifiée avec le paramètre <code>taille</code>.
* <code>iconeG</code> : nom de l'image (sans « Fichier: ») utilisée pour l'icône à gauche du nom. <small>Utilisez plus d'une icône seulement lorsque cela est vraiment nécessaire</small>. Par défaut la taille en px est de 40 et peut être modifiée avec le paramètre <code>avant taille</code>.
* <code>iconeD</code> : nom de l'image (sans « Fichier: ») utilisée pour l'icône à droite du nom. Par défaut la taille en px est de 40 et peut être modifiée avec le paramètre <code>après taille</code>.
* <code>nom</code> : libellé central de la succession (nom de la personne et/ou titre) (si identique à la boîte {{m|Succession/Ligne}} précédente, indiquer <code>idem</code>)
* <code>nom note</code> : remarque optionnelle à ajouter au libellé central.
* <code>nbno</code> : nombre de fois successives où le nom sera utilisé (fusion de la colonne centrale)
* <code>avant</code> : libellé du prédécesseur (si identique à la boîte {{m|Succession/Ligne}} précédente, indiquer <code>idem</code>).
* <code>avant note</code> : remarque optionnelle à ajouter au libellé du prédécesseur.
* <code>avant période</code> : période d'activité du prédécesseur.
* <code>avant icone</code> : nom de l'image (sans « Fichier: ») utilisée pour l'icône au-dessus du prédécesseur.
* <code>avant iconeG</code> : nom de l'image (sans « Fichier: ») utilisée pour l'icône à gauche du prédécesseur. <small>Utilisez plus d'une icône seulement lorsque cela est vraiment nécessaire</small>
* <code>avant iconeD</code> : nom de l'image (sans « Fichier: ») utilisée pour l'icône à droite du prédécesseur.
* <code>nbav</code> : nombre de fois successives où le prédécesseur sera utilisé (fusion de la colonne de gauche).
* <code>après</code> : libellé du successeur (si identique à la boîte {{m|Succession/Ligne}} précédente, indiquer <code>idem</code>).
* <code>après note</code> : remarque optionnelle à ajouter au libellé du successeur.
* <code>après période</code> : période d'activité du successeur.
* <code>après icone</code> : nom de l'image (sans « Fichier: ») utilisée pour l'icône au-dessus du successeur.
* <code>après iconeG</code> : nom de l'image (sans « Fichier: ») utilisée pour l'icône à gauche du successeur. <small>Utilisez plus d'une icône seulement lorsque cela est vraiment nécessaire</small>
* <code>après iconeD</code> : nom de l'image (sans « Fichier: ») utilisée pour l'icône à droite du successeur.
* <code>nbap</code> : nombre de fois successives où le successeur sera utilisé (fusion de la colonne de droite).
* <code>période</code> : période d'activité de la personne.

Pour le modèle {{m|Succession/Fin}}
* <code>dessous</code> : une cellule pleine largeur peut apparaître ''dessous'' le corps du modèle.
* <code>styledessous</code> : les styles CSS à appliquer à la cellule du bas (spécifiés par le paramètre ''dessous''). Souvent utilisés pour l’alignement du texte et la couleur de fond :
** <code>background:#''nnnnnn'';</code>
** <code>text-align:[''left/center/right''];</code>

== Exemples ==
=== Exemple 1 ===
<pre>
{{Succession/Début}}
{{Succession/Ligne
 | couleur1 = white
 | couleur3 = lightblue
 | icone    = Royal Arms of England (1399-1603).svg
 | nom      = [[roi d'Angleterre]]
 | avant    = [[Étienne d'Angleterre|Étienne]]
 | après    = [[Richard Ier d'Angleterre|Richard {{Ier}}]]|nbap=4
 | période  = 1154-1189
}}
{{Succession/Ligne
 | couleur2 = lightgreen
 | iconeD   = Blason Duché de Normandie.svg
 | nom      = [[duc de Normandie]]
 | avant    = [[Geoffroy V d'Anjou|Geoffroy ''Plantagenêt'']]|nbav=2
 | après    = idem
 | période  = 1150-1189
}}
{{Succession/Ligne
 | couleur1 = pink
 | iconeG   = smiley.svg
 | nom      = [[comte d'Anjou]]
 | avant    = idem
 | après    = idem
}}
{{Succession/Ligne
 | couleur1 = antiquewhite
 | couleur2 = crimson
 | nom      = [[comte du Maine]]
 | avant    = [[Élie II du Maine|Élie II]]
 | après    = idem
 | période  = 1151-1189
}}
{{Succession/Fin}}
</pre>
donne :
{{Succession/Début}}
{{Succession/Ligne|couleur1=white|couleur3=lightblue|icone=Royal Arms of England (1399-1603).svg
  |nom=[[roi d'Angleterre]]
  |avant=[[Étienne d'Angleterre|Étienne]]
  |après=[[Richard Ier d'Angleterre|Richard {{Ier}}]]
  |nbap=4
  |période=1154-1189}}
{{Succession/Ligne|couleur2=lightgreen|iconeD=Blason Duché de Normandie.svg
  |nom=[[duc de Normandie]]
  |avant=[[Geoffroy V d'Anjou|Geoffroy ''Plantagenêt'']]
  |nbav=2
  |après=idem
  |période=1150-1189}}
{{Succession/Ligne|couleur1=pink|iconeG=smiley.svg
  |nom=[[comte d'Anjou]]
  |avant=idem
  |après=idem}}
{{Succession/Ligne|couleur1=antiquewhite|couleur2=crimson
  |nom=[[comte du Maine]]
  |avant=[[Élie II du Maine|Élie II]]
  |après=idem
  |période=1151-1189}}
{{Succession/Fin}}

=== Exemple 2 ===
;Exemple avec la fusion des cases centrales
Les paramètres qui permettent de procéder ainsi sont sur les lignes '''nom=''', '''nbno=''' et '''nom=idem'''.
<pre>
{{Succession/Début|titre=Guillaume le Conquérant}}
{{Succession/Ligne
 | iconeG     = Blason Duché de Normandie.svg
 | nom        = [[Roi d'Angleterre]] et [[duc de Normandie]]
 | nom note   = appelé également Guillaume le Bâtard
 | nbno       = 2
 | avant      = [[Edgar Atheling|Edgar Ætheling]]
 | avant note = désigné par le Witan, non couronné roi d'Angleterre
 | après      = [[Guillaume II d'Angleterre|Guillaume II le Roux]]
 | après note = roi d'Angleterre
}}
{{Succession/Ligne
 | nom        = idem
 | avant      = [[Robert le Magnifique]]
 | avant note = duc de Normandie
 | après      = [[Robert II de Normandie|Robert Courteheuse]]
 | après note = duc de Normandie
}}
{{Succession/Fin}}
</pre>
donne :
{{Succession/Début|titre=Guillaume le Conquérant}}
{{Succession/Ligne
 | iconeG     = Blason Duché de Normandie.svg
 | nom        = [[Roi d'Angleterre]] et [[duc de Normandie]]|nbno=2
 | nom note   = appelé également Guillaume le Bâtard
 | avant      = [[Edgar Atheling|Edgar Ætheling]]
 | avant note = désigné par le Witan, non couronné roi d'Angleterre
 | après      = [[Guillaume II d'Angleterre|Guillaume II le Roux]]
 | après note = roi d'Angleterre
}}
{{Succession/Ligne
 | nom        = idem
 | avant      = [[Robert le Magnifique]]
 | avant note = duc de Normandie
 | après      = [[Robert II de Normandie|Robert Courteheuse]]
 | après note = duc de Normandie
}}
{{Succession/Fin}}

=== Exemple 3 ===
;Exemple avec des icônes et des périodes dans les cases de gauche ou de droite.

<pre>
{{Succession/Début|titre=Henri {{Ier}} d'Angleterre}}
{{Succession/Ligne
 | couleur1 = white
 | couleur2 = white
 | couleur3 = white
 | iconeG   = Blason Duché de Normandie.svg
 | nom      = [[Roi d'Angleterre]]
 | avant    = [[Guillaume II d'Angleterre|Guillaume II le Roux]]
 | après    = [[Étienne d'Angleterre|Étienne]]
 | après iconeD  = Blason_Duché_de_Normandie.svg
 | après période = 1135-1154
 | nbap     = 2
 | période  = 1100-1135
}}
{{Succession/Ligne
 | couleur1 = white
 | couleur2 = white
 | couleur3 = white
 | iconeG   = Blason Duché de Normandie.svg
 | nom      = [[Liste des ducs de Normandie|Duc de Normandie]]
 | avant    = [[Robert II de Normandie|Robert Courteheuse]]
 | avant iconeG  = Blason_Duché_de_Normandie.svg
 | avant période = 1087-1106
 | après    = idem
 | période  = 1106-1135
}}
{{Succession/Fin}}
</pre>
donne :
{{Succession/Début|titre=Henri {{Ier}} d'Angleterre}}
{{Succession/Ligne
 | couleur1 = white
 | couleur2 = white
 | couleur3 = white
 | iconeG   = Blason Duché de Normandie.svg
 | nom      = [[Roi d'Angleterre]]
 | avant    = [[Guillaume II d'Angleterre|Guillaume II le Roux]]
 | après    = [[Étienne d'Angleterre|Étienne]]
 | après iconeD  = Blason_Duché_de_Normandie.svg
 | après période = 1135-1154
 | nbap     = 2
 | période  = 1100-1135
}}
{{Succession/Ligne
 | couleur1 = white
 | couleur2 = white
 | couleur3 = white
 | iconeG   = Blason Duché de Normandie.svg
 | nom      = [[Liste des ducs de Normandie|Duc de Normandie]]
 | avant    = [[Robert II de Normandie|Robert Courteheuse]]
 | avant iconeG  = Blason_Duché_de_Normandie.svg
 | avant période = 1087-1106
 | après    = idem
 | période  = 1106-1135
}}
{{Succession/Fin}}

=== Exemple 4 ===
;Exemple pour une femme.

<pre>
{{Succession/Début|titre=Axelle Red|genre=féminin}}
{{Succession/Ligne
  |nom=[[Victoire de l'artiste interprète féminine|Victoire de la musique de l'artiste interprète féminine]]
  |période=1999
  |avant=[[Zazie]]
  |après=[[Natacha Atlas]]
}}
{{Succession/Fin}}
</pre>
donne :
{{Succession/Début|titre=Axelle Red|genre=féminin}}
{{Succession/Ligne
  |nom=[[Victoire de l'artiste interprète féminine|Victoire de la musique de l'artiste interprète féminine]]
  |période=1999
  |avant=[[Zazie]]
  |après=[[Natacha Atlas]]
}}
{{Succession/Fin}}

== Gestion des erreurs ==
* Le modèle de base ne peut être utilisé. Seules ses sous-pages doivent être appelées. Dans le cas contraire le message suivant s'affiche :
{{Succession}}

== Voir aussi ==
* [[Wikipédia:Utilisation des modèles dynastiques]]
* Sous-pages du modèle :
{{Special:Prefixindex/Modèle:Succession/}}

;En-têtes :
* [[:Catégorie:Modèle boîte de succession]]
* {{m|S-hou}}
<includeonly>
<!-- Catégories pour le modèle -->
[[Catégorie:Modèle succession| ]]
[[Catégorie:Exclure lors de l'impression]]
</includeonly>