CUCC Expedition Handbook

Other scripts

Current Scripts

• make-folklist.py turns the folk.csv file into a webpage.
• make_essentials.sh generates GPS tracks and routes for surface walking
• updatephotos generates navigable webpages from annual directories of photo images
• create_dplong_table.py Creates and updates the lengths and depths of all the caves
• make-areaindices.py (unmaintained?)
• make-prospectingguide-new.py and prospecting_guide_short.py - (unmaintained?)


• boe Bank of Expo (perl) 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


• wallets.py generates statuspages and to-do list pages for survey data production.
• svx2qm.py extracts QMs from the survex files
• tablize-qms.pl turns the list of QMs extracted into an HTML file
• 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


• cavestats extracts overall lengths and depths from all the survex files
• Makefile coordinates running many of these scripts (needs maintenance)

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.

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

Old and possibly obsolete scripts

• make-glossary.pl - used while documenting very complex caves (161 and 204). We may need this again for Tunnocks/Balkon.
• find-dead-qms.py - several QM scripts and intermediate files
• make-alljs.py - extracts legs and entrances
• make-indxal4.pl - obsolete
• logbk.pl - obsolete

There are perl and python scripts scattered through the :drawings: and :loser: (svx files) repos. Not all of the functions in these scripts have been recreated in more recent scripts or programmed into troggle.

When you write a script

Any script that generates an HTML file should insert <meta name="keywords" content="NOEDIT"> in the HTML header. Then when troggle renders the page it will not allow the user to edit the generated page. See handbook editing for a fuller explanation of troggle post-processing.