Site Docs & Previews: Update Site Building/Previewing Docs

* New plugin: remove-html-extension falls back to /foo.html when /foo
  isn't found in `jekyll serve` mode.

* New Makefile target: `make preview` runs bundle exec jekyll serve

* Updated site docs to describe installing all required dependencies.
  Fully tested using a new install of Ubuntu Server 14.04.1
This commit is contained in:
David A. Harding 2015-04-12 14:14:52 -04:00
parent 6a42d7b861
commit 3eee4811fd
No known key found for this signature in database
GPG key ID: 4B29C30FF29EC4B7
5 changed files with 174 additions and 53 deletions

View file

@ -14,6 +14,10 @@ JEKYLL_LOG=._jekyll.log
## `make` (no arguments): just build
default: build
## `make preview`: start the built-in Jekyll preview
preview:
$S bundle exec jekyll serve
## `make test`: don't build, but do run all tests
test: pre-build-tests post-build-tests
@ -93,8 +97,13 @@ build:
## Jekyll annoyingly returns success even when it emits errors and
## exceptions, so we'll grep its output for error strings
#
## FIXME: temporarily ignoring errors from WEBrick because
## _plugin/remove-html-extension does something hackish until we upgrade
## to Jekyll 3.0.0
check-for-build-errors:
$S egrep -i '(error|warn|exception)' $(JEKYLL_LOG) \
| grep -vi webrick.*filehandler \
| eval $(ERROR_ON_OUTPUT)