在单体仓库中组织 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 Action 和 lingo.dev@0.138.10 的版本。将 LINGODOTDEV_API_KEY 保存为仓库密钥,用于翻译,并在仓库设置中允许 Actions 创建拉取请求。GH_TOKEN 提供单独的 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 }}每个包都需要提交自己的 i18n.json、源文件、已接受的目标文件和 i18n.lock。如果使用共享的根目录配置,请将矩阵改为 package: ["."];这样,递归源路径匹配模式就能在这一配置下发现各个包。
旧版 Action 会为基准分支使用一个翻译分支,因此各个包的任务会串行运行,以更新同一个拉取请求。请与使用该翻译分支的其他工作流共用同一个并发组。审核拉取请求中每个包的输出,重新运行后也需审核,并在合并前执行每个包的资源检查。
如果 GitHub 将拉取请求的工作流标记为等待批准,拥有仓库写入权限的用户必须选择 批准工作流运行。请参阅 GitHub 的 GITHUB_TOKEN 行为。