OSGeo / OSGeoLive-doc-archive

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

OSGeoLive Documentation Archive

About OSGeoLive

OSGeoLive is a self-contained bootable DVD, USB thumb drive or Virtual Machine based on Lubuntu, that allows you to try a wide variety of open source geospatial software without installing anything. It is composed entirely of free software, allowing it to be freely distributed, duplicated and passed around.

General Notes

This branch contains all documentation releases of OSGeoLive. These are published to https://live-archive.osgeo.org/. The OSGeoLive releases themselves can be downloaded from http://download.osgeo.org/livedvd/releases/.

The archive is stored in the gh-pages branch of the OSGeoLive-doc repository. While the overall size of the repository is greatly increased git pull will only download this branch if explicitly requested.

In the future new releases could be automatically added to the archive via GitHub Actions.

From the email chain at https://lists.osgeo.org/pipermail/osgeolive/2019-December/014520.html - Cameron Shorter writes there are no docs for v1 of OSGeo Live:

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.

Extraction Process

ISOs were downloaded from https://sourceforge.net. This contains an archive of all archives from v2.0 to the present release, for example https://master.dl.sourceforge.net/project/osgeo-live/2.0/arramagong-livedvd-2.0.3-Final.iso The "mini" ISO versions were used as the full versions have been removed from SourceForge. The documentation in both however is identical.

Older ISOs (v2.0 to v5.0) could be extracted using 7Zip and a docs folder was contained in the root.

Versions v6.0 to v.8.5 required unzipping, and then further extracting the files from casper/filesystem.squashfs. Once this was extracted (to a filesystem folder) files were found in casper/filesystem/var/www/html

From v9.0 onwards casper/filesystem.squashfs was extracted using 7Zip and the docs contained in casper/filesystem/usr/share/doc/osgeolive-docs/html.

Image Duplication

The repository size was ~10GB due to many duplicate images. These were originally symlinks in the ISO files, but do not work correctly in git. A Python script was written to simply make copies of these files - see scripts/symlinks.py.

Due to limitations on publishing the site using GitHub Actions (the runner VMs only allowed 10GB of content) a second script was written to remove the duplicates and update the HTML links - see scripts/fix_images. This reduced the size of the repo by 50% (less than 5GB).

Archive Compilation

About

License:Other


Languages

Language:HTML 99.8%Language:JavaScript 0.2%Language:CSS 0.1%Language:SCSS 0.0%Language:Python 0.0%Language:CMake 0.0%