Intended audience: anyone who has heard of ruby text and would like to know a little more about it.
Updated 2006-10-16 18:50
What is 'ruby'?
The term ruby is used to refer to a particular type of annotation. Typically ruby is used in East Asian scripts to provide phonetic transcriptions of obscure characters, or characters that the reader is not expected to be familiar with. For example it is widely used in education materials and children’s texts. It is also occasionally used to convey information about meaning.
In Japanese, where ruby is called furigana, phonetic transcriptions typically appear in hiragana above horizontal text and to the right of vertical text.
Examples of horizontal and vertical text are shown below and to the right. Note: The ruby in the examples on this page is colored red only to direct your attention to it - it would normally be the same color as the base text.
Semantic (or meaning related) information is typically provided below the horizontal text or to the left of vertical text.
Although ruby in Japanese is typically in hiragana, it is also possible to occasionally find annotations in kanji, katakana and Latin text.
In Taiwan, zhuyin (bopomofo) characters are used to indicate the pronunciation of Traditional Chinese. Rather than appearing above the main text, the annotation is included vertically to the right of each character, whether the main text is vertical or horizontal.
Ruby may also be used for non-Asian annotations and to support inter-linear text.
The term derives from a named font size (5pt) used by printers.
For ruby support in markup use Ruby Annotation, which became a W3C Recommendation and part of XHTML 1.1 in May 2001. For ruby styling, there is the CSS3 Ruby Module (currently at Candidate Recommendation stage).
For implementation about ruby support in browsers see the section Implementing Ruby in the tutorial Ruby Markup and Styling.
Content first published 2003-10-01. Last substantive update 2006-10-16 18:50 GMT. This version 2011-02-18 20:01 GMT
For the history of document changes, search for qa-ruby in the i18n blog.
Copyright © 2003-2011 W3C® (MIT, ERCIM, Keio, Beihang), All Rights Reserved. W3C liability, trademark, document use and software licensing rules apply. Your interactions with this site are in accordance with our public and Member privacy statements.