Cengage Magma - Beta version 0.7
The short version
1. Open a terminal window.
npm install to install the developer dependencies.
npm install -g gulp to install the world-famous Gulp task runner.
gulp build:magma to build your Magma CSS
npm install -g harp to install the Harp web server.
gulp serve:magma to display the documentation at http://localhost:9000.
gulp compile:magma to generate a static version of the documentation. The static documentation version can be found at /static.
## Install, Build, View and Compile Magma on your local machine
In order to view the Cengage Magma documentation as a stand-alone website in your local machine, you will have to have the following installed:
Once you have installed Node.js and verified that your installation is working properly via the command line by typing
node --version (it should return a version number like 'v0.12.0'), you will need to install Harp.js via NPM, the Node Package Manager installed along with Node.js.
If you are unable to install Node.js, please consult the documentation
Fire up the command line again and type
npm install -g harp. This command should take a moment to install all of the packages required to run Harp.js locally. Once that is done installing, verify that everything is working properly by typing
harp --version on the command line which should return a number like '0.19.0'.
If your installation did not go smoothly or you are unable to run Harp.js, please consult the documentation.
Certain dependencies must be installed in order for Magma to run properly and this can be easily accomplished by running
npm install from the command line. It should only take a moment.
Magma uses Gulp for building; to install it, first run
npm install -g gulp. Once installed, verify that everything is working properly by typing
which should return a number like '3.9.0' for both the CLI and Local versions.
To build Magma, run
gulp build:magma; to compile with a skin, run
gulp build:magma --skin <skin>. Your skinned, minified CSS file will be in the build folder.
Magma can be served up locally by running
gulp serve:magma from the command line inside the
/magma folder. This will start up the harp.js server and tell the user on the command line which port is in use, generally at http://localhost:9000.
Harp.js listens by default on port 9000, so if you have a any other application running on that port, just modifying the start command to
harp server --port <port> will alleviate the congestion and allow you to run Harp.js with no issues.
In the case that you would like to compile the Magma documentation website and view it locally, run
gulp compile:magma from the command line and a static version of the website will be accesible from the
/static folder. This version does not require Harp.j but does require you to build Magma first via the command line by running