# General Translation Platform: Locadexワークフローの設定
URL: https://generaltranslation.com/ja/docs/platform/locadex/guides/configuring-workflows.mdx
---

title: Locadexワークフローの設定
description: Locadex が codegen、翻訳、ロケール更新のワークフローをいつ実行するかを設定する方法。
related:
  links:
    - /docs/platform/locadex/guides/auto-merging-prs
    - /docs/platform/locadex/guides/managing-languages
    - /docs/platform/locadex/guides/viewing-workflow-history
    - /docs/platform/locadex/guides/adding-environment-variables

---

ワークフロー設定を使うと、Locadex が何を変更するか、いつ実行するか、どのようにプルリクエストを作成するかを制御できます。

Locadex には **Codegen**、**Translation**、**Update Locales** の 3 つのワークフローがあります。各ワークフローは、すべてのプルリクエスト時、すべてのコミット時、または手動で実行できます。

## ワークフローを選択する [#choose-workflow]

ダッシュボードのプロジェクトのサイドバーで、**Locadex > Configuration** を開きます。各プロジェクトでは、3 つの Locadex ワークフローを設定できます。

* コードの国際化には **Codegen** を使用します。
  * `t()` や `T` コンポーネントなどの国際化ライブラリ呼び出しで、Locadex がソースコードをいつラップするかを設定します。
* コンテンツの更新には **Translation** を使用します。
  * Locadex が新規または更新されたソースコンテンツを対象言語にいつ翻訳するかを設定します。
* ロケールの更新には **Locales** を使用します。
  * 言語が追加または削除されたときに、Locadex がプロジェクト内のファイルをいつ更新するかを設定します。Agent page でソース言語または対象言語を変更する場合は、このワークフローを使用します。

## ワークフローを設定する [#configure-workflow]

### トリガーを編集

各ワークフローは、次の 3 つのトリガーのいずれかで実行できます。

* **On pull request** は、関連するプルリクエストが作成または更新されると実行されます。
* **On commit** は、監視対象のブランチにコミットがプッシュされると実行されます。
* **Manual only** は、エージェントを手動で実行した場合にのみ実行されます。

デフォルトでは、Codegen と Translation は **On pull request** で実行され、Locales は **Manual only** でのみ実行されます。一方、ドキュメントフレームワーク (Mintlify、Fern、Docusaurus) では、Translation ワークフローのデフォルトは **On commit** になります。

### 対象ブランチとプレフィックスを編集

Locadex が変更を監視するブランチとして **対象ブランチ** を設定します。ほとんどのプロジェクトでは `main` を使用します。

Locadex が作成するブランチに付ける **ブランチプレフィックス** を設定します。デフォルトのプレフィックスは通常、次のとおりです。

```txt
locadex/
```

LocadexのブランチをGitHubで見つけやすくするために、固定のプレフィックスを使用します。

### PR 設定を編集

トグルボタンを使って、Locadex がプルリクエストをどのように作成・管理するかを設定できます。

* **PR の自動マージ** は、チェックを通過した Locadex のプルリクエストを自動的にマージします。詳しくは [Locadex PR の自動マージ](/docs/platform/locadex/guides/auto-merging-prs) を参照してください。
* **厳密なコンテンツ変更時に実行** は、Codegen ワークフローにおける Locadex の関連性チェックの対象を絞り込みます。有効にすると、Locadex は diff 内の変更行のみをチェックします。無効にすると、変更されたファイル全体をチェックする場合があります。この設定は、Translation ワークフローや Locales ワークフローには影響しません。
* **ローカル編集を保存** は、Locadex の実行前に手動で加えた翻訳の編集内容を保持します。

ページ下部のテキストボックスでは、さらに細かいカスタマイズが可能です。

* **カスタム PR タイトル** は、Locadex のプルリクエストで使用するタイトルを設定します。
* **カスタムコミットメッセージ** は、Locadex が使用するコミットメッセージを設定します。

### コマンドを追加する

コマンドを使うと、プロジェクトでセットアップや検証などのステップを実行できます。依存関係のインストール、プロジェクトのビルド、生成された変更の lint、またはプロジェクト固有のチェックの実行に利用できます。コマンドは、Locadex がファイルを処理する前後のどちらでも実行できます。

* **前処理コマンド** は、Locadex がファイルを処理する前に実行されます。たとえば、`npm run build` を実行します。
* **後処理コマンド** は、Locadex がファイルを処理した後に実行されます。たとえば、`npm run typecheck` を実行します。

コマンドは、リポジトリのルートから、かつ [Locadex VM image](/docs/platform/locadex/reference/vm-image) 内で実行されます。パッケージ、スクリプト、またはバイナリが見つからずにワークフローが失敗する場合は、前処理コマンドを追加してください。

いずれかのチェックが失敗した場合、[auto-merge](/docs/platform/locadex/guides/auto-merging-prs) は実行されません。
## Next steps

- /docs/platform/locadex/guides/auto-merging-prs
- /docs/platform/locadex/guides/managing-languages
- /docs/platform/locadex/guides/viewing-workflow-history
- /docs/platform/locadex/guides/adding-environment-variables