Rubify is a fully offline, client-side, configurable ruby text annotation generator featuring multilingual demo text and PNG, SVG, and HTML output.
For technical background on ruby text see the documentation on MDN.
There are two different text conversion modes available: Simple and Complex, depending on the type of script and requirements of the text in question.
The most straightforward way to create ruby text is using Simple mode.
Simple mode allows ruby text to be generated quickly and easily by inputting a string of base text in the Base characters box and a corresponding transcription for each character (separated by spaces) in the Ruby text input box below. The two texts will be combined so that the transcription is printed in small text above the base characters.
Click Demo and then Rubify to see an example of Ruby text (default is Chinese text with Pinyin – this can be configured to any of a number of different languages in the options menu).
Note that if the number of characters in the base text is different from the number of words in the ruby text you will get an error – adjust the text in the input boxes or try Complex mode instead.
For more complicated text, such as a single string of transcription corresponding to multiple characters, you should use Complex mode.
漢字(hànzì)拼音(pīnyīn)
will show the pinyin for
the first two words together and the second words also together
As another example, if you want to add phonetic guides to English text with IPA, you will need to use Complex mode, for example:
English(/ɪŋɡɫɪʃ/) text(/tɛkst/) with(/wɪð/) IPA(/aɪ piː eɪ/)
For a more detailed guide and examples, consult the Rubify documentation.
Inputs are different lengths! (The Base character length is not equal to the number of words in the Ruby text input box.)
Please make sure that you have entered the same number of words in the Ruby text box as there are characters in the Base characters box.
For example, if the base characters are 東京
(2 characters) then the ruby text must be exactly 2 words/syllables/morae separated by a space (e.g., Tō kyō
or とう きょう
and not Tōkyō
or とうきょう
). For more complicated situations, such as more than one character per word of ruby text etc., you will need to use Complex mode instead.
No input text provided! (You need to input text into both the Base characters and Ruby text boxes, but either one or both of these is empty.)
Try pressing the Demo button to auto-fill the input boxes and then press Rubify to convert it to ruby text.