Add delimiters in readme

This closes #468 

The website generator now takes the README.rst, cuts out the bit thats in between the `----` delimiters, and inject the corresponding html in the page. All in a small nifty sphinx extension.