# General Translation Integrations: Настройка Storyblok
URL: https://generaltranslation.com/ru/docs/integrations/storyblok/guides/configuring-storyblok.mdx
---

title: Настройка Storyblok
description: "Как подключить пространство Storyblok к General Translation: в этом руководстве описано, как добавить учетные данные и включить переводимые поля."
related:
  links:
    - /docs/integrations/storyblok/guides/translating-content
    - /docs/integrations/storyblok/guides/managing-translations
    - /docs/integrations/storyblok/guides/using-translated-content

---

Подключите пространство Storyblok к General Translation и подготовьте его к переводу story. Storyblok — это интеграция, управляемая через Dashboard: она подключается с помощью учетных данных, а не npm-пакета.

## Прежде чем начать [#before-start]

Для подключения Storyblok требуется:

* разрешение `project:write` для проекта. Без него действие **Connect** недоступно.
* Тарифный план, включающий функцию `project_integrations`. Без него в Dashboard вместо каталога интеграций отображается предложение перейти на более высокий тариф, поэтому вы не сможете подключить пространство.

## Настройте языки в Storyblok [#configure-languages]

В Storyblok откройте свое пространство и перейдите в **Settings > Languages**. Добавьте все языки, которые хотите использовать как целевые для перевода.

Целевые локали, доступные для выбора в Dashboard, берутся из этого списка, поэтому сначала настройте их здесь. Язык будет доступен только в том случае, если он сопоставлен с поддерживаемой локалью General Translation. См. [Локали](/docs/integrations/storyblok/reference/locales).

## Создайте персональный токен доступа [#create-token]

Для аутентификации интеграции в Storyblok Management API используется персональный токен доступа.

В Storyblok перейдите в **My account > Personal access tokens** и создайте токен. Также запишите **ID пространства** (**Settings > General**) и **регион**, в котором размещено ваше пространство.

## Подключите пространство [#connect-space]

В Dashboard перейдите в **Project > Integrations**, откройте каталог, найдите **Storyblok** и нажмите **Connect**. Укажите:

* **ID пространства** — числовой ID пространства. Начальный символ `#` удаляется автоматически.
* **Регион** — один из **EU**, **US**, **CA**, **AP** или **CN**.
* **Персональный токен доступа** — ваш токен Management API.

Учетные данные сохраняются в проекте. После успешного подключения вы попадете на страницу управления интеграцией.

Полный список параметров подключения и сведения о том, где они хранятся, см. в разделе [Настройки подключения](/docs/integrations/storyblok/reference/connection).

## Включите переводимые поля [#enable-fields]

Storyblok принимает перевод на уровне отдельных полей только в том случае, если в схеме компонента для поля указано `translatable: true`. General Translation пропускает поддерживаемые поля, для которых перевод не включён, поэтому сначала включите их.

У вас есть два варианта.

a) **Автоматически включить из Dashboard.** На странице управления установите флажок **Auto-enable supported fields** перед запуском **Sync and apply**. General Translation обновит схемы компонентов Storyblok, чтобы для поддерживаемых полей `text`, `textarea`, `markdown`, `richtext` и `table` было установлено `translatable: true`. Поля, уже отмеченные как переводимые, останутся без изменений, а в сводке результатов будет указано, сколько полей и компонентов было обновлено.

b) **Изменить схему в Storyblok.** В Block Library Storyblok откройте компонент, выберите поле и включите для него опцию translatable. Повторите это для каждого поля, которое вы хотите переводить.

*Примечание: автоматическое включение вносит изменения во все компоненты в пространстве, а не только в те, что находятся в выбранных вами story.*

## Управление или отключение [#manage-disconnect]

Повторно откройте интеграцию в разделе **Project > Integrations**, чтобы выполнить новые переводы. Данные для подключения сохраняются в Project, пока интеграция не будет удалена. Отключите ее в том же разделе Integrations, если больше не хотите, чтобы General Translation имел доступ к пространству.
## Next steps

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