模板:Ruby/doc
此模板允許您為特定文本添加一段小字標註，常用於中文拼音標註、日文漢字標註假名、韓文標註漢字成語等，也可以用於
使用方法
{{Ruby|文字|上方小字|
文本语言标签|音标语言标签}}
使用示例
| 代碼 | 效果 | 說明 |
|---|---|---|
{{Ruby|注|zhù}}{{Ruby|音|yīn}} |
為中文添加拼音標註。 | |
{{Ruby|運命|さだめ}} |
為日文漢字標註假名。 | |
{{Ruby|超电磁炮|レールガン}} |
將單詞翻譯為另一種語言。 | |
{{Ruby|충|忠}}！{{Ruby|성|誠}}！ |
韓文標註漢字。 | |
A bicycle can't stand on it's own because it is {{Ruby|two-tyredmeet|too tired}}. |
A bicycle can't stand on it's own because it is |
玩一個小笑話。 |
注意事項
模板本身
- 此模板不能自身嵌套多層，否則會導致錯誤。
- 請儘量避免使用此模板排版長句內容和翻譯，標註單詞時請使用最短單位（如單詞或音節）進行排版。過長的排版可能導致窄屏設備換行異常；此模板並非專為翻譯內容設計。如需原文與翻譯同時出現，請考慮直接使用括號標明。
請不要不要不要不要不要不要不要不要 這樣排版。
瀏覽器支持
目前僅部分瀏覽器支持此模板的樣式。使用前請注意瀏覽器兼容性。
- 如果您看到文字上方有較小的標註文本，說明您的瀏覽器支持此樣式。
- Firefox 34~37 可通過打開
about:config頁面，設置layout.css.ruby.enabled參數為true以啟用標註效果。
- 參考：
表格樣式
- 問題描述：
在表格、li等元素中使用此模板可能導致某些對齊問題，這是由於渲染方式引起的。當列中元素數量不一致時，不同的寬度分配方式會導致不同的高度分配（webkit 會為塊元素提供合理的空間）。此問題僅在寬度自動分配時發生。如果指定寬度，則不會出現此問題。
在如{{LyricsKai}}等模板中也會出現類似問題，尤其是依賴表格的模板。例如左列和右列的對應行未同時使用 ruby 時會出現此問題。
| 標題文字 | 標題文字 | 標題文字 |
|---|---|---|
| 100px 寬度，換行時觸發異常 | 150px 寬度 | |
| 100px 寬度 | 附加 div 標籤後
|
- 解決方法：
在 Ruby 外加一個 div 標籤。
{| class="wikitable"
|-
! 标题文字 !! 标题文字 !! 标题文字
|-
| width=100px|100px 宽度，换行时触发异常 || width=150px|150px 宽度 || {{ruby|示例|测试}}：Ruby 标记，自动调整宽度，显示异常，单元格会向上浮动几个像素。
|-
| 100px 宽度 || {{ruby|示例|测试}}：150px 宽度。如果指定宽度则不会触发异常 || <div>附加 div 标签后 {{ruby|示例|测试}}：Ruby 标记自动调整宽度，正常显示。</div>
|}