# General Translation Knowledge Base: Как перевести контент в Storyblok?
URL: https://generaltranslation.com/ru/kb/translate-storyblok-content.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: В Storyblok добавьте целевые языки в пространство и задайте для каждого переводимого поля значение на каждом языке. Интеграция General Translation со Storyblok заполняет эти значения из панели управления с помощью действия «Синхронизировать и применить» — в виде черновиков, которые вы проверяете и публикуете в Storyblok.
Category: Инструменты для рабочих процессов
Last updated: 2026-10-21
Authors: Kevin Liu, Kevin Wu
Published: 2026-10-21

Когда в пространство добавлены языки, Storyblok хранит переводы на уровне полей: каждое поле, отмеченное как переводимое в схеме компонента, содержит по одному значению на каждый язык в рамках одной story, а приложение запрашивает нужный язык через параметр `language` API доставки контента. Заполнять эти значения непросто: story — это дерево вложенных блоков, в форматированном тексте есть разметка (например, полужирное начертание и ссылки), которая должна пережить перевод, а каждый результат нужно вернуть в то же поле и для того же языка. Поле, не отмеченное как переводимое, перевод не хранит, а любая правка источника делает остальные языковые версии устаревшими.

## Video

The video is narrated in English, with English captions.

[How do I translate content in Storyblok?](https://caxecubb9c64cezv.public.blob.vercel-storage.com/films/kb-translate-storyblok-content.mp4) (50 с)

General Translation lets you connect your space and translate stories with Sync and apply. Add your target languages in Storyblok, connect the space in the Dashboard, choose stories and target locales with Auto-enable supported fields checked, then review the Spanish, Japanese and French drafts, publish them, and fetch each language with the language parameter.

## Способы перевода контента Storyblok

| Подход                                           | Сильные стороны                                                                                                                                                                                               | Как переводы попадают в story                                                             | Что остаётся на вас                                                                                                                                                  |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Ручной перевод в редакторе Storyblok             | Переводчик видит каждое поле в контексте его story                                                                                                                                                            | Человек вводит каждое значение, переключившись на нужный язык                             | Все переводы, а также поиск полей, изменившихся после каждой правки источника                                                                                        |
| Google Translate                                 | Переводит текст поля сразу после вставки, без какой-либо настройки                                                                                                                                            | Человек вставляет каждое переведённое значение обратно в соответствующее поле             | Контекст (каждое поле переводится отдельно, без окружающего блока), разметка форматированного текста, единообразие терминологии и повторный перевод изменённых полей |
| Скрипт на основе AI API (OpenAI API, Claude API) | Переводит множество story за один запуск скрипта, учитывая заданные в промпте тон и терминологию                                                                                                              | Написанный вами скрипт читает и обновляет story через Management API Storyblok            | Обход вложенных блоков, сохранение разметки форматированного текста, контекст для каждого поля, единообразие терминологии и повторный запуск после правок            |
| General Translation (интеграция со Storyblok)    | Переводит поля `text`, `textarea`, `markdown`, `richtext` и `table`, включая вложенные блоки; сохраняет разметку форматированного текста; передаёт каждое поле с контекстом: его расположением, типом и story | **Синхронизировать и применить** записывает каждый язык перевода в story в виде черновика | Добавление языков в Storyblok, повторный запуск **Синхронизировать и применить** после правок источника, а также проверка и публикация каждого черновика             |

Если story немного и для каждого языка есть переводчик, переводите вручную в редакторе Storyblok — больше ничего не понадобится. Google Translate или скрипт на основе AI API подойдут для разового пакета, который человек проверит вручную. Если же story часто меняются или содержат много блоков и языков, используйте General Translation.

## Перевод story с помощью General Translation

Интеграция General Translation со Storyblok работает прямо из панели управления, ничего устанавливать не нужно. Интеграция доступна на тарифах Starter и Enterprise.

1. В Storyblok добавьте целевые языки в разделе **Settings &gt; Internationalization**.
2. Создайте персональный токен доступа в разделе **My account &gt; Account settings &gt; Personal access tokens**.
3. В панели управления откройте **Проект &gt; Интеграции &gt; Каталог**, нажмите **Подключить** в карточке **Storyblok** и укажите **Space ID**, **Регион** и токен.
4. Выберите story и целевые локали. Если поддерживаемые поля пока недоступны для перевода, отметьте **Автоматически включать поддерживаемые поля** (будут обновлены все компоненты в пространстве).
5. Нажмите **Синхронизировать и применить**.

## Проверка, публикация и обновление черновиков

Запуск записывает каждый язык в story как черновик и ничего не публикует: проверьте и опубликуйте черновик в Storyblok, а затем запрашивайте его с параметром `language` (для предварительного просмотра добавьте `version=draft`). При каждом повторном запуске используются переводы, уже сохранённые в story, включая значения, отредактированные вами в Storyblok, а переводятся только новые или изменённые поля. Подробные шаги описаны в разделе [Быстрый старт для Storyblok](/docs/integrations/storyblok/quickstart).

## Related questions

- [Как перевести контент в Sanity?](https://generaltranslation.com/ru/kb/translate-sanity-content.mdx): Храните каждый язык как отдельный документ или как значение для каждой локали в каждом поле, а затем переведите источник на все целевые локали. Плагин gt-sanity от General Translation добавляет в Sanity Studio действие Translate и по умолчанию импортирует каждый перевод как черновик, который вы проверяете и публикуете.
- [Как перевести сайт документации на Mintlify?](https://generaltranslation.com/ru/kb/translate-mintlify-docs.mdx): Создайте переведённую копию каждой страницы в отдельной папке для каждого языка и добавьте все языки в навигацию docs.json. AI-агент General Translation под названием Locadex открывает пул-реквест, который добавляет переведённые страницы и навигацию для каждого языка, а затем переводит последующие изменения.
- [Как перевести Google Slides?](https://generaltranslation.com/ru/kb/translate-google-slides.mdx): Создайте копию презентации для каждого языка, замените текст во всех текстовых полях, ячейках таблиц и заметках докладчика, а затем уменьшите текст, который не помещается. Интеграция General Translation с Google Drive сохраняет каждый язык в отдельную копию рядом с исходной презентацией и выполняет дополнительное форматирование, чтобы новый текст поместился на каждом слайде.
- [Как проверять и редактировать переводы?](https://generaltranslation.com/ru/kb/review-translations.mdx): Сравнивайте каждый перевод с источником и другими локалями и исправляйте то, что звучит неправильно. В General Translation переводы редактируются на странице «Переводы» в панели управления, а ход проверки отслеживается с помощью меток и комментариев. При следующем запуске перевода Locadex, AI-агент платформы, переносит правки в пул-реквест.

## Previous and next questions

- Previous question: [Как перевести контент в Sanity?](https://generaltranslation.com/ru/kb/translate-sanity-content.mdx)
- Next question: [Как перевести приложение на Node.js?](https://generaltranslation.com/ru/kb/translate-node-app.mdx)

## Sitemap

See the [Knowledge Base sitemap](https://generaltranslation.com/ru/kb/sitemap.md) for every article.
