The most famous markup language for human being is Markdown. Most static site generators support this language. But the basic Markdown has very limited (no footnote, no italics, no underline, etc.). There are some extension of Markdown, but currently it is a mess and there's not any standards yet. Oops.

Of course, this disadvantage can be overcame by Shortcodes, but I don't want tons of non-standard and ugly shortcodes in my article.

Another choice is reStructuredText. It is very popular among the Python community. rSt has more that enough language features, but it looks really confusing.

At last, there is the Org-mode, a killer application on Emacs. Since it is so tightly connected to Emacs, there are few good Org-mode parsers for other languages. Fortunately, Hugo has a quite good Org-mode parser.

I've been using Emacs and Org-mode for GTD and note-taking for a long time now, but for writing blog, I used Markdown with shortcode before. Then I discovered Hugo can do Org-mode, and that's far more comfortable for me.

(One of the reason I want to switch from WordPress is the intergrated Google Fonts is painfully slow when accessing from China and it is a hassle to remove them)

Font matters! When reading an article, people are reading the text, but not the fancy background or animations.

For latin characters, I decided to intergrate webfonts to unify the look on platforms. Here the fonts I chose:

• Vollkorn - Serif
• IBM Plex Sans - Sans-serif
• Iosevka Type - Monospace

I don't have much choice about Chinese characters though. The number of glyphs are much higher than latin characters. Thus, a font file for Chinese could be very big. For example, a font file for sigle font weight Google's Noto Sans CJK could take up 16M to 25M. (Imagine you click this site and it eat you 30M+ of bandwith, oops.) It is quite unacceptable for a website, so I have to choose from fonts came with the operating system.

It is no huge issue for macOS and GNU/Linux users. macOS has Hiragino Sans GB and Songti SC (华文宋体), and most recent Linux distros have Source Sans CJK and Source Serif CJK. All pretty good fonts, but it is not the case on Windows…

Microsoft YaHei is not bad, the trouble is serif. Without Microsoft Office installed, the only choice is SimSum, which is an awful font for HiDPI screens (it has been there for decades…)…

The only problem with Microsoft is they just have no taste, they have absolutely no taste,” he said. “I don’t mean that in a small way. I mean that in a big way, in the sense that they don’t think of original ideas and they don’t bring much culture into their product.”

– Steve Jobs

The solution? Just use Microsoft YaHei for every single Chinese text under Windows, screw it!

Hugo came with an internal font highlighting library (chroma, to be specific). But compared to Pygments, Chroma has less supported languages, so I stick with Pygments.

The color scheme is adapted from tomorrow-pygments.

(Let's just pretend I will write math stuff here…)

\( \KaTeX \) is used to render Math equations, hope it is quicker than MathJax.

Since it is a blog but not a Web App, we don't need many JavaScript.

So, a progress meter (also a Back to Top button) and fold function, and that's it.