diff --git a/theme/bootstrapbase/less/README b/theme/bootstrapbase/less/README index 9899bc11919..7c95371bea3 100644 --- a/theme/bootstrapbase/less/README +++ b/theme/bootstrapbase/less/README @@ -1,19 +1,29 @@ If you want to make changes to the .css generated from these .less files then you -need to install recess (https://github.com/twitter/recess) to compile the .less files, -then run these commands in the bootstrapbase/less/ folder: +need to use a LESS Compiler. Details on specific compilers and how to install them +can be found at http://docs.moodle.org/dev/LESS + +At present, recess is the official tool for developers to compile LESS in to CSS, as +other tools give different results in the generated CSS. + +Once recess has been installed you can compile and compress the LESS in to CSS using +the following commands from the "theme/bootstrapbase/less" directory: + +For the main Moodle styles: recess --compile --compress moodle.less > ../style/moodle.css -You can add --watch to make sure it updates every time you make a change. - And for the subset of styles of interest to the TinyMCE editor: recess --compile --compress editor.less > ../style/editor.css -Non-command line options for .less compilation are available, see their github for more info. +You can add --watch to make sure it updates every time you make a change. If the compilation is failing and you're not getting any useful error message, try using lessc instead i.e.: lessc moodle.less This is the same tool that's getting called by recess, but the errors seems better if you go direct. + +Additional information about the Moodle bootstrap base theme can be found at +http://docs.moodle.org/dev/Bootstrap +