HTML多音字标注应保存为UTF-8编码的.html文件，确保ruby标签语义完整、声调字符正确显示，避免使用BOM、.htm、.xhtml或浏览器“另存为”等易导致乱码或语义丢失的方式。
HTML 多音字标注本身不涉及特殊保存机制，直接存为 .html 文件即可；关键在于源码是否符合规范、能否被浏览器正确解析和渲染。
保存时必须用 UTF-8 编码，否则声调字符会乱码
带声调的拼音（如 ā、ě）是 Unicode 字符，不是 ASCII。如果用 ANSI 或 GBK 编码保存，ā 会被截断或显示为问号/方块。
- 在 VS Code、Sublime Text 等编辑器中，保存前务必确认右下角状态栏显示「UTF-8」，不是「GBK」或「ISO-8859-1」
- 若用记事本，「另存为」时编码下拉菜单必须选「UTF-8」，**不能选「UTF-8-BOM」**——BOM 会在文件开头插入不可见字节，某些构建工具或服务端解析可能报错
- 检查方式：用命令行运行
file -i your.html（Linux/macOS）或用 VS Code 打开后看右下角编码标识
.html 是唯一推荐格式，别用 .htm 或其他后缀
虽然浏览器大多兼容 .htm，但现代工具链（如 Vite、Webpack、Jekyll）默认只识别 .html 为页面入口；且 .htm 容易在团队协作中引发路径拼写不一致问题。
DeepBI DHTML 页面生成器
下载
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
- 服务器或 CDN 不会因后缀不同而改变对
ruby标签的处理逻辑 - 不要为了“看起来简洁”而用
.xhtml——它要求更严格的 XML 语法（如所有标签闭合、属性加引号），徒增出错概率 - 如果项目已用
.php或.ejs模板，注音 HTML 片段仍应原样写在模板里，由服务端输出为标准text/html响应
多音字标注内容不能靠「另存为网页」浏览器功能保存
Chrome/Firefox 的「另存为网页（完整）」会把 ruby 结构转成图片或内联样式，彻底丢失语义和可访问性。
立即学习“前端免费学习笔记（深入）”；
- 这种保存方式生成的是静态快照，
<ruby><rb>长</rb><rt>Cháng</rt></ruby>可能变成一堆div+position: absolute，拼音无法被读屏软件识别 - 后续修改只能重做，无法复用原始结构
- 正确做法：始终从源代码编辑器保存，而非从浏览器“另存为”
真正容易被忽略的是：**多音字标注的“保存”本质是维护源码结构完整性**——只要 ruby 成对、rb 和 rt 顺序严格、编码无误，无论存在本地硬盘、Git 仓库还是 CI 构建产物中，渲染结果都一致。声调字符、空格、全角标点这些细节，比文件名后缀重要得多。
