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.
| Contenedor | 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 contenido bajo 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 | Recursos de cadenas y 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 | Matrices 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 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:
{
"buckets": {
"json": { "include": ["src/locales/[locale].json"] }
}
}Para un catálogo Xcode compartido junto con recursos de Android específicos de cada idioma:
{
"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:
{
"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.