Ruby Character
Get Ruby Character essential facts below. View Videos or join the Ruby Character discussion. Add Ruby Character to your topic list for future reference or share this resource on social media.
Ruby Character

Ruby characters (Japanese: ; r?maji: rubi; Korean: ; romaja: rubi) are small, annotative glosses that are usually placed above or to the right of logographic characters such as Chinese, Japanese, Korean, or Vietnamese to show the pronunciation. Typically called just ruby or rubi, such annotations are most commonly used as pronunciation guides for characters that are likely to be unfamiliar to the reader.


Here is an example of Japanese ruby characters (called furigana) for Tokyo (""):

Hiragana Katakana Romaji
? ?
? ?
T? ky?
? ?

Most furigana are written with the hiragana syllabary, but katakana and romaji are also occasionally used. Alternatively, sometimes foreign words (usually English) are printed with furigana implying the meaning, and vice versa. Textbooks usually write on-readings with katakana and kun-readings with hiragana.

Here is an example of the Bopomofo ruby characters for Beijing (""):

Zhuyin Pinyin
? ?
B?i j?ng
? ?

In Taiwan, the syllabary used for Chinese ruby characters is Zhuyin fuhao (also known as Bopomofo); in mainland China pinyin is used. Typically, unlike the example shown above, zhuyin is used with a vertical traditional writing and zhuyin is written on the right side of the characters. In mainland China, horizontal script is used and ruby characters (pinyin) are written above the Chinese characters.

Books with phonetic guides (especially pinyin) are popular with children and foreigners learning Chinese.

Here is an example of the Korean ruby characters for Korea (""):

Hangul Romaja
? ?
? ?
Han guk
? ?

Romaja is normally used in foreign textbooks until Hangul is introduced. Ruby characters can be quite common on signs in certain parts of South Korea.

Here is an example of the Vietnamese ruby characters for Hanoi (""):

Ch? Qu?c ng?
? ?


Ruby may be used for different reasons:

  • because the character is rare and the pronunciation unknown to many--personal name characters often fall into this category;
  • because the character has more than one pronunciation, and the context is insufficient to determine which to use;
  • because the intended readers of the text are still learning the language and are not expected to always know the pronunciation or meaning of a term;
  • because the author is using a nonstandard pronunciation for a character or a term

Also, ruby may be used to show the meaning, rather than pronunciation, of a possibly-unfamiliar (usually foreign) or slang word. This is generally used with spoken dialogue and applies only to Japanese publications. The most common form of ruby is called furigana or yomigana and is found in Japanese instructional books, newspapers, comics and books for children.

In Japanese, certain characters, such as the sokuon () (little tsu, ?) that indicates a pause before the consonant it precedes, are normally written at about half the size of normal characters. When written as ruby, such characters are usually the same size as other ruby characters. Advancements in technology now allow certain characters to render accurately.[clarification needed][1]

In Chinese, the practice of providing phonetic cues via ruby is rare, but does occur systematically in grade-school level text books or dictionaries. The Chinese have no special name for this practice, as it is not as widespread as in Japan. In Taiwan, it is known as "zhuyin", from the name of the phonetic system employed for this purpose there. It is virtually always used vertically, because publications are normally in a vertical format, and zhuyin is not as easy to read when presented horizontally[]. Where zhuyin is not used, other Chinese phonetic systems like pinyin are employed.

An example of Vietnamese ruby text

In academic settings, Vietnamese text written in ch? Hán or ch? Nôm may be glossed with ch? qu?c ng? ruby for modern readers.[2]

Sometimes interlinear glosses are visually similar to ruby, appearing above or below the main text in smaller type. However, this is a distinct practice used for helping students of a foreign language by giving glosses for the words in a text, as opposed to the pronunciation of lesser-known characters.

Ruby annotation can also be used in handwriting.


Hunmin Jeongeum Eonhae uses hanja and small hangul for ruby on right below

In British typography, ruby was originally the name for type with a height of 5.5 points, which printers used for interlinear annotations in printed documents. In Japanese, rather than referring to a font size, the word became the name for typeset furigana. When transliterated back into English, some texts rendered the word as rubi, (a typical romanisation of the Japanese word , instead of (rub?), the expected transliteration of ruby). However, the spelling "ruby" has become more common since the W3C published a recommendation for ruby markup. In the US, the font size had been called "agate", a term in use since 1831 according to the Oxford English Dictionary.

HTML markup

This information is out of date and has been superseded by the inclusion of Ruby support in HTML5. For more information visit w3 ruby markup reference.

In 2001, the W3C published the Ruby Annotation specification[1] for supplementing XHTML with ruby markup. Ruby markup is not a standard part of HTML 4.01 or any of the XHTML 1.0 specifications (XHTML-1.0-Strict, XHTML-1.0-Transitional, and XHTML-1.0-Frameset), but was incorporated into the XHTML 1.1 specification, and is expected to be a core part of HTML5 once the specification becomes finalised by the W3C.[3]

