2
0
mirror of https://expo.survex.com/repositories/troggle/.git synced 2024-11-21 14:51:51 +00:00

Note that the instructions for adding a survey are all wrong.

This commit is contained in:
expo 2012-08-05 00:35:02 +02:00
parent 0c20ef2a04
commit 742848409b

View File

@ -1,16 +1,24 @@
#summary Instructions for entering a trip into the Troggle database
#labels HowTo
== Introduction ==
THIS DOCUMENT IS MAINLY WRONG
DO NOT USE THE ADMIN INTERFACE TO DIRECTLY MODIFY THE DATABASE. THE DATA WILL NOT BE ENTERED INTO MERCURIAL AND WILL GET LOST.
So you've just come down the hill from an exhausting week of top camp faffing. Time to immortalize your tales of great "finds". So let's put an entry in for stomping passage you found -- the 204 Hilde's beer cellar connection.
== The Troggle administrative interface ==
PLEASE DO NOT DO THE NEXT BIT
First thing is to get behind the pretty Troggle facade and into the administrative interface. On the main menu, hover over 'admin' and then click 'Troggle administrative interface.' Login with your username and password which you got from HowToRegisterAnAccount.
== Adding a LogbookEntry ==
PLEASE DO NOT DO THE NEXT BIT
The LogbookEntry model is probably the most important in Troggle. It represents a trips of all types; cave surveying trips, cave rigging and derigging trips, surface prospecting trips, car rides to expo, and the crazy trip you had after eating a slice of Djuke's nut bread. QMs, Surveys, Photos, and PersonTrips are all attached to LogbookEntries.
To make a new one, click on "LogbookEntries" and then "Add a LogbookEntry." Fill in the Date, Expedition, Author (that's probably you!), and Title. If your trip was in a real cave, then choose it from the drop down list unless you just found a brand new cave in which case you can add it by clicking the little plus icon next to Cave and following the instructions in HowToEnterACave. If you were on a trip that wasn't in a Cave, briefly describe the location of the trip, for example "Journey" or "Loser Plateau".
@ -19,12 +27,16 @@ When you fill out the text, you can use the Troggle WikiSyntax. Check it out. Tr
== Peopling your LogbookEntry ==
PLEASE DO NOT DO THE NEXT BIT
In Troggle, when a particular person goes on a particular trip, that event is called a PersonTrip. We store information such as the time underground, whether or not they were the author of the LogbookEntry, and the role that person had on the trip (FIXTHIS there is no role in persontrip).
To add some friends to your lonely trip, scroll down to "Person trips" and choose a Person expedition from the drop down list, and fill in their time underground. If you need more PersonTrip boxes, hit "Save and continue editing" at the bottom right of the page, and Troggle will give you space for more friends.
== If you create or tick off a QM ==
PLEASE DO NOT DO THE NEXT BIT
To add QMs to your trip, scroll down and fill in the fields. If you need more, use the "Save and continue editing button," as described above for entering Person trips.
The first set of QM input boxes is for the QMs that were found on this trip. There is a "ticked off by" box which should almost certainly be left blank. The way to "tick off" a QM in troggle is to add a trip in the QM's "ticked off by" field.
@ -35,8 +47,12 @@ A way to do this from the edit page for the logbook entry which ticked off the Q
== If you find a new cave ==
PLEASE DO NOT DO THE NEXT BIT
Click the little green plus sign next to the cave drop down box. In the new window that pops up, enter details of the new cave.
== If you took photos ==
Photos can be added in the same way you put your Person trips in. This time, you get to upload a file. Troggle will store that file wherever your settings has the photos directory.
PLEASE DO NOT DO THE NEXT BIT
Photos can be added in the same way you put your Person trips in. This time, you get to upload a file. Troggle will store that file wherever your settings has the photos directory.