.CSV (Strings)

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

Extensions de fichiers	.csv
Extension d'API	csv
Import	oui
Export	oui
Prise en charge des formes plurielles	oui
Prise en charge de la description	oui
Options de format	key_index comment_index tag_column max_characters_allowed_column column_separator quote_char header_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns export_key_id key_id_column

CSV (valeurs séparées par des virgules) est un format de fichier populaire utilisé principalement pour le transfert de données dans diverses applications et programmes. Dans un fichier CSV, chaque ligne est un enregistrement de données. Chaque enregistrement est composé de quelques champs séparés par des virgules. Avant importer, assurez-vous que les fichiers CSV ont trois champs pour une seule ligne représentant contenu source, traduction et commentaires (facultatif).

Le paramètre régionaux_mapping (de type hashmap) est requis pour spécifier quelle colonne du document correspond à chaque paramètre régional. Voir par exemple l'exemple de fichier de configuration et la documentation API pour uploads.

Options de format

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

Identifiant	comment_index
Type	nombre entier
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Index de la colonne contenant la description pour la clé . Les index des colonnes commencent à 1.

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

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

Identifiant	column_separator
Type	chaîne
Chargement	oui
Téléchargement	non
Par défaut	,
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 qui est utilisé pour devis sauts de ligne et séparateur de colonnes.

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	export_tags
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Exporte tags ainsi que clés et traductions.

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

Identifiant	custom_metadata_columns
Type	dièse
Chargement	oui
Téléchargement	Oui
Par défaut	[vide]
Description	Carte des 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ée, telle que définie dans Phrase Strings . Valeur = Indice de colonne (1, 2, 3, etc.) où la propriété se trouve dans le fichier importé/où la propriété devrait se trouver dans le fichier exporté.

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

Identifiant	key_id_column
Type	nombre entier
Chargement	non
Télécharger	Oui
Par défaut	[vide]
Description	Index de la colonne contenant l'Identifiant de la clé Les index des colonnes commencent à 1.

Exemple de code

boolean_key,"--- true
"
empty_string_translation,""
key_with_description, regardez ça ! Cette clé a une description ! (Au moins dans certains formats),Voici la description étonnante pour cette clé !
key_with_line-break,"Cette traduction contient
un saut de ligne."
imbriqué.deeply.key,"Ouah, cette clé est imbriquée encore plus profondément."
nested.key,Cette clé est imbriquée à l'intérieur d'un espace de noms.
null_translation,
pluralized_key.one, "Only one kitten found."
pluralized_key.other,"Ouah, vous avez %s chatons !"
pluralized_key.zero,"Vous n'avez pas de chatons."
sample_collection,"---
— premier élément
— deuxième élément
- troisième élément
"
simple_key,Juste une clé simple avec un message simple.
unified_key,Cette traduction n'a pas encore été vérifiée, elle est en attente. (Dans certains formats, nous exportons également ce statut)

Structure du fichier

Une structure de fichier .CSV type :

1 (colonne clé), 2 (colonne traduction), 3 (colonne commenter)
app_title, Mon projet logiciel, Il s'agit du 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:
        - fichier : "./multi.csv"
          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,