added documentation on usage of lesscss and customizing the style.less file

2 files changed, 32 insertions, 0 deletions

diff --git a/askbot/doc/source/customizing-skin-in-askbot.rst b/askbot/doc/source/customizing-skin-in-askbot.rst
index 92680e52..09ea0dbb 100644
--- a/askbot/doc/source/customizing-skin-in-askbot.rst
+++ b/askbot/doc/source/customizing-skin-in-askbot.rst
@@ -117,6 +117,10 @@ then it is not very convinient to tweak the skin,
 as the file path may be long and files may be writable only
 by from the root account.
 
+**IMPORTANT:** Do not edit file style.css manually, instead edit the
+source style.less, written in the `lesscss <http://lesscss.org>`_ format.
+See also: :ref:`customizing-style-css-file-in-askbot`.
+
 Create a custom skin in a new directory
 ---------------------------------------
 This is technically possible, but not advisable
diff --git a/askbot/doc/source/customizing-style-css-file-in-askbot.rst b/askbot/doc/source/customizing-style-css-file-in-askbot.rst
new file mode 100644
index 00000000..2c2d0327
--- /dev/null
+++ b/askbot/doc/source/customizing-style-css-file-in-askbot.rst
@@ -0,0 +1,28 @@
+.. _customizing-style-css-file-in-askbot:
+
+====================================
+Customizing style.css file in Askbot
+====================================
+
+File style.css is produced by the `lesscss compiler <http://lesscss.org>`_ - ``lessc``.
+
+Please read documentation about the lesscss format.
+
+Compiling lesscss files
+=======================
+
+The following command will compile the lesscss source file,
+an option -x will produce compressed css file:
+
+    lessc file.lesscss -x > file.css
+
+Installing lesscss
+==================
+
+Make sure you have recent version of `node.js <http://nodejs.org>`_ - latest version preferred.
+More recent versions of node come with the tool called `npm <http://npmjs.org>`_,
+for earlier versions ``npm`` will need to be installed manually.
+
+To install lesscss, type:
+
+    sudo npm install less