Gloss

フリガナや多言語併記を簡単に記述するためのライブラリ

提供するツール

Rustライブラリ

パーサー

no_std対応のパーサーをRustで提供します
構文木を生成します

HTML生成

$によるTeX数式記法を残し、HTMLを生成します

Webライブラリ

HTMLでこの記法を解釈して表示するライブラリをTypescriptで提供します
RustライブラリのWASMバージョンを使用します

日本語ふりがな

ruby記法は[漢字/かんじ]の記法です
全ての漢字にはrubyを付けます
片仮名や平仮名、数字や記号にrubyは付けません
rubyはglossの中にも外にも書けます
(例) [私/わたし]は[漢字/かんじ][仮名/かな][交/ま]じりの[文/ぶん]を[書/か]く

専門用語 英語併記

gloss記法を用いて{日本語/英語}のように英語を併記できます
A{B/b}Cと書くと、ABCと位置を揃えて描画され、Bの下に小さくbを表示します
つまり{ルビ[付/つ]き[日本語/にほんご]/japanese with ruby}
用語などに対してgloss記法で英語名を併記できます
(例) {[微分/びぶん][係数/けいすう]/derivative}は{[接線/せっせん]/tangent}の[傾/かたむ]きを[表/あらわ]す
(例) {カルボン[酸/さん]/carboxylic acid}は{[弱酸/じゃくさん]/weak acid}として{[水溶液/すいようえき]/aqueous solution}で{[電離/でんり]/ionize}しやすい。

他言語、多言語

gloss記法は複数の言語で併記するための記法です
日本語以外にも適用することができ、{日本語/フランス語/英語}のように複数の言語で併記することもできます
つまり、A{B/b/β}Cと書くと、ABCと位置を揃えて描画され、Bの下に小さくb、さらに下にβを添えて表示します
メインの表示はABCであるので、A,B,Cは全て同じ言語であることが推奨されます
これは例えば外国の固有名詞などで使用してください
ruby記法は中国語でのピンインの表示や、ギリシア文字やキリル文字のラテン文字転写の表示などにも使えます

日本語文で使用する例

(例) {[台湾/たいわん]/[台灣/Táiwān]}に[行/い]く
(例) [来年/らいねん]、{アテネ/Αθήνα}を[訪/おとず]れる[予定/よてい]だ
(例) {トルストイ/Лев Николаевич Толстой}の[小説/しょうせつ]を読む

英語文で使用する例

(例) Next spring, I want to visit {Firenze/Florence} and {Athens/Αθήνα}.
(例) I would like to visit {Nara/[奈良/なら]} and {Kyoto/[京都/きょうと]}.

中国語文で使用する例

話者向けの例(他言語併記)

(例) 我明年想去{佛罗伦萨/Firenze/Florence}和{雅典/Αθήνα/Athens}旅行。
(例) 我最近在读{维特根斯坦/Wittgenstein}的书。

学習者向けの例(ピンイン併記)

(例) [我/wǒ][在/zài][学/xué][校/xiào][学/xué][习/xí][汉/hàn][语/yǔ]。
(例) [明/míng][年/nián][我/wǒ][想/xiǎng][去/qù][台/tái][湾/wān][旅/lǚ][行/xíng]。

ギリシア語文で使用する例

(例) Μελετάμε {Βιτγκενστάιν/Wittgenstein} στη φιλοσοφία

その他の記法

$$による数式表示を破壊しません
つまり、$や$$で囲まれた内部の[/]や{/}はglossやrubyとして解釈しません
(例) [地表/ちひょう][付近/ふきん]に[多/おお]く[含/ふく]まれる[元素/げんそ]に[酸素/さんそ]$\mathrm{O_2}$・[珪素/けいそ]$\mathrm{Si}$・[アルミニウム/アルミニウム]$\mathrm{Al}$・[鉄/てつ]$\mathrm{Fe}$がある