模板:Ruby/doc

本模板已應用於50000+頁面。
為避免大規模的破壞及不必要的服務器負荷，任何改動均應先在該模板對應的沙盒頁面或您自己的用戶頁下進行測試，並將測試無誤的代碼一次性地改動至本模板。
為尊重其他用戶，任何功能/兼容性改動在生效前都應先在討論頁進行討論。

本模板可產生注（ㄓㄨˋ）音（ㄧㄣ）的效果。

用法

{{Ruby|文字|注音|文字的語言標籤|注音的語言標籤}}

文字語言與注音語言為可選參數，不填注音語言時，注音語言與文字語言相同。

本模板全都是編號參數。

各語言對應的語言標籤見Help:語言標籤。

值得注意的一點是由於本站除了中國大陸以外，還有其他地區的漢語用戶，標記為任意一種漢語語言標籤都可能會導致地區字形或地區詞顯示不正確。故除特殊情況外，請勿在參數中標記漢語（中文），請將該參數留空即可。

範例

代碼	效果
{{Ruby|注|zhù}}{{Ruby|音|yīn}}	注（zhù）音（yīn）
{{Ruby|運命|さだめ|ja}}	運命（さだめ）
{{Ruby|超電磁砲|レールガン|zh|ja}} {{Ruby|超電磁砲|レールガン||ja}}	超電磁砲（レールガン）
{{Ruby|東方妖々夢|とうほうようようむ|ja}} 〜 {{Ruby|Perfect|パーフェクト|en|ja}} {{Ruby|Cherry|チェリー|en|ja}} {{Ruby|Blossom|ブロッサム|en|ja}}	東方妖々夢（とうほうようようむ） ～ Perfect（パーフェクト） Cherry（チェリー） Blossom（ブロッサム）

問題

模板本身

• 本模板不可以對本身重複嵌套，會出錯。
• 請儘可能避免使用此模板排版長句內容和翻譯，在注音時請以儘可能短的單位（如單詞或音節）進行排版。過長的排版可能會導致窄屏設備無法換行等意外發生；本模板並非為翻譯內容專門設計，原文和翻譯需要一同出現的地方請考慮直接括注。

請不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要不要（やめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめてやめて）這樣排版。

瀏覽器

目前僅部分瀏覽器支持本模板的樣式，使用前請注意您的瀏覽器的兼容性。

• 如果您看到注音排在文字上面，那就說明您的瀏覽器兼容該樣式。
• Firefox 34～37 版可以打開 about:config 頁面，把 layout.css.ruby.enabled 這個參數改成 true 來開啟注音效果。

參閱：

• Can I use... 上面的瀏覽器兼容性列表
• Mozilla 開發者網站上面有關 <ruby> 的說明

表格類

現象描述：

該模板在table、li等元素中使用會可能導致部分對齊方式上的問題，這是由於渲染方式上的問題。在列內元素數量不統一時不同的寬度分配方式會導致的高度分配不一（webkit會給塊元素一個合理的空間）。這個問題只在寬度是自動分配的時候出現，如果寬度是被指定好的則不會出現這個問題。

這類問題在{{LyricsKai}}等模板中也會發生，尤其是依賴table的各種模板。LyricsKai：左右兩列中的對應行若不同時使用ruby，就會出現此類問題。

標題文字	標題文字	標題文字
100px寬度，換行時觸發異常	150px寬度	示例（test）：ruby標籤，自動調節寬度，顯示異常，單元格會向上浮動若干像素
100px寬度	示例（test）：150px寬度，寬度被寫死的情況下不會觸發異常	套上了div標籤之後，示例（test）：ruby標籤，自動調節寬度，顯示正常

解決方法：

在ruby外面套一個div標籤。

{| class="wikitable" 
|-
! 標題文字 !! 標題文字 !! 標題文字
|-
| width=100px|100px寬度，換行時觸發異常 || width=150px|150px寬度|| {{ruby|示例|test}}：ruby標籤，自動調節寬度，顯示異常，單元格會向上浮動若干像素
|-
| 100px寬度 || {{ruby|示例|test}}：150px寬度，寬度被寫死的情況下不會觸發異常 || <div>套上了div標籤之後，{{ruby|示例|test}}：ruby標籤，自動調節寬度，顯示正常</div>
|}

參見

• {{Lang}}
• {{Rubyh}}——帶有黑幕
• {{Ruby-begin}}——具有強大可定製性
• {{Photrans}}——專門用於給歌詞注音，可通過按鈕切換注音的顯示和隱藏