ExCL's Main Website

This repository contains the source for a Jekyll powered website for ExCL hosted at https://excl-docs.github.io/ExCL-Website/. If you have any questions about the source please contact Aaron Young at [email protected].

Prerequisites

Jekyll must be install first before building the website.

Here are the steps for Ubuntu from the above link:

Jekyll on Ubuntu

Install dependencies

Install Ruby and other prerequisites:

sudo apt-get install ruby-full build-essential zlib1g-dev

Avoid installing RubyGems packages (called gems) as the root user.
Instead, set up a gem installation directory for your user account. The following commands will add environment variables to your ~/.bashrc file to configure the gem installation path:

echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Finally, install Jekyll and Bundler:

gem install jekyll bundler

That’s it! You’re ready to start using Jekyll.

Install Prerequisites for project.

Next the gems used by the site must be installed with

bundle install

Serving the website locally for testing

In order to serve the website locally on a test server, with draft posts included, and with live reloading, use the command:

bundle exec jekyll serve --drafts --livereload

or 

./serve.sh

Deploying the website

In order to deploy the website, use the helper script deploy.sh.

Updating Jekyll

In order to update Jekyll use bundle update

Tools

• A create-thumbnails script is found in tools/create-thumbnails. It can be used to create lower resolution thumbnails for use in a Jekyll gallery.