Modèle:Noble/Documentation

Ceci est la page de documentation de Modèle:Noble [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 utilise le module Noble, 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.

Utilisation

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 I^er) ;
• 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

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

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 « (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 « - », 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 I^er .

Exemples

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

Syntaxe	Résultat	Commentaire
{{noble|Charlemagne}}	Charlemagne	Accepté, mais inutile. 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|-}}.
{{noble|Rotrude (fille de Charlemagne)}}	Rotrude	Accepté, mais inutile. La levée d'homonymie (entre parenthèses) n'apparaît pas. Il est préférable d'écrire [[Rotrude (fille de Charlemagne)|]].
{{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 « - »

Le second argument peut consister en un seul « + » ou un seul « - ».

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

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

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

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

Noms avec chiffres romains, mis en forme avec espace insécable et infobulle.

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 Édouard Ier (roi d'Angleterre)	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 Exemple Plantagenêt dans : [[Édouard Ier (roi d'Angleterre)|Édouard Ier Plantagenêt]]	Chaîne	facultatif
Supplément	3	Supplément à ajouter tout à la fin Exemple Voir documentation du modèle	Chaîne	facultatif

Voir aussi

• {{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 I^er ou I^re.
• {{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 I^er ou I^re.
• {{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. 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.
• w:wWikipédia:Conventions typographiques
• w:Wikipédia:Conventions concernant les nombres