Vagrant file for a GitHub Pages-compatible Jekyll environment
Simple Vagrant file to build a GitHub Pages-compatible Jekyll environment. Uses the "official" github-pages gem. Use this environment to build and test your GitHub Pages-based Jekyll sites without polluting your host box.
How to use
Next, clone this repo:
git clone firstname.lastname@example.org:rjsilk/vagrant-github-pages.git
cd into that directory and start up the Vagrant vm:
cd vagrant-github-pages vagrant up
Finally, you can ssh into the vm and do all your Jekyll-related work in there:
The Vagrant vm is configured to forward port 8124 by default. So you can start a Jekyll server like so:
jekyll server --watch -P 8124
And then navigate to localhost:8124 on your host box.
Note on SSH-forwarding
The Vagrantfile enables ssh-forwarding so that you can use your host ssh keys to authenticate with github. Make sure to add you keys to the agent with
ssh-add before running
vagrant ssh if your keys aren't automatically added to the agent.