.TXT (Strings)

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

Extensiones de archivo	.txt, .tsv
Extensión API	.txt, .tsv
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 repositorio, etc.), se pueden especificar en los parámetros de consulta `Carga`, `Descarga` 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

TXT almacena información de texto sin formato sin ninguna opción de formato incrustada como negrita, cursiva o imágenes.

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, mira el ejemplo de archivo de configuración y la documentación de la API para las 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 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 el 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	\t
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 entrecomillar saltos de línea y el 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 que coincidan se guardará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 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	HashMap de valores de Personalizar metadatos que deben importarse o exportarse: clave = Nombre de la propiedad de metadatos personalizados, 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 exportado.

Ejemplo de código

boolean_key    "--- true
"
empty_string_translation    ""
key_with_description    ¡Échale un vistazo! This key has a description! (Al menos en algunos formatos), ¡Esta es la increíble descripción para esta clave!
key_with_line-break    "Esta traducción contiene un salto de línea."
a line-break."
nested.deeply.key    "Guau, 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    "¡Guau, tienes %s gatitos!"
pluralized_key.zero    "No tienes gatitos."
sample_collection    "---
- first item
- second item
- third item
"
simple_key    Solo una clave simple con un mensaje simple.
unverified_key    Esta traducción aún no ha sido verificada y está pendiente. (En algunos formatos también se exporta este estado)

Estructura de archivo

Una estructura de archivo .TXT típica:

1 (Columna de clave)    2 (Columna de traducción)    3 (Columna de comentarios)
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 push de un .Phrase.yml para archivos .CSV:

push:
    sources:
        - archivo: "./multi.txt"
          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 comentarios)
messages.zero    No se han recibido mensajes,
messages.one    Un mensaje recibido,
messages.other    %s mensajes recibidos,