关于使用旁注标记的维基百科模板，请见"**Template:Ruby**"。

|  |  |
| --- | --- |
|  | 本頁面使用HTML注音，若瀏覽器不，注音會顯示在文字後方，如：衣（）。 |

**注音**（英語：，日语：，羅馬化：*rubi*），或稱**注音標示**、**加注音**、**标拼音**，是替漢字標音的方法，廣泛地運用於日文及中文的印刷以及電腦排版。一般這些字是放於表意文字的上方或右邊，作為文字的拼音或註解。

在中文裡，通常使用漢語拼音或注音符號來注音（在台灣標註的多為注音符號，在中国大陆则多为汉语拼音），但一般不在報章等一般或圖書使用注音，通常只用於小學的教科書、辭典、或儿童刊物等。由於中國大陆通常中文只用橫寫，所以一般只見上方的注音。台灣橫直寫均用，一般兒童讀物多直寫，注音也標示在右方為主。例如台灣每日發行的《國語日報》，所有的報導文章都標示注音符號。

名称
--

「Ruby」或「rubi」是日本印刷業的用語，非術語的稱呼則是振假名（日语：*ふりがな*）。Ruby原指5.5級的字体格式，在美国又称Agate，它的大小正好适合注音。现在在日文中，这词不再表示字体的名称，而是表示名词形式的標音。当它被翻译回英文时，它被称为**rubi**，但是Ruby的拼法还是比较普遍。

用途
--

在书写日文和中文时，有些单字的发音经常被标注在字的上方或右方。它们不止用于印刷品，也可用于手写中。这可能由于以下几种原因：

* 因为这个字是生僻字，很多人不知道发音
* 因为这个字有多种发音，且不能从上下文中推测
* 因为这篇文章是给儿童或外语学习者看的，他们对发音不太了解
* 在日语的笑话和漫画中用于强调，通常是双关语，中國大陸和台灣亦有類似的注音文[來源請求]。
* 在日语中，使用一个不熟悉的外来语或俚语，注音是为了表示它的含义，而且这些字和意思没有关系，通常使用假名

除了漢字以外，一些片假名寫成的外來語也可能使用注音標示原文。

範例
--

以下的例子將會使用平假名、片假名、罗马字注示日语中的「東京」：

| 平假名 | 片假名 | 日語羅馬字 |
| --- | --- | --- |
| 

|  |  |
| --- | --- |
|  |  |
|  |  |

 | 

|  |  |
| --- | --- |
|  |  |
|  |  |

 | 

|  |  |
| --- | --- |
| Tō | kyō |
|  |  |

 |

以下的例子將會使用注音符號、小儿经与汉语拼音注示汉语中的「北京」：

| 注音符號 | 小儿经 | 汉语拼音 |
| --- | --- | --- |
| 

|  |  |
| --- | --- |
|  |  |
|  |  |

 | 

|  |  |
| --- | --- |
| ‎ | ‎ |
|  |  |

 | 

|  |  |
| --- | --- |
|  |  |
|  |  |

 |

以下的例子將會使用諺文与羅馬字注示韩语中的「韩国」：

| 諺文 | 韓語羅馬字 |
| --- | --- |
| 

|  |  |
| --- | --- |
|  |  |
|  |  |

 | 

|
|  |
| Han | guk |
|  |  |

 |

以下的例子使用越南語字母注示越南语中的"河内"：

| 越南語字母（） |
| --- |
| 

|  |  |
| --- | --- |
| Hà | Nội |
|  |  |

 |

HTML注音
------

2011年，W3C發佈XHTML注音功能（稱為「旁註標記」），這個功能不是HTML 4.01的一部分或XHTML 1.0規格（XHTML-1.0-Strict、XHTML-1.0-Transitional，以及XHTML-1.0-Frameset）中的任何一部分，而是XHTML 1.1規格中的其中一部分，并且作為HTML5規格的核心部分由W3C完成制定。

Ruby標籤得到微軟Internet Explorer（5.0及以上）和Google Chrome以及Mac的Safari的部分支援，但Konqueror和Opera（15.0版本之前）都不支援Ruby標籤。WebKit nightly版在2010年1月添加Ruby标签支持，Safari在5.0.6版加入该功能，Mozilla Firefox 38也提供支持。

在Ruby标签未受广泛支持的情况下，可以通过使用CSS来实现。

Ruby标签也可以添加到允许自定义扩展的浏览器当中。

Ruby标签经结构化以达到向后兼容，以在主要文本后面包含在括号中的旁注字符组成，会在不支持ruby标签的浏览器里面显现出来。

