使用 Phrase 翻译动态片段,例如通常存储在数据库中的博客文章或产品信息。
设置
项目
将动态内容的翻译保存在一个单独的项目中,与已用于处理静态翻译的项目并列。根据动态内容的数量,为不同的内容类型创建单独的项目,例如 My Project - 博客文章和 My Project - 产品。
键结构
由于所有内容都以键值对形式组织,因此请为动态内容确定一种键结构。在键名中包含来自数据库的唯一标识符:
-
products.10.name
-
products.10.description
-
products.10.summary
-
products.11.name
-
products.11.description
-
products.11.summary
-
等。
根据动态内容的数量和性质,使用 tagging 来进一步优化键结构。
同步流程
如果需要频繁同步动态内容翻译,请编写一个脚本来处理内容的上传和下载,并在必要时运行,例如每天一次或由 webhook 事件触发。
上传内容
对于快速的初始上传,只需将键和原文内容渲染为简单的 .CSV 或 .JSON 文件,然后使用 push command 或 upload endpoint 直接上传即可。
若要提供更多上下文数据(如截图和描述),请直接使用 keys endpoint 创建键条目,随后附加 translation entries。
更新内容
仅在 Phrase 中处理已翻译的原文内容版本,并仅在数据库中直接修改原文内容。这消除了直接在数据库中修改内容时可能出现的版本冲突。
获取翻译
对于简单的使用场景,请使用 pull 命令 或直接通过 下载端点 下载动态内容。指定任何最适合的格式,但请使用易于解析的格式,例如 .CSV 或 .JSON。
对于更高级的设置,请直接使用 API 访问所有翻译条目。
在检索每个区域的翻译后,将每个键和区域的内容存储在数据库中。