Différences entre les pages « Module:Italiques biologiques/doc » et « Modèle:Taxobox/Documentation »

De Les Mots de l'agronomie
< Module:Italiques biologiques(Différence entre les pages)
imported>Jacques Ducloy
m (1 révision importée)
 
imported>Jacques Ducloy
m (1 révision importée)
 
Ligne 1 : Ligne 1 :
{{protection}}
+
{{Sous-page de documentation}}
== Utilisation ==
 
Fonctions exportables :
 
* <code>titre_en_italiques(frame)</code> – met le titre en italique, en ignorant la partie (éventuelle) homonymie. Ne met pas l'espace de nom éventuel en italique.
 
** paramètre nommé optionnel : "lang=XX", qui insert un ''span'' décrivant la langue.
 
* <code>ns(frame)</code> − prend en paramètre non nommé un nom scientifique et retourne ce nom en italique inconditionnellement, en respectant les contraintes typographiques de la biologie. (appellé par {{m|Taxobox taxon}})
 
* <code>nt(frame)</code> − similaire à <code>ns(frame)</code> mais utilisé par {{m|Taxobox}}. Prend en paramètres non nommés (dans l'ordre) ''nom'', ''nom2'' et ''rang'', et utilise ''nom2'' s'il est non vide sinon ''nom'' (utile pour s'adapter à la syntaxe de {{m|Taxobox}} qui peut être « rang | nom » ou « rang | nom wiki | nom ». Important : éviter d'utiliser cette fonction dans un autre contexte car pour des raisons techniques elle utilise du code HTML (et non wiki) pour gérer l'italique
 
* <code>titre(frame)</code> – prend en paramètre non nommé un nom scientifique et modifie le titre de l'article pour le mettre en italique. La fonction récupère le titre de l'article et ne met en italiques qui si le titre est de la forme XXXYYY, avec XXX le nom scientifique en paramètre et YYY éventuellement vide. Seule la partie XXX est passée en italique. Ne fait rien dans les autres cas, ni si la fonction est appelée depuis au autre espace de nom que l'espace encyclopédique. (appellé par {{m|Taxoboxoutils titre en italique}})
 
** paramètre nommé optionnel : "titre=XXX" : si ce paramètre est indiqué la fonction utilise XXX comme titre de la page au lieu du titre réel. De plus le résultat est retourné dans un nowiki afin de visualiser ce qui aurait été fait (option servant pour les pages de documentation et de test).
 
  
Modules externes et autres éléments dont ce module a besoin pour fonctionner :
+
;Utilisation
* <code>mw.title</code> (récupération du titre et espace de nom de la page)
+
{{Aide détaillée|Aide:Taxobox}}
 +
: Le but de ce modèle est de préciser, dans une taxobox, un des [[taxon]]s parent de celui décrit par l'article (par exemple préciser la [[famille (biologie)|famille]] si l'article décrit le [[genre (biologie)|genre]]).
 +
: [[Image:Nuvola apps important.svg|16px]] Attention : si l'article décrit ce taxon, alors il faut utiliser {{m|Taxobox taxon}}.
 +
: {{Taxoboxoutils doc et catégories|Taxobox|Taxoessai|Taxobox|protection=oui}}
  
{{Section déroulante début|titre=Exemples}}
+
;Exemples
Note : ces fonctions ne testent pas s'il est ''pertinent'' d'utiliser l'italique.
+
: <code><nowiki>{{Taxobox | famille | Felidae }}</nowiki></code>
 +
: <code><nowiki>{{Taxobox | famille | Sylviidae (Sibley) | Sylviidae }}</nowiki></code>
 +
: <code><nowiki>{{Taxobox | famille | liens=''[[Felidae]]'' (pour félin) }}</nowiki></code>
  
'''Fonction <code>ns(frame)</code> :
+
;Syntaxes
 +
{{Aide détaillée|Utilisateur:Hexasoft/Écrire une taxobox}}
 +
: <pre><nowiki>{{Taxobox | RangDuTaxon | Page | NomTaxon }}</nowiki></pre>
 +
: ou
 +
: <pre><nowiki>{{Taxobox | RangDuTaxon | liens=... }}</nowiki></pre>
  
<nowiki>{{#invoke:Italiques biologiques|ns|Citrus ×paradisi}}</nowiki> → {{#invoke:Italiques biologiques|ns|Citrus ×paradisi}} <br/>
+
;Paramètres
<nowiki>{{#invoke:Italiques biologiques|ns|×Sorbopyrus auricularis}}</nowiki> → {{#invoke:Italiques biologiques|ns|×Sorbopyrus auricularis}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|ns|Iberodorcadion (Hispanodorcadion) aguadoi}}</nowiki> → {{#invoke:Italiques biologiques|ns|Iberodorcadion (Hispanodorcadion) aguadoi}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|ns|Pelophylax kl. esculentus}}</nowiki> → {{#invoke:Italiques biologiques|ns|Pelophylax kl. esculentus}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|ns|Brassica olearacea var. gemmifera}}</nowiki> → {{#invoke:Italiques biologiques|ns|Brassica olearacea var. gemmifera}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|ns|Bla ×bli var. blo kl. blu}}</nowiki> → {{#invoke:Italiques biologiques|ns|Bla ×bli var. blo kl. blu}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|ns|Uroplatus (genre)}}</nowiki> → {{#invoke:Italiques biologiques|ns|Uroplatus (genre)}} − cas de mise en italique inconditonnel<br/>
 
  
 +
<templatedata>
 +
{
 +
        "description": "Permet de créer une ligne de classification dans la taxobox, du type : Famille | Felidae.",
 +
        "params": {
 +
                "1": {
 +
                        "label": "Rang du taxon",
 +
                        "description": "Le rang du taxon (ordre, famille, genre, etc.)",
 +
                        "type": "string",
 +
                        "required": true
 +
                },
 +
                "2": {
 +
                        "label": "Taxon",
 +
                        "description": "Le taxon du rang précisé précédemment.",
 +
                        "type": "string",
 +
                        "required": true
 +
                },
 +
                "3": {
 +
                        "label": "Libellé du taxon",
 +
                        "description": "Lorsque le taxon est décrit par un article dont le libellé a dû être adapté, indiquer ici le nom valide",
 +
                        "type": "string",
 +
                        "required": false
 +
                },
 +
                "liens": {
 +
                        "label": "Texte libre pour le taxon",
 +
                        "description": "Permet de mettre un texte libre pour décrire le taxon.",
 +
                        "type": "string",
 +
                        "required": false
 +
                },
 +
                "éteint": {
 +
                        "label": "Indique que le taxon est éteint",
 +
                        "description": "Permet d'indiquer que le taxon est éteint (ajoute un obèle).",
 +
                        "type": "string",
 +
                        "required": false
 +
                },
 +
                "ancien": {
 +
                        "label": "Taxon ancien ?",
 +
                        "description": "Mettre oui pour préciser que le taxon décrit n'est plus utilisé.",
 +
                        "type": "string",
 +
                        "required": false
 +
                }
 +
        }
 +
}
 +
</templatedata>
  
'''Fonction <code>titre(frame)</code>
+
:* '''RangDuTaxon'''
 +
:: Le [[rang (taxinomie)|rang]] du taxon parent (embranchement, classe, ordre, famille…).
 +
:: Voir [[Modèle:Taxoboxoutils rang|ici la liste des possibilités]].
 +
:: [[Image:Nuvola apps important.svg|16px]] Si '''''Rang à préciser''''' apparaît c'est que vous l'avez mal orthographié.
 +
:: '''Ex :''' ''famille''
 +
:* '''Page'''
 +
:: Le nom de la page ou article de Wikipédia décrivant le taxon parent.
 +
:: [[Image:Nuvola apps important.svg|16px]] '''Attention : Ne pas mettre de <nowiki>[[]]</nowiki>'''.
 +
:: '''Ex :''' ''Sylviidae (Sibley)''
 +
:* '''NomTaxon'''
 +
:: Le nom du taxon parent (optionnel si le nom de la page est le nom du taxon parent)
 +
:: '''Ex :''' ''Sylviidae''
 +
:* Paramètre nommé '''« liens= »'''
 +
:: Permet de mettre un texte libre pour décrire le taxon.
 +
:: '''Ex :''' ''<nowiki>liens=[[Felidae]] (pour félin)</nowiki>''
 +
:* Paramètre nommé '''« ancien=oui »'''
 +
:: Pour préciser que le taxon décrit par l'article était anciennement placé sous <NomTaxon> (Donc <NomTaxon> est peut-être toujours valide).
 +
:: '''Ex :''' ''ancien=oui''
 +
:* Paramètre nommé '''« éteint=oui »'''
 +
:: Pour préciser que le rang décrit est éteint.
 +
:: '''Ex :''' ''éteint=oui''
  
Note : un retour vide (après le "→") indique que la fonction a décidé de ne pas modifié le titre, elle retourne donc une chaîne vide.
+
;Exemples d'utilisation
 +
: {{Aide détaillée|Modèle:Exemple de taxobox}}
 +
:* Syntaxe simple
 +
:** [[Blatte américaine]]
 +
:* Syntaxe liens=...
 +
:** En recherche d'exemple
 +
:* Syntaxe ancien=oui
 +
:** [[Raptrix perspicua]], [[Miomantis paykullii]]
  
<nowiki>{{#invoke:Italiques biologiques|titre|Citrus ×paradisi|titre=Citrus ×paradisi}}</nowiki> → {{#invoke:Italiques biologiques|titre|Citrus ×paradisi|titre=Citrus ×paradisi}} <br/>
+
<!-- Les catégories sont gérées par {{Taxoboxoutils doc et catégories}} -->
<nowiki>{{#invoke:Italiques biologiques|titre|×Sorbopyrus auricularis|titre=×Sorbopyrus auricularis}}</nowiki> → {{#invoke:Italiques biologiques|titre|×Sorbopyrus auricularis|titre=×Sorbopyrus auricularis}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|titre|Uroplatus guentheri|titre=Uroplate de Günther}}</nowiki> → {{#invoke:Italiques biologiques|titre|Uroplatus guentheri|titre=Uroplate de Günther}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|titre|Uroplatus guentheri|titre=Uroplatus guentheri (animal)}}</nowiki> → {{#invoke:Italiques biologiques|titre|Uroplatus guentheri|titre=Uroplatus guentheri (animal)}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|titre|Brassica olearacea var. gemmifera|titre=Brassica olearacea var. gemmifera}}</nowiki> → {{#invoke:Italiques biologiques|titre|Brassica olearacea var. gemmifera|titre=Brassica olearacea var. gemmifera}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|titre|Brassica olearacea var. gemmifera|titre=Fox à poil dur}}</nowiki> → {{#invoke:Italiques biologiques|titre|Brassica olearacea var. gemmifera|titre=Fox à poil dur}} <br/>
 
<nowiki>{{#invoke:Italiques biologiques|titre|Uroplatus|titre=Uroplatus sikorae}}</nowiki> → {{#invoke:Italiques biologiques|titre|Uroplatus|titre=Uroplatus sikorae}} ⇒ limitation : la partie "homonymie" est considérée comme "YYY si le titre est XXXXYYY et que le nom scientifique indiqué est exactement XXXX". On voit ici que si on est titré genre sur l'article mais qu'on pense être l'espèce correspondante ça ne fait pas ce qui est prévu. Si c'est un problème il est possible d'imposer en plus la présence de parenthèses dans la partie homonymie. Me dire.<br/>
 
<nowiki>{{#invoke:Italiques biologiques|titre|Brassica olearacea ''var.'' gemmifera|titre=Fox à poil dur}}</nowiki> → {{#invoke:Italiques biologiques|titre|Brassica olearacea ''var.'' gemmifera|titre=Fox à poil dur}} − exemple de présence d'une mise en forme dans le nom scientifique indiqué<br/>
 
<includeonly>
 
{{Projet Scribunto}}
 
[[Catégorie:Module infobox]]
 
</includeonly>
 
<noinclude>
 
[[Catégorie:Documentation de module]]
 
</noinclude>
 

Version actuelle datée du 21 janvier 2021 à 14:51

Illustration de documentation
Ceci est la page de documentation de Modèle:Taxobox [modifier] [purger].
Cette sous-page contient les instructions, les catégories de son modèle d'origine et elle n'est pas destinée à être visualisée directement.
Utilisation

Modèle:Aide détaillée

Le but de ce modèle est de préciser, dans une taxobox, un des taxons parent de celui décrit par l'article (par exemple préciser la famille si l'article décrit le genre).
Nuvola apps important.svg Attention : si l'article décrit ce taxon, alors il faut utiliser {{Taxobox taxon}}.
Modèle:Taxoboxoutils doc et catégories
Exemples
{{Taxobox | famille | Felidae }}
{{Taxobox | famille | Sylviidae (Sibley) | Sylviidae }}
{{Taxobox | famille | liens=''[[Felidae]]'' (pour félin) }}
Syntaxes

Modèle:Aide détaillée

{{Taxobox | RangDuTaxon | Page | NomTaxon }}
ou
{{Taxobox | RangDuTaxon | liens=... }}
Paramètres

Permet de créer une ligne de classification dans la taxobox, du type : Famille | Felidae.

Paramètres du modèle

ParamètreDescriptionTypeStatut
Rang du taxon1

Le rang du taxon (ordre, famille, genre, etc.)

Par défaut
vide
Exemple
vide
Valeur automatique
vide
Chaîneobligatoire
Taxon2

Le taxon du rang précisé précédemment.

Par défaut
vide
Exemple
vide
Valeur automatique
vide
Chaîneobligatoire
Libellé du taxon3

Lorsque le taxon est décrit par un article dont le libellé a dû être adapté, indiquer ici le nom valide

Par défaut
vide
Exemple
vide
Valeur automatique
vide
Chaînefacultatif
Texte libre pour le taxonliens

Permet de mettre un texte libre pour décrire le taxon.

Par défaut
vide
Exemple
vide
Valeur automatique
vide
Chaînefacultatif
Indique que le taxon est éteintéteint

Permet d'indiquer que le taxon est éteint (ajoute un obèle).

Par défaut
vide
Exemple
vide
Valeur automatique
vide
Chaînefacultatif
Taxon ancien ?ancien

Mettre oui pour préciser que le taxon décrit n'est plus utilisé.

Par défaut
vide
Exemple
vide
Valeur automatique
vide
Chaînefacultatif
  • RangDuTaxon
Le rang du taxon parent (embranchement, classe, ordre, famille…).
Voir ici la liste des possibilités.
Nuvola apps important.svg Si Rang à préciser apparaît c'est que vous l'avez mal orthographié.
Ex : famille
  • Page
Le nom de la page ou article de Wikipédia décrivant le taxon parent.
Nuvola apps important.svg Attention : Ne pas mettre de [[]].
Ex : Sylviidae (Sibley)
  • NomTaxon
Le nom du taxon parent (optionnel si le nom de la page est le nom du taxon parent)
Ex : Sylviidae
  • Paramètre nommé « liens= »
Permet de mettre un texte libre pour décrire le taxon.
Ex : liens=[[Felidae]] (pour félin)
  • Paramètre nommé « ancien=oui »
Pour préciser que le taxon décrit par l'article était anciennement placé sous <NomTaxon> (Donc <NomTaxon> est peut-être toujours valide).
Ex : ancien=oui
  • Paramètre nommé « éteint=oui »
Pour préciser que le rang décrit est éteint.
Ex : éteint=oui
Exemples d'utilisation
Modèle:Aide détaillée