CUCC Expedition Handbook

Troggle - Maintenance Manuals

Troggle is the software which runs the the expo cave survey data management and website.

This part of the handbook is intended for people maintaining the troggle software:

• Annual tasks: preparing for next year, finishing last year.
• Regular tasks: housekeeping as surveys are digitised.
• Other scripts - photos, folk, wallets - not integral parts of troggle.
• Troggle and database architecture: how it all fits together
• Design decisions inc. troggle replacement e.g. new systems for website menus
• Maintain troggle itself. The code is public on repository :troggle:
• Troggle and django - Upgrading to later django versions
• Uncategorised notes and past speculations

Troggle is completely unlike any other django installation: it has a database, but the database is rebuilt from files every time it starts.

Most of the data entry into troggle happens during or just after the expedition.

Advanced Users' Manual

We don't have one of these. You may find what you are looking for in Other scripts above. But there are a few things which are not really 'maintenance' and are not really cave data management either, e.g.

• JSON export - how to extract cave and expo data in JSON format.
• Compressed data export - how to extract cave and expo data in gzip/tar format.

• Index of all troggle documents - list of everything you can do with troggle.

* "Troggle eats just one very big meal a year."