verbatra tmx

Mete o saca una memoria de traducción en TMX, el formato de intercambio de las principales plataformas de traducción. tmx import lleva la memoria de otra herramienta a la memoria de traducción de este proyecto, para que las siguientes ejecuciones reutilicen esas cadenas en lugar de volver a pagarlas; tmx export vuelve a escribir la memoria hacia fuera. Ninguna de las dos direcciones llama a un proveedor, lee una clave de API ni toca la red. Un import real también añade las entradas que falten a un .gitignore existente, consulta Entradas de .gitignore.

SinopsisCopiar enlace a esta sección

verbatra tmx <direction> [file] [flags]

• <direction>: import o export; cualquier otra cosa se rechaza con INVALID_DIRECTION.
• [file]: el archivo TMX que se lee o se escribe, por defecto verbatra-memory.tmx en la raíz del proyecto.

EjemplosCopiar enlace a esta sección

# traer la memoria de otra herramienta a este proyecto
verbatra tmx import legacy.tmx

# informar de lo que entraría, sin cambiar nada
verbatra tmx import legacy.tmx --dry-run

# dejar que gane el archivo donde contradice a la memoria
verbatra tmx import legacy.tmx --overwrite

# escribir la memoria en verbatra-memory.tmx
verbatra tmx export

# solo alemán, en una ruta elegida
verbatra tmx export out/memory.tmx --locales de

FlagsCopiar enlace a esta sección

También acepta los flags globales --cwd, --config y --json. Aquí la búsqueda de configuración y un [file] relativo que pases se resuelven desde --cwd, mientras que la memoria y el verbatra-memory.tmx por defecto se resuelven desde la raíz del proyecto.

ComportamientoCopiar enlace a esta sección

Qué tiene que cumplir una unidad importadaCopiar enlace a esta sección

Un archivo de otra herramienta es una entrada no fiable, y una unidad en la memoria puede reutilizarse sin que nadie vuelva a preguntar. Por eso cada traducción candidata pasa por la misma puerta de integridad que la salida de un proveedor, comprobada al entrar en la memoria:

• sus placeholders coinciden con los de su propio segmento de origen,
• sus etiquetas HTML o XML en línea coinciden con las del segmento de origen, así que una etiqueta inyectada como <img onerror> se rechaza,
• es un mensaje ICU válido para el adaptador del formato configurado,
• no ha degenerado en una salida desbocada,
• no está vacía donde el origen tiene texto.

Una unidad con el segmento de origen vacío no identifica ninguna cadena y también se rechaza. El marcado en línea (bpt, ept, ph, it) se aplana a su texto, de modo que la comprobación de placeholders detecta el marcado que llevaba algo importante; el texto de un elemento sub es un flujo aparte (un tooltip, un texto alternativo) y se omite. Las propiedades de un segmento, incluidas las x-origin y x-review que escribe un export de verbatra, se ignoran: la memoria no registra ningún origen.

Nada se descarta en silencio: cada rechazo, cada unidad inservible, cada unidad sin segmento en tu locale de origen, cada unidad aplanada y cada texto sub omitido se cuenta por motivo.

Cada unidad rechazada se lista además con su posición, su motivo y, cuando la comprobación puede nombrarlo, qué falla, por ejemplo unit 12: icu ({count} plural: missing arm "few" required by the target language).

Emparejar etiquetas de idiomaCopiar enlace a esta sección

Un archivo TMX escribe los idiomas como lo hacía la herramienta de su autor. La regla de emparejamiento nunca adivina:

1. Ambos lados pasan a minúsculas y los guiones bajos a guiones, así que pt_BR, pt-br y pt-BR son un solo locale. Una coincidencia exacta gana.
2. Si no, encaja un locale configurado que sea prefijo por subetiquetas de la etiqueta, primero el más largo (búsqueda de RFC 4647): con de y de-AT, de-AT-1996 va a de-AT y de-CH-1901 a de.
3. Una etiqueta más corta también alcanza un locale configurado que solo añade una región o una variante, nunca una escritura: de va a de-DE y pt a pt-BR, pero sr nunca a sr-Latn.
4. Etiquetas con distinta escritura o región nunca coinciden: zh-CN nunca se guarda como zh-TW, ni de-AT como de-CH.
5. Una etiqueta solo es ambigua cuando los locales que podría alcanzar no están en una misma cadena de prefijos, como pt con pt-BR y pt-AO configurados.

Cada segmento se resuelve en una sola pasada contra el locale de origen y todos los destinos configurados, también con --locales, así que un destino pt-BR en un proyecto con origen pt nunca se lee como el origen. Los segmentos de origen se ordenan igual que los de destino: una etiqueta exacta supera a una coincidencia por prefijo, valores iguales concuerdan, y segmentos del mismo rango con valores distintos (en-US "Color" y en-GB "Colour") hacen que se rechace la unidad. Una configuración cuyo origen y uno de sus destinos se normalizan a la misma etiqueta se rechaza entera.

Dos segmentos de destino que alcanzan el mismo locale nunca dejan ganar sin más al último: una etiqueta exacta supera a una coincidencia por prefijo, y dos segmentos del mismo rango con valores distintos no guardan nada para ese locale y cuentan la unidad como conflictiva. Las etiquetas sin coincidencia se cuentan por etiqueta, también los elementos tu fuera del primer body, y se informa de un srclang en la cabecera que no sea tu locale de origen.

Cuando el archivo y la memoria no coincidenCopiar enlace a esta sección

