多音字必须人工结合语境逐字标注拼音，ruby标签不识别语义、不处理变调，错误示例为脱离语境的单字注音，正确做法是按词语确定读音并严格一一对应，轻声不标调，禁用斜杠混排，专有名词需词库模式+人工校验。
多音字不能靠自动拼写规则解决，必须人工判断语境后手动标注——ruby 标签本身不识别“一”在“一个”里读 yí，它只忠实地渲染你写的 <rt></rt> 内容。
多音字必须按上下文逐字指定拼音
浏览器和读屏软件不会推理语义，ruby 也不做变调处理。你写什么，它就念什么、显示什么。
- 错误写法：
<ruby>一<rt>yī</rt></ruby>（脱离语境，无法体现“一个”中的实际读音） - 正确做法：根据句子确定读音，再写对应拼音，例如“一个”应拆为
<ruby>一<rt>yí</rt></ruby><ruby>个<rt>gè</rt></ruby> - “长”字需分场景：“长度”→
<ruby>长<rt>cháng</rt></ruby>，“长大”→<ruby>长<rt>zhǎng</rt></ruby> - 轻声不标调号：“妈妈”是
<ruby>妈<rt>mā</rt></ruby><ruby>妈<rt>ma</rt></ruby>，不是mā mā
避免用斜杠或括号混排多音选项
像 <rt>fǒu/pǐ</rt> 这种写法看似省事，实则破坏语义结构，语音引擎会朗读斜杠和字母，屏幕阅读器可能跳过整个 rt 或报错。
DeepBI DHTML 页面生成器
下载
生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面，使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力： - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面； - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”； - 提及位于 `apps/console/src/featur
- 语义上，
rt表示“此处汉字的读音”，不是“可能的读音列表” - 若需提示多音，应在
ruby外加说明文字或title属性，例如：<ruby title="也可读 fǒu">否<rt>pǐ</rt></ruby> - CSS 不支持对
rt内容做条件渲染，无法用:lang()或伪类切换拼音
动态生成时别让拼音库“猜读音”
用 pinyin-pro 或 pinyin-js 自动生成拼音时，默认行为常按单字本音输出，比如把“重庆”的“重”固定转成 zhòng，但实际应标 Chóngqìng。
立即学习“前端免费学习笔记（深入）”；
- 务必开启词库模式（如
pinyin-pro的mode: "word"），并传入完整词语而非单字 - 对专有名词、古文、方言词，必须人工校验结果，不能全信自动输出
- 生成 HTML 时，确保每个汉字严格对应一个
rt，避免出现<ruby>重庆<rt>Chóngqìng</rt></ruby>（词级）与<ruby>重<rt>chóng</rt><ruby>庆<rt>qìng</rt></ruby></ruby>（字级）混用
最易被忽略的是：多音字标注不是技术问题，而是语言判断问题。哪怕 ruby 结构完全合法，拼音错了，整段注音就失效了——它不报错，只是默默读错。
