在单体仓库中组织 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 Action 和 lingo.dev@0.138.10 的版本。将 LINGODOTDEV_API_KEY 保存为仓库密钥,用于翻译,并在仓库设置中允许 Actions 创建拉取请求。GH_TOKEN 提供单独的 GitHub 凭据。

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: ["."];这样,递归源路径匹配模式就能在这一配置下发现各个包。

旧版 Action 会为基准分支使用一个翻译分支,因此各个包的任务会串行运行,以更新同一个拉取请求。请与使用该翻译分支的其他工作流共用同一个并发组。审核拉取请求中每个包的输出,重新运行后也需审核,并在合并前执行每个包的资源检查。

如果 GitHub 将拉取请求的工作流标记为等待批准,拥有仓库写入权限的用户必须选择 批准工作流运行。请参阅 GitHub 的 GITHUB_TOKEN 行为。