louisesteward / learn

Bettercare learning programmes

Bettercare learning programmes

These books are created with the Electric Book, a Jekyll template for making books, ebooks and book-like websites.

Usage

The staging site includes the docs.

The live website is hosted at bettercare.co.za/learn. To build the HTML for the live website, don't use the usual output script. Instead:

1. Open a Terminal (or Command Prompt in Windows) in the /learn folder (or navigate to the folder in the Terminal, i.e. by using cd).

2. Then enter:

   bundle exec jekyll serve --config="_config.yml,_configs/_config.live.yml"
   

3. If you have errors, check that you have installed dependencies. The easiest way to do this is to run the usual output script and select the 'Install/update dependencies' option.

Processing images

This repo includes a script that converts any images in book/images/_source into the correct formats and saves them into the relevant output image sets in book/images/, such as book/images/web and book/images/print-pdf. It only processes images in _source that are newer than those in book/images/web.

To use this, you must have installed:

• Gulp
• GraphicsMagick

Then, from a Terminal/Command Prompt in the learn folder, enter this command:

gulp --book directory

where directory is the book directory for which you want to process images. E.g.

gulp --book perinatal-hiv

Licence

This repository contains two licences:

• a Creative Commons Attribution, Non-commercial, No-derivatives licence, which covers the Bettercare learning-programme content
• a GPL3 licence, which covers the software.