.XLSX - Spreadsheet Excel (Strings)

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

Extensions de fichiers	.xlsx
Extension d'API	xlsx
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'upload d'un fichier. Selon la méthode d'upload/téléchargement (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_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns translation_columns

.XLSX est un format de fichier largement utilisé pour la localisation. Bien que la mise en page d'un fichier .XLSX puisse différer en fonction des paramètres spécifiques, elle suit généralement la convention d'une colonne par langue. Pour traduire .XLSX, fournissez au moins la colonne du nom de clé et une colonne de traduction. Par défaut, le contenu est supposé commencer dans la première ligne. Avec les clés et la traduction, des méta-informations comme des commentaires, des balises et le nombre maximum de caractères autorisés pour les traductions peuvent être importées.

Si un fichier est téléchargé avec plusieurs feuilles ou onglets, seule la première feuille sera détectée. Enregistrez les feuilles ou onglets dans des fichiers individuels si le contenu est requis pour la localisation.

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 l'exemple de fichier de configuration et la documentation API pour les uploads.

Options de format

Identifiant	key_name_column
Type	chaîne
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Colonne contenant le nom/identification de la clé.

Identifiant	comment_column
Type	chaîne
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Colonne contenant le commentaire/la description d'une clé.

Identifiant	tag_column
Type	chaîne
Chargement	oui
Téléchargement	non
Par défaut	[vide]
Description	Index de la colonne contenant une balise pour la clé.

Identifiant	first_content_row
Type	integer
Chargement	oui
Téléchargement	non
Par défaut	1
Description	Index de la première ligne contenant le contenu de traduction.

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 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	Une hashmap de métadonnées personnalisées valeurs 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 Phrase. Valeur = Identifiant de colonne (A, B, C, etc.) où la propriété se trouve dans le fichier importé/où la propriété doit se trouver dans le fichier exporté.

Identifiant	translation_columns
Type	hash
Chargement	oui
Téléchargement	Oui
Par défaut	[vide]
Description	Identifiant/Nom de langue = Colonne de la propriété de métadonnées personnalisées, tel que défini dans les chaînes Phrase. Valeur = Identifiant de colonne (A, B, C, etc.) où la propriété se trouve dans le fichier importé/où la propriété doit se trouver dans le fichier exporté.

Exemple de structure

key_name	en_US	de-DE*	commentaire*	tags*	max_characters*
app_title	Mon Projet	Mon projet	Ceci est le titre principal	app, titre	30
salutation	Salut 'Utilisateur' !	Bonjour 'Utilisateur' !	Soyez poli

*colonnes optionnelles

Le fichier de feuille de calcul a besoin d'au moins la colonne clé et d'une langue pour être téléchargé. En plus des langues supplémentaires, les colonnes suivantes peuvent être ajoutées pour ajouter des informations méta :

comment: pour ajouter une description à la clé
tags: pour ajouter des tags aux clés individuelles dans le fichier
max_characters: pour définir une limite de caractères pour une clé lors du chargement

Exemple de configuration

Un exemple pour la section push dans un .phraseapp.yml pour les fichiers XLSX.

push:
    sources:
        - fichier : "./en.xlsx"
          params:
              file_format: xlsx
              update_translations: true
              format_options:
                  key_name_column: A
                  comment_column: C
                  first_content_row: 2
                  tag_column: D
              locale_mapping:
                  en: o