README
Adapt Builder
A web-based authoring tool for the Adapt Framework.
Features
- Web application built on NodeJS, BackboneJS, and MongoDB for creating, editing and publishing Adapt content
- Supports all core extensions and components
- Allows uploading and linking of course assets
Installation
Prerequisites
- git - http://git-scm.com/downloads
- MongoDB - http://docs.mongodb.org/manual/
- Node.js - http://nodejs.org/
- grunt-cli - http://gruntjs.com/getting-started
- adapt-cli - https://github.com/adaptlearning/adapt-cli
- FFmpeg (optional) - https://www.ffmpeg.org/index.html
There are various ways of installing these applications depending on your platform.
Installing prerequisites on Windows
Users on platforms other than Windows can use the instructions below.
Installation of Prerequisite Applications
Before installing the tool itself, you must install the following applications.
Git
You can install git from here.
If this is a fresh install of git, you should configure it:
git config --global user.name "Your Name"
git config --global user.email "youremail@domain.com"
MongoDB
MongoDB is a document based database. Download and install the version appropriate for your system here.
NodeJS & NPM
NodeJS and NPM are required. Installing Node.js will also install NPM.
IMPORTANT: The NodeJS version must be 0.10.33. Earlier versions of NodeJS are less stable and the code is currently not compatibile with 0.12.x.
You should use a NodeJS version manager. We recommend using NVM on non-Windows machines. On Windows, try nodist
Grunt and Adapt Command Line Tools
Install grunt-cli and adapt-cli using npm (NOTE the -g
in both commands is required!):
npm install -g grunt-cli
npm install -g adapt-cli
Read more about Grunt
FFMPEG (optional, but recommended)
FFmpeg is not required to use the tool, but it will produce nice thumbnails for images and videos you upload.
Clone the adapt_authoring project
Clone the project from github.com:
git clone https://github.com/adaptlearning/adapt_authoring.git
Run the install script
Firstly ensure that the MongoDB service is started is running correctly. If you installed on Linux, the service should automatically start. OSX users may have to manually run mongod
from a terminal.
Navigate to the folder where you cloned the adapt_authoring project and run npm install
:
cd /path/to/adapt_authoring/
npm install
And finally run the install script. The script will help you configure the tool. In most cases, you can just accept the default values; the only input you are required to provide are the default username and password. Note that FFmpeg is not used by default, so choose Y
when prompted if you have it installed:
node install
If the script completes succesfully, you should now be able to run the application. If any error occurs, read the output, and check if you forgot to install one of the above prerequisites.
To run the application use:
node server
The ouput on the console will tell you what url to use to access the tool. By default it will be http://localhost:5000.
You can run the install script again at anytime. If you chose the same values for the master database connection, you may overwrite any existing data, but this is occasionally desired.
We hope you enjoy using the tool! For help and support, please visit the community page at http://community.adaptlearning.org