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
• 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 and 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 (and find-dead-qms.py)
• 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


• make-alljs.py - extracts legs and entrances - part of GPX processing.
• convert.py Scripts working on Loser-1624 Uebersicht_2011.svx
• create_dplong_table.py Creates and updates the lengths and depths of all the caves.
• cavestats and smklengths extract overall lengths and depths from all the survex files
• summarizecave.sh gets .3d file contents using survex
• caves-tabular.html a re-sortable table of cave data
• JavaScript packages are used by some troggle pages. See the Expo server page.
• make-prospectingguide-new.py and prospecting_guide_short.py - (obsolete)


• 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 on the server also needs
- a running mySQL database,
- a running apache webserver and
- cgit to display git repos.

Old but maybe useful scripts

• make-glossary.pl - used while documenting very complex caves (161 and 204). We may need this again for Tunnocks/Balkon.
• make-fb-map.pl does coordinate transformations

There were 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. The old scripts have been collected into /scripts or /noinfo in the :expoweb: repository.

Obsolete scripts

• logbk.pl - 2004 - obsolete. Replaced by troggle import parsers.
• make-indxal4.pl - obsolete. Part of the spreadsheet era.

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.