Généralités
Le script est formé de plusieurs procédures qui sont appelées au moment propice par ce que l'on pourrait appeler "procédre principale" (en fait, le jeu d'instructions inclus dans aucune procédure... le niveau zéro de la hierarchie du script, en somme).
procédures
the_beginning_of_the_end()
Cette procédure a pour but de récupérer les chemins et adresses des fichiers à lire et à créer. En cours de développement, il est apparu comme très rentable de rajouter à cette procédure de type output/input (question machine - réponse utilisateur stockée dans une variable) des valeurs par défaut, ce qui a permis de tester les parties ultérieures du script sans rentrer N fois les mêmes instructions.Demander à l'utilisateur s'il souhaite utiliser les valeurs par défauts
En fonction de sa réponse :Utiliser les valeurs par défaut
OU
Demander à l'utilisateur quelles valeurs il souhaite utiliser
nota : demander confirmation
à chaque étape.
Si les noms de répertoires sont entrés avec un slash (/) à la fin, supprimer ce slash.
Si les noms de répertoires sont entrés avec un slash (/) à la fin, supprimer ce slash.
tabmaker_general()
Cette procédure crée le tableau-maître (qui contiendra à son tour plusieurs tableaux imbriqués pour arriver à une présentation de cette forme).L'algorithme se résume à :
OUVRIR le filehandler
pointant vers le résultat du script en mode
écriture-insertion
Ecrire dans ce fichier le code HTML nécessaire à
la création de l'en-tête du
tableau-maître
FERMER le filehandler
context_cell()
Cette procédure crée lune cellule en début de ligne de façon à ce que cette cellule contienne la description du sens traité. La subitlité vient du formatage du texte : là où le fichier source indique un sens en majuscules et avec des underscores en guise d'espaces, le tableau résultat devrait avoir des sens écrit proprement (premier caractère majuscule, le reste en minuscules, et un accent sur un a le cas échéant).OUVRIR le filehandler
pointant vers le résultatdu script en mode
écriture-insertion
remplacer les _ par le code HTML correspondant à un espace
( )
remplacer les A situés entre deux ' ' par un 'à'
mettre toute la chaîne de caractères en minuscules
mettre le premier caractère en majuscule
écrire dans le fichier un code HTML
créant une
nouvelle ligne, entamée par une cellule contenant la
chaîne-sens formatée
FERMER le filehandler
taburl_fr(), tabwget_fr(), tabdump_fr(), tabctxt_fr()
... et les variantes anglaises
Ces procédures sont quasi-identiques. Leur nombre s'explique par la non-utilisation de procédures argumentées et de légères différences. L'algorithme global reste le même :