W3C还为CSS level 2制定ruby模块，能允许额外自动分组和自动略去与注释对象相同的假名。当前仅有Firefox 38提供支持。

### 範例


|  | XHTML | CSS level 2 |
| --- | --- | --- |
| 标记 | 
```
<ruby> 
東京 <rp>(</rp> <rt>とうきょう</rt><rp>)</rp>
</ruby>

```
 | 
```
<ruby>
北 <rp>(</rp><rt>ㄅㄟˇ</rt><rp>)</rp>
京 <rp>(</rp><rt>ㄐㄧㄥ</rt><rp>)</rp>
</ruby>

```
 | 
```
<ruby>
<rbc><rb>振</rb><rb>り</rb><rb>仮</rb><rb>名</rb><rp>(</rp></rbc>
<rtc><rt>ふ</rt><rt>り</rt><rt>が</rt><rt>な</rt><rp>)</rp></rtc>
</ruby>

```
 |
| 显示 | 
京(
とうきょう)
 | 
北(ㄅㄟˇ)
京(ㄐㄧㄥ)
 | 
振(ふ)り仮(が)名(な)

通常情况下，上面的代码需要CSS样式得到该效果，否则显示如下。 |
| 未解析 | 京（とうきょう） | 北（ㄅㄟˇ）京（ㄐㄧㄥ） | 振り仮名（ふりがな） |

注意：并不是所有的浏览器都可以正常浏览Ruby字符，如果您的浏览器不支援，可能會以括號的方式顯示出注音的部分。

Unicode注音
---------

Unicode和通用字符集透過行间注释（interlinear annotation）符号来顯示注音功能：

* `U+FFF9`—Interlinear annotation anchor—标记要注释的文字
* `U+FFFA`—Interlinear annotation separator—注释文字的开头
* `U+FFFB`—Interlinear annotation terminator—注释文字的结尾

用法如下所示：

* 
* `U+FFF9``U+FFFA`ㄊㄞˊ`U+FFFB``U+FFF9`北`U+FFFA`ㄅㄟˇ`U+FFFB`

结果为：

* 
* ￹￺ㄊㄞˊ￻￹北￺ㄅㄟˇ￻

只有少数程序支持这个功能。Unicode技术报告#20说明这些字符不能用于标记语言和应用程序，建议在适当的地方代之以注音。

|  |
| --- |
| **特殊字符**Official Unicode Consortium code chart (PDF) |
|   | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | A | B | C | D | E | F |
| U+FFFx |  |  |  |  |  |  |  |  |  | IAA | IAS | IAT | ￼ | � |  |  |
| **注释**
1.**^** 依据Unicode 15.0
2.**^** 灰色区域表示未分配的代码点。
3.**^** 黑色区域表示非字符（英语：）（保证在Unicode标准中永远不会被分配为编码字符的码位）。 |

参考文献
----

1. ↑  Marcin Sawicki, Michel Suignard, Masayasu Ishikawa, Martin Dürst, Tex Texin.. W3C Recommendation. World Wide Web Consortium. 2001-05-31  [2007-02-14]. （原始内容存档于2021-03-06）.
2. ↑ .  [2014-11-12]. （原始内容存档于2015-08-01）.
3. ↑  Roland Steiner.. Surfin’ Safari. WebKit project. 2010-01-20  [2010-01-21]. （原始内容存档于2010-01-23）.
4. ↑  The ruby element （页面存档备份，存于） - HTML5 Doctor
5. 1 2  Xidorn Quan.. Mozilla. 2015-03-05  [2015-05-05]. （原始内容存档于2021-02-19）.
6. ↑ . Mozilla.org.  [2015-04-10]. （原始内容存档于2015-05-12）.
7. ↑  CSS Ruby支持 的存檔，存档日期2007-02-28.——适用于所有浏览器
8. 1 2  Elika J. Etemad, Koji Ishii.. W3C Editor’s Draft. World Wide Web Consortium. 2015-04-16  [2015-05-05]. （原始内容存档于2015-07-07）.
9. ↑  Martin Dürst, Asmus Freytag.. W3C和統一碼聯盟. 2007-05-16  [2014-05-22]. （原始内容存档于2005-02-19）.

外部連結
----

* W3C: XHTML Ruby註解 （页面存档备份，存于）
* W3C: XHTML 1.1規格 （页面存档备份，存于）
* Rikai.com （页面存档备份，存于） - 可在網頁提供彈出式視窗方閱讀，已在簡體中文及日文中測試