多音字必须人工判断语境后手动指定唯一读音，因ruby标签不识别语义、不支持条件渲染，rt内容会被语音软件直读为“fǒu slash pǐ”，且需与汉字严格一对一映射；正确做法是依语境选一音标注，并用data-pinyin存备选。

多音字必须人工判断语境后手动指定唯一读音，HTML 的 ruby 标签本身不识别语义、不支持条件渲染、也不接受斜杠分隔的多音写法（如 fǒu/pǐ）。

为什么不能用 rt 写“fǒu/pǐ”这种多音混排？

语音合成器和读屏软件会把 fǒu/pǐ 当作一个字符串朗读，结果是“fǒu slash pǐ”，不是切换读音。浏览器不解析拼音内部结构，rt 只接受纯文本内容，且必须与对应汉字严格一对一映射。

• 错误示例：否 —— 语义模糊，无障碍访问失败
• 正确做法：根据上下文选其一，比如“否极泰来”中固定标为 否pǐ
• 若需保留备选读音，用 data-pinyin 属性额外存一份：否pǐ，供 JS 后续处理或工具提取

常见多音字语境判断参考点

不能靠词库自动匹配，但可借助几个稳定线索缩小判断范围：

• “长”作形容词（长度、长远）读 cháng，作动词（生长、长大）读 zhǎng；作姓氏时也读 zhǎng
• “行”在“银行”“行业”中读 háng，在“行走”“行动”中读 xíng，作姓氏读 Háng
• “重”在“重要”“重复”中读 zhòng，在“重叠”“重新”中读 chóng；地名“重庆”固定读 Chóngqìng
• “发”在“发现”“发展”中读 fā，在“理发”“结发”中读 fà

注意：这些规则仍有例外（如“道行”读 dào héng），最终仍需结合具体词义和权威词典确认。

DeepBI DHTML 页面生成器

生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur

下载

如何让标注更可靠？配合 lang 和结构控制

仅靠 ruby 不足以支撑多音决策，但能提升输出一致性：

• 每个 ruby 块只包一个字或一个不可分割的词（如“重庆”整体标 Chóngqìng，不拆成“重+庆”）
• 整句含多个多音字时，逐字检查并分别标注，避免跨字共用一个 rt
• 外层容器加 lang="zh-CN"，确保语音引擎启用中文 TTS 引擎，而不是强行按英文切音节
• 避免在同一个 ruby 中混入非汉字内容（如数字、英文字母），否则 rt 映射易错位

最麻烦的地方不在写法，而在于判断本身——没有通用规则能覆盖所有文言、方言、专有名词和历史用法。哪怕标对了“乐”在“快乐”里读 lè，遇到“音乐”还得切回 yuè。人工校对仍是不可绕过的环节。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！