Assume commands are to be run from within the app's root directory, values within angle brackets (<>
) are required, and commands should be executed in the provided order, unless stated or determined otherwise.
The predominant development environment was Windows Subsystem for Linux (WSL). Hence the provided commands are in/for WSL. Similarly, the app was designed to be run on Linux (Ubuntu 24.04) with Ruby version 2.7.2. For other dependencies, see Gemfile.lock.
sudo apt-get install ruby-full build-essential zlib1g-dev jekyll
gem install jekyll bundler
bundle install
(gem install
any missing gems)jekyll new .
- Modify _config.yml such as with Google Analytics tracking ID.
bundle exec jekyll serve
- Open the app in a web browser at localhost:4000.
Continuous delivery (CD) is done on any push or pull request via a GitHub Action defined at .github/workflows/jekyll.yml.