入口:总览 → 内容管理 →「国际化」。读取需 config:read,修改需 config:write。本模块维护消息字典,不会自动把普通页面正文翻译成另一种语言。
准备语言站点#
先在 站点管理 为每个站点选择语言区域,例如中文站 zh-CN 与英文站 en-US。国际化表格按语言显示列,顶部覆盖率按已配置语言站点统计。
新增词条并填写翻译#
- 点击「新增词条」。
- 在「词条 key」输入稳定标识,例如
common.submit,移开焦点。 - 在各语言列填写翻译,例如中文「提交」、英文「Submit」。
- 每个翻译输入框在失去焦点时保存,没有整页统一保存按钮。 填完最后一个单元格后点击其他区域。
- 重新进入模块,确认词条和翻译仍然存在。
新词条仅填 key 而没有保存任何语言值时,可能不会成为持久记录。已有 key 以文本显示,当前界面不提供重命名;需要改名时新建 key、更新引用,再删除旧项。
在页面中使用#
支持国际化引用的组件模板使用 ${i18n.common.submit} 读取该 key。发布页按站点语言渲染对应翻译。
内容编辑人员应先确认组件包已经引用字典,再维护翻译。直接在普通正文里输入这种表达式不一定会被当作模板求值;是否支持取决于组件包。
检查覆盖率#
覆盖率显示每种语言的已翻译数、词条总数和未翻译数。补齐后重新加载查看。数量齐全不代表翻译准确,还要在对应语言站点预览,再重新发布需要更新的页面。
没有语言列或覆盖率为空时,先检查站点语言、权限和服务加载情况。
修改与删除#
修改翻译后移开焦点保存,再刷新核对。点击词条行的垃圾桶并确认,会删除该 key 的所有语言翻译;引用该 key 的组件可能显示缺失值,应先更新模板引用。
常见问题#
- 显示「key 已存在」:改用新 key,或直接编辑现有翻译。
- 刷新后翻译没有保存:确认移开焦点,检查权限与网络。
- 前台还是旧语言:检查站点语言、模板是否引用字典,并重新发布。
- 需要翻译整页正文:为另一语言站点建立并编辑对应页面,字典只负责被引用的消息。