A number of OME websites are produced using Jekyll, including
These sites can be built and tested by installing a local copy of Jekyll. The help and Figure sites are also built by CI jobs, see Documentation jobs.
Jekyll can be installed as a system application (requires administrator privileges) or for a single user.
Install a recent version of Ruby. Recent versions of OS X and Linux may already include a suitable version, however you will require administrator privileges to install Jekyll. Alternatively on OS X you can use Homebrew, and on Linux either rbenv or RVM:
brew install ruby
gem install jekyll
In a terminal enter the local git checkout and run:
jekyll serve -w -b ''
This will build the web pages and start a local server on http://localhost:4000/. Jekyll should automatically rebuild the pages when changes are made to the source files, and will override any baseurl defined in _config.yml.