This repository consists of a Vagrant configuration plus provisioning Bash script that let you easily vagrant up
a local mirror of any Github Pages repository. It accompanies my blog post: Vagrant, Jekyll and Github Pages for streamlined content creation.
Getting started is straightforward:
$ git clone https://github.com/kappataumu/vagrant-up-github-pages.git
$ cd vagrant-up-github-pages
$ export REPO='https://github.com/kappataumu/kappataumu.github.com.git'
$ vagrant up
That's all there is to it. Now you can:
- Access your website by browsing to
http://localhost:4000
. - Edit your website locally, from within the
www
subfolder. - Simply
vagrant up
directly in the future to start the guest (no bootstraping needed).
Jekyll will:
- Recompile everything when changes are detected.
- Log all activity in
/home/vagrant/jekyll.log
. - Automatically start serving your repo on every
vagrant up
.