fix the Toggle directive
improve the look of the buttons
remove several RST warnings
Merge pull request #230 from vrabaud/doc_cleaning

Doc cleaning