모노레포에서 CLI v0 구성하기

공유 구성과 패키지별 구성 중 알맞은 방식을 선택하고, 각 레거시 출력이 해당 소스 기준 상태와 연결되도록 유지하세요.

패키지들이 소스 언어, 대상 언어, 번역 백엔드를 공유한다면 루트에 i18n.json 하나를 두세요. 정책이나 관리 주체를 분리해야 한다면 패키지별 파일을 사용하세요. 각 구성에는 자체 i18n.lock이 있습니다.

루트 설정에서 공유 레이아웃 찾기 #

0.135.0에서 재귀 패턴을 사용해 조건에 맞는 패키지를 찾을 수 있습니다.

json
{
  "$schema": "https://lingo.dev/schema/i18n.json",
  "version": "1.15",
  "locale": { "source": "en", "targets": ["es", "fr"] },
  "buckets": {
    "json": { "include": ["apps/**/locales/[locale].json"] }
  }
}

새 패키지는 경로가 패턴과 일치할 때만 포함됩니다. 패키지를 추가한 뒤 검색 결과를 확인하고, 번역 대상으로 전송하면 안 되는 자동 생성 콘텐츠나 내부 콘텐츠는 제외하세요. 기본 제외 항목에는 일반적인 빌드 디렉터리가 포함되지만, 프로젝트별 고유 디렉터리 구조까지 모두 포함되지는 않습니다.

이전 릴리스를 사용하거나 레이아웃이 제각각인 경우에는 경로를 직접 나열할 수 있습니다.

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"] }
  }
}

두 레이아웃 모두 루트의 Lockfile 하나와 같은 백엔드 설정을 공유합니다. 이 공유 상태에 접근하는 별도 프로세스를 동시에 실행하지 마세요.

정책이 다른 패키지 분리하기 #

대상 언어를 따로 지정하거나 다른 로컬라이제이션 엔진을 사용해야 하는 패키지마다 i18n.json을 두세요. engineId을 명시적으로 선택하세요. 패키지마다 서로 다른 언어 쌍을 요청하면서도 같은 로컬라이제이션 엔진을 사용할 수 있습니다.

해당 패키지의 디렉터리에서 실행하세요.

sh
cd apps/web
lingo run

해당 패키지의 소스, 승인된 출력, 구성, Lockfile을 함께 커밋하세요. 패키지 자체의 애플리케이션이나 문서 빌드도 확인하세요. 번역 지침을 공유한다고 해서 각 패키지가 생성된 파일을 실제로 불러온다는 보장은 없습니다.

CI 패키지 목록을 명시적으로 관리하기 #

매트릭스에 작업 디렉터리를 나열하고, 각 디렉터리의 i18n.json 옆에서 버전이 고정된 레거시 바이너리를 호출하도록 할 수 있습니다. 저장소에 패키지를 추가해도 명시적으로 정의한 매트릭스에 자동으로 추가되지는 않습니다.

이 워크플로는 lingo.dev@0.138.10과 별도로 Lingo.dev 액션의 버전을 고정합니다. 번역에 사용할 LINGODOTDEV_API_KEY을 저장소 시크릿으로 저장하고, 저장소 설정에서 액션의 풀 리퀘스트 생성을 허용하세요. 별도의 GitHub 인증 정보는 GH_TOKEN에서 제공합니다.

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 }}

각 패키지에는 자체 i18n.json, 소스 파일, 승인된 대상 파일, i18n.lock이 모두 커밋되어 있어야 합니다. 루트 구성을 공유하려면 매트릭스를 package: ["."]으로 변경하세요. 그러면 재귀 소스 패턴으로 하나의 구성 아래에 있는 패키지를 찾을 수 있습니다.

레거시 액션은 기준 브랜치에 대응하는 번역 브랜치를 사용하므로, 패키지 작업은 같은 풀 리퀘스트를 업데이트하도록 순차 실행됩니다. 해당 번역 브랜치를 사용하는 다른 워크플로와 동시 실행 그룹을 공유하도록 유지하세요. 재실행한 뒤에도 풀 리퀘스트에 포함된 모든 패키지의 출력을 검토하고, 병합 전에 각 패키지의 리소스 검사를 실행하세요.

GitHub에서 풀 리퀘스트 워크플로가 승인 대기 중으로 표시되면, 저장소 쓰기 권한이 있는 사용자가 워크플로 실행 승인을 선택해야 합니다. GitHub의 GITHUB_TOKEN 동작을 참고하세요.