A static site of knowledge, tips and tricks that I've learned over the years, and wanted to gather together in a central place.

You don't need to build this repo. You can just browse the site here: https://kb.tomd.xyz

These are my unsanitised, community notes from my own learning. They are shared here for your benefit, for you to read.

No content from these pages should be taken as "best practices", advice, or scripts suitable for running production-level services. Please take time to understand what these scripts are doing to your system(s) before you execute them.

And of course, no warranty provided or liability assumed.

Create a local directory to cache build dependencies:

sudo mkdir /usr/local/bundle

Then run a build in a ruby container:

podman run --rm \
    -v "$PWD":/usr/src/site \
    -v /usr/local/bundle:/usr/local/bundle \
    -w /usr/src/site \
    -e JEKYLL_ENV=production \
    docker.io/library/ruby:2.7 /bin/bash -c "bundle install && bundle exec jekyll build"

To build the site and serve locally:

$ bundle install
$ bundle exec jekyll serve --livereload

The site will now be available at http://localhost:4000.

How to write things in this static site.

Internal links look like this:

[maven]: {{ site.baseurl }}{% link _articles/maven.md %}

Pull requests are welcome! If you see anything that needs improvement, please feel free to submit a PR.

Code licensed under GNU GPL v3. Content is (c) Tom and contributors.