Formatos de CLI v0

Identifica la estructura de idiomas que corresponde a un analizador heredado instalado y verifica el archivo nativo reconstruido.

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

Elige primero el modelo de salida #

La mayoría de los grupos 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 solo archivo. Si la salida es compartida, revisa tanto la sección de destino como la de origen después de traducir.

GrupoContenidoModelo 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 dentro de 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-stringsdictCadenas y recursos de 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
phpArreglos 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 grupos heredada, 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 autoriza la reescritura arbitraria de 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 usa un proyecto instalado hasta revisar sus entradas y salidas. Una enumeración del esquema no basta por sí sola: el esquema heredado también incluye compiler, pero esta ruta de despacho no tiene un cargador correspondiente.

yaml-root-key reconstruye únicamente la raíz del idioma seleccionado. No apuntes el origen y el destino al mismo archivo YAML compartido: una operación de escritura puede reemplazar las demás raíces. Usa una ruta específica por idioma, como locales/[locale].yml. Esto es distinto de un diccionario JSON o un bloque de Vue que 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 destinos separados:

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

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

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

Adapta la notación de los idiomas de Android y los directorios de recursos a la aplicación. Después de la primera ejecución, valida ambos formatos nativos con sus herramientas de compilación y confirma que la aplicación cargue el destino seleccionado. Que la configuración se acepte no garantiza, 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. La búsqueda recursiva con ** se incorporó en 0.135.0. De forma predeterminada, excluye node_modules, .git, dist, build, .next y .turbo. Excluye explícitamente cualquier otro contenido generado:

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

Si tienes varios paquetes, elige una configuración compartida o por paquete según los idiomas y quién esté a cargo del motor de localización. Las rutas acotadas evitan que la salida generada se use inesperadamente como entrada de origen.

Revisa las protecciones específicas de cada formato #

Para los catálogos de clave/valor, aplica controles de claves según quién esté a cargo de cada valor. Los comentarios de JSONC y de los catálogos de Xcode pueden contener notas para traductores. Los documentos de formato libre y los subtítulos no necesariamente usan estas funciones de la misma manera.

Revisa lo que reconstruyó el analizador: claves y valores del catálogo, marcado y enlaces del documento, marcas de tiempo de los subtítulos o identificadores de recursos nativos. Acepta la salida solo cuando el analizador o el proceso de compilación que la consume pueda usarla. Al migrar, consulta el manual de formatos actual y la lista de formatos compatibles de la herramienta que lo invoca, en lugar de asumir que esta matriz heredada también se aplica.