モノレポで 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 アクションのバージョンを lingo.dev@0.138.10 とは別に固定します。翻訳用の LINGODOTDEV_API_KEY をリポジトリのシークレットとして保存し、リポジトリ設定でアクションによるプルリクエストの作成を許可してください。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: ["."] に変更してください。これにより、再帰的なソースパターンを使い、単一の設定で配下のパッケージを検出できます。

従来版のアクションは、ベースブランチに対応する翻訳ブランチを使用します。そのため、同じプルリクエストを更新するパッケージのジョブは順次実行されます。その翻訳ブランチを使用する他のワークフローとも、同じ同時実行グループを共有してください。再実行後も含め、プルリクエスト内のすべてのパッケージの出力をレビューし、マージ前に各パッケージのリソースチェックを実行してください。

GitHub でプルリクエストのワークフローが承認待ちと表示された場合は、リポジトリへの書き込み権限を持つユーザーが ワークフローの実行を承認 を選択する必要があります。GitHub の GITHUB_TOKEN の動作を参照してください。