Guide Apertium pour les utilisateurs de Windows

Ce tutorial va vous guider pour utiliser l'installateur d'Apertium afin d'installer :

• Apertium
• les paires de langues d'Apertium
• TortoiseSVN (GUI SVN client pour Windows)
• Notepad++ (Bon éditeur de textes open source)

Avec l'installateur d'Apertium pour Windows, il n'est pas nécessaire d'installer des outils comme Cygwin, Subversion, GCC, etc... (qu'un autre guide Installation sur Windows en utilisant cygwin vous demande d'installer).

Installation d'Apertium

1. Téléchargez l'installateur depuis Sourceforge. Démarrez le et lisez la licence d'utilisation de l'installateur d'Apertium (beaucoup de parties sont dans la GNU/GPL) ensuite cliquez "I Agree" pour continuer.

2. Sélectionnez les composants à installer (Tous sont recommandés pour les utilisateurs non expérimentés) ensuite cliquez "Next" pour aller à la page suivante.

3. Choisissez l'emplacement désiré pour l'installation. Il est recommandé de n'utiliser aucun caractère spécial (ex: espace, caractère accentué, caractère d'un alphabet non européen) pour définir cet emplacement.

4. L'installateur de Cygwin apparaîtra. Choisissez le miroir le plus proche et continuez.

5. On vous demandera de sélectionner les paquets de Cygwin, (vous pouvez les laisser tous non marqués) cliquez "Next" pour continuer.

6. L'installateur va lister les paquets qu'il est nécessaire d'installer pour résoudre les problèmes de dépendances. Cliquez "Next" pour continuer.

7. Il y aura une boite d'alerte à la première installation, ignorez la en cliquant "OK"

8. L'installateur de Cygwin vous demandera de créer un icone sur le bureau et un raccourci dans Menu-démarrer. L'installateur d'Apertium va aussi créer le raccourci du menu de démarrage, il n'est donc pas nécessaire de les sélectionner.

9. Ensuite une console console apparaîtra pour recompiler Apertium and lttoolbox. Ça prendra autour de 30 à 60 minutes. (Il est bon de faire d'autres choses en attendant).

Test rapide pour voir si ça fonctionne

Vous devriez maintenant avoir le moteur d'Apertium installé (mais aucune paire de langues pour l'instant).

Après l'installation, la fenêtre noire du terminal "Cygwin" devrait être visible (vous pouvez aussi trouver un lien pour le faire depuis votre menu de démarrage sous "Apertium").

Si vous essayez de taper apertium suivi de la touche entrée, vous devriez voir

USAGE: apertium [-d datadir] [-f format] [-u] <direction> [in [out]] et d'autre texte du même genre. Si ce n'est pas le cas, probablement quelque-chose s'est mal passé ...

Installation des paire de langues d'Apertium

1. Téléchargez l'installateur depuis Sourceforge. Démarrez le et lisez la licence d'utilisation de l'installateur d'Apertium (beaucoup de parties sont dans la GNU/GPL) ensuite cliquez "I Agree" pour continuer.

2. Sélectionnez les paires de langues que vous aimeriez installer et cliquez "Next" pour continuer. L'installation complète prend quelques heures et n'est pas recommandée pour un utilisateur normal.

3. Choisissez l'emplacement pour l'installation et cliquez "Next". (Ça devrait être l'endroit où Apertium a été installé).

4. Cliquez Finish pour finir le processus d'installation.

Test rapide pour voir si ça fonctionne

Après l'installation, la fenêtre noire du terminal "Cygwin" devrait être visible (vous pouvez aussi trouver un lien pour le faire depuis votre menu de démarrage sous "Apertium").

Si vous tapez apertium -l suivi de la touche entrée, vous devriez voir une liste de codes des paires de langues installées. Si on trouve dans la liste es-ca, vous pouvez essayer de taper

echo hola mundo | apertium es-ca

Vous devriez voir hola món ; fonctionnement similaire avec d'autres paires de langues.

Traduire un fichier

Exemple: traduire un fichier HTML de l'asturian vers l'espagnol :

apertium -f html ast-es $(cygpath c:\\mystuff\\asturian_input.html) $(cygpath c:\\mystuff\\spanish_output.html)

(Le cygpath est malheureusement nécessaire pour récupérer un chemin d'accès Windows depuis Cygwin. Un utilisateur de Windows expérimenté devrait probablement pouvoir écrire un script pour en faire une option du menu droit (clic droit de la souris).)

Veuillez noter que le backslash \>/code> doit être "échappé", en le tapant 2 fois !

Note du traducteur : On peut également utiliser la syntaxe UNIX pour les chemins d'accès en replaçant chaque \ du chemin d'accès Windows par un / . Je ne sais pas si ça résout le problème de cygpath.

Developing further on a language pair

The installer puts the language data inside the Cygwin directory /home/apertium-install/languages, which is really located within the Windows directory C:\Apertium\home\apertium-install\languages. In there you'll find directories for all the installed language pairs, and can change language data and recompile etc. as described in Apertium_New_Language_Pair_HOWTO

or was it /home/apertium-installation/...?

Install TortoiseSVN(optional)

See also: Using SVN with TortoiseSVN

1. Download TortoiseSVN from Offical downloads page. Run and click next to skip introduction step.

2. Read EULA and select "I accept the terms in the License Agreement", click "Next" to continue.

3. Select components to install, you can leave it as it is and click "Next" to continue.

4. The installer will show the finish page, click next and it will ask you to restart. You need to restart your machine to start using TortoiseSVN.

5. After TortoiseSVN there will be a menu item in context menu of every files and directories. To checkout SVN click "SVN checkout..."

6. You can now type URL of repository in Checkout dialog and click OK to start SVN checkout.

Install Notepad++(optional)

1. Download Notepad++ from offical site. Run and click "Next" to continue.

2. Read license agreement and click "I agree" to continue.

3. Select install location (recommmend default) and click "Next" to continue.

4. Select components to install, just leave it as default and click "Next" to continue.

5. The installer will start to process. After that you can select to run Notepad++ for first time.

6. You can edit any files with Notepad++ by right click on them and click on a menu item named "Edit with Notepad++".

How to commit changes to SVN using TortoiseSVN

You need to request commit access before follow this part of tutorial. You can request commit access from these following ways.

• IRC: #apertium on irc.freenode.net
• Mailing List: apertium-stuff AT lists.sourceforge DOT net

1. Right click on directory you would like to commit changes and click "SVN Commit..." (Language pairs will normally located in C:\Apertium\home\apertium-install\languages)

2. Type message describe your changes and select file you wish to commit. Then click "OK" to start the process.

3. There will be a dialog ask your username and password. Fill the information and click "OK"

4. You will see a dialog show committing progress. Just wait and click "OK" after the process finished.