1 files changed, 100 insertions, 0 deletions
diff --git a/src/mistune/plugins/ruby.py b/src/mistune/plugins/ruby.py
new file mode 100644
index 0000000..eabc037
--- /dev/null
+++ b/src/mistune/plugins/ruby.py
@@ -0,0 +1,100 @@
+import re
+from ..util import unikey
+from ..helpers import parse_link, parse_link_label
+
+
+RUBY_PATTERN = r'\[(?:\w+\(\w+\))+\]'
+_ruby_re = re.compile(RUBY_PATTERN)
+
+
+def parse_ruby(inline, m, state):
+    text = m.group(0)[1:-2]
+    items = text.split(')')
+    tokens = []
+    for item in items:
+        rb, rt = item.split('(')
+        tokens.append({
+            'type': 'ruby',
+            'raw': rb,
+            'attrs': {'rt': rt}
+        })
+
+    end_pos = m.end()
+
+    next_match = _ruby_re.match(state.src, end_pos)
+    if next_match:
+        for tok in tokens:
+            state.append_token(tok)
+        return parse_ruby(inline, next_match, state)
+
+    # repeat link logic
+    if end_pos < len(state.src):
+        link_pos = _parse_ruby_link(inline, state, end_pos, tokens)
+        if link_pos:
+            return link_pos
+
+    for tok in tokens:
+        state.append_token(tok)
+    return end_pos
+
+
+def _parse_ruby_link(inline, state, pos, tokens):
+    c = state.src[pos]
+    if c == '(':
+        # standard link [text](<url> "title")
+        attrs, link_pos = parse_link(state.src, pos + 1)
+        if link_pos:
+            state.append_token({
+                'type': 'link',
+                'children': tokens,
+                'attrs': attrs,
+            })
+            return link_pos
+
+    elif c == '[':
+        # standard ref link [text][label]
+        label, link_pos = parse_link_label(state.src, pos + 1)
+        if label and link_pos:
+            ref_links = state.env['ref_links']
+            key = unikey(label)
+            env = ref_links.get(key)
+            if env:
+                attrs = {'url': env['url'], 'title': env.get('title')}
+                state.append_token({
+                    'type': 'link',
+                    'children': tokens,
+                    'attrs': attrs,
+                })
+            else:
+                for tok in tokens:
+                    state.append_token(tok)
+                state.append_token({
+                    'type': 'text',
+                    'raw': '[' + label + ']',
+                })
+            return link_pos
+
+
+def render_ruby(renderer, text, rt):
+    return '<ruby><rb>' + text + '</rb><rt>' + rt + '</rt></ruby>'
+
+
+def ruby(md):
+    """A mistune plugin to support ``<ruby>`` tag. The syntax is defined
+    at https://lepture.com/en/2022/markdown-ruby-markup:
+
+    .. code-block:: text
+
+        [漢字(ㄏㄢˋㄗˋ)]
+        [漢(ㄏㄢˋ)字(ㄗˋ)]
+
+        [漢字(ㄏㄢˋㄗˋ)][link]
+        [漢字(ㄏㄢˋㄗˋ)](/url "title")
+
+        [link]: /url "title"
+
+    :param md: Markdown instance
+    """
+    md.inline.register('ruby', RUBY_PATTERN, parse_ruby, before='link')
+    if md.renderer and md.renderer.NAME == 'html':
+        md.renderer.register('ruby', render_ruby)