Modèle:Souverain3/Documentation

Ceci est la page de documentation de Modèle:Souverain3 [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.

Ce modèle est obsolète mais il faut le conserver pour des raisons de compatibilité.

Le modèle Souverain3/Documentation est obsolète. (Vérifier son utilisation.)
Il a été remplacé par {{noble}}, qui est plus facile à utiliser et offre plus de possibilités.

Ce modèle utilise le module Nom dynastique, un script écrit dans le langage de programmation Lua. Toute expérimentation devrait être conduite d'abord via une sous-page bac à sable. Voir le projet Scribunto si vous voulez en savoir plus.

Le modèle Souverain3 permet d’écrire de manière concise le nom d'un membre d'une dynastie lorsqu'on veut indiquer le numéro d'ordre dynastique dans le libellé du lien en respectant la mise en forme typographique liée aux nombres. Il peut être utilisé lorsque le titre de l'article se présente sous la forme « nom numéro complément », tel Charles II le Chauve.

Par rapport à une écriture directe, ses avantages sont :

d'écrire l'exposant correctement pour les premiers d'une dynastie (à l'image de : Élisabeth I^re) ;
d'insérer une espace insécable entre le nom et le numéro d'ordre ;
d'afficher une infobulle en donnant en toutes lettres ou en chiffres arabes la signification des nombres en chiffre romains ;
de permettre une mise en forme simple pour les articles de souverains qui ont un surnom présenté en italiques.

Ils évitent les syntaxes de code wiki complexe, par exemple [[Pépin Ier d'Aquitaine|{{nobr|Pépin {{Ier}}}} d'Aquitaine]] peut s'écrire {{souverain3|Pépin Ier d'Aquitaine}} pour obtenir Pépin I^er d'Aquitaine.

Par rapport au modèle {{Souverain2}}, le modèle Souverain3 est indiqué uniquement lorsqu'on veut afficher en extension les liens du type Louis II d'Italie, puisque le code {{souverain3|Louis II d'Italie}} est plus simple que {{souverain2|Louis II d'Italie|d'Italie}} pour un même résultat, de même que {{Souverain3|Philippe IV ''le Bel''}} est plus simple que {{Souverain2|Philippe IV le Bel|''le Bel''}}

Syntaxe

Le modèle accepte un argument obligatoire :

{{Souverain3|nom d'article}}

Note : pour des raisons historiques (compatibilité des anciennes versions), il est toujours possible d'écrire les paramètres en les séparant par des « | », sans changement de rendu :

{{Souverain3|prénom de règne|ordre|complément de lien}}

Si une partie du complément de lien est libellé ''surnom'' ou dit ''surnom'', ce surnom est affiché en italique, le lien vers l'article est reconstitué en utilisant surnom seul. Cela fonctionne de la même manière avec des guillemets (« surnom » ou dit « surnom »). On peut également écrire ces formes avec une virgule : {{Souverain3|Unetelle III, dite ''surnom''}} (pour un article dont le titre est Unetelle III surnom) et {{Souverain3|Untel VI, dit « surnom »}} (pour un article dont le titre est Untel VI surnom).

Exemples d’utilisation

Syntaxe	Résultat	Commentaire
`{{Souverain3\|Marie Ire de Portugal}}`	Marie I^re de Portugal	Équivalent à : `[[Marie Ire de Portugal}}\|{{nobr\|Marie {{Ire}}}}} de Portugal]]` ou `{{Souverain2\|Marie Ire de Portugal\|de Portugal}}`
`{{Souverain3\|Charles II ''le Chauve''}}`	Charles II le Chauve	Équivalent à : `[[Charles II le Chauve\|{{nobr\|Charles {{II}}}}} ''le Chauve'']]` ou `{{Souverain2\|Charles II le Chauve\|''le Chauve''}}`
`{{Souverain3\|Charles II dit ''le Chauve''}}`	Charles II dit le Chauve	Équivalent à : `[[Charles II le Chauve\|{{nobr\|Charles {{II}}}}} dit ''le Chauve'']]` ou `{{Souverain2\|Charles II le Chauve\|dit ''le Chauve''}}`
`{{Souverain3\|Charles II, dit « le Chauve »}}`	Charles II, dit « le Chauve »	Équivalent à : `[[Charles II le Chauve\|{{nobr\|Charles {{II}}}}}, dit « le Chauve »]]` ou `{{Souverain2\|Charles II le Chauve\|, dit « le Chauve »}}`
`{{Souverain3\|Charles II le Chauve\|, roi de France}}`	Charles II, roi de France	Équivalent à : `[[Charles II le Chauve\|{{nobr\|Charles {{II}}}}}, roi de France]]` ou `{{Souverain2\|Charles II le Chauve\|, roi de France}}`.
`{{Souverain3\|Louis XXXI l'Inattendu}}`	Louis XXXI l'Inattendu	Lien rouge, article inexistant
`{{Souverain3\|Louis le Pieux}}`	Louis le Pieux	Pas de mise en forme liée aux nombres. À éviter, il faut privilégier `[[Louis le Pieux]]`.

Templatedata

Le modèle Souverain3 permet d’écrire facilement et de typographier correctement le titre d'un souverain lorsqu'on veut indiquer le numéro d'ordre dynastique dans le libellé du lien en respectant les conventions typographiques.

Paramètres du modèle[Modifier les données du modèle]
La mise en forme sur une seule ligne est préférée pour ce modèle.
Paramètre		Description	Type	État
Nom	`1`	Nom de l'article Exemple Philippe IV le Bel	Nom de page	obligatoire
Complément	`2`	Complément du nom dynastique Exemple «, roi de France » dans : [[Philippe IV le Bel\|Philippe IV, roi de France]]	Chaîne	facultatif

Voir aussi

{{Souverain2}}, {{Souverain-}}
{{Noble}}
{{Ier}}, {{Ire}}, {{II}}, {{III}}, etc.
{{Nobr romains}}
Espace insécable, obtenue par «   » dans MediaWiki : évite une rupture de ligne sur une espace.
Wikipédia:Conventions typographiques
Wikipédia:Conventions concernant les nombres