How This Blog Works

Requirements

• Math. Preferably Latex.
• Citations. I like to cite stuff.
• Figures and pictures and references to thereof.
• Be able to export to Github Flavored Markdown.

The Stack

• All documents are in Markdown. Specifically Pandoc Markdown. Obviously, the source is processed via pandoc.

• The site itself is compiled using Hugo.

  The current version (as of this writing) doesn’t support any configuration when using Pandoc for markup processing. By default Hugo only passes the --mathjax option to the pandoc invocation. So I had to make some local modifications so that I can specify filters and some other options to support citations and references.

  Pull request is here.

• Hugo output – which is a static HTML site – gets pushed out to a separate private GitHub repository.

• Netlify monitors this separate GitHub repository and updates this blog.

  As a bonus, the generated static content is pushed out to my GitHub Pages site. So there’s an easier to remember URL than https://අ.com.

• Secondary sites are fed via Pandoc which converts from Pandoc Markdown to Github Flavored Markdown.

  Why secondary sites? For various reasons, the primary site for some of the articles need to be their own GitHub repository. E.g. https://github.com/asankah/identity-domains .

  For all those sites, the primary source is the blog. That way I can use Pandoc, use citations, use math etc. and things will “just work” when publishing to another site that expects GitHub flavored Markdown.