|
[[/Aide/]]
=== La commande vcb.py ===
<code>~/vocabulary-index/vcb/vcb.py Portugais/Grammaire/Nom</code><br />
La commande ci-dessus, produit la page suivante: [[Portugais/Index vocabulaire/vcb Nom]].
=== L'option -t --test ===
L'option -t (ou --test) permet d'enregistrer la nouvelle page dans le laboratoire:<br />
<code>~/vocabulary-index/vcb/vcb.py -t Grec/Vocabulaire</code><br />
La commande ci-dessus, produit la page suivante: [[Projet:Laboratoire/Propositions/Index vocabulaire/vcb Vocabulaire]]
Cette option ne créé pas la page dans le département d'origine, elle est utile dans le cadre de tests.
==== Tester la commande sur une leçon avant de scanner tout le département ====
Attention si vous exécutez le programme sur un département (sans préciser de leçon), le temps de réponse est proportionnel au nombre de pages et de modèles correspondants. Actuellement le script restitue un index global contenant les trois listes...
=== Le processus ===
En mode normal, le programme créé une page pour le sommaire des fiches lors de la première utilisation sur le département cible, puis une page pour la fiche vocabulaire avec les noms suivants:
Sommaire = <code>Département</code>/Index vocabulaire
Fiche = <code>Département</code>/Index vocabulaire/vcb <code>Leçon</code>
Le programme détermine le nom du département, et reconnait le code langue associé (ex: pt).
Le script scanne les pages de l'espace dont le titre est donné en argument:<br />
* Si l'argument est une leçon, scanne les fichiers dans l'espace et les dossiers des leçons(exo, quiz...).
* Si l'argument est un chapitre, scanne la page uniquement.
* Si l'argument est indéfini devrait se comporter comme une leçon, scanner l'espace de nom et uniquement les dossiers spéciaux des leçons.
Les 3 listes sont formatées dans des sections successives de la même page:
"variable_département"/Index Vocabulaire/vcb_Nom_de_la_leçon</code>
Le programme créé la nouvelle page puis ajoute un lien sur la dernière ligne du sommaire (section à réviser l'édition du sommaire est semi-automatique :(
Sommaire des fiches de vocabulaire, exemple: [[Portugais/Index vocabulaire]]).
==== Si l'argument est un département====
Si l'argument est un département, créé une nouvelle page sous forme d'index global (il faudra proposer des options avec argparse (-g --global) pour générer 3 ou 4 pages distinctes pour les listes de mots, locutions, phrases et fichiers audio).
Il faut scanner tout le département et restituer "l'index global" (Cette commande est gourmande en temps processeur). <br />
<code> Département</code>/Index Vocabulaire/vcb Global
Exemple: La commande <code>./vcb.py Portugais</code> reconnait un nom de Département et va créer une liste exhaustive du vocabulaire pour l'ensemble du département ex: [[Portugais/Index vocabulaire/Index global]]
==== Minimum requis ====
Le programme refuse de créer une nouvelle page si le nombre de lignes de la liste produite est inférieur à cinq.
=== Titres des pages ===
L'outil catégorise toutes ses fiches de vocabulaire dans [[:Catégorie:Page auto]] (nom à réviser) puis les fiches de vocabulaire de chaque département dans <code>[[:Catégorie:Département/Vocabulaire/Index]]</code>.
Actuellement l'outil ne vérifie ni ne créé les pages de catégories (à réviser).
== Commentaire de l'auteur ==
| 