HTML manual

[rainwoodman]

The current manual is written strictly in Latex, and it may be hard to compile it to HTML pages.

HTML documentation is easier to access than PDF documentation, because 1) it doesn't need a PDF reader and 2) is easier to search; and 3) is paginated by sections rather than by pages.

For HTML generation, I would recommend looking into restructured text and sphinx.
It will produce HTML and pdf documents.

If this is desired I can start a PR start porting tex to .rst .

[mpip]

Looks interesting. In former times I tried to convert latex to html with no sufficient success. If sphinx has sufficient support for LaTeX (equations and syntax highlighting via listings) we can give it a try. You are very welcome to set up a starting point.

[rainwoodman]

Here is an example document

(html) http://matplotlib.org/sampledoc/
(pdf) http://matplotlib.org/sampledoc/sampledoc.pdf

Looks like it can handle the elements in the current manual(math and highlighting), but the 'default' styles may look a bit different.

[rainwoodman]

I will get this started around the end of this week.

[mpip]

Ok. Great. Thanks a lot.