모노레포에서 CLI v0 구성하기
공유 구성과 패키지별 구성 중 알맞은 방식을 선택하고, 각 레거시 출력이 해당 소스 기준 상태와 연결되도록 유지하세요.
패키지들이 소스 언어, 대상 언어, 번역 백엔드를 공유한다면 루트에 i18n.json 하나를 두세요. 정책이나 관리 주체를 분리해야 한다면 패키지별 파일을 사용하세요. 각 구성에는 자체 i18n.lock이 있습니다.
루트 설정에서 공유 레이아웃 찾기 #
0.135.0에서 재귀 패턴을 사용해 조건에 맞는 패키지를 찾을 수 있습니다.
{
"$schema": "https://lingo.dev/schema/i18n.json",
"version": "1.15",
"locale": { "source": "en", "targets": ["es", "fr"] },
"buckets": {
"json": { "include": ["apps/**/locales/[locale].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을 명시적으로 선택하세요. 패키지마다 서로 다른 언어 쌍을 요청하면서도 같은 로컬라이제이션 엔진을 사용할 수 있습니다.
해당 패키지의 디렉터리에서 실행하세요.
cd apps/web
lingo run해당 패키지의 소스, 승인된 출력, 구성, Lockfile을 함께 커밋하세요. 패키지 자체의 애플리케이션이나 문서 빌드도 확인하세요. 번역 지침을 공유한다고 해서 각 패키지가 생성된 파일을 실제로 불러온다는 보장은 없습니다.
CI 패키지 목록을 명시적으로 관리하기 #
매트릭스에 작업 디렉터리를 나열하고, 각 디렉터리의 i18n.json 옆에서 버전이 고정된 레거시 바이너리를 호출하도록 할 수 있습니다. 저장소에 패키지를 추가해도 명시적으로 정의한 매트릭스에 자동으로 추가되지는 않습니다.
이 워크플로는 lingo.dev@0.138.10과 별도로 Lingo.dev 액션의 버전을 고정합니다. 번역에 사용할 LINGODOTDEV_API_KEY을 저장소 시크릿으로 저장하고, 저장소 설정에서 액션의 풀 리퀘스트 생성을 허용하세요. 별도의 GitHub 인증 정보는 GH_TOKEN에서 제공합니다.
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 동작을 참고하세요.