[Qgis-community-team] qgis doc theme

[Tim Sutton]

Hi

On Wed, Oct 31, 2012 at 11:07 PM, Richard Duivenvoorde <richard at duif.net> wrote:
> 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!)

I would welcome improvements to the theme. Why don't we graft the good
bits out of the theme you found into my theme? I would also like to
make better use of bootstrap (which my theme is based on), especially
to enable the site and docs to degrade nicely down to mobile devices.
I'm in a workshop all this week, but would be happy to devote an
afternoon next week in a google hangout mini docfest to try to do some
of these improvements.

Regards

Tim


>
> Regards,
>
> Richard
> _______________________________________________
> Qgis-community-team mailing list
> Qgis-community-team at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/qgis-community-team



-- 
Tim Sutton - QGIS Project Steering Committee Member (Release  Manager)
==============================================
Please do not email me off-list with technical
support questions. Using the lists will gain
more exposure for your issues and the knowledge
surrounding your issue will be shared with all.

Visit http://linfiniti.com to find out about:
 * QGIS programming and support services
 * Mapserver and PostGIS based hosting plans
 * FOSS Consulting Services
Skype: timlinux
Irc: timlinux on #qgis at freenode.net
==============================================