Localization file formats

Weblate supports a wide range of translation formats. Each format is slightly different and provides a different set of capabilities.

Indication

Lorsque vous choisissez un format de fichier pour votre demande, il est préférable de conserver un format bien établi dans la boîte à outils/plateforme que vous utilisez. De cette façon, vos traducteurs pourront utiliser les outils auxquels ils sont habitués et contribueront plus probablement à votre projet.

Voir aussi

Translation Related File Formats

Détection automatique

Weblate tries to detect file format during Ajouter des projets et des composant de traduction. The detection might be wrong for different variants of the same serialization format (JSON, YAML, properties) or file encoding, so please verify that Format de fichier is correct before creating the component.

Fonctionnalités des types de traduction

Fonctionnalités de chacun des formats pris en charge

Format	Type [1]	Pluriels [2]	Descriptions [3]	Contexte [4]	Emplacement [5]	Drapeaux [8]	États supplémentaires [6]
GNU gettext PO (Portable Object)	bilingue	oui	oui	oui	oui	oui [9]	à vérifier
Gettext monolingue	monolingue	oui	oui	oui	oui	oui [9]	à vérifier
XLIFF	les deux	oui	oui	oui	oui	oui	à vérifier, approuver
Propriétés Java	les deux	non	oui	non	non	non
draggable/i18n lang files	monolingue	non	oui	non	non	non
Propriétés GWT	monolingue	oui	oui	non	non	non
Traductions Joomla	monolingue	non	oui	non	oui	non
Qt Linguist .ts	les deux	oui	oui	non	oui	oui	à vérifier
Ressources de chaînes Android	monolingue	oui	oui [7]	non	non	oui
Chaînes Apple iOS	les deux	non	oui	non	non	non
Chaînes de caractères PHP	monolingue	non [10]	oui	non	non	non
Fichiers JSON	monolingue	non	non	non	non	non
Fichiers i18next JSON	monolingue	oui	non	non	non	non
Fichiers JSON go-i18n	monolingue	oui	oui	non	non	non
Fichiers gotext JSON	monolingue	oui	oui	non	oui	non
Fichier ARB	monolingue	oui	oui	non	non	non
JSON WebExtension	monolingue	oui	oui	non	non	non
Fichiers de ressource .NET (RESX, RESW)	monolingue	non	oui	non	non	oui
Fichiers ResourceDictionary	monolingue	non	non	non	non	oui
Fichiers CSV	les deux	non	oui	oui	oui	non	à vérifier
Fichiers YAML	monolingue	non	non	non	non	non
Fichiers Ruby YAML	monolingue	oui	non	non	non	non
Fichiers DTD	monolingue	non	non	non	non	non
Fichiers XML plats	monolingue	non	non	non	non	oui
Fichiers RC Windows	monolingue	non	oui	non	non	non
Excel Open XML	monolingue	non	oui	oui	oui	non	à vérifier
Fichiers de métadonnées de l’App Store	monolingue	non	non	non	non	non
Fichiers de sous-titres	monolingue	non	non	non	oui	non
Fichiers HTML	monolingue	non	non	non	non	non
Fichiers Markdown	monolingue	non	non	non	non	non
Format OpenDocument	monolingue	non	non	non	non	non
Format IDML	monolingue	non	non	non	non	non
Traductions INI	monolingue	non	non	non	non	non
Traduction des fichier INI InnoSetup	monolingue	non	non	non	non	non
Format TermBase eXchange	bilingue	non	oui	non	non	oui
Fichiers texte	monolingue	non	non	non	non	non
Format Stringsdict	monolingue	oui	non	non	non	non
Format Fluent	monolingue	no [11]	oui	non	non	non

[1]

Voir Formats monolingues et bilingues

[2]

Voir Chaînes au pluriel

[3]

Voir Description de la chaîne source

[4]

Voir Contexte

[5]

Voir Emplacement de la chaîne source

[6]

Voir États de la chaîne

[7]

XML comment placed before the <string> element, parsed as a source string description.

[8]

Voir Drapeaux de traduction.

[9] (1,2)

Les commentaires de type gettext sont utilisés comme des drapeaux.

[10]

Les pluriels ne sont pris en charge que pour Laravel qui les utilise dans la syntaxe des chaînes de caractères pour les définir, voir Localization in Laravel.

[11]

