# General Translation Integrations: 快速入门
URL: https://generaltranslation.com/zh/docs/integrations/storyblok/quickstart.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 将 Storyblok space 连接到 General Translation，并通过仪表板翻译你的第一个 story。

Storyblok 是一种由仪表板管理的集成：使用凭据连接一个 space 即可翻译 story，无需安装任何东西。翻译内容会以字段级本地化值的形式写回每个 story，因此你可以通过 Storyblok 自有的 Content Delivery API 读取这些内容。

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

你需要：

* 一个使用 Starter 或 Enterprise 方案的 [项目](/docs/platform/dashboard/get-started)。
* 该项目的 `project:write` 权限。
* 运行翻译所需的 `translations:content:write` 权限。
* 一个 Storyblok space，并在 **Settings > Languages** 中配置好目标语言。
* 一个 Storyblok 个人访问令牌 (Management API 令牌) 。

## 快速入门 [#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 > Catalog** 并找到 **Storyblok**。点击 **Connect**，然后填写：

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

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

### 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

## Sitemap

See the full [sitemap](https://generaltranslation.com/sitemap.md) for all pages.