.TXT (Strings)

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

Extensions de fichier	.txt, .tsv
Extension d'API	.txt, .tsv
Importer	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écharger. 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`.	key_index comment_index: 4 tag_column: 5 max_characters_allowed_column column_separator: ";" quote_char header_content_row enable_pluralization exporter des balises exporter max_characters_allowed custom_metadata_columns

TXT stocke des informations en texte brut sans aucune option de formatage intégrée telle que le gras, l'italique ou les images.

Le paramètre locale_mapping (de type hashmap) est requis pour spécifier quelle colonne du document correspond à chaque paramètre linguistique. Pour des exemples, consultez le configuration file example et la API documentation pour les charger.

Options de format

Identifiant	key_index
Type	integer
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Index de la colonne contenant les noms de clé. Les index de colonne commencent à 1.

Identifiant	comment_index: 4
Type	integer
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Index de la colonne contenant la description de la clé. Les index de colonne commencent à 1.

Identifiant	tag_column: 5
Type	integer
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Index de la colonne contenant une balise pour la clé. Les index de colonne commencent à 1.

Identifiant	max_characters_allowed_column
Type	integer
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Index de la colonne contenant un nombre maximum de caractères pour la clé. Les index de colonne commencent à 1.

Identifiant	column_separator: ";"
Type	chaîne
Chargement	oui
Téléchargement	non
Par défaut	\t
Description	Caractère utilisé pour séparer les colonnes.

Identifiant	quote_char
Type	chaîne
Chargement	oui
Téléchargement	non
Par défaut	"
Description	Caractère utilisé pour mettre entre devis les sauts de ligne et le séparateur de colonne.

Identifiant	header_content_row
Type	booléen
Chargement	oui
Téléchargement	non
Par défaut	false
Description	Indique si la première ligne contient uniquement des informations d'en-tête et doit être ignorée.

Identifiant	enable_pluralization
Type	booléen
Chargement	oui
Téléchargement	non
Par défaut	vrai
Description	active la détection des clés pluralisées. Toutes les clés correspondantes persisteront sous forme de clés pluralisées.

Identifiant	exporter des balises
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Exporte les tags avec les clés et les traductions.

Identifiant	exporter max_characters_allowed
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Exporte la limite de caractères de la clé avec les clés et les traductions.

Identifiant	custom_metadata_columns
Type	hash
Chargement	oui
Téléchargement	Oui
Par défaut	[vide]
Description	HashMap de valeurs de métadonnées Personnalisées qui doivent être importées ou exportées : Clé = Nom de la propriété de métadonnées Personnalisées, tel que défini dans Phrase Strings. Valeur = Index de colonne (1, 2, 3, etc.) où la propriété se trouve dans le fichier importé/où la propriété doit se trouver dans le fichier exporté.

Exemple de code

boolean_key    "--- true
"
empty_string_translation    ""
key_with_description    Check it out! Cette clé a une description ! (Au moins dans certains formats),Ceci est l'incroyable description pour cette clé !
key_with_line-break    "This translations contains
a line-break."
nested.deeply.key    "Wow, this key is nested even deeper."
nested.clé    Cette clé est imbriquée dans un espace de noms.
null_translation    
pluralized_key.one    "Un seul chaton trouvé."
pluralized_key.other    "Wow, vous avez %s chatons !"
pluralized_key.zero    "Vous n'avez aucun chaton."
sample_collection    "---
- first item
- second item
- third item
"
simple_key    Juste une clé simple avec un message simple.
unverified_key    Cette traduction n'est pas encore vérifiée et demeure en attente. (Dans certains formats, nous exportons également ce statut)

Structure de fichier

Une structure de fichier .TXT typique :

1 (Colonne clé)    2 (Colonne traduction)    3 (Colonne commenter)
app_title    Mon projet logiciel    Ceci est le titre principal
apples.zero    une pomme    mon commenter
...

Exemple de configuration

Un exemple pour la section push d'un .phrase.yml pour les fichiers .CSV :

push:
    sources:
        - file: "./multi.txt"
          params:
              update_translations: true
              locale_mapping:
                  en: 2
                  de: 3
              format_options:
                  comment_index: 4
                  tag_column: 5

Formes plurielles

Ce format utilise des catégories nommées pour identifier les différentes pluralisations d'une clé. Les catégories suivantes sont réservées aux formes plurielles :

.zéro | .un | .deux | .quelques | .beaucoup | .autre

Exemples de noms de clés pluralisées correctement identifiées, persistantes et marquées :

inbox.messages.notification.one
inbox.messages.notification.other

Les fichiers doivent suivre cette structure :

1 (Colonne clé)    2 (Colonne traduction)    3 (Colonne commenter)
messages.zero    Aucun message reçu,
messages.one    Un message reçu,
messages.other    %s messages reçus,