Document how to compile .less files in dev docs.

[ArcTanSusan]

Somewhere in the ipython notebook developer docs, we should put instructions on how to compile the .less files into .css files.

$ cd ipython/IPython/html
$ fab css
[localhost] local: components/less.js/bin/lessc -x  style/style.less style/style.min.css
[localhost] local: components/less.js/bin/lessc -x  style/ipython.less style/ipython.min.css

Done

LESS requires extra dependencies like fabric, node, npm, and lessc.

[minrk]

or from repo root:

python setup.py css

[ArcTanSusan]

I have Sphinx installed using pip install in my virtualenv. In the process of generating the html using Sphinx, I'm getting this error: http://pastebin.com/2Ga7KjHQ Is there a step I'm missing?

[damianavila]

It seems that you need to install PyQt to generate the documentation...

[takluyver]

Yes, we autogenerate documentation of the config options, including those for the Qt console, which needs PyQt/PySide to be importable.

[ArcTanSusan]

I was thinking of where to include a short description of how to compile .less. Is the gitub wiki a good place to include the doc? See new additions in https://github.com/ipython/ipython/wiki/Dev:-Compiling-.LESS-files and https://github.com/ipython/ipython/wiki/Dev:-Index

[damianavila]

Probably is good to also have it in the wiki... but I think it would be very valuable to have it inside the IPython official doc.

[minrk]

wiki docs are sufficient.