.XLSX - Feuille de calcul Excel (Chaînes)

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

Extensions de fichiers	.xlsx
API Extension	xlsx
Import	Oui
Exporter	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 chargement et/ou du téléchargement d'un fichier. Selon la méthode de chargement/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 à la première ligne. Avec les clés et la traduction, des méta-informations telles que des commentaires, des balises et le nombre maximum de caractères autorisés pour les traductions peuvent être importées.

Si un fichier est 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 locale_mapping (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 de l'API pour les chargements.

Options de format

Identifiant	key_name_column
Type	chaîne
Charger	Oui
Télécharger	non
Par défaut	[empty]
Description	Colonne contenant le nom/l'identification de la clé.

Identifiant	comment_column
Type	chaîne
Charger	Oui
Télécharger	non
Par défaut	[empty]
Description	Colonne contenant le commentaire/la description d'une clé.

Identifiant	tag_column
Type	chaîne
Charger	Oui
Télécharger	non
Par défaut	[empty]
Description	Index de la colonne contenant une balise pour la clé.

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

Identifiant	enable_pluralization
Type	booléen
Charger	Oui
Télécharger	non
Par défaut	true
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 clé ainsi que les clés et traductions.

Identifiant	custom_metadata_columns
Type	hash
Charger	Oui
Télécharger	Oui
Par défaut	[empty]
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é devrait se trouver dans le fichier exporté.

Identifiant	translation_columns
Type	hash
Charger	Oui
Télécharger	Oui
Par défaut	[empty]
Description	Identifiant/Nom de la 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é devrait se trouver dans le fichier exporté.

Exemple de structure

key_name	en_US	de-DE*	comment*	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 nécessite au moins la colonne clé et 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 balises aux clés individuelles dans le fichier
max_characters : pour définir une limite de caractères pour une clé lors du téléchargement

Exemple de configuration

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

push :
    sources :
        - file : "./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 : B