Instantly share code, notes, and snippets.

Embed
What would you like to do?
Setting up the Electric Book toolset on OSX

Setting up the EBW tools on Mac OSX

These steps have worked for us on several machines. Every machine is a bit different, so your mileage may vary.

On Windows? I've written up guidance for installing Jekyll on Windows here.

  1. Install Homebrew (without XCode -- you do not need to install XCode!). This is done in two steps from the Terminal. See ryanwinchester.ca/posts/installing-homebrew-without-xcode. Essentially:

    1. Install XCode developer tools (lets Homebrew work):

    xcode-select --install

    1. Install Homebrew (lets you install things easily):

    ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

    On some systems, this doesn't work and you need to include the full path to Ruby:

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  2. Install the latest Ruby:

    brew install ruby

    To check whether that worked, enter ruby --version. If it doesn't list a recent version of Ruby (2.4 or later), you may have to add the new version to your path.

  3. Install Jekyll:

    gem install jekyll

  4. Install Bundler:

    gem install bundler

  5. Download and install PrinceXML. See princexml.com/doc/installing for instructions. Note that this is proprietary software (the only proprietary tool we use). You can try the trial version for free; it adds a watermark to your first page.

  6. Install PhantomJS. This is necessary for PDFs that contain maths and for building search indexes for websites. Download from phantomjs.org. Extract the zip archive and copy the phantomjs executable file in bin to your machine's /usr/local/bin folder.

  7. Install Pandoc if you're going to export to Word:

    brew install pandoc

  8. Install Git for version control. If you're new to Git, try GitHub Desktop. (Git isn't easy to understand at first, but it's worth the effort.)

  9. Install a good text/code editor. I like VS Code and Sublime Text 3. Brackets is also good. (Atom is lovely, but has a markdown bug that may also affect Brackets and VS Code.)

  10. Install Gulp and Graphicsmagick. We use these to create multi-format images. To do this:

    1. Install Node.js.

    2. Install gulp: npm install --global gulp-cli

    3. Install GraphicsMagick: brew install graphicsmagick --with-little-cms2

      Note that if you have already installed GraphicsMagick but without specifying --with-little-cms2, you will need to brew uninstall graphicsmagick first. Little CMS is required for managing colour profiles during image conversions, but it is not installed by default.

App dependencies

If you also want to create apps, you will need to install:

  1. Apache Cordova
  2. Android Studio for Android apps
  3. X-Code for Apple apps
  4. Visual Studio for Windows apps

The Electric Book scripts will use these in the background, and for some build steps you'll have to use these directly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment