diff --git a/.vscode/settings.json b/.vscode/settings.json index b5601da..5808b2c 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -1,5 +1,6 @@ { "files.associations": { "*.mdx": "markdown" - } + }, + "ltex.language": "en-US" } \ No newline at end of file diff --git a/src/content/posts/ruby-in-markdown.md b/src/content/posts/ruby-in-markdown.md index 7ce71ec..d7bfd8b 100644 --- a/src/content/posts/ruby-in-markdown.md +++ b/src/content/posts/ruby-in-markdown.md @@ -2,69 +2,29 @@ title: Ruby extensions for Markdown date: 2023-01-15T16:19:00+01:00 tags: [Japanese, zola, hugo, astro] -draft: true --- -In Markdown there is currently no notation for adding ruby to East Asian scripts, however it is possible to add support for it by using shortcodes in SSGs. + +Sadly, as far as I know CommonMark currently doesn't include anything about ruby in its spec. On top of that ruby is pretty uncommon, so it is pretty rare for any ruby extensions to exist. As I move through any new frameworks, I will try to document any simple solutions that I figure out. + ## Examples -### Japanese -{日本語}(にほんご)の{文法}(ぶんぽう)は{難}(むずか)しい -Remark: `{日本語}(にほんご)の{文法}(ぶんぽう)は{難}(むずか)しい` -Tera: `{{/* ruby(expr="日本語,にほんご;の;文法,ぶんぽう;は;難,むずか;しい") */}}` -### Chinese -{北}(Běi){京}(jīng) -{北}(ㄅㄟˇ){京}(ㄐㄧㄥ) -`{{/* ruby(expr="北,Běi;京,jīng") */}}` -`{{/* ruby(expr="北,ㄅㄟˇ;京,ㄐㄧㄥ") */}}` - -### Korean -{韓}(한){國}(국) -`{{/* ruby(expr="韓,한;國,국") */}}` - -### Vietnamese -{河}(Hà){內}(Nội) -`{河}(Hà){內}(Nội) ` -`{{/* ruby(expr="河,Hà;內,Nội") */}}` - -## Zola -The following is a snippet for the Tera templating engine which is inspired by Jinja2. -```jinja-html - - {%- for item in expr | split(pat=";") -%} - {%- set sub_item = item | split(pat=",") -%} - {{- sub_item[0] -}} - {%- if sub_item[1] -%} - ({{- sub_item[1] -}}) - {%- else -%} - - {%- endif -%} - {%- endfor -%} - -``` - -## Hugo -The following is a snippet for the Golang templating engine used by Hugo. -```html -{{- with .Get 0 -}} - - {{- /* Generate the ruby markup */ -}} - {{- range split . ";" -}} - {{- $item := split . "," -}} - {{- $ruby := index $item 1 -}} - {{- index $item 0 -}} - {{- if $ruby -}} - ({{- $ruby -}}) - {{- else -}} - - {{- end -}} - {{- end -}} - -{{- end -}} -``` +| Language | Example | +| -------- | ------- | +| Japanese | {日本語}(にほんご)の{文法}(ぶんぽう)は{難}(むずか)しい | +| Chinese | {北}(Běi){京}(jīng)
{北}(ㄅㄟˇ){京}(ㄐㄧㄥ) | +| Korean | {韓}(한){國}(국) | +| Vietnamese | {河}(Hà){內}(Nội) | +| Other | I {love}(like) ruby! | -## Astro +## Remark +Recently I moved to Astro, which generally uses JavaScript tools for parsing and manipulating markdown. In particular that's the Remark and Rehype from Unified. + +When looking for a way to extend remark I first looked for an existing plugin which would allow me to automatically convert custom shorthands for ruby inserted into Markdown. I found a plugin called [remark-ruby](https://github.com/laysent/remark-ruby#readme), but honestly after looking at its source code I decided to hand roll my own solution. It just looked overcomplicated for something that should be simple and easy to modify (for me). + +I was able to write a really simple and short solution using a pair of Regexes working in conjunction to split strings and replace custom ruby shorthands with HTML, which then passes through to Rehype. + ```ts import { visit } from "unist-util-visit"; import type { Node } from "unist-util-visit/lib"; @@ -102,3 +62,49 @@ export default function ruby() { } } ``` + +Usage: +`{日本語}(にほんご)の{文法}(ぶんぽう)は{難}(むずか)しい` + +## Zola +The following is a snippet for the Tera templating engine which is inspired by Jinja2. + +```html + + {%- for item in expr | split(pat=";") -%} + {%- set sub_item = item | split(pat=",") -%} + {{- sub_item[0] -}} + {%- if sub_item[1] -%} + ({{- sub_item[1] -}}) + {%- else -%} + + {%- endif -%} + {%- endfor -%} + +``` + +Usage: +`{{ ruby(expr="日本語,にほんご;の;文法,ぶんぽう;は;難,むずか;しい") }}` + +## Hugo +The following is a snippet for the Golang templating engine used by Hugo. +```html +{{- with .Get 0 -}} + + {{- /* Generate the ruby markup */ -}} + {{- range split . ";" -}} + {{- $item := split . "," -}} + {{- $ruby := index $item 1 -}} + {{- index $item 0 -}} + {{- if $ruby -}} + ({{- $ruby -}}) + {{- else -}} + + {{- end -}} + {{- end -}} + +{{- end -}} +``` + +Usage: +`{{ ruby "日本語,にほんご;の;文法,ぶんぽう;は;難,むずか;しい" }}`