# General Translation Integrations: 快速入门
URL: https://generaltranslation.com/zh/docs/integrations/storyblok/quickstart.mdx
---

title: 快速入门
description: 快速了解如何将 Storyblok space 连接到 General Translation，并通过仪表板翻译你的第一个 story。
related:
  links:
    - /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

---

使用 Storyblok 集成，你可以在 General Translation 仪表板中翻译 Storyblok story。

Storyblok 是一种由仪表板管理的内容源集成：你只需使用凭证连接一个 Storyblok space，然后在仪表板中翻译 story，无需安装 npm 包。翻译内容会以字段级本地化值 (即 Storyblok 的字段级翻译) 的形式写回每个 story，因此你可以通过 Storyblok 自有的 Content Delivery API 读取这些内容。

## 开始之前 [#before-start]

你需要：

* 一个启用了 `project_integrations` 功能套餐的 General Translation [项目](/docs/platform/dashboard/get-started)。
* 该项目的 `project:write` 权限。
* 一个 Storyblok space，并在 **Settings > Languages** 中配置好目标语言。
* 一个 Storyblok 个人访问令牌 (Management API 令牌) 。

*注意：如果你的套餐不包含 `project_integrations` 功能，仪表板显示的会是升级提示，而不是集成目录，因此你无法连接 space。*

## 快速入门 [#quickstart]

### 1. 在 Storyblok 中配置语言 [#configure-languages]

在 Storyblok 中，打开你的 space，然后前往 **Settings > Languages**。添加你要翻译到的每种语言。

只有当某个 Storyblok 语言既已在该 space 中配置，又映射到 General Translation 支持的区域设置时，General Translation 才会将其作为目标区域设置提供。请参阅 [区域设置](/docs/integrations/storyblok/reference/locales)。

### 2. 创建个人访问 token [#create-token]

在 Storyblok 中，前往 **My account > Personal access tokens**，创建一个 token。该集成会使用它代表你调用 Storyblok Management API。

记下你的 space 的 **Space ID** (一个数字，显示在 **Settings > General** 中) 以及其 **Region** (EU、US、CA、AP 或 CN) 。

### 3. 在仪表板中连接 space [#connect-space]

在 General Translation 仪表板中，前往 **项目 > Integrations**，打开目录列表并找到 **Storyblok**。点击 **Connect**，然后填写：

* **Space ID** — 你的 space 数字 ID。
* **Region** — 你的 space 所托管的区域。
* **Personal access token** — 上一步中的令牌。

凭据会存储在项目中。连接成功后，你会进入该集成的管理页面。

### 4. 选择 story 和区域设置，然后进行 sync [#sync-apply]

在管理页面中：

1. 选择一个或多个 **Story** 条目 (选择器支持搜索，也支持全选/全不选) 。
2. 设置 **源区域设置** (默认为你的项目的默认区域设置) 。
3. 确认 **目标区域设置** (默认采用该 space 中已配置的语言，不包括源区域设置) 。
4. 可选：勾选 **自动启用受支持字段**，在 sync 前将受支持的字段在 Storyblok 中标记为可翻译。
5. 点击 **Sync and apply**。

General Translation 会读取每个 story 的草稿，提取可翻译字段，完成翻译后再将结果作为草稿写回 story。系统不会自动发布任何内容。

完整 workflow 和结果摘要，请参阅[翻译内容](/docs/integrations/storyblok/guides/translating-content)。

### 5. 在 Storyblok 中检查草稿 [#review-draft]

在 Storyblok 中打开该 story，并切换到目标语言，检查翻译后的草稿。确认无误后，在 Storyblok 中发布。

要在应用中获取已翻译内容，请使用 `language` 参数查询 Storyblok 的 Content Delivery API。请参阅[使用已翻译内容](/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