Storyblok (TMS) 插件可将 Storyblok 内容管理系统与 Phrase 翻译管理系统无缝连接。
此插件能够实现以下功能:
-
将 Storyblok 故事中的内容发送到 Phrase TMS 进行翻译。
-
自动从故事中提取可翻译内容。
-
下载翻译后的内容并将其合并回 Storyblok。
-
跟踪翻译状态并管理工作流。
功能:
-
安全身份验证:
加密凭据存储,支持自动令牌刷新和双重身份验证 (2FA)。
-
项目模板:
使用现有的 Phrase 项目模板来标准化翻译工作流。
-
智能内容提取:
自动识别并仅提取可翻译内容,排除技术字段。
-
工作流集成:
支持 Storyblok 工作流阶段和 Phrase 翻译工作流。
-
实时跟踪:
监控翻译任务状态、工作流进度和完成指标。
-
自动合并:
将翻译后的内容无缝合并回原始故事结构中。
内容提取
该插件可自动识别可翻译内容,同时过滤掉技术字段并保留故事结构。
可翻译内容:
内容通过所有嵌套结构进行递归处理。
-
文本和文本区域字段
-
富文本内容(保留格式)
-
Markdown 内容
-
字符串值 ≥ 2 个字符
-
数组和对象中的嵌套内容
自动排除:
提取器可智能识别 40 多种技术字段类型,包括 Storyblok 核心字段、富文本结构节点、资产元数据、链接配置和翻译系统字段,以确保仅将人类可读的内容发送以供翻译。
-
核心字段:_uid、_editable、component
-
ID:uuid、id、parent_id 等。
-
路径:slug、full_slug、path
-
URL:filename、url、cached_url、src、href
-
时间戳:created_at、published_at
-
布尔值:published、is_startpage
-
富文本结构:类型、标记、属性
-
资产字段:字段类型、焦点、内容类型
-
链接字段:链接类型、目标、锚点、电子邮件
-
翻译系统:语言、备选方案、已翻译的别名
要使用此插件,需要一个具有相应权限的 Phrase TMS 账户和一个API 令牌。API 令牌采用 AES-256 加密并安全存储。从 API 获取的JWT令牌每 24 小时自动刷新一次,以保持安全访问,并设有五分钟的缓冲时间。
如果出现身份验证错误,请确保令牌正确且未被撤销,访问的是正确的数据中心,令牌具有正确的权限,并且账户具备正确的角色。
如果令牌已过期,可能需要通过点击断开 Phrase并重新连接来进行重新身份验证。
-
使用 Phrase TMS 进行身份验证:输入 API 令牌并选择一个数据中心(欧盟或美国)以连接到 Phrase TMS。
-
选择要翻译的故事:浏览 Storyblok 空间并选择要翻译的故事。
-
创建翻译项目:定义源语言、目标语言、截止日期,并可选择使用项目模板。可以同时选择多个故事。
如果无法创建翻译项目,请确保权限设置正确、至少选择了一个故事、源语言和目标语言有效,并且已获得模板访问权限。
-
内容自动提取:插件会自动提取可翻译内容(文本、富文本、Markdown),同时保留其结构。
-
上传至 Phrase:内容被上传至 Phrase TMS 作为翻译 任务,每个故事与语言的组合对应一个任务。
-
在 Phrase 中进行翻译:译员 在 Phrase 中处理内容,并按工作流阶段推进。
-
合并并发布:翻译内容被合并回 Storyblok 故事中,准备发布。