hugo and gemini article

.gitignore

@@ -10,6 +10,7 @@ node_modules/
 docs/
 
 *.class
+.certificates
 
 books/**/*.idx
 books/**/*.lof

content/post/2021/03/exploring-the-alternet.md

@@ -2,6 +2,8 @@
 title: Exploring the AlterNet
 subtitle: The Web sucks. Long live the Web!
 date: 2021-03-24
+tags:
+    - gemini
 categories:
     - webdesign
 ---

content/post/2021/04/using-hugo-to-launch-a-gemini-capsule.md

@@ -0,0 +1,50 @@
+---
+title: Using Hugo to Launch a Gemini Capsule
+subtitle: gemini://brainbaking.com was launched!
+date: 2021-04-03
+tags:
+    - gemini
+    - accessibility
+categories:
+    - webdesign
+---
+
+As you can read in the "[exploring the AlterNet](/post/2021/03/exploring-the-alternet/)" article, I've had my eye on Gemini for a few weeks now. Ever since discovering the new protocol thanks to a couple of weird Mastodon toots, I've been thinking about how to set up a "capsule" (they're not called sites) for myself. I like the appeal of a text-focused, no-whizzbang protocol where the focus is on contents, not aesthetics, especially for blogs such as this one.
+
+A few questions needed to be answered before switching to action modus and letting the static site generator Hugo do our dirty Gemini work for us.
+
+## How to host a Gemini capsule?
+
+There are many pieces of [Gemini software](https://gemini.circumlunar.space/software/) available to us, but they're all quite new, as the protocol itself is from 2019. I was keen on trying out a simple Go server, but both `go-gemini-server`, `shavit`, and `go-gemini` required me to build it myself and contained very little documentation. Furthermore, some packages weren't updated in more than a year... In the end, I decided to go with [Agate](https://github.com/mbrubeck/agate), a simple Gemini server written in Rust that can serve static files. It has binaries for every platform, was updated six days ago, and its `README.md` it extensive. 
+
+Agate even generates the needed TLS certificates if none are provided. This allowed me to quickly set up a localhost server using the command `agate --content docs/gemini --addr 0.0.0.0:1965 --hostname localhost --lang en-US`. Fun fact about the port number:
+
+> When Gemini is served over TCP/IP, servers should listen on port 1965 (the first manned Gemini mission, Gemini 3, flew in March '65).
+
+Running locally before pushing to a server was important to me as I wanted to fiddle with the `.gmi` files first to see how they look like in my Gemini browser/client, [Lagrange](https://gmi.skyjake.fi/lagrange/). Gotta double-check the ASCII art!
+
+## What to publish on Gemini?
+
+This is very personal. There are a few options. People like [Drew DevVault](gemini://drewdevault.com/) and [Sylvain Durand](gemini://sylvaindurand.org) mirror their HTTP(S) blog on Gemini, meaning all blog entries are consultable both over the web and over Gemini. Then there are more personal articles, published solely on Gemini to accompany the usually more technical HTTP blogs, such as [gemini://space.eli.li/](gemini://space.eli.li/). He claims to use it to whine like we did on MySpace yesteryear.
+
+I wanted to blog in Dutch, my mother language, for a while now, and I've tried it a few years back on Brain Baking. It didn't work out. The entries were misplaced somehow and I wasn't satisfied, even though I did not expect to actually have readers. I hoped to use a new domain, `wouter.gr`, for a Dutch Gemini capsule to do some personal whining. That sounded like a good plan.  
+
+The plan fell through. Instead, I decided to mirror Brain Baking. Why? 
+
+- I already whine in Dutch in my personal diaries using a fountain pen. I do not want to give that up. 
+- I already have a (nice?) blog, and I'd like to expand the Gemini space-i-verse by adding my existing articles to it. I already write in Markdown, so a conversion would be not too difficult.
+- I don't think I can keep up with posting on yet another blog, since I also occasionally write about retro games on [jefklakscodex.com](https://jefklakscodex.com).
+
+## How to publish on Gemini?
+
+Right. Porting articles turns out to be ridiculously easy with the help of my good old friend, Hugo. [Sylvain's method](https://sylvaindurand.org/gemini-and-hugo/) for declaring Gemini as a custom Hugo output format turned out to work flawlessly. All credits go to him. However, I did make a few significant changes to the link replacement system. 
+
+Gemini pages cannot have inline links, so I had to strip out Markdown-style `[]()` links and place them on a separate paragraph using `=> link title`. A simple find-and-replace, like in Sylvain's method, is quite ugly if you use inline links extensively like I do. It breaks up the text and the result is a difficult to read Gemlog (that's a Gemini blog!). In my approach, I collect all links, replace them with a reference number like in academic papers (`[1]`), and add a section called "References" on the bottom of the article to list them all. This is what it looks like:
+
+![](../gemini.jpg "My Gemini AlterNet article in Lagrange.")
+
+I'm quite pleased with the result, although the code itself is far from pretty, as Gemini is very newline-sensitive, and I had to jam a bunch of Hugo-specific regex functions together. Source code available at GitHub: [index.gmi source](https://github.com/wgroeneveld/brainbaking/blob/master/layouts/index.gmi), [single.gmi source](https://github.com/wgroeneveld/brainbaking/blob/master/layouts/_default/single.gmi). Next to the link change, I also replaced all `-` and `1.` (number) lines, that are enumerators in Markdown, with `*` ones, which is the only supported enumerator in Gemfiles. 
+
+I tried to design the index and single layout files as similar as possible to their html variants, while focusing in simplicity. Related articles are also visible at the end of an article, and the index file simply contains a short bio followed by an overview of all posts, groupbed by year and month, just like in my [html /post overview](/post). After defining `[outputFormats.GEMINI]` in my Hugo `config.toml`, all that was left is to use `rsync` to copy over the gemini subfolder to an appropriate location that gets picked up by Agate. Job done!
+
+Now, the the most important question, "why publish on Gemini" could be answered with "because it's easy!". I'm not yet sure if that answer is very satisfactory, but at least Brain Baking got launched in Space today! All that is left is to submit it to the GUS Gemini Universal Search engine...

package.json

@@ -12,7 +12,8 @@
     "@babel/preset-env": "^7.10.1"
   },
   "scripts": {
-    "jamstack": "node jamstack-init.js"
+    "jamstack": "node jamstack-init.js",
+    "gemini": "agate --content docs/gemini --addr 0.0.0.0:1965 --hostname localhost --lang en-US"
   },
   "repository": {
     "type": "git",