vagrant-up-github-pages

vagrant-up-github-pages

Vagrant configuration that lets you easily spin up a local Jekyll-powered GitHub Pages server

Download

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:

  1. Access your website by browsing to http://localhost:4000.
  2. Edit your website locally, from within the www subfolder.
  3. Simply vagrant up directly in the future to start the guest (no bootstraping needed).

Jekyll will:

  1. Recompile everything when changes are detected.
  2. Log all activity in /home/vagrant/jekyll.log.
  3. Automatically start serving your repo on every vagrant up.
minimalacademicresumeportfoliodocumentationwikitailwindbootstrapdarkecommercegithub-pagesblog