Template:Ruby/doc

本模板已应用于50000+页面。
为避免大规模的破坏及不必要的服务器负荷，任何改动均应先在该模板对应的沙盒页面或您自己的用户页下进行测试，并将测试无误的代码一次性地改动至本模板。
为尊重其他用户，任何功能/兼容性改动在生效前都应先在讨论页进行讨论。

本模板可產生注（zhù）音（yīn）的效果。

用法

{{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}}——专门用于给歌词注音，可通过按钮切换注音的显示和隐藏