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.
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:
- Install XCode developer tools (lets Homebrew work):
- 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)"
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.
gem install jekyll
gem install bundler
Download and install PrinceXML. See princexml.com/doc/installing for instructions.
Install PhantomJS, if you're making print-pdf books with maths. Download from phantomjs.org. Extract the zip archive and copy the
phantomjsexecutable file in
binto your machine's
Install Pandoc if you're going to export to Word:
brew install pandoc
Install GitHub Desktop for version control. See desktop.github.com. (Note that Git isn't easy to understand, but it's worth the effort.)
If your project uses Gulp (e.g. to create web-optimised images):