better-i18n.com
开发者文档帮助中心更新日志

如何启用 CMS 并创建第一个内容模型？

更新于 Aug 21, 2026

Content CMS 是一个可选组件，用于在 i18n 键之外管理结构化的多语言内容——博客文章、帮助文章、更新日志、产品描述等。

你需要 Content CMS 吗？ #

Content CMS 面向结构丰富的自由格式内容。如果你在代码中管理的是 t('key') 字符串，那由 Translation API 负责，不需要 CMS。

在以下情况使用 Content CMS：

  • 带 markdown 正文的文章或文档
  • 含自定义字段的内容（作者、日期、分类）
  • 需要分别管理的多个语言版本
  • 通过 API 或 CDN 分发、而非打包进应用的内容

第 1 步：启用 Content CMS #

  1. 在面板中打开你的项目
  2. 点击 Content 标签页
  3. 如果尚未启用，点击 “Enable Content CMS”

Content 标签页在所有套餐中都可用。部分高级功能（自定义模型、批量操作）可能需要更高套餐。

第 2 步：创建第一个内容模型 #

内容模型就是这一类内容的结构定义，可以类比数据库的表定义。

  1. 在 Content 标签页点击 “New model”
  2. 填写名称（例如 “Help Article”）和 slug（例如 help-article）
  3. 添加自定义字段：
    • Text — 短字符串（标题、作者）
    • Textarea — 较长文本（摘要、简介）
    • Number — 整数或小数
    • Boolean — 真/假标记
    • Enum — 从固定取值列表中选择的下拉框
    • Relation — 指向另一个内容模型的引用
  4. 对需要按语言翻译的字段，打开 “Localized”
  5. 点击 Create model

有一个模型级设置值得现在就定下来，而不是留到以后：该模型的条目是否带正文。带正文的模型（文章、帖子）要求某个语言必须有非空内容，才能发布该语言。纯元数据模型——标签、分类及其他分类法——仅凭字段即可发布。

第 3 步：创建第一条内容 #

  1. 在 Content 标签页选中你的模型
  2. 点击 “New entry”
  3. 填写标题、正文和自定义字段
  4. 点击 Save 或 Publish

发布之后，即可通过 Content API 获取该条目：

Bash
curl "https://content.better-i18n.com/v1/content/your-org/your-project/models/help-article/entries?status=published" \
  -H "x-api-key: YOUR_API_KEY"

后续步骤