第 22 期 · M4 翻译覆盖与系统状态
· 阅读需 3 分钟
M4 第三部分:后台多了"翻译"和"系统状态"两页。站长可以改写界面上的任何文字,也能一眼看出服务器哪里需要处理。
翻译覆盖(ADR 0031)
BS 用 language_lines 表让站长改文字。设计文档原本也规划了一张 translation_overrides 表,最后改成放在设置 i18n.overrides 里:
- 设置本来就能热加载到所有节点和已打开的页面,修改也会写进审计日志;
- 改写的文字一般只有几十条,单独建表还得给 SQLite、PostgreSQL、MySQL 各写一份迁移,换不来什么。
bootstrap 只带访客语言的那一份,前端把它覆盖到自带的消息上。只替换已经存在的文字:键名写错,或者改版后某条文字被删了,都只是不生效,不会让页面报错。覆盖时复制沿途的对象,不改动所有请求共享的消息模块。
翻译页可以按键名或文字搜索,分语言改写。原文里花括号中的占位符(例如 登录到 {site} 里的 {site})要原样保留,漏了或者花括号不成对都不能保存,服务端也会检查花括号。
目前只覆盖网页界面。邮件、兼容 BS 的接口提示和启动器登录的错误信息由服务端生成,以后后端接入消息目录时再加。
系统状态
GET /api/v1/admin/status 和后台页面显示:
- 服务端:版本、Go 版本与系统、运行方式、启动时间;
- 数据库:类型与版本、迁移版本、响应时间。BS 会显示数据库用户名,这里连接串、用户名和文件路径都不显示;
- 材质存储:存储方式、文件数与占用空间;
- 后台任务:等待中、超时、已失败的数量;
- 邮件与配置。
最上面是检查结果:数据库、迁移、任务积压、任务失败、邮件、站点地址,有问题的会说明影响。数据分别由数据库、迁移、任务队列、统计模块提供,接口只负责汇总;后台概览的存储统计也改用同一个函数。
验证
- 新测试:翻译覆盖的校验与 bootstrap、系统状态接口(包括积压任务的告警,以及不泄露数据库位置);前端的覆盖合并、占位符检查与清理。
go fmt、go vet,完整的go test ./...(SQLite 与 PostgreSQL);前端类型检查与单元测试。- 用
skinloom up --dev在浏览器里走了一遍:- 把"皮肤库"改成"皮肤广场"、英文改成"Gallery",页头立即生效,英文访客看到 Gallery;
- 把"登录到 {site}"改成"欢迎回来"会提示缺少占位符、不能保存,改成"欢迎回到 {site}"后登录页显示了站点名;
- 系统状态在没设站点地址、没配邮件时给出两条提醒,其余四项正常,接口里没有数据库文件路径。
仍未验证
- MySQL、staticcheck、govulncheck 交给 CI。
下期计划
M4 第四部分:CDN 刷新与备份。