[OSGeoLive] All OSGeoLive Docs versions online

Cameron Shorter cameron.shorter at gmail.com
Sat Dec 14 11:59:21 PST 2019

Hi Seth,

I was wondering why we don't have a symlink problem for images with the 
latest few releases? Looking at https://live.osgeo.org/de/index.html it 
appears that Vicky's new doc build script is smart enough to not create 
duplicate images for different languages (which as the case before).

If you look at the old archive directory for say release 10.5, you see 
that we have duplicates of images. Eg:

English version of docs points to: 

German version points to: 

To save space from images, Hamish Bowman wrote a script to create symlinks.

I have a few ideas in moving forward:

0. To work out the broken symlink problem for images, you could:

* Try and work out how to fix the symlink problem as you suggest. You 
might be able to find Hamish's old symlink generation script in the bin/ 
directory somewhere to help with that. (This sounds like a lot of work).

* Copy the HTML from our archive web pages (which uses duplicate 
images). This will create a large repository due to duplicate images, 
which isn't perfect, but we will be rarely working on the archive 
repository, so it is probably acceptable.

1. I think this historical archive of past releases you have created is 
really valuable.

2. I think it should be findable from the main docs, probably as a small 
link at the bottom of https://live.osgeo.org : Prior releases and docs 
can be found in our <a href="archive">archive/</a>. This archive would 
be the jump page you have created.

3. While the archive jump page can be stored in our master docs, I don't 
think we should store each releases' archive in there. We can either 
keep it on a directory, as was previously done for prior releases. Or 
put into git, as you have done (which I like). I think that it deserves 
its own repository, something like OSGeoLive-doc-archive

4. We should capture information about the latest doc release, and 
information about the archive in our build process documentation wiki: 
https://trac.osgeo.org/osgeolive/wiki. Would you like to update this? 
(You deserve the credit in the wiki history.)

5. Felicity has a bunch of pull requests for quickstarts. 
https://github.com/OSGeo/OSGeoLive-doc/pulls which are to be processed 
for the 13.1 doc release early next year. I'll try and get at least one 
of two reviewed within the week in order to check your publishing of the 
master docs pipeline.

Cheers, Cameron

On 15/12/19 4:47 am, Seth G wrote:
> Thanks for the feedback and kind words Cameron!
> I got the docs from the ISOs - see https://github.com/geographika/OSGeoLive-doc/tree/gh-pages#extraction-process
> After further investigation the missing images are due to the files being symlinks. I'm currently looking to see how these could be saved in git. They currently just have the text of the file they link to e.g. https://github.com/geographika/OSGeoLive-doc/blob/gh-pages/6.0/_images/1spatial_sml1.jpg
> I didn't know about the current archive on the main site. So there is some duplication of effort, but adding them to a repo hopely has a long term benefit. It also triggered Angelos tracking down the missing full ISOs.
> The latest master docs are already published at https://osgeo.github.io/OSGeoLive-doc/en/index.html and updated whenever a pull request is merged. The recent Appveyor setup should also allow people to see the output of their pull requests (there have been no pull requests recently to check this but it should work).
> I'm hoping to investigate the automated archiving of new releases which should help updating the main site,
> Seth
> --
> web:http://geographika.co.uk
> twitter: @geographika
> On Sat, Dec 14, 2019, at 7:31 AM, Cameron Shorter wrote:
>> Hi Seth,
>> Sorry for the delayed response. I'm really impressed with what you have
>> achieved. Well done.
>> More comments inline.
>> On 12/12/19 11:19 pm, Seth G wrote:
>>> Hi all,
>>> I've been collating the various documentation releases for OSGeo-Live and adding into my fork at fork is at https://github.com/geographika/OSGeoLive-doc/tree/gh-pages
>> Nice work. How are you creating these pages?
>> It seems that image links are broken for releases 6.0 to 10.5. Do you
>> know why that is? (I'm suspecting it might be because we changed our
>> directory structure around version 10.5 and our build process would have
>> been different.)
>> Have you noticed that we have some of the old doc sites stored in our
>> archived, and referenced from:
>> https://live.osgeo.org/en/prior_applications.html
>> (You can actually see the entire doc websites from 5.0 to 10.5
>> https://live.osgeo.org/archive/5.0/en/index.html
>> https://live.osgeo.org/archive/10.5/en/index.html
>>> This can then be automatically published by GitHub pages - I've currently set this up to publish to https://osgeolive.geographika.co.uk/
>>> The archive branch could be easily added via a pull request to the main project.
>>> The branch can be downloaded or cloned in git to publish on any server. One possibility to consider is to automate adding a build of the docs for a new tagged release using Travis. Deployment of the latests docs would then be a simple git clone rather than requiring a manual build an upload.
>> I'm super excited by the potential of this. One of our pain points in
>> documentation has been that we haven't had a current, nightly build that
>> people can see as soon as they update docs.
>> It would be great if we could set this up. Would you be interested in
>> setting up a:
>> live.osgeo.org/dev/... (or similar) for the latest docs?
>>> If anyone has a v1.0 docs copy please let me know!
>> Version 1.0 was effectively a test run of OSGeoLive (called the Live DVD
>> at the time). Our aim was to have OSGeoLive ready for FOSS4G 2009 in
>> Australia, and we had an early version ready for FOSS4G 2008 in South
>> Africa.
>> While I can't remember for sure, I don't think had developed
>> documentation for the 1.0 release.
>> Here is a blog post / press release from the time:
>> http://cameronshorter.blogspot.com/2008/09/geofoss-livedvd-test-it-before-we-burn.html
>>> Thoughts on the above welcome,
>> Super impressed.
>>> Seth
>>> --
>>> web:http://geographika.co.uk
>>> twitter: @geographika
>>> _______________________________________________
>>> osgeolive mailing list
>>> osgeolive at lists.osgeo.org
>>> https://lists.osgeo.org/mailman/listinfo/osgeolive
>> -- 
>> Cameron Shorter
>> Technology Demystifier
>> Open Technologies and Geospatial Consultant
>> M +61 (0) 419 142 254
Cameron Shorter
Technology Demystifier
Open Technologies and Geospatial Consultant

M +61 (0) 419 142 254

More information about the osgeolive mailing list