User:Hexasoft/Taxobox2

Sorry, this is in french

Description et fonctionnement des Taxobox module (version 2).

Principe des taxobox sur fr:

edit

L'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

edit

Elle 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:

edit

Pour 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.

Un exemple vaut mieux qu'un discours

edit
Format « 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

edit

Quelques 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.