多音字必须人工指定读音，浏览器不会自动识别语义；需用规范标注，兼顾新旧环境兼容与排版正确性。

多音字必须人工指定， 不会自动识别

浏览器对 的处理完全静态——它只按你写的结构渲染，不分析语义。比如“长”在“长度”中读 cháng，在“长大”中读 zhǎng， 无法判断上下文，更不会调用词典或分词模型。你写成 长cháng，它就永远显示 cháng。

常见错误是依赖自动注音工具（如 pypinyin）直接输出，结果把“重庆”的“重”标成 chóng（实际应为 zhòng），因为工具默认返回高频读音，没做语境消歧。

• 人工校对不可省：批量注音后务必逐句检查多音字，尤其专有名词、成语、古诗文
• 避免用 Style.TONE3（如 chong2）直接生成 内容，数字声调在旧字体下可能渲染异常，优先用 Unicode 声调符（zhòng）
• 轻声字（如“妈妈”的第二个“妈”）必须手动去掉声调，写成 ma，不能留 ma1 或 mā

标签不是必需的，但加了能明确基字范围

规范允许省略 ，直接写 重zhòng，浏览器会把 开始处到 前的所有文本当作基字。但遇到多音字组合（如“行”在“银行”中读 háng，单独出现常读 xíng），漏掉 容易让结构松散、后续维护困难。

加 能显式圈定基字单元，尤其适合一个 对应多个汉字（如“中华人民共和国”中“中华人民”共用一个拼音 zhōnghuá），此时必须用 包裹全部基字：

<ruby><rb>中华人民</rb><rt>zhōnghuá</rt></ruby>

• 不加 时，中华人民zhōnghuá 在部分老浏览器中可能只把“华”关联到拼音
• 和 必须同级，不能嵌套在 里
• 现代浏览器对 支持良好，IE10+、Chrome 15+、Firefox 3.5+ 均可正常渲染

拼音始终在上方，别试图用 CSS 移动它

的默认行为就是把 渲染在基字正上方（横排）或右侧（竖排），这是由浏览器内建 ruby 排版引擎控制的，不是靠 position: relative 或 top 实现的。强行用 CSS 干预，比如给 rt 设 margin-top 或 transform，会导致换行错位、缩放失准、竖排崩溃。

DeepBI DHTML 页面生成器

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

下载

真正需要微调的场景极少，仅限统一字号或行距：

ruby rt { font-size: 0.7em; line-height: 1.2; }

• 不要给 ruby 元素本身设 width、margin 或 display: block，它没有传统盒模型
• rt 的垂直位置由浏览器自动计算基线偏移，改 line-height 过大会让拼音和基字重叠
• 如果发现拼音离基字太远（比如某些中文字体空隙过大），优先换字体，而不是调 CSS

不是装饰，它决定旧环境是否可读

IE8–9、Android 4.3 WebView 等旧环境不支持 ，会把 当普通文本渲染出来，导致页面出现裸露的拼音（如“重zhòng”），破坏阅读流。 的作用就是兜底：它让这些浏览器只显示括号，把拼音藏进括号里，变成“重(zhòng)”这种格式。

标准写法必须成对出现，且括号内容必须是纯 ASCII 符号：

<ruby>重<rp>(</rp><rt>zhòng</rt><rp>)</rp></ruby>

• 漏掉任一 ，旧浏览器可能显示“重zhòng)”或“重(zhòng”，括号不闭合
• 用中文括号（“（”“）”）或全角符号会导致旧环境解析失败，必须用半角 ( 和 )
• 现代浏览器会自动隐藏 内容，只显示 ，所以加 不影响新环境视觉效果

多音字标注最耗时的环节从来不是写标签，而是判断读音本身； 只负责忠实呈现你的判断，它不替你思考。

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