[Qgis-community-team] qgis doc theme

[Diethard Jansen]

Hi there,

I have seen a few sphinx themes out there that are really nice that we can
learn from.
I think the one from geoserver is also pretty good, see.
http://docs.geoserver.org/stable/en/user/data/vector/shapefile.html

I also think we should not stick to the top library index and convert it to
HTML instead.
Not as flexible, but I am pretty sure if we remove the library index, the
pdf documents will come out OK as well.
It seems for pdf creation you really need one top level index..

Regards,
Diethard

2012/10/31 Tim Sutton <lists at linfiniti.com>

> 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
> ==============================================
> _______________________________________________
> Qgis-community-team mailing list
> Qgis-community-team at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/qgis-community-team
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/qgis-community-team/attachments/20121101/cdc979d5/attachment.html>