.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 téléchargement et/ou de l'importation d'un fichier. Selon la méthode de téléchargement/importation (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

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'importation, assurez-vous que les fichiers CSV ont trois champs pour une seule ligne représentant le contenu source, la traduction et les commentaires (facultatif).

Le paramètre paramètre linguistique (de type hashmap) est requis pour spécifier quelle colonne dans le document correspond à chaque paramètre linguistique. Pour des exemples, voir le exemple de fichier de configuration et la documentation API pour les téléchargements.

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és. 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 de 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 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	,
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 citer les nouvelles lignes et le 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 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'ID 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 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ées, tel que défini dans les chaînes de phrases. 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é.

Identifiant	export_key_id
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	key_id_column
Type	integer
Chargement	non
Télécharger	Oui
Par défaut	[vide]
Description	Index de la colonne contenant l'ID 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 ! (Du moins dans certains formats), c'est la description incroyable 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 .phrase.yml pour des 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,