[Qgis-community-team] qgis doc theme

[Richard Duivenvoorde]

Hi All,

Now that we have some 'books' in our html documentation 
http://documentation.qgis.org/html/en/  my opinion is that current theme 
is nice to see but not so practical?

If you are reading somewhere in eg the 'user manual' or the 'gentle 
intro', the theme does not give you your context anymore. The huge 
'Previous topic' and 'Next topic' sent you around 
books/chapters/sections without knowing where you are.

I've also build our docs-structure with the so called 'sphinxdoc' theme 
(and a localtoc.html in the sidebar). And while it looks not so good as 
Tim's theme, I think it is more practical/usable.
See http://www.duif.net/theme.png and http://www.duif.net/theme2.png
As you can see, in the top there is some kind of breadcrumb so you know 
in which 'book' your are. You can easily go to the root of the docs etc etc.

I planned to get the best of these two worlds, but would not mind if 
someone is keen to share some sphinx templating knowledge

Anybody an opinion about this?

If people agree and with some help (and Linfiniti maybe can share some 
knowledge about the original theme) I'll try to merge the themes.

(to be clear: this can be done and decided in parallel of the current 
process of upgrading to 1.8 and translating. It should not be an 
obstacle in current progress.. we do have a working live stack at the 
moment!)

Regards,

Richard