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
• pmap generates gpx file of geolocated photos from the 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


• 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
• gpx2survex, make_svx.sh generates surface Survex tracks from gpx
• svxtrace.py (obsolete) analysed Survex tracks to help find 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.
• convert_shx.ml converts coordinates to a shapefile
• Makefile coordinates running many of these scripts (obsolete or needs severe 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 (at least)
- a mySQL database,
- a webserver such as apache
- a text seach utility such as xapian
- cgit to display git repos.

See the server configuration for the full list, or the smaller troggle dev setup for just core software development.

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.
• make-prospectingguide-new.py and prospecting_guide_short.py - (obsolete)
• wallets.py - obsolete. Generated statuspages and to-do list pages for survey data production.

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.