MBX is the mechanism used to create the PCC calculus lab manual and other OER math books. This guide will get you started if you want to contribute on one of these projects.
This guide is for anyone who feels like a complete newcomer to projects like this. If you already know about things like git, then you should consider visiting the MBX homepage instead.
Until further notice, this guide assumes that you are working on a Mac. If you have a Linux machine, it is probably easy for you to work out the corresponding instructions. If you use Windows, the appropriate tools are still experimental and I'm unable to help with how to use them. For Windows users, for now, if you really want to work on one of these projects, you should find a Mac that you can use.
We'll do almost everything from the Terminal:
MBX and MBX-based projects are not complicated things to install, but they rely on a fair amount of other software that we need first. The following steps worked on 12/01/2016 on a fresh MacBook Pro running OS X El Capitan. It's possible that if your OS is different, you may run into (overcome-able) obstacles.
From the Terminal prompt, install Homebrew by running:
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
You will be prompted for your Mac OS account's password.
brew install git
Make sure you are still in your user profile's root folder:
That is a tilde character, not a hyphen.
Clone the MathBook XML repository:
git clone https://github.com/rbeezer/mathbook
Check out the dev branch of mathbook:
cd ~/mathbook git checkout dev
Install the utility that converts pdf images to svg images:
brew install pdf2svg
Install ImageMagick; among other things it provides the "convert" command which can convert pdf images to png images:
brew install imagemagick
Install pip, the Python package manager:
sudo easy_install pip
Install the Python requests package:
sudo pip install requests
(Optional, if you would like to be able to make gource videos animating your repository history) install gource:
brew install gource
(Optional, if you would like to be able to save gource videos as mpeg videos) install ffmpeg:
brew install ffmpeg
From the Terminal, still in your main user profile folder (which you can be sure you are in by first running "cd /~"), clone the repository using one of the following (or something like these):
For the PCC Calculus Lab Manual:
git clone https://github.com/Alex-Jordan/Calculus-Lab-Manual
For ORCCA (Open Resources for Community College Algebra):
git clone https://github.com/PCCMathSAC/orcca
For APEX Calculus:
git clone https://github.com/PCCMathSAC/apex-mbx
Set up the git repository to know who you are:
cd ~/Calculus-Lab-Manual git config user.name "First Last" git config user.email firstname.lastname@example.org
At this point you should have all the software that you need to compile the various output formats for the project. And you should be able to edit the project's source files to make edits and contribute. The details of how to actually do any of these things vary from project to project, so it's not feasible to give comprehensive instructions here. If you make it this far, contact Alex Jordan to proceed.