# General Translation Platform: Locadex の自動化設定
URL: https://generaltranslation.com/ja/docs/platform/locadex/guides/configuring-automations.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Locadex の自動化テンプレート、トリガー、ブランチ、プルリクエストの動作、コマンドを設定する方法。

自動化設定を使うと、Locadex が何を変更するか、いつ実行するか、またプルリクエストをどのように作成または更新するかを制御できます。

Locadex には 3 つのテンプレートがあります。各自動化は、プルリクエストに変更があったとき、コミットがプッシュされたとき、または手動で実行できます。

## テンプレートを選択 [#choose-template]

**プロジェクト > 自動化** を開きます。**テンプレートから開始** で、次のいずれかを選択します。

* コードの国際化には **Generate code**。
  * Locadex が `t()` や `T` コンポーネントなどの国際化ライブラリ呼び出しでソースコードを囲むタイミングを設定します。
* コンテンツの更新には **Generate translations and push**。
  * Locadex が新規または更新されたソースコンテンツを対象言語に翻訳するタイミングを設定します。
* ロケールの更新には **Keep locales in sync**。
  * 言語が追加または削除されたときに、Locadex がプロジェクト内のファイルを更新するタイミングを設定します。手動実行では、ソースロケールと対象ロケールを選択できます。

このページで設定済みの自動化を選択して編集できます。**Organization > Locadex > Automations** を使って、複数のプロジェクトにまたがる自動化を検索および管理することもできます。

### コード生成時の静的チェック

**Generate code** 自動化では、編集するファイルに対して lint ルールを実行し、その結果を Agent にフィードバックします。すでに General Translation をインポートしているファイルでは、`user-facing-object` ルールにより、ハードコードされたテキストがオブジェクトや定数を介してユーザーインターフェースに渡される場合 (たとえば `{labels.save}` や設定オブジェクトから分割代入した値) に警告が表示されます。

Locadex は、文字列を source で翻訳することでこの警告を解決します。JSX content には [`<T>`](/docs/react/reference/components/t)、props やオブジェクトに保持されている strings には [`useGT`](/docs/react/reference/hooks/use-gt) や [`msg`](/docs/react/reference/functions/msg) などの string translation API を使用します。

## 自動化を設定する [#configure-automation]

### トリガーを編集する

**Run when** を、次の 3 つのトリガーのいずれかに設定します。

* **A pull request changes** は、該当するプルリクエストがオープンされたとき、再オープンされたとき、またはレビュー可能としてマークされたときに実行されます。新しいコミットが追加されると進行中の実行はキャンセルされますが、次の実行は自動では開始されません。プルリクエストを再度処理できる状態になったら、`/locadex` とコメントしてください。
* **A commit is pushed** は、対象のブランチにコミットが push されたときに実行されます。
* **Started manually** は、**Run now** をクリックした場合にのみ実行されます。

新しい **Generate code** と **Generate translations and push** の自動化では、デフォルトで **A pull request changes** が設定されます。**Keep locales in sync** のデフォルトは **Started manually** です。

### ターゲットブランチとプレフィックスを編集する

**ターゲットブランチ** には、Locadex が作業の起点とし、プルリクエストの作成先となるブランチを設定します。自動トリガーはこのブランチの変更を監視します。手動実行では、**今すぐ実行** をクリックすると Locadex がこのブランチをチェックアウトします。ほとんどのプロジェクトでは `main` を使用します。

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

```txt
locadex/
```

LocadexのブランチをGitHubで見つけやすくするため、安定したプレフィックスを使用してください。

### PR設定を編集

トグルを使って、Locadex によるプルリクエストの作成方法と管理方法を制御します。

* **自動マージ** は、チェックに通過すると Locadex のプルリクエストを自動的にマージします。 ([Locadex の PR を自動マージする](/docs/platform/locadex/guides/auto-merging-prs) を参照してください) 。
* **変更されたファイルのみ** は、**Generate code** の関連性チェックを、変更されたファイル全体ではなく変更行のみに限定します。翻訳およびロケール同期の自動化ではこのフィルターは使用されず、ドキュメントフレームワークでは関連性チェック自体がスキップされます。
* **ローカル編集を保持** は、Locadex が以前に生成したファイルに対する手動編集を保持します。

自動トリガーの場合、Locadex は同じソースブランチと自動化に対して開いているプルリクエストを再利用します。増分更新の前に、再利用する PR をドラフトに戻し、実行ごとのステータスコメントを投稿します。その PR が実行前にレビュー可能な状態だった場合にのみ、実行後にその状態へ戻します。ユーザーがドラフトのままにしていた場合は、ドラフトのままです。Dashboard からの手動実行では、単発のプルリクエストを使用します。

プルリクエストをきっかけにトリガーされた自動化では、Locadex が別の Locadex PR を作成した際に、そのリンクをトリガー元の PR にコメントします。

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

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

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

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

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

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

いずれかのチェックが失敗した場合、[自動マージ](/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-automation-activity
- /docs/platform/locadex/guides/adding-environment-variables

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.