[Live-demo] Enhancement for Version number in Online Documentation

[Cameron Shorter]

Frank,
Checking the latest changes to the Makefile, it seems we have lost the 
VERSION from the documents.

You can see a link to a nightly build here: 
http://wiki.osgeo.org/wiki/Live_GIS_Disc#Documentation
to
http://adhoc.osgeo.osuosl.org/livedvd/docs/en/index.html

Are you able to look into this?

We don't have a nightly mavin build or similar automated build process 
(yet). Having one could make our build process easier if someone were 
able to set it up.

On 04/07/11 17:02, Frank Gasdorf wrote:
> Thanks Hamish, please have a look at the inline comments ..
>
> 2011/7/4 Hamish <hamish_b at yahoo.com <mailto:hamish_b at yahoo.com>>
>
>     Frank wrote:
>     > OK, just fixed the version read from VERSION.txt in conf.py
>     > and updated html_tilte property - in the title was still v4.5
>     > instead of the current version.
>
>     thanks
>
>     > I tried it on mac os but the arguments for sphinx-build
>     > command where not used like I thought it would. Therefore the
>     > python conf.py update to read from version file instead of
>     > parameters for sphinx-build command in Makefile
>
>     sphinx has been a bit of a moving target.. can you set up a
>     virtual machine in OSX to run xubuntu 11.04 in? it's the best
>     way to verify the results are the same.
>
>
> Agree, it was only mentioned to get feedback if anybody else had 
> problems like this. I know, that the geotools project works with ant 
> build scripts and there it seems to work but I've no idea what OS the 
> build server for the docs is running.
>
>     also note that if the Makefile changes the nightly doc build
>     on the adhoc server stops until I validate them. (intentional
>     feature, not a bug)
>
> Quit interesting. Everything still all right after my changes? Is 
> there a public accessible build server (hudson/jenkins) where I can 
> check the build results? Is it possible to get these results to the 
> mailing list?
>
>
>     > In addition I searched all 'OSGeo Live' occurrences and
>     > replaced it with OSGeo-Live.
>
>     it would be better to make the grep regex more robust, rather
>     than forcing all docs to use an identical version of the nom du
>     jour.
>
>     grep 'OSGeo[ -]Live' *.rst
>
> Thanks! To be exact I used the sed and searched the regular expression 
> 'OSGeo.Live' and replaced it with OSGeo-Live. ;)
>
>
>     > Last but not least I updated the copyright to 2011.
>
>     thanks,
>
>
>
>     with respect to :Version: in the ReST docs header comments, I
>     would like to preserve that, it makes it easy to know if I've
>     verified that the content is still valid for the currently
>     packaged version of the software. (making it the version of
>     the software would be just as good)  that version doesn't need
>     to be exported beyond the ReST document though.
>
>
>     cheers,
>     Hamish
>
>
>
> _______________________________________________
> Live-demo mailing list
> Live-demo at lists.osgeo.org
> http://lists.osgeo.org/mailman/listinfo/live-demo
> http://wiki.osgeo.org/wiki/Live_GIS_Disc


-- 
Cameron Shorter
Geospatial Director
Tel: +61 (0)2 8570 5050
Mob: +61 (0)419 142 254

Think Globally, Fix Locally
Geospatial Solutions enhanced with Open Standards and Open Source
http://www.lisasoft.com

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.osgeo.org/pipermail/osgeolive/attachments/20110707/8ea7b060/attachment.html>