Plurals are handled in the syntax of the strings and not exposed as plurals in Weblate.

Formats monolingues et bilingues

Les formats monolingual et bilingual sont pris en charge. Les formats bilingues stockent deux langues dans un seul fichier — source et traduction (exemples principaux GNU gettext PO (Portable Object), XLIFF ou Chaînes Apple iOS). A l’opposé, les formats mono-langue identifient la chaîne par un identifiant, et chaque fichier de langue contient uniquement la traduction correspondante pour une langue donnée (exemple Ressources de chaînes Android). Certains formats de fichiers sont utilisés dans les deux variantes, veuillez consulter la description détaillée ci-dessous.

Pour une utilisation correcte des fichiers monolingues, Weblate nécessite l’accès à un fichier contenant la liste complète des chaînes de caractères à traduire avec leur source — ce fichier est appelé Fichier de langue de base mono-langue dans Weblate, bien que le nom puisse varier selon votre paradigme.

De plus, ce flux de travail peut être étendu en utilisant un Fichier de langue intermédiaire pour inclure des chaînes fournies par les développeurs, mais qui ne doivent pas être utilisées telles quelles dans les chaînes finales.

États de la chaîne

Many file formats only differentiate « Untranslated » and « Translated » strings. With some formats it is possible to store more fine-grained state information, such as « Needs editing » or « Approved ».

Description de la chaîne source

Source string descriptions can be used to pass additional info about the string to translate.

Several formats have native support for providing additional info to translators (for example XLIFF, GNU gettext PO (Portable Object), JSON WebExtension, Fichiers CSV, Excel Open XML, Qt Linguist .ts, Fichiers JSON go-i18n, Fichiers gotext JSON, Fichier ARB, Fichiers de ressource .NET (RESX, RESW)). Many other formats extract closest comment as source string description.

Explication

The Explication on strings can be stored and parsed from a few file formats.

Pris en charge actuellement uniquement dans Format TermBase eXchange.

Emplacement de la chaîne source

L’emplacement d’une chaîne dans le code source peut aider les traducteurs compétents à comprendre comment la chaîne est utilisée.

Cette information est typiquement disponible dans les formats bilingues où les chaînes sont extraites du code source en utilisant des outils. Par exemple GNU gettext PO (Portable Object) et Qt Linguist .ts.

Drapeaux de traduction

Les options de traduction permettent de personnaliser le comportement de Weblate. Certains formats prennent en charge leur définition dans la traduction (vous pouvez toujours les définir dans l’interface Weblate, voir Personnaliser le comportement en utilisant des drapeaux).

Cette fonctionnalité est construite d’après les options de GNU gettext PO (Portable Object).

Additionally, for all XML based format, the flags are extracted from the non-standard attribute weblate-flags. Additionally max-length:N is supported through the maxwidth attribute as defined in the XLIFF standard, see Specifying translation flags.

Voir aussi

Personnaliser le comportement en utilisant des drapeaux, documentation des fichiers PO

Contexte

Context is used to differentiate identical strings in a bilingual format used in different scopes (for example Sun can be used as an abbreviated name of the day « Sunday » or as the name of our closest star).

Pour les formats monolingues, l’identifieur de chaîne (souvent appelé la clé) peut servir dans le même but et le contexte supplémentaire n’est pas nécessaire.

Chaînes au pluriel

Plurals are necessary to properly localize strings with variable count. The rules depend on a target language and many formats follow CLDR specification for that.

Indication

Utiliser la forme plurielle des chaînes nécessite d’avoir aussi le propre support dans l’environnement de l’application. Choisissez le format natif de votre plateforme tel que GNU gettext PO (Portable Object), Ressources de chaînes Android ou Format Stringsdict.

Chaînes en lecture seule

Read-only strings from translation files will be included, but can not be edited in Weblate. This feature is natively supported by few formats (XLIFF and Ressources de chaînes Android), but can be emulated in others by adding a read-only flag, see Personnaliser le comportement en utilisant des drapeaux.

Prise en charge d’autre formats

Most formats supported by translate-toolkit which support serializing can be easily supported, but they did not (yet) receive any testing. In most cases some thin layer is needed in Weblate to hide differences in behavior of different translate-toolkit storages.

To add support for a new format, the preferred approach is to first implement support for it in the translate-toolkit.

Voir aussi

Translation Related File Formats