Re: [OSGeoLive] Motion to Setup new GitHub repository for Archived Documentation
+1 Cameron On Wed, 18 Dec 2019 at 07:39, Seth G wrote: > Hi all, > > I'd like to propose a motion for the following: > > 1. Create a new repository at > https://github.com/OSGeo/OSGeoLive-doc-archive > 2. Create a new subdomain archive.live.osgeo.org > 3. Populate the new repository with the contents of > https://github.com/geographika/OSGeoLive-doc-archive - all OSGeoLive docs > from v2.0 to v13.0 > 4. Publish these docs to archive.live.osgeo.org and create a link to the > archive website on the https://live.osgeo.org/ page > > Please see the IRC logs [1] and message thread [2] for further details and > background. > > In summary all the previous OSGeoLive documentation versions would be > available online (and stored in source control), and would provide an > important historal record of geospatial development over the past 10 years. > > Thanks to Cameron and Angelos for feedback and support in setting up the > archive. > > Regards, > > Seth > > [1] http://irclogs.geoapt.com/osgeolive/%23osgeolive.2019-12-17.log > [2] https://lists.osgeo.org/pipermail/osgeolive/2019-December/014516.html > > -- > web:http://geographika.co.uk > twitter: @geographika > ___ > osgeolive mailing list > osgeolive@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 ___ osgeolive mailing list osgeolive@lists.osgeo.org https://lists.osgeo.org/mailman/listinfo/osgeolive
Re: [OSGeoLive] Motion to Setup new GitHub repository for Archived Documentation
Hello Seth, great idea! +1 And thanks a lot for all the work. Astrid Am 17.12.2019 21:38 schrieb Seth G: Hi all, I'd like to propose a motion for the following: 1. Create a new repository at https://github.com/OSGeo/OSGeoLive-doc-archive 2. Create a new subdomain archive.live.osgeo.org 3. Populate the new repository with the contents of https://github.com/geographika/OSGeoLive-doc-archive - all OSGeoLive docs from v2.0 to v13.0 4. Publish these docs to archive.live.osgeo.org and create a link to the archive website on the https://live.osgeo.org/ page Please see the IRC logs [1] and message thread [2] for further details and background. In summary all the previous OSGeoLive documentation versions would be available online (and stored in source control), and would provide an important historal record of geospatial development over the past 10 years. Thanks to Cameron and Angelos for feedback and support in setting up the archive. Regards, Seth [1] http://irclogs.geoapt.com/osgeolive/%23osgeolive.2019-12-17.log [2] https://lists.osgeo.org/pipermail/osgeolive/2019-December/014516.html -- web:http://geographika.co.uk twitter: @geographika ___ osgeolive mailing list osgeolive@lists.osgeo.org https://lists.osgeo.org/mailman/listinfo/osgeolive ___ osgeolive mailing list osgeolive@lists.osgeo.org https://lists.osgeo.org/mailman/listinfo/osgeolive
[OSGeoLive] Motion to Setup new GitHub repository for Archived Documentation
Hi all, I'd like to propose a motion for the following: 1. Create a new repository at https://github.com/OSGeo/OSGeoLive-doc-archive 2. Create a new subdomain archive.live.osgeo.org 3. Populate the new repository with the contents of https://github.com/geographika/OSGeoLive-doc-archive - all OSGeoLive docs from v2.0 to v13.0 4. Publish these docs to archive.live.osgeo.org and create a link to the archive website on the https://live.osgeo.org/ page Please see the IRC logs [1] and message thread [2] for further details and background. In summary all the previous OSGeoLive documentation versions would be available online (and stored in source control), and would provide an important historal record of geospatial development over the past 10 years. Thanks to Cameron and Angelos for feedback and support in setting up the archive. Regards, Seth [1] http://irclogs.geoapt.com/osgeolive/%23osgeolive.2019-12-17.log [2] https://lists.osgeo.org/pipermail/osgeolive/2019-December/014516.html -- web:http://geographika.co.uk twitter: @geographika ___ osgeolive mailing list osgeolive@lists.osgeo.org https://lists.osgeo.org/mailman/listinfo/osgeolive
Re: [OSGeoLive] All OSGeoLive Docs versions online
Hi Astrid, I think it would be great to send a press release, but let's first make it fully accessible and linked into the master docs, which I propose we do in conjunction with a 3.1 docs release, which includes a working presentation reintroduced, updated quickstarts, and now links to archives. I expect we should be able to get this ready by early in 2020. On 18/12/19 3:46 am, Astrid Emde (OSGeo) wrote: Hello, question: I can't find the archive from ealier Versions at https://live.osgeo.org/archive/ works https://live.osgeo.org/archive/4.5/en/index.html does not work https://live.osgeo.org/archive/2.0/ At Seths link you get the whole list https://osgeolive.geographika.co.uk/ By the way: shall we write a news item about it or tweet. LIke: We are happy to announce that @OSGeoLive has published a historical archive of past releases. Thanks a lot to @geographika. Starting from Version 4.5 you can https://live.osgeo.org/archive/4.5/en/index.html https://live.osgeo.org/archive/ Astrid Am 16.12.2019 11:02 schrieb Angelos Tzotsos: Excellent work Seth! Thanks for making the archive. Lets plan on setting the archive repo and the subdomain during the meeting tomorrow. Best, Angelos On 12/15/19 6:29 PM, Seth G wrote: Hi Cameron, Some answers in the email below. If you are able to find out how we can make a new https://github.com/OSGeo/OSGeoLive-archive repository and a new subdomain at osgeo.org I can hopefully take care of the rest. Seth -- web:http://geographika.co.uk twitter: @geographika On Sat, Dec 14, 2019, at 8:59 PM, Cameron Shorter wrote: 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: https://live.osgeo.org/archive/10.5/_images/osgeolive_menu6.png German version points to: https://live.osgeo.org/archive/10.5/_images/osgeolive_menu2.png 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. I've written a small Python script to change the symlinks to copies of the images. See https://github.com/geographika/OSGeoLive-doc/blob/gh-pages/scripts/symlinks.py It does create a larger repo, but probably simpler to manage across different OSs than symlinks in the long-term. All images should now be visible in the archive URL. 1. I think this historical archive of past releases you have created is really valuable. Thanks! 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 archive/. This archive would be the jump page you have created. Sounds good. I guess we need to decide where the archive will be hosted (which URL/subdomain). Maybe https://archive.osgeo.org/ or Maybe https://livearchive.osgeo.org/ ? Who would be contact with regards to setting up a domain name? 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 Currently the archive is in a branch so shouldn't increase size of git clone downloads etc. but moving to its own archive may make things clearer. Who would we contact with regards to creating a new repo at https://github.com/OSGeo/ ? 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.) The build information is already linked to on https://trac.osgeo.org/osgeolive/wiki I've updated the link to the development build to point to OSGeoLive home page (development version). 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
Re: [OSGeoLive] All OSGeoLive Docs versions online
Hello, question: I can't find the archive from ealier Versions at https://live.osgeo.org/archive/ works https://live.osgeo.org/archive/4.5/en/index.html does not work https://live.osgeo.org/archive/2.0/ At Seths link you get the whole list https://osgeolive.geographika.co.uk/ By the way: shall we write a news item about it or tweet. LIke: We are happy to announce that @OSGeoLive has published a historical archive of past releases. Thanks a lot to @geographika. Starting from Version 4.5 you can https://live.osgeo.org/archive/4.5/en/index.html https://live.osgeo.org/archive/ Astrid Am 16.12.2019 11:02 schrieb Angelos Tzotsos: Excellent work Seth! Thanks for making the archive. Lets plan on setting the archive repo and the subdomain during the meeting tomorrow. Best, Angelos On 12/15/19 6:29 PM, Seth G wrote: Hi Cameron, Some answers in the email below. If you are able to find out how we can make a new https://github.com/OSGeo/OSGeoLive-archive repository and a new subdomain at osgeo.org I can hopefully take care of the rest. Seth -- web:http://geographika.co.uk twitter: @geographika On Sat, Dec 14, 2019, at 8:59 PM, Cameron Shorter wrote: 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: https://live.osgeo.org/archive/10.5/_images/osgeolive_menu6.png German version points to: https://live.osgeo.org/archive/10.5/_images/osgeolive_menu2.png 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. I've written a small Python script to change the symlinks to copies of the images. See https://github.com/geographika/OSGeoLive-doc/blob/gh-pages/scripts/symlinks.py It does create a larger repo, but probably simpler to manage across different OSs than symlinks in the long-term. All images should now be visible in the archive URL. 1. I think this historical archive of past releases you have created is really valuable. Thanks! 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 archive/. This archive would be the jump page you have created. Sounds good. I guess we need to decide where the archive will be hosted (which URL/subdomain). Maybe https://archive.osgeo.org/ or Maybe https://livearchive.osgeo.org/ ? Who would be contact with regards to setting up a domain name? 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 Currently the archive is in a branch so shouldn't increase size of git clone downloads etc. but moving to its own archive may make things clearer. Who would we contact with regards to creating a new repo at https://github.com/OSGeo/ ? 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.) The build information is already linked to on https://trac.osgeo.org/osgeolive/wiki I've updated the link to the development build to point to OSGeoLive home page (development version). 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. I don't think these pull requests have the Appveyor CI merged into them so they don't currently trigger builds. If we add a link to the archives we can see if this process works on a new pull request. Cheers, Cameron On 15/12/19 4:47 am, Seth G wrote: Thanks for the feedback and kind words Cameron! I got the docs fro