wiki

commit b68394f4b95f3d486084ccadb4f041f4f861985b
parent d820b195f0b4bd9a9b0d9e15dbeb9cf426f74d07
Author: al1-ce <al1-ce@null.net>
Date:   Sun, 13 Jul 2025 01:16:00 +0300

add html-ruby and digraphs articles

Diffstat:
M
public/all_pages.md
 | 
7
++++---
A
public/wiki/html_furigana.md
 | 
61
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
R
public/wiki/Kagai_nihongo.md -> public/wiki/kagai_nihongo.md
 | 
0

A
public/wiki/vim_digraphs.md
 | 
10
++++++++++

4 files changed, 75 insertions(+), 3 deletions(-)
diff --git a/public/all_pages.md b/public/all_pages.md
@@ -1,5 +1,6 @@
 ||||
 |:-|:-|:-|
-|[aa](wiki/aa.md)|[maintenance](meta/maintenance.md)|[recursion](wiki/recursion.md)|
-|[index](/)|[markdown_flavour](meta/markdown_flavour.md)|[style_guidelines](meta/style_guidelines.md)|
-|[kagai_nihongo](wiki/kagai_nihongo.md)|[options](meta/options.md)|[style_test](meta/style_test.md)|
+|[aa](wiki/aa.md)|[maintenance](meta/maintenance.md)|[style_guidelines](meta/style_guidelines.md)|
+|[html_furigana](wiki/html_furigana.md)|[markdown_flavour](meta/markdown_flavour.md)|[style_test](meta/style_test.md)|
+|[index](/)|[options](meta/options.md)|[vim-digraphs](wiki/vim-digraphs.md)|
+|[kagai_nihongo](wiki/kagai_nihongo.md)|[recursion](wiki/recursion.md)|
diff --git a/public/wiki/html_furigana.md b/public/wiki/html_furigana.md
@@ -0,0 +1,61 @@
+# HTML furigana
+
+For providing furigana (kana on top of <ruby>世界<rp>(</rp><rt>せかい</rt><rp>)</rp></ruby>) for kanji or similar style markup `<ruby>`[^1] tag can be used.
+
+Structure of `<ruby>` tag might seem complicated at first but it's rather simple when you learn what each tag does.
+
+The above example can be shown as:
+
+```html
+<ruby>世界<rp>(</rp><rt>せかい</rt><rp>)</rp></ruby>
+```
+
+However it can also be shown as:
+
+```html
+<ruby>
+    世界
+    <rp>(</rp>
+    <rt>せかい</rt>
+    <rp>)</rp>
+</ruby>
+```
+
+Each of lines provides certain function, `<ruby>` tag itself wraps the furigana, `<rp>` tag provides support for legacy browsers to display furigana beside the kanji 世界(せかい) and `<rt>` provides furigana itself.
+
+If one would want to split furigana between kanji it can be easily done inside a single tag.
+
+<ruby title="World">
+    世
+    <rp>(</rp>
+    <rt>せ</rt>
+    <rp>)</rp>
+    界
+    <rp>(</rp>
+    <rt>かい</rt>
+    <rp>)</rp>
+</ruby>
+
+
+```html
+<ruby title="World">
+    世
+    <rp>(</rp>
+    <rt>せ</rt>
+    <rp>)</rp>
+    界
+    <rp>(</rp>
+    <rt>かい</rt>
+    <rp>)</rp>
+</ruby>
+```
+
+<style>
+rt {
+font-size: 0.5em;
+}
+</style>
+
+TODO: add furigana styling to index.html
+
+[^1]: https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/ruby
diff --git a/public/wiki/Kagai_nihongo.md b/public/wiki/kagai_nihongo.md
diff --git a/public/wiki/vim_digraphs.md b/public/wiki/vim_digraphs.md
@@ -0,0 +1,10 @@
+# Vim digraphs
+
+[[Vim]] provides an easy way to input printable non-ascii (usually unicode) characters with digraphs[^1].
+
+Example:
+- `Ctrl-k wa` - わ
+- `Ctrl-k Wa` - ワ
+- `Ctrl-k u=` - у
+
+[^1]: https://vimhelp.org/digraph.txt.html#digraphs