多音字必须人工指定拼音，ruby仅负责呈现不分析语境；需逐字标注、用Unicode声调符、确保UTF-8编码与支持字体；一字一ruby保证对齐；rp标签提供旧浏览器fallback。

多音字必须人工指定拼音，ruby 不会自动判断语境

浏览器的 ruby 标签只负责呈现，不参与语义分析。它不会读上下文，也不会调用分词模型——“长”在“长度”里是 cháng，在“长大”里是 zhǎng，这个决定必须由你手动写进 里。

常见错误是直接丢一整段文字进去，指望自动出拼音，结果要么全错，要么漏标。比如：长大zhǎng dà 是对的；但写成 长大cháng dà 就违背语义，工具不会帮你纠错。

• 多音字标注前，先通读原文，确认每个字在此处的实际读音
• 避免依赖“自动拼音库”直接塞进 rt，除非你已用 pinyin-pro 等库预处理并人工核验过
• 轻声字（如“妈妈”的第二个“妈”）要写成 mā ma，不能加调号；儿化音（如“花儿”）统一写作 huār，不是 huā ér

声调符号要用 Unicode 字符，别用数字后缀

想让拼音带正确声调，得用 Unicode 声调符（如 ā、á、ǎ、à），而不是写成 zhang1 或 chang2。后者在 ruby 中会被原样显示，不会渲染成上标声调。

输入方式取决于你的编辑环境：搜狗/讯飞输入法可调出软键盘选声调字母；VS Code 可装拼音插件；Mac 用户可用「字符检视器」搜索“a with macron”快速插入。

• 确保网页 里有 ，否则声调符号可能乱码
• 字体要支持 Unicode 声调区（如 Noto Sans CJK、Microsoft YaHei、PingFang SC），不要用 Courier New 这类无中文支持的字体
• 别混用全角空格或中文标点进拼音字符串，例如 nǐ ？ 会导致排版错位

一字一 ruby 是唯一可靠对齐方式

把整词包一层 ruby（如 中华人民共和国Zhōnghuá Rénmín Gònghéguó）看似省事，但拼音和汉字无法逐字对齐，尤其在换行、缩放或小字号下极易错位。

DeepBI DHTML 页面生成器

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

下载

真正稳定的做法是每个汉字单独套 ruby：中Zhōng华huá人rén…。虽然代码量翻倍，但浏览器能精确控制每个拼音的位置。

• 分词要按语义单位切，不是机械按字——“中华人民共和国”应拆为“中华/人民/共和国”，每词内部再逐字处理
• 避免在 ruby 内部加
或 display: block，这会破坏默认的 ruby 对齐逻辑
• 如需微调拼音字号，用 ruby rt { font-size: 0.65em; }，别碰 ruby 自身的宽高或 margin

rp 标签不是摆设，旧环境 fallback 很关键

如果你的页面还需兼容 IE9 或老安卓 WebView， 就不是可选项。没它的话，这些浏览器会把 当普通文本直接显示在汉字后面，变成“汉hàn”，完全不可读。

标准写法是成对使用：汉(hàn)。现代浏览器会隐藏 rp 内容，只显示拼音；老浏览器则退化为“汉(hàn)”，至少保住了可读性。

• 漏掉 rp 在新环境看不出问题，但一旦用户用旧设备打开，就是硬伤
• rp 必须紧邻 rt，顺序不能错：必须是 ………
• 不要给 rp 加样式，它的唯一作用就是提供括号 fallback

实际最难的从来不是写对标签，而是确认每个字在当前语境下的真实读音——机器可以拼出一百种可能，但只有一个是语文老师点头的那个。

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