.CSV (Strings)

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

Extensiones de archivo	.csv
Extensión API	csv
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 parámetros de consulta `cargar`, `Descargar` o en el archivo de configuración `phrase.yml`.	key_index comment_index tag_column max_characters_allowed_column column_separator quote_char header_content_row enable_pluralization export_tags export_max_characters_allowed custom_metadata_columns export_key_id key_id_column

CSV (valores separados por comas) es un formato de archivo popular utilizado principalmente para la transferencia de datos en diversas aplicaciones y programas. En un archivo CSV, cada línea es un registro de datos. Cada registro consta de algunos campos separados por comas. Antes de importar, asegúrese de que los archivos CSV tengan tres campos para una sola línea que represente contenido fuente, traducción y comentarios (opcional).

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 de archivo de configuración y la documentación de la API para cargas.

Opciones de formato

Identificador	key_index
Tipo	integer
Carga	Sí
Descarga	No
Por defecto	[vacío]
Descripción	Índice de la columna que contiene los nombres de clave. Los índices de columna comienzan en 1.

Identificador	comment_index
Tipo	integer
Carga	Sí
Descarga	No
Por defecto	[vacío]
Descripción	Índice de la columna que contiene la descripción para la clave. Los índices de columna comienzan en 1.

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

Identificador	max_characters_allowed_column
Tipo	integer
Carga	Sí
Descarga	No
Por defecto	[vacío]
Descripción	Índice de la columna que contiene un número máximo de caracteres para la clave. Los índices de columna comienzan en 1.

Identificador	column_separator
Tipo	cadena
Carga	Sí
Descarga	No
Por defecto	,
Descripción	Carácter que se utiliza para separar columnas.

Identificador	quote_char
Tipo	cadena
Carga	Sí
Descarga	No
Por defecto	"
Descripción	Carácter que se utiliza para cotización de saltos de línea y separador de columnas.

Identificador	header_content_row
Tipo	Booleano
Carga	Sí
Descarga	No
Por defecto	false
Descripción	Indica si la primera fila contiene solo información de encabezado y debe omitirse.

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

Identificador	custom_metadata_columns
Tipo	hash
Carga	Sí
Descarga	Sí
Por defecto	[vacío]
Descripción	HashMap de valores de metadatos Personalizar que deben importarse o exportarse: clave = Nombre de la propiedad de metadatos Personalizar, tal como se define en Phrase Strings. Valor = Índice de columna (1, 2, 3, etc.) donde se encuentra la propiedad en el archivo importado/donde debería estar la propiedad en el archivo exportar.

Identificador	export_key_id
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Exportar el límite de carácter de la clave junto con las claves y las traducciones.

Identificador	key_id_column
Tipo	integer
Carga	No
Descarga	Sí
Por defecto	[vacío]
Descripción	Índice de la columna que contiene el ID para la clave. Los índices de columna comienzan en 1.

Ejemplo de código

boolean_key,"--- true
"
empty_string_translation,""
key_with_description,Check it out! This key has a description! (Al menos en algunos formatos), ¡Esta es la increíble descripción para esta clave!
key_with_line-break,"This translations contains
a line-break."
nested.deeply.key,"Wow, this key is nested even deeper."
nested.key,This key is nested inside a namespace.
null_translation,
pluralized_key.one, "Only one kitten found."
pluralized_key.other,"Wow, you have %s kittens!"
pluralized_key.zero,"You have no kittens."
sample_collection,"---
- first item
- second item
- third item
"
simple_key,Just a simple key with a simple message.
unverified_key,This translation is not yet verified and waits for it. (In some formats we also export this status)

Estructura del archivo

Una estructura típica de archivo .CSV:

1 (Key column), 2 (Translation column), 3 (Comment column)
app_title,      My Software Project,    This is the main title
apples.zero,    one apple,              my comment
...

Ejemplo de configuración

Un ejemplo para la sección push de un archivo .phrase.yml para archivos .CSV:

push:
    sources:
        - file: "./multi.csv"
          params:
              update_translations: true
              locale_mapping:
                  en: 2
                  de: 3
              format_options:
                  comment_index: 4
                  tag_column: 5

Formularios plurales

Este formato utiliza categorías nombradas para identificar las diferentes pluralizaciones de una clave. Las siguientes categorías están reservadas para las formas plurales:

.zero | .one | .two | .few | .many | .other

Nombres de ejemplo para claves pluralizadas correctamente identificadas, persistentes y marcadas:

inbox.messages.notification.one
inbox.messages.notification.other

Los archivos deben seguir esta estructura:

1 (Key column), 2 (Translation column), 3 (Comment column)
messages.zero,  No messages received,
messages.one,   One message received,
messages.other,  %s messages received,