Support du format d'un document - Revision history

Bech: Lien page anglaise

2014-10-06T09:51:24Z

Lien page anglaise

Bech: orthographe pour '''dé-formateur'''

2012-10-14T20:17:27Z

orthographe pour '''dé-formateur'''

Bech: /* Formats supportés dans des paquets séparés */

2012-10-14T18:33:28Z

Formats supportés dans des paquets séparés

Bech: [ et ] plus visibles

2012-10-14T17:46:37Z

[ et ] plus visibles

Hectoralos at 11:53, 18 January 2012

2012-01-18T11:53:03Z

Bech: Création page

2011-12-31T18:37:11Z

Création page

New page

Le '''support du format''' dans Apertium est réalisé par des programmes spéciaux pour encapsuler et dé-encapsuler les informations de formatage dans des "superblancs", qui sont délimités par les caractères <code>[</code> et <code>]</code>. Donc par exemple, pour traiter le HTML, le programme <code>apertium-deshtml</code> encapsule les informations de formatage, alors que <code>apertium-rehtml</code> les dé-encapsule (restaure), comme dans l'exemple suivant :

<pre>
$ echo "<em>C'est</em> un <b>test</b>" | apertium-deshtml
[<em>]C'est[<\/em> ]un[ <b>]test.[][<\/b>]

$ echo "<em>C'est</em> un <b>test</b>" | apertium-deshtml | apertium-rehtml
<em>C'est</em> un <b>test</b>
</pre>

Pour l'instant, des déformateurs et re-formateurs sont disponibles pour :

* '''texte simple''' (<code>apertium-destxt</code>)
* '''HTML''' (<code>apertium-deshtml</code>)
* '''RTF''' (<code>apertium-desrtf</code>)
* '''OpenOffice.org Writer ODT''' (<code>apertium-desodt</code>)
* '''Microsoft Word DOCX, WXML''' (<code>apertium-deswxml</code>)
* '''Microsoft Powerpoint PPTX''' (<code>apertium-despptx</code>)
* '''Microsoft Excel XLSX''' (<code>apertium-desxlsx</code>)
* '''QuarkXPress XpressTag''' (<code>apertium-desxpresstag</code>)
* '''MediaWiki''' (<code>apertium-desmediawiki</code> -- encore en développement, voir [[Traduction des documents wikimedia]])

Il n'y a pour l'instant aucune construction supportant les fichiers '''gettext''' <code>.po</code> ou les formats de sous-titres, mais voir [[Traduction des fichiers gettext]] et [[Traduction des sous titres]] pour des très solutions simples.

''Note: apertium-destxt ajoute un point avant chaque changement de ligne qui n'est pas suivi de texte, ce qui fait que vous pouvez avoir quelquefois deux points.''

== Spécification de format ==

