.XLSX - Hoja de cálculo de Excel (Cadenas)

El contenido se traduce automáticamente del inglés por Phrase Language AI.

Extensiones de archivo	.xlsx
Extensión API	xlsx
Importar	Sí
Exportación	Sí
Compatibilidad con formularios plurales	Sí
Compatibilidad con descripción	Sí
Opciones de formato Estas opciones que se pueden especificar cuando se carga y/o descarga un archivo. Dependiendo del método de carga/descarga (API, CLI, sincronización de repositorios, etc.), se pueden especificar en parámetros de consulta `Cargar`, `Descargar` o en el archivo de configuración `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 es un formato de archivo ampliamente utilizado para la localización. Aunque el diseño de un archivo .XLSX puede diferir según configuraciones específicas, generalmente sigue la convención de una columna por idioma. Para traducir .XLSX, proporciona al menos la columna del nombre de la clave y una columna de traducción. Por defecto, se asume que el contenido comienza en la primera fila. Junto con las claves y la traducción, se puede importar información meta como comentarios, etiquetas y el número máximo de caracteres permitidos para las traducciones.

Si se carga un archivo con múltiples hojas o pestañas, solo se detectará la primera hoja. Guardar hojas o pestañas en archivos individuales si el contenido es necesario para la localización

El parámetro locale_mapping (de tipo hashmap) es necesario para especificar qué columna en el documento corresponde a cada localización. Para ejemplos, consulte el archivo de configuración de ejemplo y la documentación de la API para cargas.

Opciones de formato

Identificador	key_name_column
Tipo	cadena
Cargar	Sí
Descargar	No
Por defecto	[vacío]
Descripción	Columna que contiene el nombre/identificación de la clave.

Identificador	comment_column
Tipo	cadena
Cargar	Sí
Descargar	No
Por defecto	[vacío]
Descripción	Columna que contiene el comentario/descripción de una clave.

Identificador	tag_column
Tipo	cadena
Cargar	Sí
Descargar	No
Por defecto	[vacío]
Descripción	Índice de la columna que contiene una etiqueta para la clave.

Identificador	first_content_row
Tipo	entero
Cargar	Sí
Descargar	No
Por defecto	1
Descripción	Índice de la primera fila que contiene el contenido de la traducción.

Identificador	enable_pluralization
Tipo	booleano
Cargar	Sí
Descargar	No
Por defecto	verdadero
Descripción	Permite la detección de claves pluralizadas. Todas las claves coincidentes persisten como claves pluralizadas.

Identificador	export_tags
Tipo	booleano
Cargar	No
Descargar	Sí
Por defecto	false
Descripción	Exporta etiquetas junto con claves y traducciones.

Identificador	export_max_characters_allowed
Tipo	booleano
Cargar	No
Descargar	Sí
Por defecto	false
Descripción	Exporta el límite de caracteres de la clave junto con claves y traducciones.

Identificador	custom_metadata_columns
Tipo	hash
Cargar	Sí
Descargar	Sí
Por defecto	[vacío]
Descripción	Un hashmap de metadatos personalizados valores que necesitan ser importados o exportados: Clave = Nombre de la propiedad de metadatos personalizados, según se define en Phrase Strings. Valor = Identificador de columna (A, B, C, etc.) donde la propiedad está en el archivo importado/donde la propiedad debería estar en el archivo exportado.

Identificador	translation_columns
Tipo	hash
Cargar	Sí
Descargar	Sí
Por defecto	[vacío]
Descripción	ID/Nombre del idioma = Columna de la propiedad de metadatos personalizados, según se define en Phrase Strings. Valor = Identificador de columna (A, B, C, etc.) donde la propiedad está en el archivo importado/donde la propiedad debería estar en el archivo exportado.

Ejemplo de estructura

key_name	en_US	de-DE*	comentario*	etiquetas*	max_characters*
app_title	Mi Proyecto	Mein Projekt	Este es el título principal	app, título	30
saludo	¡Hola 'usuario'!	¡Hola 'Usuario'!	Sea cortés

*columnas opcionales

El archivo de hoja de cálculo necesita al menos la columna clave y un idioma para ser cargado. Además de los idiomas adicionales, se pueden agregar las siguientes columnas para añadir información meta:

comentar: para añadir una descripción a la clave
etiquetas: para añadir etiquetas a claves individuales en el archivo
max_caracteres: para establecer un límite de caracteres para una clave a través de la carga

Ejemplo de configuración

Un ejemplo para la sección push en un .phraseapp.yml para archivos 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:
                  es: B