什么是 Content CMS?
Better i18n 的 Content CMS 让你在管理 i18n 键的同一个平台上,管理结构化的多语言内容——文章、博客、帮助文档、产品描述等。
翻译键与内容条目
Better i18n 管理两类内容:
| 类型 | 是什么 | 示例 |
|---|---|---|
| 翻译键 | 代码中使用的短字符串 | auth.login_button = "Sign in" |
| 内容条目 | 带丰富正文的结构化文档 | 一篇完整的帮助文章或博客 |
大多数应用两者都用:界面文案用翻译键,长内容用内容条目。
Content CMS 提供什么 #
- 内容模型 — 定义内容类型的结构(自定义字段、字段类型、本地化字段)
- 条目 — 创建并管理每一条具体内容
- 多语言 — 每个条目都可以拥有项目全部语言的译文
- 读取 API + 边缘缓存 — 内容由
https://content.better-i18n.com提供,在边缘缓存,发布时自动清除 - MCP 工具 — AI 智能体可以直接创建、翻译和发布内容
- 版本历史 — 模型可以为每次保存保留一个修订版,便于回看某种语言此前的内容
内容如何到达你的应用
Code
面板 / MCP 智能体
→ 创建或编辑带译文的条目
→ Publish
→ Content API 缓存被清除,开始提供新版本
→ 你的应用在运行时拉取无需重新构建。一经发布,内容更新立即生效。
请留意各个入口的职责:面板和 MCP 写入内容;Content API 只负责读取。你的应用持有的密钥只能获取内容,不能做别的。
Content API 端点 #
Code
https://content.better-i18n.com/v1/content/{org}/{project}/models/{model}/entries示例:
Bash
curl "https://content.better-i18n.com/v1/content/acme/docs/models/help-article/entries?language=en&status=published" \
-H "x-api-key: YOUR_API_KEY"两个能省下一张工单的细节:鉴权使用 x-api-key 请求头(不是 Authorization: Bearer),并且 API 不会自动按状态过滤——不加 status=published 时草稿也会一并返回。
适合谁使用?
Content CMS 适用于:
- 文档站点 — 帮助中心、知识库
- 营销内容 — 落地页、博客文章
- 产品内容 — 功能说明、更新日志
- 动态内容 — 任何你希望不重新部署就能更新的内容
Better I18N