1 d7de9ba6 2020-12-29 op I like text/gemini. I like writing in this format. At first, it was a bit limitating, like, I want *bold*, /italic/, _underline_, ~striked~, [inline links](…), , ! (?) etc. But I as started writing (by the way, every post in the last 3 months was written in text/gemini) I found myself pretty accustomed to it. I really like the idea of one link-per-line.
3 d7de9ba6 2020-12-29 op I also started writing text/gemini outside this blog. The INSTALL file for gmid is written in text/gemini. The README for tango (a new hack, will write about that later) is also written in text/gemini.
5 d7de9ba6 2020-12-29 op => https://git.omarpolo.com/gmid/about/ gmid repository
6 d7de9ba6 2020-12-29 op => https://git.omarpolo.com/tango/about/ tango repository
8 d7de9ba6 2020-12-29 op (they’re only gemini-related things, so using text/gemini for documentational/presentational purpose seems appropriate.)
10 d7de9ba6 2020-12-29 op I also have a public (HTTP-only for the time being) git repository, powered by cgit.
12 d7de9ba6 2020-12-29 op If you sum this two things, you’ll reach the logical conclusion that I need a filter for cgit to display text/gemini over HTTP.
14 d7de9ba6 2020-12-29 op Cgit has this cool things called filters: you can write script (or any executable really) that accept input in a particular format and output HTML and cgit will use it to render pages.
16 d7de9ba6 2020-12-29 op There are a few text/gemini to HTML converters, but I rolled my own. NIH. Well, not really. I currently run cgit on a FreeBSD jail, and I don’t like the idea of installing too much things inside it. I could have built a (say) go executable linked statically and copied into the jail, but I don’t really like the idea.
18 fec02a6b 2021-02-13 op Instead, I wrote an AWK script to convert text/gemini files to HTML. I was kinda surprised that nobody had already written one in AWK (or Perl). It isn’t too ugly, and was an chance to review the language.
20 d7de9ba6 2020-12-29 op AWK is, in my opinion, an almost perfect scripting language. It is quick, easy to learn and to use (both as a filter in pipe and as a standalone script) and packed with nice and essential features. But it lacks something. I don’t know exactly what, but every time I use it (for more than a one-liner) I get the impression that something is missing.
22 d7de9ba6 2020-12-29 op Anyway, here’s the script in all its glory. This time I discovered the “next” statement, that unfortunately cannot be used inside a function (probably for a good reason).
24 d7de9ba6 2020-12-29 op (it’s open to improvements, but at the moment I’m happy with it)
26 bb54dbe9 2021-08-03 op EDIT 2021/02/03: after seeing another decoder, I took some time to refactor the original converter. I reordered the matches so the pre handling is before everything else.
28 fec02a6b 2021-02-13 op => https://gist.github.com/dracometallium/bf70ae09b4dd9a857d33e93daa2810c4 dracometallium’ gmi2html.awk
31 d7de9ba6 2020-12-29 op #!/usr/bin/awk -f
38 d7de9ba6 2020-12-29 op !in_pre && /^```/ {
40 d7de9ba6 2020-12-29 op if (in_list) {
42 d7de9ba6 2020-12-29 op print("</ul>");
44 d7de9ba6 2020-12-29 op print "<pre>";
47 d7de9ba6 2020-12-29 op in_pre && /^```/ { in_pre = 0; print "</pre>"; next }
48 d7de9ba6 2020-12-29 op in_pre { print san($0); next }
50 fec02a6b 2021-02-13 op /^###/ { output("<h3>", substr($0, 4), "</h3>"); next }
51 fec02a6b 2021-02-13 op /^##/ { output("<h2>", substr($0, 3), "</h2>"); next }
52 fec02a6b 2021-02-13 op /^#/ { output("<h1>", substr($0, 2), "</h1>"); next }
53 fec02a6b 2021-02-13 op /^>/ { output("<blockquote>", substr($0, 2), "</blockquote>"); next }
54 fec02a6b 2021-02-13 op /^\*/ { output("<li>", substr($0, 2), "</li>"); next }
57 fec02a6b 2021-02-13 op $0 = substr($0, 3);
60 fec02a6b 2021-02-13 op output_link(link, $0);
64 fec02a6b 2021-02-13 op // { output("<p>", $0, "</p>"); next }
70 d7de9ba6 2020-12-29 op print "</pre>"
73 d7de9ba6 2020-12-29 op function trim(s) {
74 d7de9ba6 2020-12-29 op sub("^[ \t]*", "", s);
78 d7de9ba6 2020-12-29 op function san(s) {
79 d7de9ba6 2020-12-29 op gsub("&", "\\&", s)
80 d7de9ba6 2020-12-29 op gsub("<", "\\<", s)
81 d7de9ba6 2020-12-29 op gsub(">", "\\>", s)
85 fec02a6b 2021-02-13 op function output(ot, content, ct) {
86 d7de9ba6 2020-12-29 op content = trim(content);
88 d7de9ba6 2020-12-29 op if (!in_list && ot == "<li>") {
93 d7de9ba6 2020-12-29 op if (in_list && ot != "<li>") {
95 d7de9ba6 2020-12-29 op print "</ul>";
98 d7de9ba6 2020-12-29 op if (ot == "<p>" && content == "")
101 fec02a6b 2021-02-13 op printf("%s%s%s\n", ot, san(content), ct);
104 d7de9ba6 2020-12-29 op function output_link(link, content) {
105 d7de9ba6 2020-12-29 op if (in_list) {
107 d7de9ba6 2020-12-29 op print "</ul>";
110 d7de9ba6 2020-12-29 op if (content == "")
111 d7de9ba6 2020-12-29 op content = link;
113 d7de9ba6 2020-12-29 op printf("<p><a href=\"%s\">%s</a></p>\n", link, trim(san(content)));
