Traduction des fichiers mnémoniques - Revision history

Bech: Mise à jour : 2 formats acceptés pour la partie droite des fichier mnémoniques

2018-06-15T12:16:15Z

Mise à jour : 2 formats acceptés pour la partie droite des fichier mnémoniques

Bech: /* Récupération et installation du paquet apertium-c-formatters */ Mise à jour pour Git

2018-06-15T12:07:29Z

Récupération et installation du paquet apertium-c-formatters: Mise à jour pour Git

Bech: Lien page anglaise

2014-10-06T10:37:14Z

Lien page anglaise

Bech: Correction accès svn

2014-07-04T21:40:10Z

Correction accès svn

Bech: Corrections mineures

2012-10-18T12:00:17Z

Corrections mineures

Bech: Création page

2012-10-14T22:43:10Z

Création page

New page

Les fichiers mnémoniques constituent une alternative aux fichier <code>.po</code> pour générer des interfaces utilisateur multilingues.

En dehors des commentaires éventuels (commençant par #) au début d'un fichier, Les fichiers mnémoniques sont constitués de lignes respectant le format suivant :

Mnémonique "chaine_de_format_pour_printf"

Dans ces lignes, le mnémonique (qui commence en première colonne) doit être conservé sans changement d'une langue à l'autre, alors que la chaine de caractères situés plus vers la droite est traduite.

Toutefois, une chaine de caractères à traduire peut comporter les séquences <code>\r</code> ou <code>\n</code> ou d'autres similaires qui, non seulement ne doivent pas être traduites, mais ne doivent pas perturber la traduction du mot suivant s'il touche la lettre ayant un rôle spécial.

De la même manière, les indications de format comme <code>%s</code>, <code>%3d</code>, <code>%4.2f</code> ... sont conservés sans modification.

Le format des '''fichiers mnémoniques''' n'est pas directement supporté par le paquet Apertium. Il est nécessaire de récupérer le paquet '''apertium-c-formatters''' pour disposer d'un dé-formateur qui prend en compte les spécificités de ce format.

== Récupération et installation du paquet apertium-c-formatters ==

Si vous n'avez pas déjà récupéré le paquet apertium-c-formatters pour la [[traduction des pages de man]], commencez par faire les opérations suivantes :

Téléchargez apertium-c-formatters depuis SVN :
<pre>
svn checkout http://apertium.svn.sourceforge.net/svnroot/apertium/trunk/apertium-c-formatters
</pre>

Compilez les fichiers source :
<pre>
make
</pre>

Et oui, la compilation est très simple, et rapide !

Installez les outils :
<pre>
make install
</pre>

La commande ci-dessus suppose que vous ayez un accès en écriture dans <code>/usr/local/bin</code> et <code>/usr/local/share/man</code>. Si ce n'est pas le cas, tapez la commande :
<pre>
sudo make install
</pre>

Par défaut, comme pour lttoolbox, apertium, et les paires de langues, l'installation se fait dans <code>/usr/local/bin</code> et <code>/usr/local/share</code>. Si vous souhaitez modifier le répertoire d'installation, il vous faut modifier la première ligne du fichier ''makefile''.

<pre>
install_dir=/usr/local
</pre>

sera remplacé par le répertoire parent de celui où iront les commandes exécutables. Par exemple, en mettant :

<pre>
install_dir=/usr
</pre>

Les outils seront installés dans <code>/usr/bin</code> et les pages de man dans <code>/usr/share/man</code> .

== Utilisation ==

=== Les outils disponibles ===

Les outils disponibles pour traduire les fichiers mnémoniques sont les suivants :

* '''desmnemo''' : dé-formateur pour les fichiers mnémoniques,
* '''remnemo''' : re-formateur générique utilisé pour les fichiers mnémoniques,
* '''apertium-mnemo''' : un shell destiné à faciliter la traduction de fichiers mnémoniques.

=== Traduction en appelant les différents outils nécessaires ===

Supposons que nous sommes placés dans le sous répertoire <code>samples-mnemo</code> du paquet apertium-c-formatters et que nous voulons traduire en espagnol le fichier <code>mess-libremail.fr-utf</code> . On peut taper :

<pre>
cat mess-libremail.fr-utf | desmnemo | apertium -f none fr-es | remnemo > mess-libremail.es-utf
</pre>

On remarque d'abord qu'on a traduit un fichier mnémonique utilisant le jeu de caractères UTF-8. Si le fichier est en format ISO-8859-''n'' (ou tout autre jeu de caractères), il faut convertir les données en UTF-8 pour qu'elles soient compatibles avec Apertium, lequel fournira aussi un résultat encodé UTF-8.

D'autre part, la commande <code>apertium</code> est exécutée avec l'option <code>-f none</code>, ce qui est nécessaire pour que le dé-formateur <code>apertium-destxt</code> ne soit pas utilisé.

On peut aussi passer les noms de fichiers en paramètre aux dé-formateur et re-formateur :

<pre>
desmnemo mess-libremail.fr-utf | apertium -f none fr-es | remnemo - mess-libremail.es-utf
</pre>

On peut remarquer le tiret '''<code>-</code>''' comme premier paramètre de <code>remnemo</code> . Les re-formateurs utilisent habituellement l'entrée standard (en l'occurrence le résultat produit par la commande <code>apertium</code>) alors qu'il peut être utile de conserver le résultat de re-formatage dans un fichier. Mais le problème est que la syntaxe générale des re-formateurs d'apertium nécessitent d'indiquer le fichier de sortie comme 2ème paramètre. Le '''<code>-</code>''' comme premier paramètre permet de s'affranchir de ce problème.

=== Plus simple avec la commande apertium-mnemo ===

Lorsqu'un format de données est intégré directement dans la commande <code>apertium</code>, on dispose de l'option '''<code>-f</code>''' pour traduire les données produites dans ce format sans avoir à appeler à la main un dé-formateur et un re-formateur. La commande <code>apertium-mnemo</code> est un shell qui permet de faire de même.

Par exemple, pour traduire en espéranto le fichier <code>mess-libremail.fr-utf</code> . On peut taper :

<pre>
cat mess-libremail.fr-utf | apertium-mnemo fr-eo > mess-libremail.es-utf
</pre>

Ou encore mieux :

<pre>
apertium-mnemo fr-eo mess-libremail.fr-utf mess-libremail.es-utf
</pre>

Les options '''<code>-u</code>''' et '''<code>-d datadir</code>''' de la commande <code>apertium</code> sont supportées par <code>apertium-mnemo</code>. Il suffit de les placer avant le paramètre indiquant la direction de traduction (comme pour la commande <code>apertium</code>).

[[Category:Formats]]
[[Category:Documentation en français]]

@@ Line 19: / Line 19: @@
 Si vous n'avez pas déjà récupéré le paquet apertium-c-formatters pour la [[traduction des pages de man]], commencez par faire les opérations suivantes :
-Téléchargez apertium-c-formatters depuis SVN :
+Téléchargez apertium-c-formatters depuis GIT :
 <pre>
-svn checkout https://svn.code.sf.net/p/apertium/svn/trunk/apertium-c-formatters
+git clone --depth 1 https://github.com/apertium/apertium-c-formatters
 </pre>

← Older revision		Revision as of 10:37, 6 October 2014
Line 1:		Line 1:
			[[Translating mnemonic files\|In English]]

	Les fichiers mnémoniques constituent une alternative aux fichier <code>.po</code> pour générer des interfaces utilisateur multilingues.		Les fichiers mnémoniques constituent une alternative aux fichier <code>.po</code> pour générer des interfaces utilisateur multilingues.

@@ Line 6: / Line 6: @@
  Mnémonique           "chaine_de_format_pour_printf"
+               ou
+ Mnémonique           chaine_de_caractères
 Dans ces lignes, le mnémonique (qui commence en première colonne) doit être conservé sans changement d'une langue à l'autre, alors que la chaine de caractères situés plus vers la droite est traduite.
@@ Line 62: / Line 64: @@
 * '''desmnemo''' : dé-formateur pour les fichiers mnémoniques,
-* '''remnemo'''  : re-formateur générique utilisé pour les fichiers mnémoniques,
+* '''remnemo'''  : re-formateur pour les fichiers mnémoniques,
 * '''apertium-mnemo''' : un shell destiné à faciliter la traduction de fichiers mnémoniques.

@@ Line 87: / Line 87: @@
 Lorsqu'un format de données est intégré directement dans la commande <code>apertium</code>, on dispose de l'option '''<code>-f</code>''' pour traduire les données produites dans ce format sans avoir à appeler à la main un dé-formateur et un re-formateur. La commande <code>apertium-mnemo</code> est un shell qui permet de faire de même.
-Par exemple, pour traduire en espéranto le fichier <code>mess-libremail.fr-utf</code> . On peut taper :
+Par exemple, pour traduire en espéranto le fichier <code>mess-libremail.fr-utf</code> , on peut taper :
 <pre>