Gana la memoria del proyecto: una traducción importada distinta de una ya guardada se rechaza y se cuenta como conservada, salvo que pases --overwrite. Dentro de un archivo gana la primera unidad de cada origen y las repeticiones cuentan como duplicados, así que importar el mismo archivo dos veces no escribe nada la segunda.

Las unidades importadas se guardan bajo la huella de configuración actual del proyecto, así que se reutilizan justo mientras el proveedor, el modelo, el tono, los términos del glosario que verbatra enviaría y localeMap no cambien. Vuelve a importar el archivo después de cambiarlos. Un archivo de memoria escrito por un verbatra más nuevo se deja intacto; los recuentos se siguen informando, como en un dry run.

Unidades importadas y reutilización difusaCopiar enlace a esta sección

El texto de origen de una unidad aceptada entra en el índice contra el que la reutilización difusa puntúa las cadenas cambiadas, así que un origen importado distinto de una de tus cadenas puede servirse para ella. Esa reutilización sigue pasando la puerta de integridad contra tu entrada real y lleva la marca de revisión FUZZY_CACHE_REUSE. Un origen importado idéntico a una de tus cadenas pero con otro hash (tu entrada tiene una descripción o un significado que TMX no puede llevar) nunca se reutiliza. Una forma de plural se encuentra por su texto: la importación toma la marca de plural de tu archivo de origen, así que cart.items_one y cart.items_other se rellenan desde la memoria como cualquier otra clave. Quita fuzzyCache de tu configuración para permitir solo coincidencias exactas.

Qué escribe el exportCopiar enlace a esta sección

Un tu por cada cadena de origen distinta, con el segmento de origen y un segmento de destino por locale exportado, bajo una cabecera TMX 1.4b (srclang, creationtool, creationtoolversion, segtype, o-tmf). Solo se escriben las entradas bajo la huella de configuración actual; las guardadas bajo una configuración anterior de proveedor, modelo, tono o glosario se omiten y se cuentan como otherConfiguration, con una línea propia en el resumen. Las etiquetas de idioma salen en forma BCP 47 (en_US pasa a en-US), los caracteres que XML 1.0 no puede representar se eliminan y se cuentan, y una memoria vacía produce un archivo válido y vacío. Las entradas sin texto de origen guardado, heredadas de una caché antigua, se omiten y se cuentan. El resumen cuenta elementos tu en el total y segmentos de destino por locale, así que los recuentos por locale suman más que el total cuando una cadena está traducida a varios locales.

Cada segmento de destino lleva <prop type="x-origin"> (machine, human, import o unknown) tomado de verbatra.provenance.json, y un segmento machine también <prop type="x-review"> (approved, unreviewed o rejected). Si no se puede leer el archivo de procedencia o el lock, no se escribe ninguna propiedad y el resultado indica provenanceMarkers: "unavailable". Consulta Evidencia de traducción automática.

El archivo solo se escribe dentro de la raíz del proyecto. Una ruta que no nombra ningún archivo, sale de la raíz del proyecto o apunta a un archivo del que depende el proyecto (un archivo de locale, el lock, el archivo de procedencia o de caché, un archivo de configuración, el archivo de glosario) se rechaza con TMX_OUTPUT_CONFLICT antes de leer la memoria, también tras resolver los enlaces simbólicos. Si la escritura falla en disco, la ejecución se detiene con TMX_UNWRITABLE, nombrando el archivo y el código del sistema de archivos.

Salida JSONCopiar enlace a esta sección

Esquema: tmx-envelope.json valida el envoltorio completo; Esquemas enumera los demás.

Con --json, el envoltorio JSON lleva el resultado del import o del export:

// tmx import
{ dryRun: boolean; file: string; units: number; locales: ImportTmxLocaleResult[];
  unmatchedLanguages: TmxLanguageReport[]; ambiguousLanguages: TmxLanguageReport[];
  memoryWritable: boolean; /* plus the skipped, unmatched and conflicting unit counts */ }

// tmx export
{ path: string; units: number; locales: { locale: string; units: number }[];
  withoutSource: number; otherConfiguration?: number; illegalCharactersRemoved: number;
  provenanceMarkers: "written" | "unavailable" }

Cada locale del import informa de los recuentos added, unchanged, overwritten, kept, duplicates, conflicting, rejected por motivo y de la lista refusals.

Información en el terminalCopiar enlace a esta sección

Ambas direcciones muestran una línea de progreso en stderr. tmx import sugiere después verbatra translate, o el import real tras un dry run; esa sugerencia conserva el archivo, --overwrite, --locales, --cwd y --config. tmx export no sugiere nada:

verbatra: importing legacy.tmx into the memory... done (0.2s)
next: verbatra translate (reuses the imported memory before calling a provider)

--quiet elimina estas líneas. Consulta Salida en el terminal.

Códigos de salidaCopiar enlace a esta sección

Con un archivo no válido, el mensaje nombra la línea, la columna y la unidad donde falló; las declaraciones de entidades y los subconjuntos DTD internos se rechazan sin más, y un doctype externo se descarta, nunca se descarga. Consulta el contrato de códigos de salida.

RelacionadoCopiar enlace a esta sección

• La caché explica la memoria de traducción y cómo se indexa.
• Traducción manual cubre la entrega de cadenas pendientes a una persona en xlsx, CSV y TSV.
• Seguridad de la traducción explica las comprobaciones que pasa una unidad importada.
• tmxErrorLocation lee desde el SDK el lugar de un error de TMX.