Organiza la CLI v0 en un monorepositorio
Elige una configuración compartida o una por paquete y mantén cada resultado de la versión antigua vinculado a su propia versión de referencia del contenido de origen.
Usa un único i18n.json en la raíz cuando los paquetes compartan el idioma de origen, los idiomas de destino y el servicio de traducción. Usa archivos por paquete cuando necesiten políticas o responsables independientes. Cada configuración tiene su propio i18n.lock.
Descubre un diseño compartido desde la configuración raíz #
Desde 0.135.0, los patrones recursivos permiten detectar los paquetes cuyas rutas coincidan:
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": { "include": ["apps/**/locales/[locale].json"] }
}
}Un paquete nuevo solo se incorpora si su ruta coincide con el patrón. Comprueba la detección después de añadirlo y excluye el contenido generado o interno que no deba enviarse a traducir. Las exclusiones predeterminadas cubren los directorios de compilación habituales, pero no todos los árboles de directorios específicos de cada proyecto.
En versiones anteriores o con estructuras diversas, las rutas se pueden enumerar de forma explícita:
{
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": {
"include": [
"apps/web/locales/[locale].json",
"apps/dashboard/locales/[locale].json"
]
},
"markdown": { "include": ["packages/docs/content/[locale]/*.md"] }
}
}Ambas estructuras comparten un único Lockfile en la raíz y el mismo servicio de traducción. No ejecutes procesos independientes sobre ese estado al mismo tiempo.
Separa los paquetes con políticas distintas #
Coloca i18n.json dentro de cada paquete que necesite idiomas de destino independientes o un motor de localización diferente. Selecciona engineId de forma explícita. Los paquetes pueden compartir un motor de localización y solicitar pares de idiomas distintos.
Ejecuta el comando desde el directorio del paquete:
cd apps/web
lingo runIncluye en el mismo commit el contenido de origen, el resultado aceptado, la configuración y el Lockfile de ese paquete. Comprueba la compilación de su aplicación o documentación; compartir las instrucciones de traducción no garantiza que cada paquete cargue los archivos generados.
Mantén una lista explícita de paquetes en CI #
Una matriz puede enumerar los directorios de trabajo para ejecutar en cada uno el binario de la versión antigua, fijado a una versión concreta, junto a su i18n.json. Añadir un paquete al repositorio no lo incorpora a una matriz explícita.
El flujo de trabajo fija la versión de la acción de Lingo.dev por separado de lingo.dev@0.138.10. Guarda LINGODOTDEV_API_KEY como secreto del repositorio para la traducción y, en la configuración del repositorio, permite que Actions cree solicitudes de cambios. GH_TOKEN proporciona la credencial independiente de GitHub.
name: Translate legacy packages
on:
workflow_dispatch:
push:
branches: [main]
permissions:
contents: write
pull-requests: write
concurrency:
group: legacy-translations-${{ github.ref }}
cancel-in-progress: false
jobs:
translate:
runs-on: ubuntu-latest
strategy:
max-parallel: 1
fail-fast: false
matrix:
package: [apps/web, apps/marketing]
steps:
- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4
with:
fetch-depth: 0
- uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4
with:
node-version: "22"
- uses: lingodotdev/lingo.dev@0050b4858e1cea2b745c8f131fe178a23f643dc7
with:
version: "0.138.10"
api-key: ${{ secrets.LINGODOTDEV_API_KEY }}
working-directory: ${{ matrix.package }}
pull-request: true
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}Cada paquete necesita su propio i18n.json, archivos de origen, archivos de destino aceptados y i18n.lock, todos incluidos en el repositorio mediante un commit. Para usar una configuración compartida en la raíz, cambia la matriz a package: ["."]; así, los patrones recursivos de origen podrán detectar paquetes con esa única configuración.
La acción de la versión antigua usa una rama de traducción para la rama base, por lo que los trabajos de los paquetes se ejecutan en serie para actualizar la misma solicitud de cambios. Mantén el grupo de concurrencia compartido con otros flujos de trabajo que usen esa rama de traducción. Revisa el resultado de todos los paquetes en la PR, también después de volver a ejecutar los trabajos, y ejecuta las comprobaciones de recursos de cada paquete antes de fusionar los cambios.
Si GitHub indica que los flujos de trabajo de la PR están pendientes de aprobación, alguien con permisos de escritura en el repositorio debe seleccionar Aprobar la ejecución de los flujos de trabajo. Consulta el comportamiento de GITHUB_TOKEN en GitHub.