概要

GT CLI では、翻訳済みのあらゆるファイル形式を GT CDN に公開できるようになりました。JSON、MDX、YAML、その他すべての対応ファイル形式を、translate、upload、save-local コマンドから直接公開できます。

設定

グローバル公開フラグ

対応している任意のコマンドに --publish を追加します:

npx gt translate --publish

または、gt.config.jsonで設定します:

{
  "publish": true
}

これにより、翻訳済みのすべてのファイル (GT JSON を含む) が CDN に配信されます。

ファイル単位の公開制御

include パターン構文を使うと、個々のファイルを公開対象に含めるか除外するかを指定できます。単なる glob 文字列ではなく、publish フラグを持つオブジェクトを使用します。

{
  "defaultLocale": "en",
  "locales": ["fr", "es"],
  "files": {
    "json": {
      "include": [
        { "pattern": "locales/[locale]/*.json", "publish": true },
        { "pattern": "locales/[locale]/internal/**/*.json", "publish": false }
      ]
    }
  }
}

この例では、internal/ サブディレクトリ内のファイルを除き、locales/[locale]/ 配下のすべての JSON ファイルが CDN に公開されます。

GT JSON の公開制御

GT の内部形式には、gt キーの下に独自の公開フラグがあります。

{
  "files": {
    "gt": {
      "output": "public/i18n/[locale].json",
      "publish": true
    }
  }
}

解決順序

任意のファイルについて、CLI は次の順序で公開の対象かどうかを判定します。

1. 明示的なオプトアウト — ファイルが "publish": false の include エントリに一致する → 公開されない、または CDN から削除される
2. 明示的なオプトイン — ファイルが "publish": true の include エントリに一致する → CDN に公開される
3. グローバルなフォールバック — トップレベルの publish 設定を使用する (未設定の場合はデフォルトで false)

どのレベルでも公開の設定がされていない場合、公開ステップは完全にスキップされ、API 呼び出しも行われません。

公開に対応するコマンド

リンク

• CLI 設定リファレンス
• PR #1122 — 初回のファイル公開に対応
• PR #1132 — オプトインの修正
• PR #1133 — 保存時およびupload時に公開