Please turn on JavaScript. To find out how to do this visit the WebWise JavaScript guide.

Building Glow

If you want to build Glow from source, please read these instructions.

Most users will not need to build from source. If you just want to use Glow without modifying it, head over to the Download section instead.

Dependencies

Source code

For more details on how to get the Glow source code, please see the full documentation on doing this.

For the purposes of this guide, we recommend you put the source code in a directory called "projects".

You can actually put it wherever you want, just remember to substitute "projects" for the name of the directory you chose if we mention it later.

$ cd ~
$ mkdir projects
$ cd projects
$ git clone git://github.com/glow/glow1.git

Ant

Glow is built using Apache Ant, so you'll need to install that before going any further.

If you are on a Linux based system this should be as easy as running the following command, or similair depending on your distribution's package manager.

sudo apt-get install ant

Mac OSX users may want to install Xcode (which includes Ant), or get it using MacPorts.

For Windows users we recommend WinAnt; a Windows installer for Apache Ant.

YUI Compressor

Glow uses the excellent YUI Compressor to optimise the file size of the built files.

Download the latest version of YUI Compressor, and extract it into the same "projects" directory that contains the checked out Glow source code.

Building

Once you have Ant and the YUI Compressor installed, building Glow is quite simple.

Open a shell prompt in the root of the Glow source directory and run Ant:

$ cd ~/projects/glow1
$ ant

If everything goes well, this will create a new directory called "dist" that contains the built files, and two archive files of this directory with the extensions zip and tgz.

If Ant cannot find YUI Compressor, it will fail with a message stating the location it expected it to be at. To correct this, check the YUI_JAR file path listed in the file build.properties and modify it if necessary.

API Quick Reference

JavaScript is required to use the quick reference

BBC © 2014 The BBC is not responsible for the content of external sites. Read more.

This page is best viewed in an up-to-date web browser with style sheets (CSS) enabled. While you will be able to view the content of this page in your current browser, you will not be able to get the full visual experience. Please consider upgrading your browser software or enabling style sheets (CSS) if you are able to do so.