# General Translation Knowledge Base: 如何在 Storyblok 中翻译内容？
URL: https://generaltranslation.com/zh/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 会在字段级别存储译文：组件 schema 中标记为可翻译的每个字段，都会在同一个 条目 中为每种语言各保存一个值；你的应用则通过内容交付 API 的 `language` 参数请求指定语言。填充这些值并不容易：条目 是由嵌套区块构成的树，富文本中的粗体、链接等标记必须在翻译后完整保留，而且每条结果都必须准确写回对应的字段和语言。未标记为可翻译的字段不会存储译文；源内容一旦修改，其他语言的内容就会过时。

## 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 内容的方式

| 方式                                     | 优势                                                                                                     | 译文如何写入 条目                          | 需要你自行处理的工作                                        |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------- | ------------------------------------------------- |
| 在 Storyblok 编辑器中手动翻译                   | 译者可以在 条目 中查看每个字段                                                                                    | 由人工切换到对应语言视图，逐个输入每个值                  | 全部翻译工作，以及每次编辑源内容后找出有变动的字段                         |
| Google Translate                       | 粘贴字段文本即可翻译，无需任何初始化设置                                                                                   | 由人工将每条译文粘贴回对应字段                       | 上下文 (每个字段单独翻译，缺少所在块的信息) 、富文本标记、术语一致性，以及重新翻译有变动的字段 |
| 基于 AI API 的脚本 (OpenAI API、Claude API)  | 运行一次脚本即可翻译大量条目，并可在提示词中指定语气和术语                                                                        | 由你编写的脚本通过 Storyblok 的管理 API 读取并更新条目 | 遍历嵌套块、保留富文本标记、为每个字段提供上下文、保持术语一致，以及在内容编辑后重新运行      |
| General Translation (Storyblok 集成)     | 翻译 `text`、`textarea`、`markdown`、`richtext` 和 `table` 字段 (含嵌套块) ；保留富文本标记；发送每个字段时，附带其位置、类型及所属 条目 等上下文 | **同步并应用**会将每种目标语言的译文以草稿形式写入 条目     | 在 Storyblok 中添加语言、编辑源内容后重新运行**同步并应用**，以及审阅并发布每份草稿 |

如果条目不多，且每种语言都有译者，直接在 Storyblok 编辑器中手动翻译即可，无需借助其他工具。如果只是一次性批处理且有人工逐一检查，可以使用 Google Translate 或 AI API 脚本；如果条目经常变动，或涉及大量块和语言，建议使用 General Translation。

## 使用 General Translation 翻译条目

General Translation 的 Storyblok 集成直接在仪表板中运行，无需安装任何内容，但需要 Starter 或 Enterprise 方案。

1. 在 Storyblok 中，前往 **Settings > Internationalization** 添加目标语言。
2. 前往 **My account > Account settings > Personal access tokens** 创建个人访问令牌。
3. 在仪表板中，打开 **项目 > 集成 > 目录**，点击 **Storyblok** 上的 **连接**，然后输入 **Space ID**、**地区** 和令牌。
4. 选择条目和目标语言区域。如果支持的字段尚未设为可翻译，请勾选 **自动启用支持的字段** (此操作会更新该空间中的所有组件) 。
5. 点击 **同步并应用**。

## 审阅、发布和更新草稿

每次运行都会将各语言以草稿形式写入 条目，但不会发布任何内容：请在 Storyblok 中审阅并发布草稿，并在请求时指定 `language` (如需预览，请添加 `version=draft`) 。每次重新运行都会复用 条目 中已有的译文 (包括你在 Storyblok 中编辑过的值) ，并翻译新增或有改动的字段。完整步骤请参阅 [Storyblok 快速入门](/docs/integrations/storyblok/quickstart)。

## Related questions

- [如何在 Sanity 中翻译内容？](https://generaltranslation.com/zh/kb/translate-sanity-content.mdx): 将每种语言存储为独立文档，或在每个字段中按区域设置分别存储值，然后将源内容翻译为每个目标区域设置。General Translation 的 gt-sanity 插件会在 Sanity Studio 中添加 Translate 操作，并默认将每条译文导入为草稿，供你审阅后发布。
- [如何翻译 Mintlify 文档站点？](https://generaltranslation.com/zh/kb/translate-mintlify-docs.mdx): 为每种语言创建一个文件夹，在其中存放每个页面的译文副本，并将每种语言添加到 docs.json 导航中。General Translation 的 AI 智能体 Locadex 会提交一个拉取请求，添加翻译后的页面和各语言的导航，之后还会持续翻译后续变更。
- [如何翻译 Google Slides？](https://generaltranslation.com/zh/kb/translate-google-slides.mdx): 为每种语言复制一份演示文稿，替换每个文本框、表格单元格和演讲者备注中的文本，并缩放溢出的文本。General Translation 的 Google Drive 集成会把每种语言分别写入源文件旁的独立副本，并执行一轮格式化处理，让新文本适配每张幻灯片。
- [如何审阅和编辑译文？](https://generaltranslation.com/zh/kb/review-translations.mdx): 将每条译文与其源内容及其他区域设置的版本进行对比，修正读着别扭的地方。借助 General Translation，你可以在仪表板的翻译页面中编辑译文，并通过标签和评论跟踪审阅进度；其 AI 智能体 Locadex 下一次运行翻译时，会将这些修改纳入拉取请求。

## Previous and next questions

- Previous question: [如何在 Sanity 中翻译内容？](https://generaltranslation.com/zh/kb/translate-sanity-content.mdx)
- Next question: [如何在每次部署时保持译文同步更新？](https://generaltranslation.com/zh/kb/translations-in-ci.mdx)

## Sitemap

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