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

[Frank Gasdorf]

2011/7/7 Alex Mandel <tech_dev at wildintellect.com>

> Frank,
>
> No there is not a deployment script which uploads the ISOs, it's much
> more complicated than you think since that url is actually redirected to
> a tool that then sorts people's downloads amongst the 5 mirrors.
>
> The url as defined by the last release will be correct for the next
> release.
> Where:
>
> http://download.osgeo.org/livedvd/release/[version]/osgeo-live-[version].iso
>
>
> http://download.osgeo.org/livedvd/release/[version]/osgeo-live-mini-[version].iso
>
>
> http://download.osgeo.org/livedvd/release/[version]/osgeo-live-vm-[version].7z
>
> End up as:
> http://download.osgeo.org/livedvd/release/5.0/osgeo-live-5.0.iso
>
> I'll just have to remember to stick to that naming convention when I'm
> making new versions
>

Correct me, when I'm wrong, I understood, that there is an naming convention
and if we use a pattern like the version replacement, we could change the
download.rst files in the way you summarized. So we don't have to care about
it in the future except the naming convention or uploading area will change.

Give me a go and I can update the download.rst files ...

Cheers,
Frank



> Thanks,
> Alex
>
> On 07/07/2011 06:24 AM, Frank Gasdorf wrote:
> > All right, Sorry for the confusion ...
> >
> > I've updated to index, download and overview pages. What I've done:
> > added rst_epilog to the conf.py script and replaced at the specific
> places
> > OSGeo-Live with |osgeo-live-version| which is a concatenation of the
> project
> > and the projects version:
> >
> > .. |osgeo-live-version| replace:: %(projectname)s %(projectversion)s
> > in addition I defined a replacement |osgeo-live-project| which can be
> used
> > everywhere OSGeo-Live is currently in the docs ...
> >
> > Could please somebody *review *the *Japanese *index page.
> >
> > What's next:
> > We should update the URL's in download pages and make these dynamic by
> using
> > the version number as well. I've no idea where the path would be correct
> if
> > we would replace (see |version|:
> >
> > e.g:
> > http://download.osgeo.org/livedvd/release/4.5/osgeo-live-4.5.iso
> > with
> >
> http://download.osgeo.org/livedvd/release/|version|/osgeo-live-|version|.iso
> >
> > is there a deployment script which uploads the ISO files? Where can I
> find
> > it?
> >
> > Cheers, Frank
> >
> > 2011/7/7 Cameron Shorter <cameron.shorter at gmail.com>
> >
> >> **
> >>
> >>
> >> On 07/07/11 20:10, Frank Gasdorf wrote:
> >>
> >> Right, I removed the version from makefile, because it's a post process
> on
> >> html files and have not replaced all OSGeo Live occurrences. Few days
> ago I
> >> requested an enhancement to put the version number at a specific place,
> lets
> >> say right behind the banner, that every page shows the current version
> >> number. I haven't got any feedback yet. IMHO the whole doc should be
> without
> >> any version number, except the HOME index page.
> >>
> >>
> >> I suggest you go ahead and insert the version tag in:
> >> http://live.osgeo.org/en/index.html
> >> Welcome to OSGeo-Live <version>
> >>
> >> http://live.osgeo.org/en/overview/overview.html
> >> OSGeo-Live <version> Contents
> >>
> >> http://live.osgeo.org/en/download.html
> >> The latest stable release of OSGeo-Live <version>:
> >>
> >>
> >>  Whats next? I'll go over and replace all OSGeo-Live places with
> >> OSGeo-Live |version| and thats it. Otherwise we could use replacements,
> but
> >> right now I don't know how to define global values, that can be
> referenced
> >> in all *.rst files.
> >>
> >>
> >> If you are not able to work out how to insert the global variables, then
> we
> >> should revert to using the previous post HTML production of inserting
> >> VERSION. It is not perfect, but it does work.
> >>
> >>
> >>
> >>  Thanks a lot for the adhoc url, that everybody can have a look at the
> >> current content! Are the pages uploaded daily?
> >>
> >>
> >> Yes, reloaded daily.
> >>
> >>
> >>
> >>  Cheers, Frank
> >>
> >> 2011/7/7 Cameron Shorter <cameron.shorter at gmail.com>
> >>
> >>>  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>
> >>>
> >>>> 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
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.osgeo.org/pipermail/live-demo/attachments/20110707/7b16a96a/attachment.html