Traduction des pages de man - Revision history

Bech: /* Caractéristiques du dé-formateur pour les pages de man */ orthographe

2018-06-15T11:49:13Z

Caractéristiques du dé-formateur pour les pages de man: orthographe

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

2018-06-15T11:47:48Z

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

Bech: Lien page anglaise

2014-10-06T10:37:10Z

Lien page anglaise

Bech: Correction accès svn

2014-07-04T21:39:39Z

Correction accès svn

Bech: Quelques correction

2012-10-18T10:47:07Z

Quelques correction

Bech: Création page

2012-10-14T22:05:46Z

Création page

New page

Le format des '''pages de man''' 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 fichiers mnémoniques]], 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 pages de man sont les suivants :

* '''desman''' : dé-formateur pour les pages de man,
* '''reman''' : re-formateur générique utilisé pour les pages de man,
* '''apertium-man''' : un shell destiné à faciliter la traduction de pages de man.

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

Supposons que nous sommes placés dans le répertoire <code>/usr/share/man</code> et que nous voulons traduire en espagnol la version française de la page de man de la commande ''desman'' qu'on copiera directement au bon endroit. On peut taper :

<pre>
cat fr/man/desman.1 | desman | apertium -f none fr-es | reman > es/man/desman.1
</pre>

On remarque que 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>
desman fr/man/desman.1 | apertium -f none fr-es | reman - es/man/desman.1
</pre>

On peut remarquer le tiret '''<code>-</code>''' comme premier paramètre de <code>reman</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-man ===

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-man</code> est un shell qui permet de faire de même.

Par exemple, pour traduire en espéranto la version française de la page de man de la commande ''apertium-man'' on peut taper :

<pre>
cat fr/man/apertium-man.1 | apertium-man fr-eo > eo/man/apertium-man.1
</pre>

Ou encore mieux :

<pre>
apertium-man fr-eo fr/man/apertium-man.1 eo/man/apertium-man.1
</pre>

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

== Caractéristiques du dé-formateur pour les pages de man ==

Certaines lignes des pages de man commence par un mnémonique en lettres majuscules précédées d'un point. On trouve notamment :

* .TH
* .SH
* .TP
* .B
* .I
* .PP

Ces mnémoniques concernent la mise en page du document et ne doivent pas être modifiés durant la traduction. Le dé-formateur <code>desman</code> marque comme texte à conserver tel-quel tous les débuts de ligne commençant par un point suivi d'une ou plusieurs lettres.

D'autre part, les commandes décrites dans une page de man peuvent accepter des options : en général une lettre précédée d'un '''<code>-</code>'''. Pour éviter l'apparition d'* indésirables (voire quelquefois pire avec certaines lettre et certaines langues source), le dé-formateur <code>desman</code> marque comme texte à conserver tel-quel les '''<code>-</code>''' immédiatement suivis (sans espace) d'un ou plusieurs caractères alphanumériques.

== Voir aussi ==

[http://new.linuxfocus.org/Francais/November2003/article309.shtml Documentation sur le format des pages de man]

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

@@ Line 7: / Line 7: @@
 Si vous n'avez pas déjà récupéré le paquet apertium-c-formatters pour la [[traduction des fichiers mnémoniques]], 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 man pages\|In English]]

	Le format des '''pages de man''' 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.		Le format des '''pages de man''' 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.

@@ Line 91: / Line 91: @@
 == Caractéristiques du dé-formateur pour les pages de man ==
-Certaines lignes des pages de man commence par un mnémonique en lettres majuscules précédées d'un point. On trouve notamment :
+Certaines lignes des pages de man commencent par un mnémonique en lettres majuscules précédées d'un point. On trouve notamment :
 * .TH

@@ Line 39: / Line 39: @@
 </pre>
-Les outils seront installés dans <code>/usr/bin</code> et les pages de man dans <code>/usr/share/man</code> .
+les outils seront installés dans <code>/usr/bin</code> et les pages de man dans <code>/usr/share/man</code> .
 == Utilisation ==
@@ Line 56: / Line 56: @@
 <pre>
-cat fr/man/desman.1 | desman | apertium -f none fr-es | reman > es/man/desman.1
+cat fr/man1/desman.1 | desman | apertium -f none fr-es | reman > es/man1/desman.1
 </pre>
@@ Line 64: / Line 64: @@
 <pre>
-desman fr/man/desman.1 | apertium -f none fr-es | reman - es/man/desman.1
+desman fr/man1/desman.1 | apertium -f none fr-es | reman - es/man1/desman.1
 </pre>
@@ Line 76: / Line 76: @@
 <pre>
-cat fr/man/apertium-man.1 | apertium-man fr-eo > eo/man/apertium-man.1
+cat fr/man1/apertium-man.1 | apertium-man fr-eo > eo/man1/apertium-man.1
 </pre>
-Ou encore mieux :
+ou encore mieux :
 <pre>
-apertium-man fr-eo fr/man/apertium-man.1 eo/man/apertium-man.1
+apertium-man fr-eo fr/man1/apertium-man.1 eo/man1/apertium-man.1
 </pre>
@@ Line 100: / Line 100: @@
 Ces mnémoniques concernent la mise en page du document et ne doivent pas être modifiés durant la traduction. Le dé-formateur <code>desman</code> marque comme texte à conserver tel-quel tous les débuts de ligne commençant par un point suivi d'une ou plusieurs lettres.
-D'autre part, les commandes décrites dans une page de man peuvent accepter des options : en général une lettre précédée d'un '''<code>-</code>'''. Pour éviter l'apparition d'* indésirables (voire quelquefois pire avec certaines lettre et certaines langues source),  le dé-formateur <code>desman</code> marque comme texte à conserver tel-quel les '''<code>-</code>''' immédiatement suivis (sans espace) d'un ou plusieurs caractères alphanumériques.
+D'autre part, les commandes décrites dans une page de man peuvent accepter des options : en général une lettre précédée d'un '''<code>-</code>'''. Pour éviter l'apparition d'* indésirables (voire quelquefois pire avec certaines lettres et certaines langues source),  le dé-formateur <code>desman</code> marque comme texte à conserver tel-quel les '''<code>-</code>''' immédiatement suivis (sans espace) d'un ou plusieurs caractères alphanumériques.
 == Voir aussi ==