|
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 lorsqu'un fichier est chargé et/ou Télécharger. 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 |
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 disposition d'un fichier .XLSX puisse différer en fonction de 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 la clé et une colonne de traduction. Par défaut, le contenu est supposé commencer à la première ligne. En plus des clés et de la traduction, des méta-informations comme les commenter, les balises et le nombre maximum de caractère autorisés pour les traductions peuvent être importés.
Si un fichier est chargé avec plusieurs feuilles ou onglets, seule la première feuille sera détectée. Enregistrer les feuilles ou les 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 du document correspond à chaque paramètre linguistique. Pour des exemples, consultez l'exemple de fichier de configuration et la documentation API pour les charger.
Options de format
|
Identifiant |
key_name_column |
|
Type |
chaîne |
|
Chargement |
oui |
|
Téléchargement |
non |
|
Par défaut |
[vide] |
|
Description |
Colonne qui contient le nom/l'identification de la clé. |
|
Identifiant |
comment_column |
|
Type |
chaîne |
|
Chargement |
oui |
|
Téléchargement |
non |
|
Par défaut |
[vide] |
|
Description |
Colonne qui contient le commenter/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ère 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 valeurs de métadonnées Personnalisé qui doivent être importées ou exportées :
|
|
Identifiant |
translation_columns |
|
Type |
hash |
|
Chargement |
oui |
|
Téléchargement |
Oui |
|
Par défaut |
[vide] |
|
Description |
|
Exemple de structure
|
key_name |
en-US |
de-DE* |
commentaire* |
tags* |
max_characters* |
|---|---|---|---|---|---|
|
app_title |
Mon Projet |
Mein Projekt |
Ceci est le titre principal |
app, title |
30 |
|
greeting |
Hi 'User'! |
Hallo 'User'! |
Soyez poli |
*colonnes facultatives
Le fichier de feuille de calcul nécessite au moins la colonne clé et une langue pour être téléchargé. Outre les langues supplémentaires, les colonnes suivantes peuvent être ajoutées pour ajouter des méta-informations :
-
commentaire : pour ajouter une description à la clé
-
balises : pour ajouter des balises à des clés individuelles dans le fichier
-
max_caractères : pour définir une limite de caractère pour une clé lors du charger
Exemple de configuration
Un exemple pour la section push dans un fichier .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