GitHub automatically builds the site whenever commits are pushed to the master
branch. You don't need to build and run the site locally, but it's useful when
developing large portions of the site.
- Install Bundler.
- Run
bundle installto install Jekyll and its plugins locally.
Run bundle update to update the local environent when needed (usually when the
Gemfile is updated).
Run bundle exec jekyll serve --incremental in the repository folder to start a
local webserver. The website should be regenerated whenever a file is changed.
The --incremental flag is not required, but it decreases regeneration times.
To make sure the build is clean, delete _site and .jekyll-metadata
beforehand (if they exist).
Files in the _posts folder are read as blog posts. To write a new blog post,
create a new file in said folder. Look at the files already present to see what
they should look like.