My personal website. Built with Jekyll, a static website generation framework, and hosted on Netlify.
The site can be developed in either Linux, Windows, or using the Linux Subsystem for Windows. The instructions below can be followed to get the site up and running locally in any of these environments.
The following system dependencies must be installed to build and run the project locally.
- Node + NPM. The version that should be used is noted in the
.nvmrc
file. A node version manager may be helpful when working on a development machine with multiple projects:- On Linux, use nvm
- On Windows, use nvm-windows
- Ruby + Rubygems. The version of Ruby that should be used is noted in the
.ruby-version
file. A ruby version manager may be helpful when working on a development machine with multiple projects:- On Linux, use rbenv
- On Windows, use RubyInstaller
- Bundler: After Ruby + Rubygems has been installed, run
gem install bundler
- Rake: After Ruby + Rubygems has been installed, run
gem install rake
Once the above dependencies have been installed, add the application dependencies by running the following commands:
npm ci
bundle install
To run the development server bundled with Jekyll, run the following:
npm start
See .vscode/extensions.json for a list of VS Code extensions that are supported/recommended to be used during development.
To run tests on the site execute the npm test
task:
npm test