aoxborrow / jekyll-ansible-vagrant

Jekyll-Ansible-Vagrant Starter Pack

Jekyll-Ansible-Vagrant Starter Pack

Description

This is a starter pack for quickly developing a new Jekyll project locally with Vagrant, which is then easily deployed with Github Pages. It is based on a stock Ubuntu 14.04 base image, and uses Ansible to install and configure the basic services you'll need:

• Ruby 2.2 & Bundler
• Github-Pages gem (this includes Jekyll)
• Node.js (Jekyll requirement)

Features

• fully self-contained, installs Ansible within the VM
• develop with local Jekyll server, then deploy to Github Pages
• update Github Pages dependencies with vagrant provision

---

Quick start, developing locally

0. Install Vagrant (Requires 1.8.2+)

1. Clone this repo:

   git clone [e-mail]:paste/jekyll-ansible-vagrant.git
   

2. Modify your computer's local /etc/hosts:

   192.168.33.33   jekyll.local
   

3. Build your Vagrant VM:

   vagrant up

4. Log into the VM and start local Jekyll server:

   vagrant ssh
   cd /vagrant
   jekyll serve --host 0.0.0.0 --port 80

5. Visit your app:

   http://jekyll.local
   

6. Profit ✔️