CUCC Expedition Handbook

Other scripts

Apart from these scripts, troggle in full deployment also needs a running mySQL database, a running apache webserver and cgit to display git repos.

Scripts

• make-folklist.py turns the folk.csv file into a webpage.
• updatephotos generates navigable webpages from annual directories of photo images
• wallets.py generates statuspages and to-do list pages for survey data production.
• make_essentials.sh generates GPS tracks and routes for surface walking
• make_svx.sh generates surface Survex tracks
• svxtrace.py analyses Survex tracks to help find errors
• chk-refs.sh analyses Survex files and wallets files to find reference errors
• create_dplong_table.py Creates and updates the lengths and depths of all the caves
• make-areaindices.py (obsolete?)
• make-prospectingguide-new.py and prospecting_guide_short.py - unmaintained
• boe Bank of Expo runs the accounts preceding and during expo
• bierbook.tex LaTeX script for generating the bierbook - a new list of names and dates each year
• seshbook.tex LaTeX script for generating the seshbook - works from the same list of names
• therionpage.tex LaTeX script anbd makefile for generating therion-style protractors

There are also scripts running cron jobs on the server to fix file permissions and to periodically tidy repositories, and example rsync and scp scripts to help manage synchronisation of the expofiles directories which are not under version control.

Wallets

Online wallets are maintained using the wallets.py script, but troggle also directly imports all the expofiles/surveyscans/ directories of scanned survey notes.

Survex files

Survex files contain a reference to the wallet which contains the original survey notes for that surveyed passage. These sometimes have errors and also get out of date as caves get renamed when they get a kataster number issued. Each online survey wallet also has a reference to the survex file(s) which have been typed up from that data.

Folk

Folk update process produces a webpage listing all expo participants but it also runs some validation checks on the input file /folk/folk.csv . Troggle also directly imports folk.csv so that it knows who everyone is, but errors during the importing are not as easy to see as validation errors printed when running the make-folklist.py script.

Photos

updatephotos uses the BINS package to generate the webpages. BINS is no longer maintained by its author so expo has taken on the responsibility for keeping it running. (Wookey is in the process of packaging it as a proper debian package).