sys42/docker-jekyll3 repository overview

⁠docker-jekyll3

⁠Jekyl 3.0 (BETA) running in a Docker container

⁠What's in the container?

Well, this is a running target, but for now:

• Ubuntu 14.04 including native build environment (build-essential)
• Python 2.7.6
• Ruby 2.2
• NodeJS 0.12.7
• Jekyll 3.0.0 beta 8 with various plugins

⁠Quickstart

When using in interactive mode with the settings from 'start.sh':

## change directory to the mount point 
cd /project

## generate skeleton in new subdirectory demo (must be done only once)
##
## If you wish to install jekyll into the current directory, you can do so by 
## alternatively running "jekyll new ." instead of a new directory name

jekyll new demo
cd demo

## IMPORTANT: serve website on all ips
jekyll serve -H 0.0.0.0

The setting -H 0.0.0.0 is necessary, otherwise you won't see anything from outside the container. If you use jekyll in interactive mode you can call just js which is an alias for jekyll serve -H 0.0.0.0.

Now navigate from outside to localhost:4000 or 127.0.0.1:4000 and you will see the generated website.

⁠Next Steps

• customize _config.yml in the project directory (email, site title etc.pp.)
• check the sources of some sites using Jekyll⁠
• ???

⁠Problems

• Highlighter pygments doesn't well behave on slow systems (it crashes jekyll with some weird error message). Environment variable MENTOS_TIMEOUT can be used to give the highlighter more time for its job. This image sets MENTOS_TIMEOUT to 20 (default:8) in /home/app.bashrc.

⁠Related Links

Jeykill Homepage⁠ Jekyll on Github⁠