模板:Ruby/doc

此条目最初引自中文維基百科的同名模板，版权协定可能与Mooncell并不相同。内容经过双方不同人员的修改后，可能会有很大差异。

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

用法

{{Ruby|文字|注音|文字語言|注音語言}}

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

本模板不可以對本身重複嵌套，會出錯。

本模板全都是编号参数。

範例

代码	效果
{{Ruby|注|zhù}}{{Ruby|音|yīn}}	注（zhù）音（yīn）

问题

目前仅部分浏览器支持本模板的样式，使用前请注意您的浏览器的兼容性。如果您看到注音排在文字上面，那就说明您的浏览器兼容该样式。

参阅：

• Can I use... 上面的浏览器兼容性列表
• Mozilla 开发者网站上面有关 <ruby> 的说明

Firefox 34～37 版可以打开 about:config 页面，把 layout.css.ruby.enabled 这个参数改成 true 来开启注音效果。

现象描述：

该模板在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}}——具有强大可定制性