Odds and ends—hopefully at least some interesting blog posts!
The base setup is based on duplone.github.io, see BSD-3. Further—less direct—inspirations include gwern.net and Practical Typography.
For various definitions of "notable".
-
Sidenotes with the help of Tufte CSS. Unlike most implementations, SideNotesHTML.hs, which is now part of the
pandoc-sidenote
library, allows arbitrary blocks to be placed inside of sidenotes. -
In comparison to pandoc's default, better syntax highlighting via the
pygmentize
command line utility. -
All LaTeX output is pregenerated with KaTeX and directly embedded in the HTML. This is both faster when loading the page, and does not require any JavaScript on the client side.
Interfacing with KaTeX is done with math.ts, a tiny TS script originally from here, which starts up a server that one can talk to. See the relevant hlKaTeX function for more information.
-
Automatic smallcaps for certain abbreviations, like
HTML
orGNU
. As such, a font that actually supports this (instead of rescaling capital letters) is also provided. -
Section marks when hovering over a heading, linking to the respective section.
-
Citation handling with BibTeX.
-
Straightforward file inclusions with pandoc's fenced divs.
-
Fully featured fonts that are not 2mb in size—see here for some prose, as well as here for the relevant script.
The tiny Makefile should be reasonably self-explanatory.
The TL;DR is to use make
to build the website once,
or make watch
to create an updating preview on localhost:8000
.