add Docs, fixes to default theme and add carousel theme

* added some documentation
* fixed a bug in the default theme and an awful system for directory/file names handling jinja2 -> js
* added carousel theme

The themes are awful, and a lot of bugs/wrong behaviours are still in the code. I prefer bugfixes, the UI problems can wait.