.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 Ces options peuvent être spécifiées lors du charger et/ou du Télécharger d'un fichier. 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 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

Le 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 se compose de quelques champs séparés par des virgules. Avant l'importer, assurez-vous que les fichiers CSV comportent trois champs pour une seule ligne représentant le contenu source, la traduction et les commentaires (facultatif).

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 l'exemple de fichier de configuration et la documentation de l'API 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
Type	integer
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Index de la colonne contenant la description pour la clé. Les index de colonne commencent à 1.

Identifiant	tag_column
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 maximal 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	,
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 le devis des sauts de ligne et du 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	export_tags
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Exporte les balises avec les clés et les traductions.

Identifiant	export_max_characters_allowed
Type	booléen
Charger	non
Télécharger	Oui
Par défaut	false
Description	Exporte l'Identifiant de 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ù se trouve la propriété dans le fichier importé/où la propriété doit 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ère de la clé avec les clés et les traductions.

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

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.key,This key is nested inside a namespace.
null_translation,
pluralized_key.one, "Only one kitten found."
pluralized_key.other,"Wow, you have %s kittens!"
pluralized_key.zero,"You have no kittens."
sample_collection,"---
- first item
- second item
- third item
"
simple_key,Just a simple key with a simple message.
unverified_key,This translation is not yet verified and waits for it. (Dans certains formats, nous exportons également ce statut)

Structure de fichier

Une structure de fichier .CSV typique :

1 (Key column), 2 (Translation column), 3 (Comment column)
app_title,      My Software Project,    This is the main title
apples.zero,    one apple,              my comment
...

Exemple de configuration

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

push:
    sources:
        - file: "./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 (Key column), 2 (Translation column), 3 (Comment column)
messages.zero,  No messages received,
messages.one,   One message received,
messages.other,  %s messages received,