Note:

If you want to create a new page for developers, you should create it on the Moodle Developer Resource site.

LESS

From MoodleDocs
Revision as of 03:21, 12 April 2013 by Jason Fowler (talk | contribs)

About Recess

Recess is a tool used to compile and compress LESS into CSS under *nix based systems.

Installing Recess under Ubuntu

The following commands should be run to install Recess

sudo apt-get install npm node
npm install recess -g

Installing Recess under Mac OS X using MacPorts

1) Install MacPorts on Mac OS X. If you use a different package manager some install commands will vary. 2) Install NPM

    port install npm
    rehash

3) Download https://github.com/twitter/recess/archive/master.zip and unzip it, then cd into the directory. 4) Install recess

    npm install recess -g
    rehash

Using Recess

To compile to LESS for the boostrap theme use these commands, from the root of your moodle code directory

cd theme/boostrap/less/
recess --compile --compress moodle.less > ../style/generated.css

This will compile and compress the moodle.less file (and all the LESS and CSS files it imports) into a single file, generated.css, and store it in the style folder of the bootstrap theme.

NOTE: if you are getting empty generated.css files, this is being caused by a parsing error in your LESS code. You will need to examine what you have altered or written to make sure it is complete and the syntax is correct.