.XLSX - Spreadsheet Excel (Strings)

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

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 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. Guarda hojas o pestañas en archivos individuales si se requiere el contenido para la localización.

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

Opciones de formato

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

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

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

Identificador	first_content_row
Tipo	integer
Carga	Sí
Descarga	No
Por defecto	1
Descripción	Índice de la primera fila que contiene contenido de traducción.

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 etiquetas 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 de la clave junto con claves y traducciones.

Identificador	custom_metadata_columns
Tipo	hash
Carga	Sí
Descarga	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 personalizada, según lo definido en Phrase Strings. Valor = Identificador de columna (A, B, C, etc.) donde se encuentra la propiedad en el archivo importado/donde debería estar la propiedad en el archivo exportado.

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

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'!	¡Hallo 'Usuario'!	Sé educado

*columnas opcionales

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

comentar: para agregar una descripción a la clave
tags: para agregar etiquetas a claves individuales en el archivo
max_characters: 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 de 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:
                  en: B