多音字必须人工结合语境逐字标注拼音，ruby标签不识别语义、不处理变调，错误示例为脱离语境的单字注音，正确做法是按词语确定读音并严格一一对应，轻声不标调，禁用斜杠混排，专有名词需词库模式+人工校验。

多音字不能靠自动拼写规则解决，必须人工判断语境后手动标注——ruby 标签本身不识别“一”在“一个”里读 yí，它只忠实地渲染你写的 内容。

多音字必须按上下文逐字指定拼音

浏览器和读屏软件不会推理语义，ruby 也不做变调处理。你写什么，它就念什么、显示什么。

• 错误写法：一yī（脱离语境，无法体现“一个”中的实际读音）
• 正确做法：根据句子确定读音，再写对应拼音，例如“一个”应拆为 一yí个gè
• “长”字需分场景：“长度”→ 长cháng，“长大”→ 长zhǎng
• 轻声不标调号：“妈妈”是 妈mā妈ma，不是 mā mā

避免用斜杠或括号混排多音选项

像 fǒu/pǐ 这种写法看似省事，实则破坏语义结构，语音引擎会朗读斜杠和字母，屏幕阅读器可能跳过整个 rt 或报错。

DeepBI DHTML 页面生成器

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

下载

• 语义上，rt 表示“此处汉字的读音”，不是“可能的读音列表”
• 若需提示多音，应在 ruby 外加说明文字或 title 属性，例如：否pǐ
• CSS 不支持对 rt 内容做条件渲染，无法用 :lang() 或伪类切换拼音

动态生成时别让拼音库“猜读音”

用 pinyin-pro 或 pinyin-js 自动生成拼音时，默认行为常按单字本音输出，比如把“重庆”的“重”固定转成 zhòng，但实际应标 Chóngqìng。

• 务必开启词库模式（如 pinyin-pro 的 mode: "word"），并传入完整词语而非单字
• 对专有名词、古文、方言词，必须人工校验结果，不能全信自动输出
• 生成 HTML 时，确保每个汉字严格对应一个 rt，避免出现 重庆Chóngqìng（词级）与 重chóng庆qìng（字级）混用

最易被忽略的是：多音字标注不是技术问题，而是语言判断问题。哪怕 ruby 结构完全合法，拼音错了，整段注音就失效了——它不报错，只是默默读错。

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