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.
| Grupo | Contenido | Modelo de salida documentado |
|---|---|---|
json, json5, jsonc | Variantes de JSON estructurado | Archivos separados por idioma |
json-dictionary | Valores JSON que contienen objetos con claves por idioma | Archivo compartido |
yaml | Catálogo YAML | Archivos separados por idioma |
yaml-root-key | YAML dentro de la clave raíz del idioma de salida | Archivos separados por idioma |
markdown, mdx, markdoc | Documentos de la familia Markdown | Archivos separados por idioma |
html, mjml | Marcado HTML y de correo electrónico | Archivos separados por idioma |
android | Recursos XML de Android | Archivos separados por idioma |
xcode-strings, xcode-stringsdict | Cadenas y recursos de plurales de Apple | Archivos separados por idioma |
xcode-xcstrings | Catálogo de cadenas de Xcode | Archivo compartido |
flutter | Catálogo ARB | Archivos separados por idioma |
po | PO de Gettext | Archivos separados por idioma |
properties | Propiedades de Java | Archivos separados por idioma |
csv | CSV con varios idiomas | Archivo compartido |
csv-per-locale | Un CSV por idioma | Archivos separados por idioma |
xml, xliff | XML y XLIFF | Archivos separados por idioma |
srt, vtt | Subtítulos | Archivos separados por idioma |
php | Arreglos de localización de PHP | Archivos separados por idioma |
typescript | Contenido de localización de TypeScript | Archivos separados por idioma |
vue-json | Bloques JSON de Vue i18n con claves por idioma | Archivo compartido |
txt | Texto sin formato | Archivos 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:
{
"buckets": {
"json": { "include": ["src/locales/[locale].json"] }
}
}Para un catálogo compartido de Xcode junto con recursos de Android específicos por idioma:
{
"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:
{
"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.