.XML - Chaînes Android

Le contenu est traduit de l’anglais par Phrase Language AI.

Extensions de fichiers	.xml
Extension d'API	xml
Import	oui
Export	oui
Prise en charge des formes plurielles	oui
Prise en charge de la description	oui
Options de format Ces options peuvent être spécifiées lorsqu'un fichier est chargé et/ou Téléchargé. Selon la méthode de charger/Télécharger (API, CLI, synchronisation de dépôt, etc.), elles peuvent être spécifiées dans les paramètres de requête `charger`, `Télécharger` ou dans le fichier de configuration `phrase.yml`.	convert_placeholder escape_linebreaks unescape_linebreaks enclose_in_cdata indent_size indent_style unescape_tags include_tools_ignore include_tools_locale_definition escape_android_chars unescape_android_chars

Le XML Android est une variante XML spécifique à Android qui peut être utilisée pour charger du contenu traduit dans des applications Android. Son élément racine est un <resources> avec de nombreux éléments <string> imbriqués en dessous qui stockent des chaînes en attente de traduction. Vous pouvez utiliser Android Studio pour générer ces fichiers de ressources et utiliser Phrase pour gérer la traduction.

Android Studio utilise la propriété traduisible pour indiquer si le contenu doit être traduit. Dans Phrase, cette propriété est ignorée. Il n'est pas nécessaire de pousser ces Strings vers Phrase. Si une chaîne ne doit pas être traduite, définissez-la dans un fichier de ressources séparé contenant toutes les chaînes à ne pas traduire (par ex. donottranslate.xml).

Options de format

Identifiant	convert_placeholder
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	L'espace réservé sera converti pour correspondre aux exigences spécifiques du format. Exemple : `$s' => '$@`

Identifiant	escape_linebreaks
Type	Booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Tous les sauts de ligne seront échappés sous la forme `\\n`

Identifiant	unescape_linebreaks
Type	booléen
Chargement	oui
Téléchargement	non
Par défaut	false
Description	Tous les `\\n` seront importés comme de vrais sauts de ligne

Identifiant	enclose_in_cdata
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Entoure les traductions contenant des balises HTML dans des CDATA

Identifiant	indent_size
Type	integer
Charger	non
Télécharger	Oui
Par défaut	4
Description	Spécifie le nombre de caractères d'indentation

Identifiant	indent_style
Type	chaîne
Charger	non
Télécharger	Oui
Par défaut	Espace
Description	Spécifie le caractère d'indentation. Les valeurs autorisées sont `Espace` et `onglet`.

Identifiant	unescape_tags
Type	booléen
Chargement	oui
Téléchargement	non
Par défaut	false
Description	Tous les caractères `<` seront déséchappés en `<` et tous les caractères `>` seront déséchappés en `>` pour les balises.

Identifiant	include_tools_locale_definition
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Inclure l'attribut `Outils:paramètre linguistique` attribute dans le XML résultant.

Identifiant	include_tools_ignore
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Inclure l'attribut `Outils:ignorer` attribute dans le XML résultant. Lorsqu'il est désactivé (par défaut), l'attribut `Outils:ignorer` est omis des fichiers exportés. Cela permet de garder les fichiers de ressources propres et évite d'inclure des attributs de suppression de lint spécifiques au développement.

Identifiant	preserve_cdata
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Si le contenu de la traduction contient déjà une balise CDATA, ce commutateur empêche le contenu d'être échappé davantage.

Identifiant	escape_android_chars
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Échappe `@`, `?` et `onglet` caractères spéciaux Android avec un préfixe barre oblique inverse.

Identifiant	unescape_android_chars
Type	booléen
Chargement	oui
Téléchargement	non
Par défaut	false
Description	Déséchappe `\\@`, `\\?`, `\\t` et `\\uXXXX` (caractère Unicode avec le code XXXX).

Exemple de code

<?xml version="1.0" encoding="UTF-8"?>
<resources>
    <string name="boolean_key">--- true
</string>
    <string name="empty_string_translation"/>
    <!-- Ceci est la magnifique description pour cette clé ! -->
    <string name=\"key_with_description\">Check it out! Cette clé a une description ! (Au moins dans certains formats)</string>
    <string name=\"key_with_line-break\">This translations contains
a line-break.</string>
    <string name=\"nested.deeply.key\">Hé, cette clé est imbriquée encore plus profondément.</string>
    <string name=\"nested.key\">This key is nested inside a namespace.</string>
    <string name="null_translation"/>
    <plurals name="pluralized_key">
        <item quantity=\"one\">Une seule forme plurielle trouvée.</item>
        <item quantity=\"other\">Hé, vous avez %s pluriels !</item>        
    </plurals>
    <string-array name="sample_collection">
        <item>premier élément</item>
        <item>deuxième élément</item>
        <item>troisième élément</item>
    </string-array>
    <string name=\"simple_key\">Juste une clé avec un message.</string>
    <string name=\"unverified_key\">Cette traduction n'est pas encore vérifiée et attend de l'être. (Dans certains formats, nous exportons également ce statut)</string>
</resources>

Pluriels pour les fichiers XML Android

Pour les valeurs plurielles, assigner une <plurals> balise spéciale comme ceci :

<plurals name="messages">
        <item quantity=\"one\">Un message reçu.</item>
        <item quantity=\"other\">%s messages reçus.</item>        
</plurals>