Getting started

• Install ruby, e.g., with mise
• gem install bundler
• bundler install - use the Gemfile to install dependencies
• make serve to serve locally
• make build to build locally

Notes

• See the original repository for help
• See the creator's personal website and the corresponding repo

Writing math

The GitHub Pages gem renders pages using kramdown and the MathJax option. This leads to some weird results, where whole blocks get commented out. I found the simplest answer was the bypass kramdown altogether by wrapping paragraphs around double-dollars:

<p>
$$
x = y
$$
</p>

This way, kramdown doesn't touch anything inside, and MathJax finds the $$ and works its normal magic.