# General Translation Integrations: 配置 Storyblok
URL: https://generaltranslation.com/zh/docs/integrations/storyblok/guides/configuring-storyblok.mdx
---
title: 配置 Storyblok
description: "如何将 Storyblok space 连接到 General Translation：本指南介绍如何添加凭据并启用可翻译字段。"
related:
  links:
    - /docs/integrations/storyblok/guides/translating-content
    - /docs/integrations/storyblok/guides/managing-translations
    - /docs/integrations/storyblok/guides/using-translated-content

---

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

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

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

* 在 项目 上拥有 `project:write` 权限。否则，**连接** 操作将不可用。
* 使用包含 `project_integrations` 功能的套餐。否则，仪表板中显示的将是升级提示，而不是集成目录，因此你无法连接 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 令牌。

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

如需查看完整的连接设置列表及其存储位置，请参阅[连接设置](/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 中的组件。*

## 管理或断开连接 [#manage-disconnect]

如需继续执行更多翻译，请前往 **项目 > 集成** 重新打开该集成。连接凭据会一直保留在 项目 中，直到该集成被移除为止。当你不再希望 General Translation 访问该 space 时，可在同一处 集成 页面断开连接。
## Next steps

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