Ruby Markup Converter

Ruby Markup Converter lets you publish manuscripts written for online novel submission sites on WordPress using the ruby and bouten (emphasis dots) notation already in your text.

Copy and paste your manuscript from a text file into a Ruby Markup Converter block, or write directly in the block using the same notation. Supported notations are displayed as ruby annotations and bouten when readers view the post, without having to add each annotation again in the editor.

If you normally write directly in the WordPress editor and add ruby annotations one at a time, you may not need this plugin. WordPress 6.3 and later includes built-in support for adding ruby annotations in the block editor.

Ruby Markup Converter is primarily designed for Japanese typesetting and Japanese novel markup conventions, but the conversion itself is not limited to Japanese text. Any text that follows a supported markup pattern can be converted.

Place a Ruby Markup Converter block wherever markup conversion should apply. You can also enable conversion for the entire post content.

The plugin includes an admin settings screen where you can choose the conversion scope, enable or disable individual markup styles, and choose how bouten should be rendered.

Supported Markup Styles:

• Ruby:

  • ｜BaseText《RubyAnnotation》
  • BaseText《RubyAnnotation》
  • BaseText(RubyAnnotation)
  • [[rb:BaseText > RubyAnnotation]]
  • #BaseText__RubyAnnotation__#
  • {{ruby|BaseText|RubyAnnotation}}

• Bouten (Emphasis):

  • 《《Emphasis》》

Usage

Using the Ruby Markup Converter block

1. Open a post or page in the block editor.
2. Add the Ruby Markup Converter block.
3. Paste your manuscript into a Paragraph block inside it, keeping the supported ruby and bouten notation as written. You can also type directly using the same notation.
4. Preview or publish the post to see the notation displayed as ruby annotations and bouten. In the editor, the notation remains as written.

Converting the entire post content

If you prefer to write markup directly in the post content without placing it inside Ruby Markup Converter blocks, open Settings > Ruby Markup Converter and set the conversion scope to Apply to Entire Post Content.

This also includes text inside Ruby Markup Converter blocks and [rubymaco]...[/rubymaco] shortcodes.

This mode is convenient for posts that are mostly written with ruby or bouten markup, but unintended text may also be converted. Long posts may also take more processing.

Documentation

For detailed instructions, examples, and troubleshooting, see the user guides:

• English: Ruby Markup Converter User Guide
• 日本語: Ruby Markup Converter ユーザーガイド