Maxhodges / showdown-kanji

Showdown markdown extension for Japanese kanji / furigana support using HTML5 <ruby> tags

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

showdown-kanji


This extension is intended to provide helpers for the showdown JS markdown plugin, kanji characters, and the Japanese language in general.

Right now, it's only feature is allowing an easy to add furigana to kanji characters using HTML5 <ruby> tags - however more features may be added in the future.

Install


  1. Get the Showdown package (you'll need to install this package separately).

  2. Install this package via:

npm install --save showdown-kanji-helpers
  1. Add the extension to your showdown converer, ex:
var Showdown = require("Showdown");
var kanjiExtension = require("showdown-kanji-helpers");

var markDown = "{私}(わたし)はジョーと{申}(もう)します";
var converter = new Showdown.Converter({ extensions: [kanjiExtension] });
var html = converter.makeHtml(markDown);

console.log(html) #=> <p><ruby>私<rt>わたし</rt></ruby>はジョーと<ruby>申<rt>もう</rt></ruby>します</p>

Furigana


Adding furigana to your kanji characters is quite easy using this plugin (although this does not work consistently well on older browsers - please check this table for <ruby> tag support first).

Take a look at these examples to understand how it works:

{漢字}(かんじ)
#=> <p><ruby>漢字<rt>かんじ</rt></ruby></p>
{漢}(かん){字}(じ)
#=> <p><ruby>漢<rt>かん</rt>字<rt>じ</rt></ruby></p>
**これは**ジョーの{記}(き){事}(じ)です
#=> <p><strong>これは</strong>ジョーの<ruby>記<rt>き</rt>事<rt>じ</rt></ruby>です</p>

TODO


  • add rp tag support

License

This packaged is licensed under the BEER-WARE LICENSE

<joe@joeellis.la> wrote this file.  As long as you retain this notice you
can do whatever you want with this stuff. If we meet some day, and you think
this stuff is worth it, you can buy me a beer in return.

About

Showdown markdown extension for Japanese kanji / furigana support using HTML5 <ruby> tags


Languages

Language:JavaScript 100.0%