<ruby> Ruby Wrapper

An inline wrapper element that surrounds some of the document narrative text in the same way a bold or italic emphasis would. The <ruby> element contains a Ruby Base (<rb> element) which contains the document text and a Ruby Textual Annotation (<rt> element) that applies to that base text.

Usage/Remarks

What is Ruby

A Ruby textual annotation is an annotation, typically short, applied to a letter, word, phrase, or name that appears in narrative text. Ruby annotations can indicate, for example, pronunciation advice, notes for translation, semantic annotations, etc. Ruby is used with Japanese, for example, in Furigana, which typically uses Hiragana annotations on Kanji base text. Ruby is also used in Chinese Pīnyīn (a phonetic system for transcribing the sound of Chinese characters into Latin script) as well as for some Korean names. In display or print, the characters of a Ruby annotation are frequently placed above the characters they modify, in parentheses after the characters they modify, or to the right of vertically set text.

Structure of NISO STS Ruby

The <ruby> element is an inline wrapper element that contains some of the document narrative text (inside a Ruby Base <rb> element) and associates that base text with a Ruby Textual Annotation (inside an <rt> element).
Attributes

Base Attributes

Models and Context
May be contained in
Description
Content Model
<!ELEMENT  ruby         %ruby-model;                                 >
Expanded Content Model

(rb, rt)

Related Resources