6. Run gulp serve:magma to display the documentation at http://localhost:9000.
7. Run 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:
- Node.js
- Harp.js
Node.js is a platform built on Chrome's JavaScript runtime for easily building fast, scalable network applications.
Navigate over to nodejs.org and click the installer button or follow the Downloads link in case you cannot locate the right version of Node required for your machine.
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
Harp.js is a static web server with built-in preprocessing for serving Jade, Markdown, EJS, CoffeeScript, Sass, LESS and Stylus as HTML, CSS & JavaScript files.
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 gulp -v
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 gulp build:magma.