HTML ruby 标签无法支持藏文、蒙文等少数民族文字的注音，因其依赖静态结构而无法触发OpenType连字与重定位特性；仅适用于汉字转写读音、简短词义标注等无需文字变形的轻量场景。
HTML ruby 标签本身不支持自动适配少数民族文字注音逻辑，必须手动构造结构并配合 CSS 与字体支持才能实现可用效果。
为什么直接用 ruby 显示藏文/蒙文注音会失败
浏览器对 ruby 的渲染依赖于基础排版引擎（如 HarfBuzz）和系统字体对「注音位置」的定义。藏文、蒙古文、维吾尔文等文字的注音（如藏文的“加字”、蒙文的“前缀标音符号”）不是简单地“在上方标注”，而是与基文字母存在严格的连字（ligature）、上下文重定位（contextual repositioning）关系。ruby 只提供 rb（基字）、rt（注音）、rp（括号 fallback）三层静态包裹，无法触发这些文字所需的 OpenType 特性（如 abvs、blws、pres 等）。
常见错误现象包括：
- 注音符号堆叠在基字左侧或右侧，而非预期的上方/左上角
- 基字与注音之间出现异常空隙或重叠
- 使用系统默认中文字体时，藏文注音显示为方块或乱码（字体无对应 glyph）
ruby 在实际少数民族文本中能用在哪类场景
它只适用于「语义明确、位置固定、无需连字干预」的轻量级标注，比如：
立即学习“前端免费学习笔记（深入）”；
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 给汉字转写的少数民族人名加拉丁字母读音（如
<ruby>扎西<rt>Zaxi</rt></ruby>） - 在维吾尔文正文中插入简短汉语词义说明（
<ruby>ئەپىل<rt>苹果</rt></ruby>），前提是字体支持 Uyghur + Han 混排且rt足够窄 - 教学材料中对单个蒙古文音节做音标标注（如
<ruby>ᠠ<rt>[a]</rt></ruby>），不涉及词内变形
注意：ruby 对藏文「སྐྱེས་པ」这类带前加字、上加字、下加字的复合字形完全无效——你不能把「ཀྱེས」拆成三个 rt 去套，浏览器不会按藏文书写规则重新排列。
真正可行的替代方案：CSS + font-feature-settings + 手动 markup
要让藏文、蒙文等实现符合规范的注音效果，必须绕过 ruby，改用以下组合：
- 用
span包裹基字和注音内容，通过position: relative / absolute控制注音层位置（例如藏文注音常需top: -0.8em） - 启用字体 OpenType 特性：
font-feature-settings: "abvs" on, "blws" on（针对藏文）；"mgrk" on（针对蒙文） - 指定支持该文字的字体栈，例如藏文必须用
Noto Sans Tibetan或Microsoft Himalaya，不能依赖默认serif - 对维吾尔文等从右向左文字，还需设置
direction: rtl和unicode-bidi: embed防止顺序错乱
示例（藏文前加字注音）：
<span class="tibetan-annotated"> <span class="tibetan-base">སྐྱེས</span> <span class="tibetan-annotation">སྐྱེས</span> </span>
CSS 中需明确定义 .tibetan-annotation 的 position、font-size（通常为基字的 70%）、line-height（避免行高挤压）。
最易被忽略的一点：没有一个通用 CSS 属性能自动识别「这是藏文注音还是蒙文注音」。每个文字系统都需要单独测试字体渲染行为、测量像素偏移、验证 OpenType 特性是否生效——哪怕用了同一套 HTML 结构，换一种文字就得重调一遍 CSS。
