Aloha Editor

Aloha Guides

These guides help you to make your content editable and to develop Aloha.

Using Aloha Editor

After reading this guide, you will be able to:

  • Prepare your development envireonment
  • build your custom Aloha Editor

1 Clone from Github

You should know how to work with git before continuing.

First of all you have to get your copy of the Aloha Editor. Just clone our Github repository:

fork Aloha Editor before doing anything ;-)


git clone git@github.com:YOURNAME/Aloha-Editor.git alohaeditor
cd alohaeditor
git checkout dev

2 Building – Aloha Building

2.1 Debian Linux / Mac OS X

  • Install nodejs See: http://nodejs.org
  • Install npm See: http://npmjs.org

curl http://npmjs.org/install.sh | sh
  • Install r.js

npm install -g requirejs@0.26.0 
Note: Please use r.js 0.26.0 for now

Linux: Add r.js to your bin directory:


ln -s /root/node_modules/requirejs/bin/r.js /usr/local/bin/

Mac: r.js should be automatically added to your bin directory. Manual linking:


ln -s /Users/{username}/lib/node_modules/requirejs/bin/r.js /Users/{username}/bin/r.js

Manually from github

  • Invoke Building:

cd alohaeditor
./bin/build.sh aloha

2.2 Other OS:

  • Microsoft Windows: Not yet supported

3 Guide

3.1 Installation

3.1.1 Debian Linux

apt-get install build-essential
apt-get install ruby1.9.1-full
gem install guides
ln -s ruby1.9.1  ruby
ln -s gem1.9.1  gem
ln -s /var/lib/gems/1.9.1/gems/guides-0.7.1/bin/guides /usr/bin/guides
guides preview 
3.1.2 Mac OSX

gem install guides
3.1.3 Microsoft Windows

3.2 Using the Guides

  • Preview Guides:

cd alohaeditor/doc/guides
guides preview

Preview URL: http://localhost:9292/

  • Building Guides:

guides build

4 Changelog