# General Translation Integrations: クイックスタート
URL: https://generaltranslation.com/ja/docs/integrations/payload/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: gt-payload をインストールして Payload CMS にプラグインを追加し、最初のローカライズ対象ドキュメントを翻訳します。

`gt-payload` プラグインは、Payload CMS のコレクションとグローバルに翻訳コントロールを追加し、ローカライズ対象のフィールドを Payload の設定で指定されたロケールに翻訳します。

## 始める前に [#before-start]

以下が必要です:

* `localization` を設定済みの Payload CMS 3.90.0 以降
* Next.js 15.2.9 以降
* React 19.0.1 以降
* General Translation の[プロジェクト ID](/docs/platform/dashboard/get-started)と、**All** 権限を持つ[プロジェクト API キー](/docs/platform/dashboard/reference/api-keys#create-project-keys)
* `localized: true` を指定したフィールド (1 つ以上)

## クイックスタート [#quickstart]

### 1. `gt-payload` をインストールする

<Tabs items={['npm', 'yarn', 'bun', 'pnpm']}>
  <Tab value="npm">
    ```bash
    npm install gt-payload
    ```
  </Tab>

  <Tab value="yarn">
    ```bash
    yarn add gt-payload
    ```
  </Tab>

  <Tab value="bun">
    ```bash
    bun add gt-payload
    ```
  </Tab>

  <Tab value="pnpm">
    ```bash
    pnpm add gt-payload
    ```
  </Tab>
</Tabs>

### 2. ローカライゼーションを設定する

Payload の設定でソースロケールとターゲットロケールを指定し、翻訳対象とする各フィールドを localized に設定します。

```ts title="src/payload.config.ts"
import { buildConfig } from 'payload';

export default buildConfig({
  // ... 既存の設定
  localization: {
    locales: ['en', 'es', 'fr'],
    defaultLocale: 'en',
  },
  collections: [
    {
      slug: 'pages',
      fields: [
        {
          name: 'title',
          type: 'text',
          localized: true,
        },
      ],
    },
  ],
});
```

Payload のローカライゼーションが設定されていない場合、プラグインは設定を変更しません。

### 3. プラグインを追加する

[`gtPlugin`](/docs/integrations/payload/reference/plugin-configuration) を `plugins` 配列に追加します。

```ts title="src/payload.config.ts"
import { buildConfig } from 'payload';
import { gtPlugin } from 'gt-payload';

export default buildConfig({
  // ... 既存の設定
  localization: {
    locales: ['en', 'es', 'fr'],
    defaultLocale: 'en',
  },
  plugins: [gtPlugin()],
});
```

### 4. 認証情報を設定する

Payload を実行するサーバーで、プロジェクト ID とプロジェクト API キーを設定します。

```bash title=".env"
GT_PROJECT_ID=your-project-id
GT_API_KEY=your-project-api-key
```

`GT_API_KEY` をクライアントコードに公開したり、ソース管理にコミットしたりしないでください。

### 5. Payload を更新する

管理パネルでプラグインのコンポーネントを読み込めるように、import map を再生成します。

```bash
npx payload generate:importmap
```

このプラグインは、翻訳実行とロック用のコレクションを追加します。PostgreSQL または SQLite を使用している場合は、通常の Payload のスキーマ変更と同じ手順でマイグレーションを作成し、適用してください：

```bash
npx payload migrate:create
npx payload migrate
```

### 6. ドキュメントを翻訳する

1. Payload を起動し、管理パネルを開きます。
2. ローカライズ対象のフィールドを持つドキュメントまたはグローバルを開きます。
3. 未保存の編集内容があれば保存します。
4. **Translate** を選択します。
5. ターゲットロケールを 1 つ以上選択し、**Translate into …** を選択します。

プラグインは、各翻訳結果を対応する Payload ロケールに書き込みます。下書きが有効な場合は下書きとして保存され、翻訳済みコンテンツが公開されることはありません。

## Next steps

- /docs/integrations/payload/guides/translating-content
- /docs/integrations/payload/guides/managing-translations

## Sitemap

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