I'm using Windows. Doing this on Linux is probably simpler. This process describes how to install everything necessary to build and serve your github_pages project locally so you don't have to commit and push to test every little change. This is documented on github too.
- Install Ruby: I installed the latest release of Ruby+devkit. Devkit is probably not required but I'm a professional software developer by trade so...why not.
- Install Bundler
- Create a Gemfile Your repo needs a Gemfile in the root. This repo has a Gemfile, so if you start with this repo, you can skip this.
- Open a shell to the root of the repo and run
bundle install. This will install all the necessary gems. - Create Personal Access Token: This is required to fix the
Open a git bash shell at the repo root (or wherever your publishing root is set).
bundle exec jekyll serve- Open your site in your browser