.xlsx - Hoja de cálculo de 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 Descargar un archivo. Dependiendo del método de cargar/Descargar (API, CLI, sincronización de repositorio, etc.), se pueden especificar en los 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 muy utilizado para la localización. Aunque el diseño de un archivo .xlsx puede diferir según la configuración específica, generalmente sigue la convención de una columna por idioma. Para traducir .xlsx, proporcione al menos la columna de nombre de clave y una columna de traducción. De forma predeterminada, se asume que el contenido comienza en la primera fila. Junto con las claves y la traducción, se puede importar meta-información como comentar, etiquetas y el máximo carácter permitido para las traducciones.

Si se carga un archivo con varias hojas o pestañas, solo se detectará la primera hoja. guardar las hojas o pestañas en archivos individuales si el contenido es necesario 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 ver ejemplos, consulte el ejemplo del archivo de configuración y la documentación de la API para las 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 comentar/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 carácter 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 mapa hash de valores de Personalizar metadatos que deben importarse o exportarse: clave = Nombre de la propiedad de metadatos Personalizar, tal como se define 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	idioma ID/Nombre = Columna de la propiedad de metadatos Personalizar, tal como se define 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*	comentario*	Etiquetas*	max_characters*
app_title	Mi Proyecto	Mein Projekt	Este es el título principal	app, title	30
greeting	¡Hola 'usuario'!	Hallo 'User'!	Sea educado

*columnas opcionales

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

comentar: para agregar una descripción a la clave
etiquetas: para agregar etiquetas a claves individuales en el archivo
max_caracteres: para establecer un límite de carácter para una clave a través de la cargar

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:
                  en: B