We use Jekyll as static site generator. You can read its docs here.
sudo gem install jekyll
sudo gem install jekyll-redirect-from
sudo gem install jekyll-paginate
jekyll serve
This blog requires ruby, jekyll and a bunch of other dependencies in specific versions. Managing these dependencies can become difficult over time and often the simplest solution is to use docker.
NOTE: Depending on the docker installation, the following commands might need to be run using sudo.
| Action | Local Jekyll | Using Docker |
|---|---|---|
| Building | jekyll build |
yarn docker-jekyll-build |
| Serving | jekyll serve |
yarn docker-jekyll-serve |
| Deplyoing | yarn deploy [...] |
yarn deploy --use-docker [...] |
These commands are intended to be used as straight forward replacements. There's one caveat though: They don't let one use additional parameters. E.g. one can not change the default port for serving, it is hard-wired to serve the site on http://localhost:4000.
Also if sudo is needed to run these tasks, the repo might end up owned by the super user which may be a slight inconvenience.