Téléchargez Python sur votre système.

• Sous Windows et Mac

  • Cliquez sur l'installateur et laissez vous guider.

• Sous *nix

  • Debian

    jpcw@debian:~$ sudo apt-get update
    jpcw@debian:~$ sudo apt-get install python2.4
    

  • Autres : utilisez votre sytème de paquetages, vous pouvez également compiler Python sur votre système avec GCC

Téléchargez GAG et dézippez l'archive dans le répertoire tournoi/ où vous voulez sur votre disque dur !

• tournoi/
  • gag.bat
  • sample_1-6_Ga.htm
  • sample_3-0_Ga.htm
  • gag/
    • BeautifulSoup.py
    • config.py
    • doc_gag.htm
    • gag.cfg
    • gag.py
    • licence.txt
    • parserga.py
    • styles.cfg
    • utils.py
    • backup/
      • doc.rst
      • gag.bat
      • gag.cfg
      • gag.po
      • notes_for_developpers
      • styles.cfg
    • i18n/
      • en/
        • LC_MESSAGES/
          • gag.mo
          • gag.po
      • es/
        • LC_MESSAGES/
          • gag.mo
          • gag.po
      • fr/
        • LC_MESSAGES/
          • gag.mo
          • gag.po
    • input/
    • output/
      • gag.css
      • my_footer
      • my_header

Vérifiez bien que le répertoire gag/ contient un répertoire input/ vide. Certains extracteurs d'archives ne recréent pas les répertoires vides. Si c'est le cas créez le!

Nous vous proposons le scénario d'utilisation suivant :

Plutôt que de copier sytématiquement à la main les fichiers *.htm dans gag/input/ , il est plus judicieux de copier votre fichier tournoi.papi dans le répertoire tournoi/ qui a normalement été créé lors de la décompression du zip.

Ainsi lorsque que vous utilisez PAPI vous générez vos grilles dans le même répertoire. Il ne vous reste plus qu' a double-cliquer sur gag.bat.

gag.bat filtre les documents *Ga.htm, les copie dans gag/input/ et lance gag.py.

@echo off
for %%f IN (*Ga.htm) DO copy "%%f" gag\input
cd gag
echo starting gag
gag.py

L'une des idées de GAG est de souligner certains résultats en modifiant leur fonte. CSS est là pour ça !

Reste a édicter les "règles" qui s'appliqueront, et ce qui représente les bonnes valeurs pour certains, ne correspondra pas aux avis des autres. L'idéal est donc que chaque utilisateur de GAG puisse édicter ses propres règles.

Si vous avez dézippé sur votre bureau ouvrez une console et tapez ceci :

cd Bureau\tournoi\gag
gag.py --help

Vous devriez voir apparaître les options admises par GAG au lancement :

usage: gag.py [options]
options:
  -h, --help            show this help message and exit
  -c CONFIG_GAG, --conf=CONFIG_GAG
                        software file configuration, default = gag.cfg
  -s CONFIG_STYLES, --style=CONFIG_STYLES
                        set styles configuration employed to output, default =
                        styles.cfg
  -l LANG, --lang=LANG  set language softawre default = fr

GAG se configure suivant les fichiers *.cfg [4] qui lui sont passés en arguments en ligne de commande.

Si aucun argument n'est spécifié ce sont les valeurs par défaut de ces derniers qui s'appliquent.

Vous pouvez donc lancer GAG avec :

• Un fichier autre que gag.cfg
• Un fichier de styles autre que styles.cfg
• En précisant une autre langue d'exécution

Ainsi, si vous avez plusieurs scénarios d'utilisation, plutôt que de modifier à chaque fois les valeurs des fichiers de config, il suffit de créer autant de fichiers de config que de scénarios.

Il ne vous reste qu' a lancer GAG avec de nouveaux arguments. Vous pouvez invoquer les arguments avec leur "nom court" ('-x fichier'), leur "nom long" ('--xblabla fichier'), mixer les deux.

Soit en console, soit avec un fichier gag_scénario2.bat

gag.py --conf scenario2_gag.conf --styles scenario2_styles.cfg -l en

Bien entendu vous pouvez aussi duppliquer le fichier gag.bat situé dans tournoi/ et ne modifier que la dernière ligne.

Aucun message n'est codé en dur. Ces derniers se situent à deux endroits dans le programme :

• le fichier styles.cfg pour les commentaires de la légende
• les fichiers gag.mo situés dans i18n/$langue/LC_MESSAGES/

Les fichiers *.mo sont des fichiers compilés. Si vous souhaitez modifié une traduction, il vous faut passer par le fichier gag.po un exemplaire se trouve dans backup/.

Faites en une copie avec votre éditeur de texte préféré ou un logiciel spécialisé [5] , effectuez votre traduction et enregistrez votre fichier au format ANSI, mais pas en UTF-8 à cause des accents car la page générée est codée en iso-8859-1.

Ensuite copiez le fichier gag.po que vous venez de modifier dans C:/Python24/Tools/i18n/

Ouvrez une console et tapez ceci :

cd C:\Python24\Tools\i18n
msgfmt.py gag.po

Vous venez de compiler votre fichier gag.po en gag.mo

Il ne vous reste plus qu'à remplacer les fichiers existants dans i18n/$langue/LC_MESSAGES/

A l'heure actuelle seuls les messages français sont traduits.

Toute traduction effectuée en suivant la procédure ci-dessus est la bienvenue. Envoyez la par mail, avec votre nom afin que je puisse vous citer, et je la mettrai en téléchargement sur le site.

Pour ajouter une langue au programme il suffit d'ajouter l'arborescence suivante avec bien entendu les bons fichiers gag.po et gag.mo dans i18n/.

• code iso langue sur deux lettres/
  • LC_MESSAGES/
    • gag.mo
    • gag.po