Installation¶
Alberon Note
If you are using Jericho (Alberon’s shared development server), Awe is already installed and you can skip to Project configuration files.
Quick start¶
If you already know what you’re doing, this is a shorthand version of the instructions below for Debian Wheezy:
$ curl -sL https://deb.nodesource.com/setup_0.12 | sudo bash -
$ sudo apt-get install -y nodejs
$ sudo gem install bundler
$ sudo npm install -g awe bower
System requirements¶
Linux¶
Awe is developed and tested on Linux. It should run on Mac OS X too, but it hasn’t been tested. It probably won’t work on Windows (at least not 100%) because it uses symlinks.
Future Plans
I could add Windows support if there is demand for it, but this would add some complexity (e.g. symlinks to bower_components/
would not be possible so the files would need to be copied instead).
Node.js & npm¶
Node.js v0.12+ and npm must be installed. Awe is tested on Node.js 0.10, and may not work on older versions.
To check they’re installed, run:
$ node --version
$ npm --version
Installing Node.js on Debian¶
$ curl -sL https://deb.nodesource.com/setup_0.12 | sudo bash -
$ sudo apt-get install -y nodejs
See NodeSource for more details or other versions.
Ruby & Bundler¶
You must also have Ruby and Bundler installed - they are required to run Compass, Sass files to CSS.
Since Awe is installed system-wide, they also need to be installed system-wide - i.e. not using RVM or rbenv.
To check they’re installed, run:
$ ruby --version
$ bundle --version
(Compass itself will be installed by Awe, so it does not need to be installed manually.)
Installing Ruby on Debian¶
$ sudo apt-get install ruby ruby-dev
$ sudo gem install bundler
Bower (optional)¶
You may also install Bower for managing third-party assets:
$ sudo npm install -g bower
To check it’s installed, run:
$ bower --version
Installing¶
Simply install Awe using npm:
$ sudo npm install -g awe
This will install the Awe package globally, including the awe
executable, and also download the Node.js and Ruby dependencies.
To check it’s installed, run:
$ awe --version
Installing a specific version¶
To install a specific version, use the awe@<version>
syntax of npm, for example:
$ sudo npm install -g awe@1.0.0
To see a list of all available versions, see the list of releases or the list of commits.
Upgrading¶
Because Awe is installed globally, you only need to upgrade it once per machine, not separately for each project. Every effort will be made to ensure backwards compatibility, though you should check Upgrading a project to see if anything important has changed.
Checking for updates¶
$ npm outdated -g awe
If Awe is up to date, only the headings will be displayed:
Package Current Wanted Latest Location
If there is a newer version, the currently installed version and latest version number will be displayed:
Package Current Wanted Latest Location
awe 1.0.0 1.1.0 1.1.0 /usr/lib > awe
Upgrading to the latest version¶
$ sudo npm update -g awe
Upgrading to a specific version¶
To upgrade (or downgrade) to a specific version, use install
instead:
$ sudo npm install -g awe@1.0.0
Uninstalling¶
To remove Awe from your machine, simply uninstall it with npm:
$ sudo npm uninstall -g awe
This will also delete the Node.js and Ruby dependencies that were downloaded automatically during installation (e.g. CoffeeScript, Sass, Compass). It will not remove any project files (configuration, cache files or compiled assets).