Roxanne: 1 revision imported

2025-12-08T04:34:26Z

1 revision imported

← Older revision		Revision as of 04:34, 8 December 2025
(No difference)

Wikipedia>~2025-31563-08: Japanese "On" reading must be used instead of "Kun" reading.

2025-11-22T03:29:09Z

Japanese "On" reading must be used instead of "Kun" reading.

New page

{{Documentation subpage}}

{{warning|Per {{section link|Wikipedia:Manual of Style/Japan-related articles#Ruby}}, do not use this template for kanjis in articles, except when they are about ruby characters themselves, or it is needed to accurately quote something that includes ruby characters.}} 

{{Uses TemplateStyles|Template:Ruby/styles.css}}
== Usage ==
{{nihongo|'''[[Ruby character]]s'''|ルビ|Rubi}} are small, annotative [[gloss (annotation)|gloss]]es that can be placed above or to the right of a [[Chinese character]] when writing languages with [[logogram|logographic]] characters such as [[Chinese language|Chinese]] or [[Japanese language|Japanese]] to show the pronunciation. Typically called just '''ruby''' or '''rubi''', such annotations are used as pronunciation guides for characters that are likely to be unfamiliar to the reader.

* {{Template link expanded|Ruby|人|rén}} → {{Ruby|人|rén}}
* {{Template link expanded|Ruby|人|じん}} → {{Ruby|人|じん}}
* {{Template link expanded|Ruby|人|인}} → {{Ruby|人|인}}

The first parameter is the base (the lower part) and the second is the Ruby text (the smaller part on top or in parentheses).

* {{para|large|yes}} enlarges the characters by 250% for use in examples

Examples:

{{markup
|<nowiki>{{Ruby|全|すべ}}て</nowiki>
|{{Ruby|全|すべ}}て

|<nowiki>{{Ruby|媽|mā}}</nowiki>
|{{Ruby|媽|mā}}

|<nowiki>{{Ruby|large=yes|媽|mā}}</nowiki>
|{{Ruby|large=yes|媽|mā}}
}}

== Browser support ==
The manner in which the Ruby characters are displayed is dependent upon the browser. For browser support, see [https://caniuse.com/ruby Ruby annotation] at ''Can I use''.

For example: {{Ruby|Base|top}}

If you see {{overset|top|Base}}, then your browser supports Ruby.

If you see Base (top), then your browser does not support Ruby.

== See also ==
* {{Template link|ruby line}} for easier annotation of multiple series of characters
* {{Template link|ruby-zh-p}} for [[Hanyu Pinyin]]
* {{Template link|ruby-zh-b}} for [[Bopomofo]]
* {{Template link|ruby-ja}} for Japanese
* {{Template link|Linked Ruby}} for easier wikilinks to Ruby annotations
* {{Template link|overset}} for oversetting characters for math and similar uses

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
"params": {
"1": {
"label": "Base",
"description": "Text in Kana or Chinese characters to be annotated",
"example": "全",
"type": "line",
"required": true
},
"2": {
"label": "Annotation",
"description": "Hiragana, romanization or other transcription; shown above the Base text",
"example": "すべ",
"type": "line",
"required": true
},
"large": {
"label": "Large?",
"description": "If 'yes', renders text large",
"example": "yes",
"type": "string"
},
"style": {
"label": "CSS styling",
"type": "string",
"aliases": [
"css"
]
}
},
"description": "Shows a Chinese, Kanji or other phrase with Ruby text above it"
}
</templatedata>
<includeonly>{{sandbox other||

[[Category:Wikipedia HTML tag-replacing templates]]
[[Category:Pronunciation templates]]
}}</includeonly>

Template:Ruby/doc - Revision history

Roxanne: 1 revision imported

Wikipedia>~2025-31563-08: Japanese "On" reading must be used instead of "Kun" reading.