.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 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_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 algunos campos separados por comas. Antes de importar, asegúrese de que los archivos CSV tengan tres campos para una sola línea que representen el contenido de origen, la traducción y los 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 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 las claves. 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 de 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 citar saltos de línea y separadores de columna.

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 ser omitida.

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 se persistirán 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 la 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 ser importados o exportados: Clave = Nombre de la propiedad de metadatos personalizada, según lo definido 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
Carga	No
Descarga	Sí
Por defecto	false
Descripción	Exporta el límite de caracteres de la clave junto con claves y 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. (En algunos formatos también exportamos este estado)

Estructura de 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 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 (Key column), 2 (Translation column), 3 (Comment column)
messages.zero,  No messages received,
messages.one,   One message received,
messages.other,  %s messages received,