https://baripedia.org/index.php?action=history&feed=atom&title=Module%3ATaxobox2%2FDocumentationModule:Taxobox2/Documentation - Historique des versions2026-05-06T01:54:06ZHistorique des versions pour cette page sur le wikiMediaWiki 1.38.6https://baripedia.org/index.php?title=Module:Taxobox2/Documentation&diff=7825&oldid=prevArthur : 1 version2014-01-13T22:02:24Z<p>1 version</p>
<p><b>Nouvelle page</b></p><div>Ce module fournit une fonction permettant de générer une taxobox.<br />
<br />
== Utilisation ==<br />
Fonctions exportables :<br />
* <code>taxobox(frame)</code> – la fonction servant à créer une taxobox. Voir documentation détaillée pour son utilisation<br />
<br />
Autres fonctions :<br />
* <code>genere_sortie(texte, debug)</code> – formate le retour de <code>taxobox(frame)</code> et insert si besoin la sortie debug<br />
<br />
Modules externes et autres éléments dont ce module a besoin pour fonctionner :<br />
* <code>Module:Taxobox données</code> − module contenant toutes les données constantes relatives à la construction d'une taxobox<br />
* <code>Module:Taxobox fonctions</code> − module contenant toutes les fonctions de traitement des paramètres et de création du contenu<br />
* <code>mw.title</code> – utilisé pour connaître le titre de la page où on est utilisé<br />
* <code>.mw.text, mw.ustring…</code><br />
<br />
== Déroulement de l'exécution ==<br />
Les étapes pour créer une taxobox sont toujours les mêmes. Les actions de la fonction <code>taxobox(frame)</code> sont :<br />
* enregistrement ''frame'' et ''pframe'' dans la table ''donnees.defauts.{frame|pframe}}'' (pour utilisation par d'autres fonctions<br />
* récupération du titre et du namespace de l'article (''donnees.defauts.{article|titre}'')<br />
* analyse des paramètres nommés. Contenu : "charte" et "nom vernaculaire" ; comportement : c_titre, c_sous_titre, c_categories, c_categories_err, c_erreurs, c_force_titre ; debug : raw, debug. Vérifications sur les paramètres (présence obligatoire de "charte", et qu'elle corresponde à une charte connue).<br />
* analyse des paramètres non nommés pour créer la liste des commandes (suite des lignes de taxobox à créer : ''donnees.defauts.commandes'') avec la commande ''tri_parametres()''. Validation que cette phase c'est bien passée.<br />
* initialisation de l'état courant de la taxobox (ouverte, fermée, nombre de tables ouvertes…)<br />
* recherche des entrées "taxon" (commande ''tri_taxons''). Cette fonction regroupe les lignes "taxon" dans une table, note le dernier "taxon" donné Note également si l'un des taxons indiqué peut correspondre au titre de l'article.<br />
* détermination du titre de la taxobox (''genere_titre_taxobox()'').<br />
* boucle de parcours des commandes de la taxobox. Parcours sur les lignes de ''donnees.defauts.commandes'' :<br />
** analyse de la ligne (''lecture_parametres()'') en utilisant la syntaxe de la commande. Retourne ''resu'' contenant les paramètres de la ligne<br />
** exécution de la fonction traitant la commande correspondante, sur les paramètres de la ligne<br />
** gestion de la structuration (ouverture/fermeture de tables typiquement)<br />
** ajout du code de la ligne à la taxobox en cours de création<br />
** note : à chaque étape diverses vérifications de la présence d'erreurs<br />
* détermination des modifications éventuelles du titre de l'article (mise en forme)<br />
* détermination de l'ajout éventuel d'un sous-titre à l'article<br />
* détermination des catégories éventuelles à ajouter (et selon le mode choisi et le namespace)<br />
* détermination des catégories d'erreurs éventuelles à ajouter (et selon le mode choisi et le namespace)<br />
* détermination des erreurs éventuelles à ajouter (et selon le mode choisi et le namespace)<br />
* retour du résultat<br />
<br />
<includeonly><br />
{{Projet Scribunto}}<br />
</includeonly><br />
<noinclude><br />
[[Catégorie:Documentation de module|{{BASEPAGENAME}}]]<br />
</noinclude></div>Arthur