{"id":313435,"date":"2026-05-21T10:09:51","date_gmt":"2026-05-21T10:09:51","guid":{"rendered":"https:\/\/ja.wordpress.org\/plugins\/ruby-markup-converter\/"},"modified":"2026-09-10T10:47:28","modified_gmt":"2026-09-10T10:47:28","slug":"ruby-markup-converter","status":"publish","type":"plugin","link":"https:\/\/ory.wordpress.org\/plugins\/ruby-markup-converter\/","author":23500174,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.0","stable_tag":"1.1.0","tested":"7.1","requires":"6.8","requires_php":"7.4","requires_plugins":null,"header_name":"Ruby Markup Converter","header_author":"Foriba","header_description":"Automatically convert plain-text ruby notations into display-ready HTML.","assets_banners_color":"f4efe6","last_updated":"2026-09-10 10:47:28","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/foriba\/ruby-markup-converter\/","header_author_uri":"https:\/\/github.com\/foriba\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":262,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"foriba","date":"2026-05-22 15:00:17","revision":3544058},"1.0.1":{"tag":"1.0.1","author":"foriba","date":"2026-08-26 02:26:17","revision":3666159},"1.1.0":{"tag":"1.1.0","author":"foriba","date":"2026-09-10 10:47:28","revision":3689772}},"upgrade_notice":{"1.1.0":"<p>Adds a dedicated conversion block, preserves HTML structure during conversion, and fixes bouten markup after kanji being mistaken for ruby. Requires WordPress 6.8 or later.<\/p>","1.0.0":"<ul>\n<li>Initial public release.<\/li>\n<\/ul>","0.9.1":"<ul>\n<li>Addressed WordPress.org review feedback.<\/li>\n<\/ul>","0.9.0":"<p>Initial review submission.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3552022,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3552022,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3551887,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500-ja.png":{"filename":"banner-1544x500-ja.png","revision":3551954,"resolution":"1544x500","location":"assets","locale":"ja","width":1544,"height":500},"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3551954,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250-ja.png":{"filename":"banner-772x250-ja.png","revision":3551954,"resolution":"772x250","location":"assets","locale":"ja","width":772,"height":250},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3551954,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"rubymaco\/content":{"$schema":"https:\/\/schemas.wp.org\/trunk\/block.json","apiVersion":3,"name":"rubymaco\/content","version":"1.1.0","title":"Ruby Markup Converter","category":"text","icon":"editor-code","description":"Convert ruby and bouten markup within this block.","keywords":["ruby","bouten","rubymaco"],"attributes":{},"textdomain":"ruby-markup-converter","editorScript":"file:.\/index.js","editorStyle":"file:.\/index.css"}},"tagged_versions":["1.0.0","1.0.1","1.1.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[1220,5520,5622,20326,5126],"plugin_category":[43,59],"plugin_contributors":[263806],"plugin_business_model":[],"class_list":["post-313435","plugin","type-plugin","status-publish","hentry","plugin_tags-block","plugin_tags-converter","plugin_tags-japanese","plugin_tags-ruby","plugin_tags-typography","plugin_category-customization","plugin_category-utilities-and-tools","plugin_contributors-foriba","plugin_committers-foriba"],"banners":{"banner":"https:\/\/ps.w.org\/ruby-markup-converter\/assets\/banner-772x250.png?rev=3551954","banner_2x":"https:\/\/ps.w.org\/ruby-markup-converter\/assets\/banner-1544x500.png?rev=3551954","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/ruby-markup-converter\/assets\/icon.svg?rev=3551887","icon":"https:\/\/ps.w.org\/ruby-markup-converter\/assets\/icon.svg?rev=3551887","icon_2x":false,"generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>Place a Ruby Markup Converter block wherever markup conversion should apply. You can also enable conversion for the entire post content.<\/p>\n\n<p>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.<\/p>\n\n<p>Supported Markup Styles:<\/p>\n\n<ul>\n<li><p>Ruby:<\/p>\n\n<ul>\n<li>\uff5cBaseText\u300aRubyAnnotation\u300b<\/li>\n<li>BaseText\u300aRubyAnnotation\u300b<\/li>\n<li>BaseText(RubyAnnotation)<\/li>\n<li>[[rb:BaseText &gt; RubyAnnotation]]<\/li>\n<li>#BaseText__RubyAnnotation__#<\/li>\n<li>{{ruby|BaseText|RubyAnnotation}}<\/li>\n<\/ul><\/li>\n<li><p>Bouten (Emphasis):<\/p>\n\n<ul>\n<li>\u300a\u300aEmphasis\u300b\u300b<\/li>\n<\/ul><\/li>\n<\/ul>\n\n<h3>Usage<\/h3>\n\n<h4>Using the Ruby Markup Converter block<\/h4>\n\n<ol>\n<li>Open a post or page in the block editor.<\/li>\n<li>Add the <code>Ruby Markup Converter<\/code> block.<\/li>\n<li>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.<\/li>\n<li>Preview or publish the post to see the notation displayed as ruby annotations and bouten. In the editor, the notation remains as written.<\/li>\n<\/ol>\n\n<h4>Converting the entire post content<\/h4>\n\n<p>If you prefer to write markup directly in the post content without placing it inside Ruby Markup Converter blocks, open <code>Settings &gt; Ruby Markup Converter<\/code> and set the conversion scope to <code>Apply to Entire Post Content<\/code>.<\/p>\n\n<p>This also includes text inside Ruby Markup Converter blocks and <code>[rubymaco]...[\/rubymaco]<\/code> shortcodes.<\/p>\n\n<p>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.<\/p>\n\n<h3>Documentation<\/h3>\n\n<p>For detailed instructions, examples, and troubleshooting, see the user guides:<\/p>\n\n<ul>\n<li>English: <a href=\"https:\/\/github.com\/foriba\/ruby-markup-converter\/blob\/main\/docs\/en-US\/user-guide.md\">Ruby Markup Converter User Guide<\/a><\/li>\n<li>\u65e5\u672c\u8a9e: <a href=\"https:\/\/github.com\/foriba\/ruby-markup-converter\/blob\/main\/docs\/ja-JP\/user-guide.md\">Ruby Markup Converter \u30e6\u30fc\u30b6\u30fc\u30ac\u30a4\u30c9<\/a><\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>ruby-markup-converter<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the <code>Plugins<\/code> menu in WordPress.<\/li>\n<li>Open <code>Settings &gt; Ruby Markup Converter<\/code>.<\/li>\n<li>Choose the conversion scope and markup rules you want to use.<\/li>\n<li>Save your settings.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"how%20do%20i%20use%20the%20plugin%20safely%20at%20first%3F\"><h3>How do I use the plugin safely at first?<\/h3><\/dt>\n<dd><p>Start with the selected-area mode and place a Ruby Markup Converter block around the text you want to convert. This keeps conversion limited to the content you choose.<\/p><\/dd>\n<dt id=\"can%20i%20apply%20conversions%20to%20the%20entire%20post%20content%3F\"><h3>Can I apply conversions to the entire post content?<\/h3><\/dt>\n<dd><p>Yes. You can switch the conversion scope in the settings screen to apply markup conversion to the entire post content. This is convenient, but selected-area conversion is safer when only part of a post uses ruby or bouten markup.<\/p><\/dd>\n<dt id=\"can%20i%20use%20the%20shortcode%3F\"><h3>Can I use the shortcode?<\/h3><\/dt>\n<dd><p>Yes. The <code>[rubymaco]...[\/rubymaco]<\/code> shortcode is supported. For new content created with the block editor, using the Ruby Markup Converter block is recommended.<\/p><\/dd>\n<dt id=\"does%20the%20plugin%20support%20bouten%3F\"><h3>Does the plugin support bouten?<\/h3><\/dt>\n<dd><p>Yes. The plugin supports bouten markup using <code>\u300a\u300aEmphasis\u300b\u300b<\/code>, and you can choose both the bouten style and the rendering method.<\/p><\/dd>\n<dt id=\"can%20i%20enable%20only%20specific%20markup%20styles%3F\"><h3>Can I enable only specific markup styles?<\/h3><\/dt>\n<dd><p>Yes. Each supported markup rule can be enabled or disabled individually from the settings screen.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20i%20uninstall%20the%20plugin%3F\"><h3>What happens when I uninstall the plugin?<\/h3><\/dt>\n<dd><p>Uninstalling the plugin removes its saved settings but does not delete or rewrite your posts or pages. Ruby and bouten notation remains in your text and is displayed as written instead of being converted into annotations or emphasis dots. Any manually written <code>[rubymaco]...[\/rubymaco]<\/code> shortcode tags also remain visible.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added the Ruby Markup Converter block for converting markup within a specific block area.<\/li>\n<li>Changed the default bouten rendering method to CSS text-emphasis.<\/li>\n<li>Fixed unintended markup conversion within HTML tags and attributes that could break the displayed content.<\/li>\n<li>Fixed bouten markup immediately following kanji being misinterpreted as ruby markup.<\/li>\n<li>Fixed ampersands being displayed incorrectly with the custom bouten renderer.<\/li>\n<li>Fixed default markup rules being re-enabled when all rules were disabled.<\/li>\n<li>Updated the minimum required WordPress version to 6.8.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Improved internal option management.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial public release.<\/li>\n<\/ul>\n\n<h4>0.9.1<\/h4>\n\n<ul>\n<li>Addressed WordPress.org review feedback.<\/li>\n<\/ul>\n\n<h4>0.9.0<\/h4>\n\n<ul>\n<li>Initial review submission<\/li>\n<li>Added support for multiple ruby markup styles<\/li>\n<li>Added bouten markup support<\/li>\n<li>Added shortcode-only and full-content conversion modes<\/li>\n<li>Added admin settings screen with previews<\/li>\n<li>Added selectable bouten style and rendering method<\/li>\n<\/ul>","raw_excerpt":"Paste manuscripts written for novel submission sites into WordPress and display supported markup as ruby annotations and bouten.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/313435","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=313435"}],"author":[{"embeddable":true,"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/foriba"}],"wp:attachment":[{"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=313435"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=313435"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=313435"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=313435"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=313435"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ory.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=313435"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}