Cette section décrit comment le déformateur et le re-formateur sont générés depuis la spécification du format en XML. Les règles pour le format, comme les données linguistiques, sont spécifiées en XML, et elles contiennent des expressions régulières avec la syntaxe flex. La spécification est divisée en trois parties (voir sa DTD dans l'Appendice A.6):

*'''Options de configuration'''. Ici on spécifie la valeur pour la longueur maximale d'un superblanc non-extensif, les encodages d'entrée et sortie, si on doit prendre considération la casse des caractères, et les expressions régulières pour les caractères d'échappements et les espaces.
*'''Règles de format'''. Décrit l'ensemble de balises appartenant à un format spécifique qui doit être inclus dans un bloc de format par le déformateur. Ces balises peuvent, optionellement, indiquer une fin de phrase, auquel cas le déformateur ajoutera une marque de ponctuation artificielle (suivie d'un bloc de format vide, comme expliqué dans la section précédente). On doit spécifier la priorité d'application de ces règles, toutefois, quand ce n'est pas pertinent, il est possible de donner la même priorité à toutes les règles en leur assignant la même valeur (n'importe quel nombre). Tout ce qui n'est pas spécifié comme format sera laissé sans encapsulation et, par conséquent, sera considéré comme du texte traduisible.
*'''Règles de remplacement'''. Permet de remplacer les caractères spéciaux dans le texte. Une expression régulière va reconnaître un ensemble de caractères spéciaux, et va le remplacer par les caractères spécifiés. Par exemple, en HTML, les caractères exprimés en hexadécimal doivent être replacés par l'entité correspondante ou le caractère ASCII. Par exemple, carr&eacute;s correspond à carrés.

== Racine du fichier de spécification ==

L'attribut name contient le nom du format.

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<format name="html">
<options>
...
</options>
<rules>
...
</rules>
</format>
</pre>

Il doit comprendre les options et les règles, un exemple est présenté plus loin.

== Options ==

L'élément <largeblocks> spécifie la longueur maximale d'un superblanc non-extensif, par la valeur de l'attribut ''size''. Les éléments <code><input></code> et <code><output></code> spécifient les encodages d'entrée et sortie du texte, à travers l'attribut ''encoding''. L'élément <code>escape-chars</code> spécifie, au moyen d'une expression régulière déclarée dans la valeur de l'attribut regexp, quels caractères doivent être échappés avec un backslash. L'élément <code><space-chars></code> spécifie l'ensemble des caractères qui doivent être considérés comme des blancs. Finalement, l'élément <code>case-sensitive</code> spécifie si la casse des caractères est significative dans les spécifications des attributs de format dans lesquels figurent des expression régulières.

;Exemple

<pre>
<options>
<largeblocks size="8192"/>
<input encoding="UTF-8"/>
<output encoding="UTF-8"/>
<escape-chars regexp=’[\[\]ˆ$\\]’/>
<space-chars regexp=’[ \n\t\r]’/>
<case-sensitive value="no"/>
</options>
</pre>

== Règles ==

Il y a des règles de format et des règles de remplacement.

<pre>
<rules>
<format-rule ... >
...
</format-rule>
...
<replacement-rule>
...
</replacement-rule>
...
</rules>
</pre>

Les deux types sont décrits dans les points suivants.

=== Règles de format ===

Le déformateur va encapsuler dans des blocs de format les balises indiquées par ces règles dans le champ regexp. S'il y a des balises de début et de fin, et que tout ce qui est délimité par elles est un format, il faut spécifier une valeur regexp à la fois pour le début et la fin :

<pre>
<format-rule eos="no" priority="1">
<begin regexp=’"\</nowiki></code>
* '''Priorité 2''': Les marques for pour le début et la fin <code><script> </script></code> et <code><style> </style></code>, où tout ce qui est inclus entre ces balises est considéré comme du format.
* '''Priorité 3''': C'est pour les balises qui indiquent la fin d'une phrase (ponctuation artificielle), qui sont <code><nowiki><br/></nowiki></code>, <code></hr></code>, <code></p></code>, etc.
* '''Priorité 4''': Les dernières sont les règles de remplacement, qui remplace tous les codes qui commencent par <code>&</code>, comme spécifié dans l'expression régulière. Ainsi, chaque remplacement est défini : <code>&Agrave;</code>, aussi bien que <code>&#192;</code>, <code>&#xC0;</code> et <code>&#xc0;</code> sont remplacé par <code>À</code>. Les caractères spéciaux restant sont déclarés de la même manière.

;Exemple

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<format name="html">
<options>
<largeblocks size="8192"/>
<input encoding="UTF-8"/>
<output encoding="UTF-8"/>
<escape-chars regexp='[\[\]ˆ$\\]'/>
<space-chars regexp='[ \ n\ t\ r]'/>
<case-sensitive value="no"/>
</options>
<rules>
<format-rule eos="no" priority="1">
<begin regexp='""'/>
</format-rule>
<format-rule eos="no" priority="2">
<begin regexp='"<script"[ˆ>]*">"'/>
<end regexp='"</script"[ˆ>]*">"'/>
</format-rule>
<format-rule eos="no" priority="2">
<begin regexp='"<style"[ˆ>]*">"'/>
<end regexp='"</style"[ˆ>]*">"'/>
</format-rule>
<format-rule eos="yes" priority="3">
<begin-end regexp='"<"[/]?"br"[ˆ>]*">"'/>
</format-rule>


<format-rule eos="no" priority="4">
<begin-end regexp='"<"[a-zA-Z][ˆ>]*">"'/>
</format-rule>
<replacement-rule regexp=’"&"[ˆ;]+;’>
<replace source="&Agrave;" target="À"/>
<replace source="&#192;" target="À"/>
<replace source="&#xC0;" target="À"/>
<replace source="&#xc0;" target="À"/>


</replacement-rule>
</rules>
</format>
</pre>

== Notes ==
<references/>

== Voir aussi ==

* [[Format du flux Apertium]]
* [[Traduction des fichiers gettext]]

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

← Older revision		Revision as of 09:51, 6 October 2014
Line 1:		Line 1:
			[[Format handling\|In English]]

	Le '''support du format''' dans Apertium est réalisé par des programmes spéciaux pour encapsuler et dé-encapsuler les informations de formatage dans des "superblancs", qui sont délimités par les caractères '''<code>[</code>''' et '''<code>]</code>'''. Donc par exemple, pour traiter le HTML, le programme <code>apertium-deshtml</code> encapsule les informations de formatage, alors que <code>apertium-rehtml</code> les dé-encapsule (restaure), comme dans l'exemple suivant :		Le '''support du format''' dans Apertium est réalisé par des programmes spéciaux pour encapsuler et dé-encapsuler les informations de formatage dans des "superblancs", qui sont délimités par les caractères '''<code>[</code>''' et '''<code>]</code>'''. Donc par exemple, pour traiter le HTML, le programme <code>apertium-deshtml</code> encapsule les informations de formatage, alors que <code>apertium-rehtml</code> les dé-encapsule (restaure), comme dans l'exemple suivant :

@@ Line 11: / Line 11: @@
 == Formats officiellement supportés par Apertium ==
-Pour l'instant, des déformateurs et re-formateurs sont disponibles dans le paquet Apertium pour :
+Pour l'instant, des dé-formateurs et re-formateurs sont disponibles dans le paquet Apertium pour :
 * '''texte simple''' (<code>apertium-destxt</code>)
@@ Line 29: / Line 29: @@
 == Formats supportés dans des paquets séparés ==
-D'autres déformateurs et re-formateurs ont été écrits directement en langage C ou C++ sans faire appel à des fichiers XML. Ils ne respectent donc pas les spécification de format décrites à partir du chapitre suivant. De ce fait, ils sont diffusés dans des paquets séparés.
+D'autres dé-formateurs et re-formateurs ont été écrits directement en langage C ou C++ sans faire appel à des fichiers XML. Ils ne respectent donc pas les spécification de format décrites à partir du chapitre suivant. De ce fait, ils sont diffusés dans des paquets séparés.
 * '''apertium-mediawiki''' est un paquet développé en C++ qui gère le format des documents wikimedia avec un meilleur support des liens.
@@ Line 41: / Line 41: @@
 ''Ce paragraphe et les suivants concernent uniquement les formats officiellement supportés par Apertium.''
-Cette section décrit comment le déformateur et le re-formateur sont générés depuis la spécification du format en XML. Les règles pour le format, comme les données linguistiques, sont spécifiées en XML, et elles contiennent des expressions régulières avec la syntaxe flex. La spécification est divisée en trois parties (voir sa DTD dans l'Appendice A.6):
+Cette section décrit comment le dé-formateur et le re-formateur sont générés depuis la spécification du format en XML. Les règles pour le format, comme les données linguistiques, sont spécifiées en XML, et elles contiennent des expressions régulières avec la syntaxe flex. La spécification est divisée en trois parties (voir sa DTD dans l'Appendice A.6):
 *'''Options de configuration'''. Ici on spécifie la valeur pour la longueur maximale d'un superblanc non-extensif, les encodages d'entrée et sortie, si on doit prendre considération la casse des caractères, et les expressions régulières pour les caractères d'échappements et les espaces.
-*'''Règles de format'''. Décrit l'ensemble de balises appartenant à un format spécifique qui doit être inclus dans un bloc de format par le déformateur. Ces balises peuvent, optionellement, indiquer une fin de phrase, auquel cas le déformateur ajoutera une marque de ponctuation artificielle (suivie d'un bloc de format vide, comme expliqué dans la section précédente). On doit spécifier la priorité d'application de ces règles, toutefois, quand ce n'est pas pertinent, il est possible de donner la même priorité à toutes les règles en leur assignant la même valeur (n'importe quel nombre). Tout ce qui n'est pas spécifié comme format sera laissé sans encapsulation et, par conséquent, sera considéré comme du texte traduisible.
+*'''Règles de format'''. Décrit l'ensemble de balises appartenant à un format spécifique qui doit être inclus dans un bloc de format par le dé-formateur. Ces balises peuvent, optionellement, indiquer une fin de phrase, auquel cas le dé-formateur ajoutera une marque de ponctuation artificielle (suivie d'un bloc de format vide, comme expliqué dans la section précédente). On doit spécifier la priorité d'application de ces règles, toutefois, quand ce n'est pas pertinent, il est possible de donner la même priorité à toutes les règles en leur assignant la même valeur (n'importe quel nombre). Tout ce qui n'est pas spécifié comme format sera laissé sans encapsulation et, par conséquent, sera considéré comme du texte traduisible.
 *'''Règles de remplacement'''. Permet de remplacer les caractères spéciaux dans le texte. Une expression régulière va reconnaître un ensemble de caractères spéciaux, et va le remplacer par les caractères spécifiés. Par exemple, en HTML, les caractères exprimés en hexadécimal doivent être replacés par l'entité correspondante ou le caractère ASCII. Par exemple, carr&amp;eacute;s correspond à carrés.
@@ Line 103: / Line 103: @@
 === Règles de format ===
-Le déformateur va encapsuler dans des blocs de format les balises indiquées par ces règles dans le champ regexp. S'il y a des balises de début et de fin, et que tout ce qui est délimité par elles est un format, il faut spécifier une valeur regexp à la fois pour le début et la fin :
+Le dé-formateur va encapsuler dans des blocs de format les balises indiquées par ces règles dans le champ regexp. S'il y a des balises de début et de fin, et que tout ce qui est délimité par elles est un format, il faut spécifier une valeur regexp à la fois pour le début et la fin :
 <pre>

@@ Line 9: / Line 9: @@
 </pre>
+== Formats officiellement supportés par Apertium ==
-Pour l'instant, des déformateurs et re-formateurs sont disponibles pour :
+Pour l'instant, des déformateurs et re-formateurs sont disponibles dans le paquet Apertium pour :
 * '''texte simple''' (<code>apertium-destxt</code>)
@@ Line 24: / Line 26: @@
 ''Note: apertium-destxt ajoute un point avant chaque changement de ligne qui n'est pas suivi de texte, ce qui fait que vous pouvez avoir quelquefois deux points.''
+== Formats supportés dans des paquets séparés ==
+D'autres déformateurs et re-formateurs ont été écrits directement en langage C ou C++ sans faire appel à des fichiers XML. Ils ne respectent donc pas les spécification de format décrites à partir du chapitre suivant. De ce fait, ils sont diffusés dans des paquets séparés.
+* '''apertium-mediawiki''' est un paquet développé en C++ qui gère le format des documents wikimedia avec un meilleur support des liens.
+* '''apertium-c-formatters''' est un paquet développé en C qui gère les format des :
+** [[Traduction des pages de man|pages de man]]
+** [[Traduction des fichiers mnémoniques|fichiers mnémoniques]] (une alternative aux fichier <code>.po</code> pour générer des interfaces utilisateur multilingues).
 == Spécification de format ==
+''Ce paragraphe et les suivants concernent uniquement les formats officiellement supportés par Apertium.''
 Cette section décrit comment le déformateur et le re-formateur sont générés depuis la spécification du format en XML. Les règles pour le format, comme les données linguistiques, sont spécifiées en XML, et elles contiennent des expressions régulières avec la syntaxe flex. La spécification est divisée en trois parties (voir sa DTD dans l'Appendice A.6):

← Older revision		Revision as of 17:46, 14 October 2012
Line 1:		Line 1:
	Le '''support du format''' dans Apertium est réalisé par des programmes spéciaux pour encapsuler et dé-encapsuler les informations de formatage dans des "superblancs", qui sont délimités par les caractères <code>[</code> et <code>]</code>. Donc par exemple, pour traiter le HTML, le programme <code>apertium-deshtml</code> encapsule les informations de formatage, alors que <code>apertium-rehtml</code> les dé-encapsule (restaure), comme dans l'exemple suivant :		Le '''support du format''' dans Apertium est réalisé par des programmes spéciaux pour encapsuler et dé-encapsuler les informations de formatage dans des "superblancs", qui sont délimités par les caractères '''<code>[</code>''' et '''<code>]</code>'''. Donc par exemple, pour traiter le HTML, le programme <code>apertium-deshtml</code> encapsule les informations de formatage, alors que <code>apertium-rehtml</code> les dé-encapsule (restaure), comme dans l'exemple suivant :

	<pre>		<pre>

@@ Line 193: / Line 193: @@
 * [[Traduction des fichiers gettext]]
-[[Category:Documentation]]
 [[Category:Formats]]
 [[Category:Documentation en français]]