# General Translation Integrations: Storyblok の設定
URL: https://generaltranslation.com/ja/docs/integrations/storyblok/guides/configuring-storyblok.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 認証情報と翻訳可能なフィールドを使用して、Storyblok スペースを General Translation に接続する方法。

Storyblok スペースを General Translation に接続し、ストーリーを翻訳できるように準備します。Storyblok はダッシュボードで管理するインテグレーションで、npm パッケージではなく認証情報を使って接続します。

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

Storyblok を接続するには、次の条件を満たしている必要があります。

* プロジェクトに対する `project:write` 権限。これがないと、**Connect** アクションは利用できません。
* Starter または Enterprise プラン。これがないと、ダッシュボードにはインテグレーションカタログの代わりにアップグレードを促す表示が出るため、スペース を接続できません。

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

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

ダッシュボードで選択できる対象ロケールはこの一覧から取得されるため、まずここで設定してください。言語が表示されるのは、対応する General Translation のサポート対象ロケールにマッピングされている場合のみです ([ロケール](/docs/integrations/storyblok/reference/locales) を参照) 。

## パーソナルアクセストークンを作成する [#create-token]

この連携では、パーソナルアクセストークンを使って Storyblok Management API に認証します。

Storyblok で **My account > Personal access tokens** に移動し、トークンを作成します。あわせて **Space ID** (**設定 > General**) と、スペース がホストされている **リージョン** も確認しておいてください。

## スペースを接続する [#connect-space]

ダッシュボードで **Project > Integrations > Catalog** に移動し、**Storyblok** を見つけて **Connect** をクリックします。次の情報を入力します。

* **Space ID** — 数値のスペース ID です。先頭の `#` は自動的に削除されます。
* **リージョン** — **EU**、**US**、**CA**、**AP**、または **CN** のいずれかです。
* **パーソナルアクセストークン** — Management API トークンです。

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

接続設定の一覧と保存場所の詳細については、[接続設定](/docs/integrations/storyblok/reference/connection)を参照してください。

## 翻訳可能なフィールドを有効にする [#enable-fields]

Storyblok では、コンポーネントのスキーマでそのフィールドが `translatable: true` に設定されている場合にのみ、フィールド単位の翻訳を受け付けます。General Translation は、翻訳可能になっていない対応フィールドをスキップするため、翻訳前に有効にしてください。

方法は 2 つあります。

a) **ダッシュボードから自動で有効にする。** 管理ページで、**Sync and apply** を実行する前に **Auto-enable supported fields** をチェックします。General Translation は Storyblok のコンポーネントスキーマを更新し、対応する `text`、`textarea`、`markdown`、`richtext`、`table` フィールドを `translatable: true` に設定します。すでに翻訳可能に設定されているフィールドは変更されず、結果の概要には更新されたフィールド数とコンポーネント数が表示されます。

b) **Storyblok でスキーマを編集する。** Storyblok の Block Library でコンポーネントを開き、フィールドを選択して翻訳可能オプションを有効にします。翻訳したい各フィールドに対してこれを繰り返します。

*注: 自動有効化では、選択したストーリー内のコンポーネントだけでなく、スペース 内のすべてのコンポーネントに書き込みます。*

## インテグレーションを再度開く [#reopen]

さらに翻訳を実行するには、**Project > Integrations > Connected** からインテグレーションを再度開いてください。基になる Organization の接続レコードは、**Organization > Connections** に表示されます。

## Next steps

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

## Sitemap

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