Support for ruby markup in web browsers is limited, as XHTML 1.1 is not yet widely implemented. Ruby markup is partially supported by Microsoft Internet Explorer (5.0+) for Windows and Macintosh, supported by Chrome, but is not supported by Konqueror or Opera.[4] The WebKit nightly builds added support for Ruby HTML markup in January 2010.[5]Safari has included support in version 5.0.6.[6] It is also supported in Mozilla Firefox as of version 38.[7]

For those browsers that don't support Ruby natively, Ruby support is most easily added by using CSS rules that are easily found on the web.[8]

Ruby markup support can also be added to some browsers that support custom extensions.

Ruby markup is structured such that a fallback rendering, consisting of the ruby characters in parentheses immediately after the main text, appears if the browser does not support ruby.

The W3C is also working on a specific ruby module for CSS level 2, which additionally allows the grouping of ruby and automatic omission of furigana matching their annotated part.[9] This is currently only supported by Firefox 38.[7]

Markup examples

Below are a few examples of ruby markup. The markup is shown first, and the rendered markup is shown next, followed by the unmarked version. Web browsers either render it with the correct size and positioning as shown in the table-based examples above, or use the fallback rendering with the ruby characters in parentheses:

XHTML CSS level 2[9]



By default, the code above will come to the effect below. To achieve this effect, we need further CSS styling.

Unmarked () ?()?() ?(?)

Note that Chinese ruby text would normally be displayed in vertical columns to the right of each character. This approach is not typically supported in browsers at present.

This is a table-based example of vertical columns:

? ?
? ?

Complex ruby markup

Complex ruby markup makes it possible to associate more than one ruby text with a base text, or parts of ruby text with parts of base text.[10] It is currently only supported in Firefox 38.[7]


Unicode and its companion standard, the Universal Character Set, support ruby via these interlinear annotation characters:

  • Code point FFF9 (hex)--Interlinear annotation anchor--marks start of annotated text
  • Code point FFFA (hex)--Interlinear annotation separator--marks start of annotating character(s)
  • Code point FFFB (hex)--Interlinear annotation terminator--marks end of annotated text

Few applications implement these characters. Unicode Technical Report #20[11] clarifies that these characters are not intended to be exposed to users of markup languages and software applications. It suggests that ruby markup be used instead, where appropriate.


ISO/IEC 6429 (also known as ECMA-48) which defines the ANSI escape codes also provided a mechanism for ruby text for use by text terminals, although few terminals and terminal emulators implement it. The PARALLEL TEXTS (PTX) escape code accepted six parameter values giving the following escape sequences for marking ruby text:

  • CSI 0 \ (or simply CSI \ since 0 is used as the default value for this control) - end of parallel texts
  • CSI 1 \ - beginning of a string of principal parallel text
  • CSI 2 \ - beginning of a string of supplementary parallel text
  • CSI 3 \ - beginning of a string of supplementary Japanese phonetic annotation
  • CSI 4 \ - beginning of a string of supplementary Chinese phonetic annotation
  • CSI 5 \ - end of a string of supplementary phonetic annotations

See also


  1. ^ a b Marcin Sawicki; Michel Suignard; Masayasu Ishikawa; Martin Dürst; Tex Texin (2001-05-31). "Ruby Annotation". W3C Recommendation. World Wide Web Consortium. Retrieved .
  2. ^ Lunde 2009, p. 529.
  3. ^ "HTML5". Retrieved 2012.
  4. ^ "Web Specifications supported in Opera". Retrieved . Opera supports XHTML 1.1 with these exceptions: (...) Ruby annotations are not supported
  5. ^ Roland Steiner (2010-01-20). "Ruby Rendering in WebKit". Surfin' Safari. WebKit project. Retrieved . External link in |work= (help)
  6. ^ The ruby element - HTML5 Doctor
  7. ^ a b c Xidorn Quan (2015-03-05). "Ruby support in Firefox Developer Edition 38". Mozilla. Retrieved .
  8. ^ CSS Ruby Support Archived 2007-02-28 at the Wayback Machine--Works in all modern browsers
  9. ^ a b Elika J. Etemad; Koji Ishii (2015-04-16). "CSS Ruby Layout Module Level 1". W3C Editor's Draft. World Wide Web Consortium. Retrieved .
  10. ^ Complex ruby markup
  11. ^ Martin Dürst; Asmus Freytag (2007-05-16). "Unicode in XML and other Markup Languages". W3C and Unicode Consortium. Archived from the original on 2005-02-19. Retrieved .

Further reading

  This article uses material from the Wikipedia page available here. It is released under the Creative Commons Attribution-Share-Alike License 3.0.



Music Scenes