Extensiones de archivo |
.xlsx |
Extensión API |
xlsx |
Importación |
Sí |
Exportación |
Sí |
Compatibilidad con formularios plurales |
Sí |
Compatibilidad con descripción |
Sí |
Opciones de formato |
key_name_column comment_column tag_column first_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns |
.XLSX es un formato de archivo muy utilizado para la localización. Aunque el diseño de un archivo .XLSX puede diferir en función de configuraciones específicas, generalmente se sigue la convención de una columna por idioma. Para traducir .XLSX, proporciona al menos la columna de nombre clave y una columna de traducción. De forma predeterminada, se supone que el contenido comienza en la primera fila. Junto con las claves y la traducción, se puede importar metainformación como comentarios, tags y los caracteres máximos permitidos para las traducciones.
Se requiere el parámetro de localización
(de tipo hashmap) para especificar qué columna del documento corresponde a cada localización. Por ejemplo, consulte el ejemplo del archivo y la documentación API para uploads.
Opciones de formato
Identificador |
key_name_column |
Tipo |
cadena |
Carga |
Sí |
Descarga |
No |
Por defecto |
[vacuy] |
Descripción |
Columna que contiene el nombre/identificación clave. |
Identificador |
comment_column |
Tipo |
cadena |
Carga |
Sí |
Descarga |
No |
Por defecto |
[vacuy] |
Descripción |
Columna que contiene comentar para una clave. |
Identificador |
tag_column |
Tipo |
cadena |
Carga |
Sí |
Descarga |
No |
Por defecto |
[vacuy] |
Descripción |
Índice de la columna que contiene una etiqueta para la clave. |
Identificador |
first_content_row |
Tipo |
número entero |
Carga |
Sí |
Descarga |
No |
Por defecto |
1 |
Descripción |
Índice de la primera fila para contener contenido traducido. |
Identificador |
enable_pluralization |
Tipo |
Booleano |
Carga |
Sí |
Descarga |
No |
Por defecto |
true |
Descripción |
Permite la detección de claves pluralizadas. Todas las claves coincidentes persisten como claves pluralizadas. |
Identificador |
export_tags |
Tipo |
Booleano |
Carga |
No |
Descarga |
Sí |
Por defecto |
false |
Descripción |
Exporta tags junto con claves y traducciones. |
Identificador |
export_max_characters_allowed |
Tipo |
Booleano |
Carga |
No |
Descarga |
Sí |
Por defecto |
false |
Descripción |
Exporta el límite de caracteres clave junto con claves y traducciones. |
Identificador |
custom_metadata_columns |
Tipo |
hash |
Carga |
Sí |
Descarga |
Sí |
Por defecto |
[vacuy] |
Descripción |
Un hashmap de valores de metadatos personalizados que necesitan importarse o exportarse:
|
Ejemplo de estructura
key_name |
en_US |
de-DE* |
comentar* |
tags* |
max_characters* |
---|---|---|---|---|---|
app_title |
Mi proyecto |
Mein Projekt |
Este es el título principal |
app, título |
30 |
saludo |
Hola 'usuario'! |
¡Hola, 'usuario'! |
Sé educado |
* columnas opcionales
El archivo de hoja de cálculo necesita al menos la columna de clave y un idioma orden poder cargarse. Aparte de agregar idiomas adicionales, se pueden agregar las siguientes columnas para agregar metainformación:
-
comentario: agregar una descripción a la clave
-
tags: agregar tags a claves individuales en el archivo
-
max_caracters: para establecer un límite de caracteres para una clave al cargar
Ejemplo de configuración
Un ejemplo para la sección push en un .phraseapp.yml para archivos XLSX.
push: sources: - archivo: "./es.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