User:Hexasoft/Taxobox2
Sorry, this is in french
Description et fonctionnement des Taxobox module (version 2).
Principe des taxobox sur fr:
editL'idée est de reprendre la syntaxe libre des taxobox utilisées sur fr:, celle-ci étant modulaires − c'est-à-dire que l'on construit le résultat final en utilisant des modèles indépendants.
Cette approche modulaire a des avantages :
- simplicité de développement : chaque brique est simple à gérer et à développer
- simplicité d'évolution : ajouter de nouvelles fonctionnalités revient à créer une nouvelle brique, sans forcément devoir tout connaître
- grande liberté de construction : il n'est pas nécessaire de prévoir tous les cas, c'est le rédacteur qui construit le résultat morceau par morceau
Mais elle a aussi quelques inconvénients :
- répétition de paramètres : comme il s'agit de modèles indépendants certains paramètres nécessaires doivent être re-donnés plusieurs fois (règne par exemple)
- absence de contrôle structurel : chaque brique étant indépendante il n'est pas possible de détecter des utilisations incohérentes
Principe de la taxobox module
editElle reprend la même liberté de construction que la forme modulaire. Pour cela il n'y a pas de paramètres nommés (enfin si, mais très peu). Ce sont les paramètres non nommés qui, dans l'ordre où ils apparaissent, permettent de construire le résultat final, de la même façon que l'ordre des différents modèles le fait sur fr:.
La structure est simple : les paramètres (non nommés) suivent une syntaxe très similaire à celles des modèles briques-de-base : un mot-clé identifiant le type d'élément, suivi de ses paramètres.
L'ordre de ces éléments permet de construire le résultat final dans l'ordre voulu.
Le seul paramètre nommé obligatoire est le règne, qui est commun à toute la taxobox. Les autres paramètres nommés sont des options permettant de modifier le comportement final, et la quasi-totalité d'entre-eux n'a pas à être utilisé en dehors de cas spécifiques (et qui ne relèvent pas des articles). La seule exception est le paramètre nommé "nv" ou "nom vernaculaire" permettant de préciser le ou les noms en français d'un taxon.
Liste des briques de base existant sur fr:
editPour chaque ligne : le modèle sur fr: / le mot-clé dans taxobox-module / son support dans taxobox-module / une courte description.
Note : les mots-clés ne sont pas sensibles aux différences minuscule/majuscule.
- fr:Modèle:Taxobox CITES / cites / ok / description statut CITES
- fr:Modèle:Taxobox conflit / conflit / ok / entrée de classification avec désaccord entre plusieurs classification
- fr:Modèle:Taxobox début / début / ok / débute la taxobox, permet de donner l'image principale
- fr:Modèle:Taxobox fin / fin / ok / termine la taxobox. Note : optionnel dans la taxobox-module
- fr:Modèle:Taxobox image / image / ok / ajoute une image
- fr:Modèle:Taxobox légende / légende / ok / ajoute une légende additionnelle (pour une image typiquement)
- fr:Modèle:Taxobox parents / parents / ? / donne les parents d'un hybride
- fr:Modèle:Taxobox phylogénie arbre / non fait / non fait
- fr:Modèle:Taxobox phylogénie inexistant / phylogénie inexistant / ok, presque / indique qu'un taxon n'existe pas en classification phylo
- fr:Modèle:Taxobox phylogénie bandeau / phylogénie bandeau / ok, presque / début d'une classification phylo
- fr:Modèle:Taxobox position / non fait /
- fr:Modèle:Taxobox répartition / répartition / ok / carte+légende de répartition
- fr:Modèle:Taxobox répartition début / non fait / inutile dans la structure actuelle
- fr:Modèle:Taxobox répartition image / répartition image / ok / image de répartition
- fr:Modèle:Taxobox répartition fin / non fait / inutile dans la structure actuelle
- fr:Modèle:Taxobox répartition légende / répartition légende / ok / légende de carte de répartition
- fr:Modèle:Taxobox simple début / non fait / sous-modèle non utilisé directement
- fr:Modèle:Taxobox synonymes / synonymes / ok / liste les synonymes du taxon
- fr:Modèle:Taxobox / rang / ok / décrit un niveau de la classification
- fr:Modèle:Taxobox taxon / taxon / ok / décrit le taxon sujet de la taxobox
- fr:Modèle:Taxobox taxons / taxons / ok / liste les taxons de rang inférieur
- fr:Modèle:Taxobox UICN / uicn / ok / décrit le statut UICN du taxon
Un exemple vaut mieux qu'un discours
editFormat « taxobox-module » | Format « taxobox-fr » |
{{Hexasoft-test | règne=algue | nv=Haptophytes |début|image.png | légende | classification|AlgaeBASE |rang | sous-règne | Hacrobia |taxon | embranchement | Haptophyta | <auteurs>, <date> | taxons | * classe ''[[Pavlovophyceae]]'' ** ordre ''[[Pavlovales]]'' * classe ''[[Prymnesiophyceae]]'' Hibberd, 1976 ** ordre ''[[Prymnesiales]]'' ** ordre ''[[Phaeocystales]]'' ** ordre ''[[coccolithophore|Isochrysidales]]'' ** ordre ''[[coccolithophore|Coccolithales]]'' |position | {{Phylogénie Eukaryota}} | Cryptophyta |fin }} |
{{Taxobox début | algue | image.png | légende | classification=AlgaeBASE }} {{Taxobox | sous-règne | Hacrobia }} {{Taxobox taxon | algue | embranchement | Haptophyta | <auteurs>, <date> }} {{Taxobox taxons | * classe ''[[Pavlovophyceae]]'' ** ordre ''[[Pavlovales]]'' * classe ''[[Prymnesiophyceae]]'' Hibberd, 1976 ** ordre ''[[Prymnesiales]]'' ** ordre ''[[Phaeocystales]]'' ** ordre ''[[coccolithophore|Isochrysidales]]'' ** ordre ''[[coccolithophore|Coccolithales]]'' }} {{Taxobox position | {{Phylogénie Eukaryota}} | Cryptophyta }} {{Taxobox fin}} |
Les différences :
- il n'y a pas de {{ ... }} puisque c'est un seul modèle
- le règne (algue) n'apparaît qu'une fois au début, sous forme de paramètre nommé
- l'identifiant de modèle Taxobox n'apparaît plus (inutile). Seule différence : le modèle Taxobox devient rang (sinon ça serait vide). Les autres sont identiques à la suppression de "Taxobox" près
- les paramètres nommés (exemple : "|classification=AlgaeBASE") sont ré-écris sous la forme "nom-paramètre|valeur-paramètre" (exemple : "|classification|AlgaeBASE")
- le paramètre (optionnel) "nv=Haptophytes" qui permet de spécifier le ou les noms en français (pour le sous-titre)
On peut voir le résultat : Haptophyta pour la version taxobox-module et fr:Haptophyta pour la version taxobox-fr.
Note : il y a une légère différence d'aspect car le CSS sur fr: a évolué depuis (couleurs en particulier) sans que ce soit reporté ici.
Note bis : pour une raison de comparaison des deux formes certaines mises en forme ne sont pas opportunes. Par exemple il semble préférable de mettre les paramètres nommés seuls sur une ligne.
Fonctionnalités non nécessaires mais sympatiques
editQuelques trucs que fait la Taxobox-module et que ne fait pas la Taxobox-fr :
- gestion unifiée et propre de l'affichage des noms scientifiques. En particulier gestion propre des italiques même pour les hybrides (non mise en italique du "x" des hybrides)
- mise en italique automatique du titre (si titré en nom scientifique), en respectant le "x" des hybrides et en tenant compte d'une éventuelle homonymie (texte entre parenthèses, non mis en italique)
- ajout automatique du sous-titre : si l'article est titré en nom scientifique le sous-titre correspond aux noms vernaculaires ; si l'article est titré en nom vernaculaire le sous-titre correspond au nom(s) scientifique(s)
- hors de l'espace encyclopédique les catégories ne sont pas incluses (comme sur fr:). Par contre celles-ci apparaissent dans une boîte sous la taxobox, permettant de savoir quelles catégories auraient été incluses si cela avait été l'espace encyclopédique (désactivable par une option)
- gestion des erreurs : s'il y a des erreurs de syntaxe sur certaines lignes celles-ci sont ignorées (sauf certaines erreurs fatales). Des catégories sont insérées selon les types d'erreurs. Il est possible (option à passer) de faire apparaître les erreurs dans une boîte séparée, elles sont alors explicite (type d'erreur, ligne où l'erreur s'est produite). Les erreurs fatales produisent une "box d'erreur" décrivant le problème.
- vérification de la cohérence de la taxobox : certaines combinaisons ne correspondent pas à des taxobox valides. Les Taxobox-module peuvent le détecter et générer des erreurs (par catégorie ou en clair selon les options) − fonctionnalité partielle, en cours de finalisation.