Para ruby, general ruby, and T2S - Advanced-Publishing-Laboratory/A11Y GitHub Wiki

As described in JLREQ, Ruby is a small-sized, supplementary text attached to a character or a group of characters in the main text. JLreq further defines two methods of choosing how to attach ruby annotations to which base characters.

1. 'General-ruby' is the method of attaching ruby annotations to all base characters in ideographic character (cl-19).
2. 'Para-ruby' is the method of attaching ruby annotations to only those base characters in ideographic character (cl-19) for which readings are difficult.

Some students require general-ruby since every ideographic character is difficult for them. Others require para-ruby since they understand most ideographic characters. Yet others prefer no ruby, since they find it difficult to separate base characters and ruby characters.

As a result, those who create DAISY or EPUB3 textbooks in Japan are forced to provide more than one version of a single textbook. It would be much nicer if a single textbook can be rendered differently, depending on the preferences of the user.