readme

Running locally:

1. https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll

Requires Ruby version 3.x, installed via brew install ruby.

cd docs
bundle install
bundle exec jekyll serve

Edit the CSS by changing main.scss.

Creating a new post

Create a new post in the docs/_posts directory. Prefix the filename with the date. Note that if you use a future date, jekyll will not render the post on the blog homepage. I.e. if the current date is 2024-12-30 and you use the date 2024-12-31, the post will not show up on the homepage.

Things we use:

1. Theme: https://github.com/yous/whiteglass
2. Linkify <h1>, <h2>, etc tags: https://github.com/allejo/jekyll-anchor-headings

Known issues

The site doesn't work via the url https://www.dasl.cc. This is because my username ends with a hyphen. But it works for all other combinations of the url, e.g. http://www.dasl.cc or https://dasl.cc.