Docker containerization for jekyll tasks

Makefile

@@ -0,0 +1,23 @@
+#!/usr/bin/make
+
+SHELL := /bin/sh
+
+JEKYLL_VERSION := 3.8
+
+UID := $(shell id -u)
+GID := $(shell id -g)
+
+DOCKER_RUN := docker run --rm
+DOCKER_VOLUMES := --volume="${PWD}:/srv/jekyll" --volume="${PWD}/vendor/bundle:/usr/local/bundle"
+DOCKER_ENV := --env JEKYLL_UID=${UID} --env JEKYLL_GID=${GID}
+DOCKER_PORT := -p 4000:4000
+DOCKER_IT := -it jekyll/jekyll:${JEKYLL_VERSION}
+
+build:
+	$(DOCKER_RUN) $(DOCKER_VOLUMES) $(DOCKER_ENV) $(DOCKER_IT) jekyll build
+
+update:
+	$(DOCKER_RUN) $(DOCKER_VOLUMES) $(DOCKER_ENV) $(DOCKER_IT) jekyll update
+
+serve:
+	$(DOCKER_RUN) $(DOCKER_VOLUMES) $(DOCKER_ENV) $(DOCKER_PORT) $(DOCKER_IT) jekyll serve

README.md

@@ -1,17 +1,51 @@
-This site is built using Jekyll and hosted on GitHub Pages.
+# CoopCycle Docs Repo
 
-To install:
+This site is built using [Jekyll](https://jekyllrb.com/) and hosted on [GitHub Pages](https://pages.github.com/).
+
+## Environment
+
+### Local
+
+Install Jekyll and project dependencies:
 ```
 gem install bundler jekyll
+bundle install
 ```
 
-To run it locally:
+Serve it locally:
 ```
-bundle install
 bundle exec jekyll serve --safe
 ```
 
-### Documentation
+Build Static Site:
+```
+bundle exec jekyll build
+```
 
-The URLs will map the folder tree (they are not configured with a `.yml` file).
+Update dependencies:
+> Note: it modifies Gemfile.lock
+```
+bundle exec jekyll update
+```
+
+### Docker
 
+Serve it and browse to it: [Open](http://localhost:4000)
+```shell
+make serve
+```
+
+Build Static site:
+```
+make update
+```
+
+Update dependencies:
+> Note: it modifies Gemfile.lock
+```
+make update
+```
+
+## Documentation
+
+The URLs will map the folder tree (they are not configured with a `.yml` file).