Formatos de CLI v0

Adapta un analizador heredado ya instalado a la estructura de archivos por idioma y verifica el archivo nativo reconstruido.

Elige el contenedor según los datos que quieras extraer y los archivos que esperes obtener. V0 selecciona el analizador según el tipo de contenedor; la extensión no altera esa selección. Por eso, un catálogo JSON y un catálogo Xcode con varios idiomas necesitan configuraciones distintas, aunque ambos contengan mensajes.

Elige primero el modelo de salida #

La mayoría de los contenedores generan archivos separados por idioma con [locale] en la ruta. Los archivos CSV, los catálogos de cadenas de Xcode, los diccionarios JSON y los bloques de Vue i18n pueden contener varios idiomas en un mismo archivo. Si el archivo de salida es compartido, revisa tanto la sección de destino como la de origen después de la traducción.

ContenedorContenidoModelo de salida documentado
json, json5, jsoncVariantes de JSON estructuradoArchivos separados por idioma
json-dictionaryValores JSON que contienen objetos con claves por idiomaArchivo compartido
yamlCatálogo YAMLArchivos separados por idioma
yaml-root-keyYAML contenido bajo la clave raíz del idioma de salidaArchivos separados por idioma
markdown, mdx, markdocDocumentos de la familia MarkdownArchivos separados por idioma
html, mjmlMarcado HTML y de correo electrónicoArchivos separados por idioma
androidRecursos XML de AndroidArchivos separados por idioma
xcode-strings, xcode-stringsdictRecursos de cadenas y plurales de AppleArchivos separados por idioma
xcode-xcstringsCatálogo de cadenas de XcodeArchivo compartido
flutterCatálogo ARBArchivos separados por idioma
poPO de GettextArchivos separados por idioma
propertiesPropiedades de JavaArchivos separados por idioma
csvCSV con varios idiomasArchivo compartido
csv-per-localeUn CSV por idiomaArchivos separados por idioma
xml, xliffXML y XLIFFArchivos separados por idioma
srt, vttSubtítulosArchivos separados por idioma
phpMatrices de localización de PHPArchivos separados por idioma
typescriptContenido de localización de TypeScriptArchivos separados por idioma
vue-jsonBloques JSON de Vue i18n con claves por idiomaArchivo compartido
txtTexto sin formatoArchivos separados por idioma

Esta es la familia de contenedores heredados, no una lista de compatibilidad con otras herramientas. Algunas entradas pueden ser posteriores a las primeras versiones de v0. Los analizadores de TypeScript, PHP y Vue procesan las estructuras de localización que admiten; su presencia no significa que permitan reescribir arbitrariamente código fuente ejecutable.

El despachador 0.138.10 también contiene ail, ejs, twig, dato y xcode-xcstrings-v2. Mantén el analizador que ya utiliza el proyecto instalado hasta haber revisado sus entradas y salidas. Un tipo enumerado en el esquema no basta por sí solo: el esquema heredado también incluye compiler, pero esta ruta de despacho no cuenta con un cargador correspondiente.

yaml-root-key solo reconstruye la raíz del idioma seleccionado. No hagas que el origen y el destino apunten al mismo archivo YAML compartido: una operación de escritura puede sobrescribir sus otras raíces. Usa una ruta específica para cada idioma, como locales/[locale].yml. A diferencia de este comportamiento, un diccionario JSON o un bloque de Vue integra explícitamente un nuevo idioma en la estructura original.

Configura un archivo representativo #

Para JSON, el mismo patrón identifica un archivo de origen y archivos de destino separados:

json
{
  "buckets": {
    "json": { "include": ["src/locales/[locale].json"] }
  }
}

Para un catálogo Xcode compartido junto con recursos de Android específicos de cada idioma:

json
{
  "buckets": {
    "xcode-xcstrings": { "include": ["ios/Localizable.xcstrings"] },
    "android": {
      "include": ["android/app/src/main/res/values-[locale]/strings.xml"]
    }
  }
}

Adapta la nomenclatura de los idiomas de Android y los directorios de recursos a la aplicación. Tras la primera ejecución, valida ambos formatos nativos con sus herramientas de compilación y confirma que la aplicación carga el destino seleccionado. Que la configuración se acepte no demuestra, por sí solo, que la ruta funcione.

Busca archivos sin seleccionar la salida generada #

Las rutas se resuelven con respecto a i18n.json; * busca coincidencias dentro de un mismo nivel. El patrón recursivo ** se incorporó en 0.135.0. Excluye node_modules, .git, dist, build, .next y .turbo de forma predeterminada. Excluye explícitamente cualquier otro contenido generado:

json
{
  "buckets": {
    "markdown": {
      "include": ["docs/[locale]/*.md"],
      "exclude": ["docs/[locale]/drafts/*.md"]
    }
  }
}

Si trabajas con varios paquetes, elige una configuración compartida o por paquete según los idiomas y quién sea responsable del motor de localización. Acotar las rutas evita que la salida generada se use inesperadamente como entrada de origen.

Comprueba las protecciones específicas de cada formato #

Para los catálogos de clave/valor, aplica controles de claves según quién sea responsable de cada valor. Los comentarios de JSONC y de los catálogos Xcode pueden incluir notas para traductores. Los documentos de formato libre y los subtítulos no utilizan necesariamente estas funciones del mismo modo.

Revisa lo que ha reconstruido el analizador: las claves y los valores del catálogo, el marcado y los enlaces del documento, las marcas de tiempo de los subtítulos o los identificadores de recursos nativos. Acepta la salida solo cuando el analizador o el proceso de compilación que la utilice pueda procesarla. Al migrar, consulta el manual de formatos actual y la lista de formatos admitidos por la herramienta que realiza la invocación, en lugar de dar por hecho que esta matriz heredada sigue siendo aplicable.