.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	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 varias aplicaciones y programas. En un archivo CSV, cada línea es un registro de datos. Cada registro consta de unos pocos campos separados por comas. Antes de importar, asegúrate de que los archivos CSV tengan tres campos para una sola línea que represente contenido fuente, traducción y comentarios (opcional).

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_index
Tipo	número entero
Carga	Sí
Descarga	No
Por defecto	[vacío]
Descripción	Índice de la columna que contiene los nombres clave. Los índices de columna comienzan en 1.

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

Identificador	tag_column
Tipo	número entero
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	número entero
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	Caracter que se utiliza para separar columnas.

Identificador	quote_char
Tipo	cadena
Carga	Sí
Descarga	No
Por defecto	"
Descripción	Caracter que se utiliza para cotización de nuevas líneas 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 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	[vacío]
Descripción	HashMap de valores de metadatos personalizados que necesitan importarse o exportarse: Clave = nombre de la propiedad de metadatos personalizada, según se define en Phrase Strings. Valor = índice de columna (1, 2, 3, etc.) donde la propiedad está en el archivo importado o donde la propiedad debe estar en el archivo exportado.

Identificador	export_key_id
Tipo	Booleano
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Exporta el límite de caracteres clave junto con claves y traducciones.

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

Ejemplo de código

"boolean_key": "--- true
"
empty_string_translation,""
key_with_description, ¡Compruébalo! This key has a description! (Al menos en algunos formatos), ¡Esta es la increíble descripción para esta clave!
key_with_line-break,"Estas traducciones contienen
un salto de línea".
nested.deeply.key,"Wow, this clave is nested even deep."
nested.key,Esta clave está anidada dentro de un espacio de nombres.
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,"---
- primer item
- segundo item
- tercer item
"
simple_key,Just a simple clave with a simple message.
unverified_key,Esta traducción aún no se ha verificado y la espera. (En algunos formatos también exportamos este estado)",

Estructura de archivos

Una estructura de archivo .CSV típica:

1 (columna clave), 2 (columna de traducción), 3 (columna comentar)
app_title, Mi proyecto software, Este es el título principal
apples.zero, one apple, mi comentar
...

Ejemplo de configuración

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

push:
    sources:
        - archivo: "./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 (columna clave), 2 (columna de traducción), 3 (columna comentar)
messages.zero, No messages received,
messages.one, Un mensaje recibido,
messages.other, %s mensajes recibidos,