CUCC Expedition: Data Maintenance Manual

Expo Data Maintenance Manual

[This page currently being restructured and edited to make it more appropriate to the task. Many fragments have been moved here but not yet properly edited together. Also there are no links to other pages which will be needed.]

Expo data maintenance manual

Getting a username, password and key

You don't need a password to view most things, but you will need one to change them.

Use these credentials for access to the troggle site. The user is 'expo', with a cavey:beery password. Ask someone if this isn't enough clue for you. This password is important for security. The whole site will get hacked by spammers or worse if you are not careful with it. Use a secure method for passing it on to others that need to know (i.e not unencrypted email), don't publish it anywhere, don't check it in to the data management system by accident. A lot of people use it and changing it is a pain for everyone so do take a bit of care.

This password is all you need to log in to troggle and to use the troggle control panel (very few people need to do this). But if you want to update webpages (a much more common requirement) or to edit the software itself (very rare), then you will also need to get a login (register a key with the server). See key-pair setup for details.

Pushing cave data to the :loser: and :drawings: repositories also needs a key. So cavers entering their cave survey data have to use a machine on which this already set up. These machines are the expo laptop and the laptop 'aziraphale' which live in the potato hut during expo. If you want to use your own laptop then see below.

Updating cave pages

Public cave description pages are automatically generated by troggle from a set of cave files in /cave_data/ and /entrance_data/. These files are named -.html (where area is 1623 or 1626), e.g. /cave_data/1623-115.html

Read the survey handbook section on creating a new cave in the system for instructions on how to name caves and the files you use to recoird them.

Cave names do not have leading zeros They are stored by number/ID in the dataset, not by name.

Caves with a provisional number consisting of a year and a serial number should be hyphenated, thus 2002-04 not 2002_04 or any of the various other variants

Clicking on 'New cave' (at the bottom of the cave index) lets you enter a new cave. Info on how to enter new caves has been split into its own page.

This may be a useful reminder of what is in a survex file how to create a survex file.