- The framework may be installed manually, or it may be installed with assistance from the Adapt-CLI. The CLI downloads and installs the latest public release of the Adapt framework obtained from adaptlearning/adapt_framework. If you are installing code obtained from a different repository, install it manually.
- Installing the Adapt framework also installs within it a sample e-learning course.
Install the following before proceeding:
Tips:
- Windows users should run these commands in Git Bash if Git was installed using default settings.
- Mac and Linux users may need to prefix the commands with
sudoor give yourself elevated permissions on the /usr/local directory as documented here.
Download the Adapt framework as a ZIP and extract the files. If you are a Windows user, you may need to unblock the ZIP archive before you extract it.
Open a console interface (e.g. Git Bash, Terminal on OSX, Powershell or CMD.exe) and navigate to the extracted folder (typically adapt_framework-master, but you can safely rename this).
From within the extracted folder, run the following command.
npm install
This will install all of the package dependencies of the framework. If this command completes successfully, run the following command.
adapt install
This will download all of the Adapt plug-ins to the correct locations in the framework.
Build the included sample course by running the following command:
grunt build
Start a server by running the following command:
grunt server
Once the server has started, the course will open in your default browser via the URL http://localhost:9001/
To terminate the server, press CTRL+c.
Install the following before proceeding:
Tips:
- Windows users should run these commands in Git Bash if Git was installed using default settings.
- Mac and Linux users may need to prefix the commands with
sudoor give yourself elevated permissions on the /usr/local directory as documented here.
Open a console interface (e.g. Git Bash, Terminal on OSX, Powershell or CMD.exe) and navigate to the folder where you'd like to install the framework. The CLI will create a root folder using the name you supply as the course name. Run the following command substituting your course name for "My Course Name".
adapt create course "My Course Name"
To create an Adapt course from a specific branch, run:
adapt create course "My Course Name" develop
This will open a dialogue. Pressing enter or return will accept the default displayed. Package dependencies and core plug-ins will be installed.
Navigate the terminal into the newly created course folder. Build the included sample course by running the following command:
grunt build
Start a server by running the following command:
grunt server
Once the server has started, the course will open in your default browser via the URL http://localhost:9001/
To terminate the server, press CTRL+c.
Consult the Adapt community's Technical Discussion Forum or chat room on Gitter:
