Tested and modified README so that it can be rendered as HTML

Using rst2html. Moved some parts in dedicated pages in documentation.
Refs #18
Should fix project page on PyPI.