.CSV (Cadenas)

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

Extensiones de archivo	.csv
Extensión API	csv
Importar	Sí
Exportar	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 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 el contenido de origen, la traducción y los comentarios (opcional).

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

Opciones de formato

Identificador	key_index
Tipo	entero
Cargar	Sí
Descargar	No
Por defecto	[vacío]
Descripción	Índice de la columna que contiene los nombres de las claves. Los índices de columna comienzan en 1.

Identificador	comment_index
Tipo	entero
Cargar	Sí
Descargar	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	entero
Cargar	Sí
Descargar	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	entero
Cargar	Sí
Descargar	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
Cargar	Sí
Descargar	No
Por defecto	,
Descripción	Carácter que se utiliza para separar columnas.

Identificador	quote_char
Tipo	cadena
Cargar	Sí
Descargar	No
Por defecto	"
Descripción	Carácter que se utiliza para citar saltos de línea y separadores de columna.

Identificador	header_content_row
Tipo	booleano
Cargar	Sí
Descargar	No
Por defecto	falso
Descripción	Indica si la primera fila contiene solo información de encabezado y debe ser omitida.

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

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

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

Identificador	custom_metadata_columns
Tipo	hash
Cargar	Sí
Descargar	Sí
Por defecto	[vacío]
Descripción	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 = Í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 exportado.

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

Identificador	key_id_column
Tipo	entero
Cargar	No
Descargar	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,¡Échale un vistazo! ¡Esta clave tiene una descripción! (Al menos en algunos formatos), ¡Esta es la increíble descripción para esta clave!
key_with_line-break,"Esta traducción contiene
una ruptura de línea."
nested.deeply.key,"Wow, esta clave está anidada aún más profundamente."
nested.key,Esta clave está anidada dentro de un espacio de nombres.
null_translation,
pluralized_key.one, "Solo se encontró un gatito."
pluralized_key.other,"¡Vaya, tienes %s gatitos!"
pluralized_key.zero,"No tienes gatitos."
sample_collection,"---
- primer elemento
- segundo elemento
- tercer elemento
"
simple_key,Una clave simple con un mensaje simple.
unverified_key,Esta traducción aún no está verificada y espera por ello. (En algunos formatos también exportamos este estado)

Estructura de archivo

Una estructura típica de archivo .CSV:

1 (Columna de clave), 2 (Columna de traducción), 3 (Columna de comentario)
app_title,      Mi Proyecto de Software,    Este es el título principal
apples.zero,    una manzana,              mi comentario
...

Ejemplo de configuración

Un ejemplo para la sección de push de un .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 (Columna de clave), 2 (Columna de traducción), 3 (Columna de comentario)
messages.zero,  No se han recibido mensajes,
messages.one,   Se ha recibido un mensaje,
messages.other,  %s mensajes recibidos,