This is my mostly-code blog! It runs on Jekyll and is forked from the Hyde theme.

Run server

Serve: make serve

Is Ruby working? If not:

rvm get stable --auto-dotfiles
rvm use ruby-2.6.3

Writing posts

Daily notes

To generate a daily micro-note: make daily.

Images

Store images in assets/images.

Include as:

<img src="{{site.baseurl}}/assets/images/MY_IMAGE_NAME.EXT" />

Caption images with: <p class="caption"></p>.

Implementation notes to self

Tag pages

Tag pages are auto-generated via a Python script which is auto-run on :post_write by a Jekyll hook.

Jekyll hooks are a subtype of plugins. The build tool expects to see .rb files placed in the _plugins directory.

Implementation references

• Implement tags in Jekyll
• Automatic generation of category/tag pages in Jekyll
• site.url vs site.baseurl
• Spotify embeds

TODO

• separate "topic" tags
• per-page comments plugin (disqus?)
• refactor all existing posts to a Jekyll category named code so I can use this blog for other things too
• tagged microblog posts don't show up on tag pages
• basic analytics
• RSS feed
• meta info/img for embeds