# General Translation Integrations: 配置 Storyblok
URL: https://generaltranslation.com/zh/docs/integrations/storyblok/guides/configuring-storyblok.mdx
Docs index: https://generaltranslation.com/llms.txt
Description: 使用凭据和可翻译字段将 Storyblok space 连接到 General Translation。

将 Storyblok space 连接到 General Translation，并完成相应配置，为翻译 story 做好准备。Storyblok 是一项通过仪表板管理的集成——你需要使用凭据进行连接，而不是通过 npm 包。

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

连接 Storyblok 需要满足以下条件：

* 在项目上拥有 `project:write` 权限。否则，**连接** 操作将不可用。
* 使用 Starter 或 Enterprise 方案。否则，仪表板中显示的将是升级提示，而不是集成目录，因此你无法连接 space。

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

在 Storyblok 中，打开你的 space，然后前往 **设置 > Languages**。添加你想用作翻译目标的每种语言。

你可以在仪表板中选择的目标区域设置都来自此列表，因此请先在这里配置。只有当某种语言也映射到 General Translation 支持的区域设置时，才会显示为可选。 (请参阅 [区域设置](/docs/integrations/storyblok/reference/locales)) 。

## 创建个人访问令牌 [#create-token]

该集成通过个人访问令牌对 Storyblok Management API 进行身份验证。

在 Storyblok 中，前往 **我的账户 > 个人访问令牌** 并创建一个令牌。同时记下你的 **Space ID** (**设置 > 常规**) ，以及你的 space 所托管的 **区域**。

## 连接 space [#connect-space]

在仪表板中，前往 **项目 > 集成 > 目录**，找到 **Storyblok**，然后点击 **连接**。填写以下信息：

* **Space ID** — space 的数字 ID。开头的 `#` 会自动去掉。
* **区域** — 从 **EU**、**US**、**CA**、**AP** 或 **CN** 中选择一个。
* **个人访问令牌** — 你的 Management API 令牌。

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

如需查看完整的连接设置列表及其存储位置，请参阅[连接设置](/docs/integrations/storyblok/reference/connection)。

## 启用可翻译字段 [#enable-fields]

只有当字段在其组件 schema 中标记为 `translatable: true` 时，Storyblok 才会接受该字段级别的翻译。General Translation 会跳过受支持但未启用可翻译的字段，因此请先启用这些字段，再开始翻译。

你有两种做法。

a) **在仪表板中自动启用。** 在管理页面上，运行 **Sync and apply** 之前，勾选 **自动启用受支持字段**。General Translation 会更新你的 Storyblok 组件 schema，将受支持的 `text`、`textarea`、`markdown`、`richtext` 和 `table` 字段设为 `translatable: true`。已经标记为可翻译的字段不会变动，结果摘要中还会显示更新了多少个字段和组件。

b) **在 Storyblok 中编辑 schema。** 在 Storyblok 的 Block Library 中，打开一个组件，选择一个字段，然后开启它的可翻译选项。对每个你想翻译的字段重复此操作。

*注意：自动启用会写入该 space 中的所有组件，不仅限于你所选 stories 中的组件。*

## 重新打开集成 [#reopen]

如需继续执行更多翻译，请前往 **项目 > 集成 > 已连接** 重新打开该集成。底层的组织连接记录显示在 **组织 > 连接** 下。

## Next steps

- /docs/integrations/storyblok/guides/translating-content
- /docs/integrations/storyblok/guides/managing-translations
- /docs/integrations/storyblok/guides/using-translated-content

## Sitemap

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