跳转到内容

翻译贡献指南

StudioCMS 是一个全球化项目,我们致力于让所有人都能使用它。如果您精通多种语言,欢迎帮助我们将 StudioCMS 翻译成您的母语。

开始翻译前,请先加入我们的 Discord 聊天室^

加入 Discord 意味着您可以:

  • 实时获取问题解答
  • 与其他译者协调工作,避免重复劳动
  • 参与 i18n 讨论和样式指南制定
  • 学习最佳实践并参与决策

当前翻译状态:

翻译状态

访问我们的 i18n 控制面板^帮助翻译 StudioCMS 核心包。如果您的语言未列出,可直接在控制面板中添加。

翻译文件位于 packages/studiocms/src/lib/i18n/translations^ 目录。英文参考文件为 en.json^

无论通过 Crowdin 还是 GitHub 贡献,信息都会自动同步并在下个版本发布。

所有 StudioCMS 包使用 Crowdin^ 管理翻译。新手可查阅 Crowdin 官网的译者指南^

翻译添加后,将被集成到 StudioCMS i18n 配置^中。

StudioCMS 正在积极将文档翻译成多种语言,当前重点语言包括:

  • 西班牙语
  • 法语
  • 德语
  • 韩语

衷心感谢社区译者的无私奉献!由于新增语言需要组建团队维护多代码库,我们优先支持已有翻译团队的语言。

访问翻译追踪器^查看实时状态:

  • 页面更新状态
  • 需要修改的内容
  • 待审核的 PR

或在 GitHub 直接操作:

  1. 按 i18n 标签筛选您语言的 PR
  2. 检查拼写和翻译准确性
  3. 提交审核意见

文档仓库包含三类可翻译内容:

  • 文件夹src/
    • 文件夹content/
      • 文件夹docs/ MDX 页面内容(按语言分目录)
        • 文件夹de/
        • 文件夹en/
        • 文件夹es/
      • 文件夹i18n/ UI 字符串翻译(按语言分文件)
        • de.json
        • en.json
        • es.json
    • 文件夹starlight-sidebar/ 侧边栏翻译(按语言分文件)
      • de.json
      • en.json
      • es.json
  • astro.config.ts
  • package.json

按内容类型定位文件:

  1. 页面内容(标题、正文等) ➤ src/content/docs/{语言代码}/{页面标识}.mdx

  2. 共享文本(搜索框、右侧边栏、“下一篇文章”链接等) ➤ src/content/i18n/{语言代码}.json

  3. 主侧边栏翻译src/starlight-sidebar/{语言代码}.json

当你找到目标文件后,请先查阅翻译追踪清单^和现有PR——可能已经有人在进行翻译。若确认无人认领,请立刻在Discord的docs-i18n频道招呼一声,千万别重复劳动!