Template repo for external media for large Electric Book projects
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_tools/profiles
book/images/_source
.gitignore
LICENSE
README.md
gulpfile.js
package-lock.json
package.json
run-linux.sh
run-mac.command
run-windows.bat

README.md

Electric Book media

This is a template repo for storing images separately from an Electric Book project. This is useful when your book contains many images, and would make the main project repo too big.

This content is managed using the Electric Book workflow. See the EBW docs for how this works.

In particular, see the docs on using external media.

Usage

Image resizing, JavaScript linting and minifying

We use the task runner Gulp for these tasks. You can run gulp to generate smaller, optimised, version of the images in the book/images/print-pdf directory and automatically put them into the book/images/web, book/images/screen-pdf, and book/images/epub directories.

First, we need to install Gulp, NodeJS (which Gulp requires), and GraphicsMagick (which we need behind the scenes for the image resizing).

Install Node

Head to nodejs.org and download and install the latest version. If you're using MacOS, it's best to use Homebrew to do this (by running brew update then brew install node).

Install Gulp and our dependencies

From the terminal / command line run npm install gulp-cli -g to install gulp. This installs gulp on your system.

Once that's finished run npm install to install the dependencies we need, listed in package.json.

Install GraphicsMagick

Head to the downadload secrion of graphicsmagick.org and download and install GraphicsMagick for your system. Use the Q16 version for best results with colour conversions.