# General Translation Integrations: Быстрый старт
URL: https://generaltranslation.com/ru/docs/integrations/storyblok/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: Подключите пространство Storyblok к General Translation и переведите первую story из панели управления.

Storyblok — это интеграция, которой вы управляете через панель управления: подключите пространство с помощью учетных данных и переводите stories, ничего не устанавливая. Переводы записываются обратно в каждую story как локализованные значения на уровне полей, поэтому получать их нужно через собственный Content Delivery API Storyblok.

## Перед началом [#before-start]

Вам потребуется:

* [проект](/docs/platform/dashboard/get-started) на тарифе Starter или Enterprise.
* Разрешение `project:write` для этого проекта.
* Разрешение `translations:content:write` для запуска переводов.
* Пространство Storyblok, в котором целевые языки настроены в разделе **Settings > Languages**.
* токен персонального доступа Storyblok (токен Management API).

## Быстрый старт [#quickstart]

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

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

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

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

В Storyblok перейдите в **My account > Personal access tokens** и создайте токен. Интеграция использует его для вызова Storyblok Management API от вашего имени.

Запишите **Space ID** вашего пространства (это число, оно указано в **Settings > General**) и его **регион** (EU, US, CA, AP или CN).

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

В панели управления General Translation перейдите в **проект > Integrations > Catalog** и найдите **Storyblok**. Нажмите **Connect** и укажите:

* **Space ID** — числовой идентификатор вашего пространства.
* **регион** — регион, в котором размещено ваше пространство.
* **токен персонального доступа** — токен из предыдущего шага.

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

### 4. Выберите stories и локали, затем выполните синхронизацию [#sync-apply]

На странице управления:

1. Выберите одну или несколько записей **Story** (селектор поддерживает поиск и выбор всех/снятие выбора).
2. Укажите **Source локаль** (по умолчанию используется локаль по умолчанию вашего проекта).
3. Подтвердите **Target локали** (по умолчанию они берутся из языков, настроенных в пространстве, за исключением исходной локали).
4. При необходимости установите флажок **Auto-enable supported fields**, чтобы отметить поддерживаемые поля как доступные для перевода в Storyblok перед синхронизацией.
5. Нажмите **Sync and apply**.

General Translation считывает черновик каждой story, извлекает переводимые поля, переводит их и записывает результаты обратно в story как черновик. Ничего не публикуется автоматически.

(Полный процесс и сводку результатов см. в разделе [Translating content](/docs/integrations/storyblok/guides/translating-content)).

### 5. Просмотрите черновик в Storyblok [#review-draft]

Откройте story в Storyblok и переключитесь на целевой язык, чтобы просмотреть переведённый черновик. Когда всё вас устроит, опубликуйте его в Storyblok.

Чтобы получить переведённый контент в приложении, отправьте запрос к Content Delivery API Storyblok с параметром `language`. (См. [Использование переведённого контента](/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.