Modèle:Noble/Documentation
Utilisation
[modifier le code]Le modèle Noble permet d’écrire de manière concise le nom d'un membre d'une dynastie lorsqu'on veut indiquer le numéro d'ordre (nombre ordinal) dynastique dans le texte en respectant la mise en forme typographique liée aux nombres et en insérant, ou non, un lien vers l'article correspondant.
Par rapport à une écriture directe, ses avantages sont :
- d'écrire l'exposant correctement pour les premiers d'une dynastie (à l'image de : Clovis Ier) ;
- 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 numéros (nombres ordinaux) en chiffres romains.
Le modèle prend un ou deux arguments : le nom de l'article et un complément optionnel. Le modèle Noble insère un lien vers l'article correspondant, et le modèle Noble- (avec un tiret) n'insère pas de lien.
Syntaxe
[modifier le code]Le modèle Noble est utilisé de la manière suivante :
{{
noble|nom de l'article}}
{{
noble-|nom de l'article}}
{{
noble|nom de l'article|complément du nom}}
{{
noble-|nom de l'article|complément du nom}}
{{
noble|nom de l'article|nom avec un autre numéro}}
{{
noble-|nom de l'article|nom avec un autre numéro}}
Détails
[modifier le code]Le nom d'un article, par exemple « Louis II de Bavière (1229-1294) », peut être décomposé en quatre parties :
- un nom « Louis » qui est toujours affiché ;
- un numéro « II » qui est toujours affiché avec sa traduction en texte ou en chiffres arabes dans une infobulle ;
- un éventuel complément « de Bavière » ;
- une éventuelle levée d'homonymie[1] « (1229-1294) » entre parenthèses, qui précise la page à utiliser lorsqu'il y a plusieurs homonymes comme c'est le cas pour Louis II de Bavière.
Quand le modèle est utilisé avec un seul argument ou avec un deuxième argument constitué d'un « * », le texte affiché contient le nom, le numéro et le complément : Louis II de Bavière.
Quand le modèle est utilisé avec un deuxième argument constitué d'un « + », le modèle affiche plus : le nom, le numéro, le complément et l'homonymie : Louis II de Bavière (1229-1294).
Quand le modèle est utilisé avec un deuxième argument vide ou constitué d'un « - »[2], le modèle affiche moins : le nom et le numéro : Louis II.
Quand le modèle est utilisé avec un deuxième argument non vide qui ne contient pas de chiffres romains, le texte affiché contient le nom, le numéro et le deuxième argument.
Quand le modèle est utilisé avec un deuxième argument qui contient des chiffres romains, le texte affiché contient seulement le deuxième argument, avec bien sûr l'infobulle pour les chiffres romains.
Le modèle accepte aussi un troisième argument comme supplément optionnel. Dans ce cas, il traitera les deux premiers arguments comme indiqué ci-dessus, puis il ajoutera le supplément avec bien sûr ses infobulles. Ceci peut être utile pour le cas particulier où on veut spécifier un autre complément du nom, mais que cet autre complément du nom contient des chiffres romains. Par exemple, {{noble|Ptolémée III||''Évergète Ier''}}
(notez le deuxième argument vide) génère Ptolémée III Évergète Ier .
Exemples
[modifier le code]Les exemples n'utilisent que le modèle Noble qui génère un lien interne. L'utilisation est identique avec le modèle Noble- (avec un tiret) qui ne génère pas de lien.
Avec un seul argument
[modifier le code]Syntaxe | Résultat | Commentaire |
---|---|---|
{{noble|Charlemagne}} |
Charlemagne | Accepté, mais inutile[3]. Il est préférable d'écrire[[Charlemagne]] .
|
{{noble|Clovis Ier}} |
Clovis Ier | Cas simple avec exposant. |
{{noble|Louis XIV}} |
Louis XIV | Cas simple avec chiffres romains. |
{{noble|Louis II le Jeune}} |
Louis II le Jeune | Un complément du nom apparaît. Pour qu'il n'apparaisse pas, écrire{{noble|Louis II le Jeune|-}} [4].
|
{{noble|Rotrude (fille de Charlemagne)}} |
Rotrude | Accepté, mais inutile[3]. La levée d'homonymie (entre parenthèses) n'apparaît pas. Il est préférable d'écrire[[Rotrude (fille de Charlemagne)|]] [4].
|
{{noble|Louis II de Bavière (1229-1294)}} |
Louis II de Bavière | Cas complexe, avec chiffres romains et levée d'homonymie. Le complément de nom apparaît, mais la levée d'homonymie n'apparaît pas. |
Avec un second argument « + » ou « - »
[modifier le code]Le second argument peut consister en un seul « + » ou un seul « - »[2].
Syntaxe | Résultat | Commentaire |
---|---|---|
{{noble|Louis II de Bavière (1229-1294)}} |
Louis II de Bavière | Affichage standard. |
{{noble|Louis II de Bavière (1229-1294)}|+}} |
Louis II de Bavière (1229-1294) | On affiche plus. |
{{noble|Louis II de Bavière (1229-1294)}|-}} |
Louis II | On affiche moins. |
{{noble|Louis II le Jeune|-}} |
Louis II | Un complément du nom n'apparaît pas. Pour qu'il apparaisse, écrire{{noble|Louis II le Jeune}} .
|
Avec un complément
[modifier le code]Syntaxe | Résultat | Commentaire |
---|---|---|
{{noble|Louis XV|le Bien-Aimé}} |
Louis XV le Bien-Aimé | Ajout d'un complément. |
{{noble|Louis II de Germanie|de Bavière}} |
Louis II de Bavière | Remplacement d'un complément. |
{{noble|Philippe IV le Bel|''le Bel''}} |
Philippe IV le Bel | Mise en forme d'un complément. |
Avec un autre numéro
[modifier le code]Syntaxe | Résultat | Commentaire |
---|---|---|
{{noble|Louis le Pieux|Louis Ier le Pieux}} |
Louis Ier le Pieux | Ajout d'un numéro. |
{{noble|Charles XIII|Charles II}} |
Charles II | Modification d'un numéro. |
{{noble|Philippe V le Long|Philippe V dit « le Long » ou Philippe II de Navarre}} |
Philippe V dit « le Long » ou Philippe II de Navarre | On peut avoir plusieurs fois des chiffres romains. |
Avec un supplément
[modifier le code]Syntaxe | Résultat | Commentaire |
---|---|---|
{{noble|Ptolémée III||''Évergète Ier''}} |
Ptolémée III Évergète Ier | Ajout d'un supplément. |
Dans l'exemple ci-dessus, le deuxième argument est vide. Ou pouvait aussi utiliser un « - » qui est traité de la même manière. Comme le titre de l'article ne contient qu'un nom et un numéro, on aurait tout aussi bien pu spécifier « * » ou « + » sans que cela change quoi que ce soit au résultat final.
Enfin, le troisième argument, le supplément, est ajouté à la fin. L'utilisation d'un supplément permet d'éviter de recourir à un deuxième argument avec chiffres romains et de devoir recopier Ptolémée III
, comme ce serait le cas si on avait écrit {{noble|Ptolémée III|Ptolémée III ''Évergète Ier''}}
.
Templatedata
[modifier le code]Noms avec chiffres romains, mis en forme avec espace insécable et infobulle.
Paramètre | Description | Type | État | |
---|---|---|---|---|
Nom | 1 | Nom de l'article
| Nom de page | obligatoire |
Complément | 2 | Complément du nom, ou nom avec autre numéro(s), ou + pour afficher plus, ou - pour afficher moins
| Chaîne | facultatif |
Supplément | 3 | Supplément à ajouter tout à la fin
| Chaîne | facultatif |
Voir aussi
[modifier le code]- {{nobr rom}}, sans lien interne, est plus approprié quand il ne s'agit pas d'une personne, mais il ne gère pas les exposants comme Ier ou Ire.
- {{lnobr rom}}, avec un lien interne, est plus approprié quand il ne s'agit pas d'une personne, mais il ne gère pas les exposants comme Ier ou Ire.
- {{Ier}}, {{Ire}}, {{IIe}}, {{IIIe}}, etc. quand on ne veut que le numéro ordinal. Cela n'apparaît pas dans la documentation, mais on peut mettre un second argument qui sera séparé du numéro par une espace insécable.
- {{I}}, {{II}}, {{III}}, etc. quand on ne veut que le numéro. Attention au piège : {{LV}} ne génère pas 55 ! Dans ce cas, il faut écrire
{{rom-maj|LV|55}}
. - {{rom-maj}} quand on ne veut que le numéro et qu'il n'y a pas de modèle plus simple.
- {{souverain3}} peut être remplacé par {{noble}}. Contrairement à Souverain3, le modèle Noble ne modifie jamais le nom de l'article[5]. Pour une mise en forme spéciale du complément, il faut répéter le complément avec sa mise en forme dans le second argument.
- {{souverain2}} peut être remplacé par {{noble}}. Contrairement à Souverain2, avec un seul argument un complément de nom apparaît. Pour qu'il n'apparaisse pas, il faut spécifier un second argument vide ou constitué d'un seul tiret.
- {{souverain-}} peut être remplacé par {{noble-}}. Contrairement à Souverain-, un complément de nom apparaît et ne doit pas nécessairement être spécifié dans un second argument.
- {{monarque}}, {{monarque-}} peuvent être remplacés par {{noble}} et {{noble-}} en utilisant un seul argument. L'argument « pays=non » peut être remplacé par un second argument vide ou constitué d'un seul tiret.
- 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
Notes
[modifier le code]- Plus précisément, un texte de disambiguïsation.
- Un deuxième argument présent mais complètement vide est accepté aussi, comme c'est le cas dans un lien interne, par exemple [[Tripoli (Libye)|]].
- Pourrait être utile pour un robot qui effectuerait des modifications automatiques.
- Notez la barre verticale après le premier argument.
- Voir à ce sujet la discussion du modèle Souverain3.