Organiza CLI v0 en un monorepo

Elige una configuración compartida o por paquete y mantén cada salida de la versión anterior vinculada a su propia versión de referencia del contenido fuente.

Usa un solo 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 pueden descubrir los paquetes que coincidan:

json
{
  "$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 se incorpora solo si su ruta coincide con el patrón. Revisa los paquetes descubiertos después de agregarlo y excluye el contenido generado o interno que no deba enviarse a traducir. Las exclusiones predeterminadas cubren los directorios de compilación más comunes, pero no todos los árboles de directorios específicos de cada proyecto.

En versiones anteriores y estructuras diversas, las rutas se pueden indicar explícitamente:

json
{
  "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 solo 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 que tengan políticas diferentes #

Coloca i18n.json dentro de cada paquete que necesite idiomas de destino independientes o un motor de localización diferente. Selecciona engineId explícitamente. Los paquetes pueden compartir un motor de localización y solicitar distintos pares de idiomas.

Ejecuta desde el directorio del paquete correspondiente:

sh
cd apps/web
lingo run

Incluye en un mismo commit el contenido fuente, la salida aceptada, la configuración y el Lockfile de ese paquete. Verifica la compilación de su aplicación o documentación; compartir instrucciones de traducción no garantiza que cada paquete cargue los archivos generados.

Mantén explícita la lista de paquetes de CI #

Una matriz puede enumerar los directorios de trabajo y ejecutar en cada uno el binario de la versión anterior, con su versión fijada, junto a su i18n.json. Agregar un paquete al repositorio no lo agrega 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 un secreto del repositorio para la traducción y, en la configuración del repositorio, permite que las acciones creen solicitudes de incorporación de cambios. GH_TOKEN proporciona la credencial de GitHub por separado.

yaml
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 fuente, archivos de destino aceptados y i18n.lock, todos guardados en el repositorio. Para usar una configuración compartida en la raíz, cambia la matriz a package: ["."]; así, los patrones recursivos de archivos fuente podrán descubrir paquetes bajo esa única configuración.

La acción de la versión anterior 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 incorporación de cambios. Mantén el mismo grupo de concurrencia para los demás flujos de trabajo que usen esa rama de traducción. Revisa la salida de todos los paquetes en la PR, también después de volver a ejecutar los trabajos, y ejecuta las verificaciones de recursos de cada paquete antes de fusionar.

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 elegir Aprobar la ejecución de flujos de trabajo. Consulta el comportamiento de GITHUB_TOKEN en GitHub.