# General Translation Integrations: クイックスタート
URL: https://generaltranslation.com/ja/docs/integrations/storyblok/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: StoryblokのスペースをGeneral Translationに接続し、ダッシュボードから最初のストーリーを翻訳します。

Storyblokは、ダッシュボード上で管理するインテグレーションです。認証情報を使ってスペースを接続すれば、何もインストールせずにストーリーを翻訳できます。翻訳は各ストーリーにフィールド単位のローカライズ済み値として書き戻されるため、Storyblok独自のContent Delivery APIを通じて読み取ります。

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

必要なもの:

* Starter または Enterprise プランの [プロジェクト](/docs/platform/dashboard/get-started)。
* そのプロジェクトに対する `project:write` Permission。
* 翻訳を実行するための `translations:content:write` Permission。
* **設定 > 言語** で対象言語が設定されている Storyblok の スペース。
* Storyblok の パーソナルアクセストークン (Management API token) 。

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

### 1. Storyblokで言語を設定する [#configure-languages]

Storyblok でスペースを開き、**設定 > 言語** に移動します。翻訳先にしたい各言語を追加します。

General Translation では、Storyblok の言語がスペースで設定されており、かつGeneral Translation がサポートするロケールにマッピングされている場合にのみ、その言語を対象ロケールとして利用できます ([ロケール](/docs/integrations/storyblok/reference/locales)を参照してください) 。

### 2. 個人アクセストークンを作成する [#create-token]

Storyblok で **My account > Personal access tokens** に移動し、トークンを作成します。この連携では、このトークンを使ってあなたに代わり Storyblok Management API を呼び出します。

スペースの **Space ID** (数値。**設定 > General** に表示) と **リージョン** (EU、US、CA、AP、または CN) をメモしておきます。

### 3. ダッシュボードでスペースを接続する [#connect-space]

General Translation ダッシュボードで **Project > Integrations > Catalog** に移動し、**Storyblok** を探します。**Connect** をクリックし、次の項目を入力します。

* **Space ID** — スペースの数値 ID。
* **Region** — スペースがホストされているリージョン。
* **パーソナルアクセストークン** — 前の手順で取得したトークン。

認証情報は Storyblok スペース用の Organization 接続に保存されます。プロジェクトのインテグレーションはその接続にリンクされます。正常に接続されると、そのインテグレーションの管理ページに移動します。

### 4. ストーリーとロケールを選択してから同期する [#sync-apply]

管理ページで、次の操作を行います。

1. 1 つ以上の **ストーリー** エントリを選択します (セレクターは検索可能で、全選択／全解除に対応しています) 。
2. **ソースロケール** を設定します (デフォルトではプロジェクトのデフォルトロケールが使用されます) 。
3. **ターゲットロケール** を確認します (デフォルトでは、ソースを除く スペース で設定済みの言語が使われます) 。
4. 必要に応じて **対応フィールドを自動で有効化** をオンにし、同期前に Storyblok で対応フィールドを翻訳対象としてマークします。
5. **同期して適用** をクリックします。

General Translation は各 ストーリー の下書きを読み取り、翻訳可能なフィールドを抽出して翻訳し、その結果を下書きとして ストーリー に書き戻します。自動的に公開されることはありません。

(完全な workflow と結果の概要については、[コンテンツの翻訳](/docs/integrations/storyblok/guides/translating-content) を参照してください) 。

### 5. Storyblokで下書きを確認する [#review-draft]

Storyblokでストーリーを開き、対象の言語に切り替えて翻訳済みの下書きを確認します。内容に問題がなければ、Storyblokで公開します。

アプリで翻訳済みコンテンツを取得するには、`language` パラメータを指定して Storyblok の Content Delivery API をクエリします。 ([翻訳済みコンテンツを使う](/docs/integrations/storyblok/guides/using-translated-content)を参照してください) 。

## Next steps

- /docs/integrations/storyblok/guides/translating-content
- /docs/integrations/storyblok/guides/managing-translations
- /docs/integrations/storyblok/guides/using-translated-content
- /docs/integrations/storyblok/guides/configuring-storyblok

## Sitemap

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