Create a gist now

Instantly share code, notes, and snippets.

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's a bit different, so your mileage may vary.

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 Essentially:

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

    xcode-select --install

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

    ruby -e "$(curl -fsSL"

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

    /usr/bin/ruby -e "$(curl -fsSL"

  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 for instructions.

  6. Install PhantomJS, if you're making print-pdf books with maths. Download from 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 GitHub Desktop for version control. See (Note that Git isn't easy to understand, but it's worth the effort.)

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

  10. If your project uses Gulp (e.g. to create web-optimised images):

    1. install Node.js
    2. install gulp: npm install --global gulp-cli
    3. Install GraphicsMagick: brew install graphicsmagick
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment