[Qgis-community-team] website and doc(websiteS)

[Alexander Bruy]

Hi Richard and all,

maybe I'm wrong but we decide that we don't split docs by QGIS verisons,
so in documentation repository we have only docs for 2.0 in master branch.
Older version (1.8) available in separate branch. With this approach we
avoid duplication and reduce repository size.

2013/9/7 Richard Duivenvoorde <richard at duif.net>:
> Hi,
>
> as the website layout etc is going further and further, I start thinking
> about merging (or merging back) the documentation websites in this same tree
> (sphinx project).
>
> It would be nice if somebody familiar with this concepts would brainstorm
> with me about this.
>
> Some background:
>
> The (older) doc site source tree:
>
>
> source
>         website
>         docs
>         conf.py
>
>
> Current website source tree:
>
> source
>         website
>                 conf.py
>
> Where I try to make a descision about, is if I should create a tree like the
> older doc website (by pulling conf.py one level lower, and just copy the
> docs dir from the old site into it and merge the conf.py's
>
> OR (as Tim tried to explain to me I think), we should opt for several sphinx
> projects (with one global toc, one search and interproject links???)
>
> Some thoughts:
> - I want preferably have just one site, with one global toc
> - the search should search ALL sites (I think)
> - we should be able to 'version' some of the documentation-docs (manual and
> python cookbook at least)
> - maybe we want to reference from one project to another (eg, from the
> website to both the 1.8 and the 2.0 manual
>
> So I wonder if this is possible:
>
> source
>         conf.py
>         website
>                 (conf.py?)
>         docs1.8
>                 conf.py (because these hold a the image replacers)
>         docs2.0
>                 conf.py (because these hold a the image replacers)
>
> OR
>
> source
>         conf.py
>         website
>         docs
>                 manual1.8
>                         conf.py
>                 manual2.0
>                         conf.py
>                 cookbook1.8
>                         conf.py
>                 cookboob2.0
>                         conf.py
>                 governmant docs
>                         (conf.py? or can it use another one)
>
>
> I don not have time/energy to test all these, so it would be nice if
> somebody stood up, with either some experience with this, or someone who
> wants to try this out. Or someone with a better/easier idea :-)
>
> Or should I just wait with all this...
>
> Regards,
>
> Richard
> _______________________________________________
> Qgis-community-team mailing list
> Qgis-community-team at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/qgis-community-team



-- 
Alexander Bruy