Carview!

CARVIEW

MOTORHOMES

Select Language

HTTP/2 200 server: GitHub.com content-type: text/html; charset=utf-8 last-modified: Thu, 14 Aug 2025 07:18:44 GMT access-control-allow-origin: * etag: W/"689d8dd4-1753" expires: Fri, 10 Oct 2025 18:57:50 GMT cache-control: max-age=600 content-encoding: gzip x-proxy-cache: MISS x-github-request-id: FB06:54038:24CF:2CE4:68E954D0 accept-ranges: bytes age: 0 date: Fri, 10 Oct 2025 18:47:50 GMT via: 1.1 varnish x-served-by: cache-bom-vanm7210097-BOM x-cache: MISS x-cache-hits: 0 x-timer: S1760122070.995668,VS0,VE292 vary: Accept-Encoding x-fastly-request-id: 53faa70d45fd4a07711abb90ff29d88516eb5b38 content-length: 2493 Ruby and Accessibility

Placeholder for information about ruby accessibility.

The document Rules for Simple Placement of Japanese Ruby has been moved here.

The information below about accessibility was removed from that document, and is retained here until it can be extended, at which point it will be published as a separate, accessibility-specific document.

Ruby and Accessibility

Accessibility Improvements Using Ruby

Ruby plays a role in improving accessibility for people with visual impairments, and other sources of reading difficulties. Therefore, this section examines the relationship between ruby and accessibility.

Reading difficulties can be caused by a variety of factors, and therefore, requirements to improve accessibility also vary. For example, here are some common requirements:

To accommodate young children who cannot read any kanji, general-ruby must be added to all kanji.

See JLReq section “3.2.2 Choice of Base Characters to be Annotated by Ruby” for an explanation of “general-ruby” and “para-ruby”. [[JLREQ]]
As studies progress, a greater number of kanji is known. After having read general-ruby many times, ruby on difficult kanji only becomes sufficient. Therefore para-ruby on only some of the kanji is required.

According to the results of the 2017 DAISY survey towards general users of textbooks, 61% of children require general-ruby. Based on the same survey, para-ruby is found to be sufficient for 32% of children. This means that after having read general-ruby multiple times, having ruby on difficult kanji only is found sufficient. Moreover, printed textbooks use para-ruby, and faithful digital reproduction is needed.

Kanji to be learned during primary school are defined in the “Primary School Learning Guidelines”. Those kanji are often called “educational kanji”. In the list published in 2017, 1026 kanji are listed and spread across the various school years according to the “Kanji Allotment Table by Grade”. For middle school, the split between each grade is undefined, but students are required to study the 1110 “characters in common use” no included in educational kanji so as to have studied all 2136 characters in common use by the end of middle school.
Some people have difficulties in visually distinguishing between ruby characters and the base characters to which they are attached, and misread the combination as a different character altogether. There must be a display method that enables clearly distinguishing between the two. Also, for those who already know how to read the kanji, there must be a way to hide the ruby.
As inline parenthesised annotations can be used instead, there is no strong need for double-sided ruby.

Ruby Display Requirements for Accessibility

Based on the above, we can gather the following ruby display requirements for accessibility:

Support for general-ruby is required.
Support for para-ruby is required. Moreover, as the number of kanji known increases with the level of studies, based on the content and on the level of the reader, it must be possible to only display ruby for kanji assigned to a particular school year (or later).
Support for hiding ruby is required.
Considering the cost of production, distribution, and of user management, it is necessary to support ruby-less display, general-ruby display, and para-ruby display with the same content.
A method to clearly visually distinguish the ruby characters and their based characters, such as displaying them in different colors, is required.

Original Source | Taken Source