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 |
key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns |
Le format .XLSX est un format de fichier très 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 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, les méta-informations telles que commentaires, tags et le maximum de caractères autorisés pour les traductions peuvent être importés.
Le paramètre régionaux_mapping
(de type hashmap) est requis pour spécifier quelle colonne du document correspond à chaque paramètre régional. Voir par exemple l'exemple de fichier de configuration et la documentation API pour uploads.
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 commente/description pour 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 |
nombre entier |
Chargement |
oui |
Téléchargement |
non |
Par défaut |
1 |
Description |
Index de la première ligne pour contenir le contenu 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 tags ainsi que clés et 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 les traductions. |
Identifiant |
custom_metadata_columns |
Type |
dièse |
Chargement |
oui |
Téléchargement |
Oui |
Par défaut |
[vide] |
Description |
Une carte de hachage des valeurs de métadonnées personnalisées qui doivent être importées ou exportées :
|
Exemple de structure
key_name |
en_US |
de-DE* |
commenter* |
tags* |
max_characters* |
---|---|---|---|---|---|
app_title |
Mon projet |
Mein Projekt |
Ceci est le titre principal |
application, titre |
30 |
salutation |
Salut « Utilisateur » ! |
Hallo « Utilisateur » ! |
Sois poli |
*colonnes facultatives
Le fichier de tableur a besoin au minimum de la colonne clé et d'une langue pour commande d'être téléversé. En dehors des langues ajoutées, les colonnes suivantes peuvent être ajoutées pour ajouter des méta-informations :
-
commenter : pour ajouter une description à la clé
-
tags : pour ajouter tags aux clés individuelles du fichier
-
max_caractères : pour définir une limite de caractères pour une clé via le charger
Exemple de configuration
Un exemple pour la section push dans un .phraseapp.yml pour les fichiers XLSX.
push: sources: - fichier : "./fr.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