2020-03-01 22:22:21 +00:00
<!DOCTYPE html>
2018-08-02 16:06:49 +01:00
< html >
2017-12-07 03:25:11 +00:00
< head >
2020-03-01 22:22:21 +00:00
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
< title > CUCC Expedition Handbook: Cave data entry< / title >
2020-03-01 19:23:17 +00:00
< link rel = "stylesheet" type = "text/css" href = "../../css/main2.css" / >
2017-12-07 03:25:11 +00:00
< / head >
< body >
2020-03-01 22:22:21 +00:00
< body >
< h2 id = "tophead" > CUCC Expedition Handbook - New Cave data< / h2 >
< h1 > Creating a new cave in the online system< / h1 >
2018-08-02 16:06:49 +01:00
2020-03-01 22:22:21 +00:00
< h2 > Great, I have discovered a new cave...< / h2 >
< p > If you have not come to this page from the sequence starting at < a href = "newcave.html" > Starting a New Cave"< / a > then go and read that first.
2017-12-07 03:25:11 +00:00
2020-03-02 12:51:18 +00:00
< div style = "width:100%;height:50px;background:#C8E1E2" align = "center" >
This page outlines step 6 of the survey production process. Each step is documented separately.< br / >
2020-03-01 22:22:21 +00:00
<!-- Yes we need some proper context - marking here, breadcrumb trails or something.
Maybe a colour scheme for just this sequence of pages
-->
2020-03-02 12:51:18 +00:00
< a href = "newcave.html" > 1< / a >
- < a href = "newwallet.html" > 2< / a >
- < a href = "newsurvex.html" > 3< / a >
- < a href = "drawup.htm" > 4< / a >
- < a href = "newrig.html" > 5< / a >
- < a href = "caveentry.html" > 6< / a >
- < a href = "cavedescription.html" > 7< / a >
< / div >
2020-03-01 22:22:21 +00:00
< h2 > Process< / h2 >
< p >
This page and those following describe the process for creating new
caves and entrances, and especially how to add images/surveys so that they appear correctly online.< / p >
< / p >
< h3 > Two ways of creating a new cave in the online system< / h3 >
< ul >
< li > Filling in the online form< / li >
< li > Editing a file and uploading it< / li >
< / ul >
< p > For experienced people creating a batch of small caves the file upload & import process is quicker. Most people won't use this method
for their first cave so it is documented separately in < a href = "newcavefile.html" > new cave file method< / a > .
< p > In other words you can either add caves (or entrances) using the web-interface
2020-04-26 21:41:21 +01:00
or you can check out the 'expoweb' < a href = "../computing/repos.html" > repository< / a > using the version control system and just edit the files.< / p >
2019-04-02 00:54:05 +01:00
2020-03-01 22:22:21 +00:00
< p > Nevertheless you will find it useful when filling out the form for the first time
to have some idea what is going on behind the scenes. So you are recommended to have a quick look
at the < a href = "newcavefile.html" > new cave file method< / a > even if you have no intention of using it.
< / p >
< h2 > Recommended procedure< / h2 >
2017-12-07 03:25:11 +00:00
2020-03-01 22:22:21 +00:00
< p >
You will find the process a lot easier to follow if you Edit an existing cave first, because then you can see all the necesary
fields filled in. You can then fill out the form for your new cave using that as an example to follow. But of course be
very careful not to actually chenge anything on the form you have open for editing.
< / p >
2020-08-02 23:55:06 +01:00
< h3 > New Cave Number< / h3 >
< p > For a totally new cave you will be using a temporary number such as 2017-CUCC-24 or 2018-dm-07, not an Austrian official-issued Kataster number. But you may have been surveying a new passage in an established cave in which case you will need to find out if it has recently been issued with a Kataster number.
< p > The list in the "< a href = "/caves" > Caves< / a > " page (the menu item "Caves" in the vertical menu in the top-left of the page you are reading now)
shows all the caves which have been already "created" within the online system. You can see a slightly-more updated list in the
<!-- replace this with a link to a page with an IFRAME so that the UTF - 8 is done right -->
< a href = "../../noinfo/cave-number-index" > Cave Number Index< / a > which includes caves which are in the process of being registered but may not have been "created" using either of the two methods described here.
2020-03-01 22:22:21 +00:00
< h3 > New Cave form< / h3 >
< p > The links to follow to open up the "New Cave" form or the "Edit Cave" forms are
somewhat obscure. <!-- We should change this! -->
Go to the main cave index page which lists all the caves: < a href = "/caves" > Cave Index< / a >
and right at the bottom of the page (you will need to scroll down) it says< br / >
< a href = "/cave/new/" > New Cave< / a > .< br / > But don't click on it yet, first we will edit an old cave.
< / p >
2017-12-26 01:43:50 +00:00
2020-03-01 22:22:21 +00:00
< h3 > Edit Cave form< / h3 >
< p >
First make sure that you are logged-in to the troggle website. You almost certainly are already,
but if you are trying this on a new machine this can catch you out. Go to
< a href = "https://expo.survex.com/accounts/login/" > expo.survex.com/accounts/login/< / a > .
The username is "expo" and the password is the usual "{cavey}:{beery}" one.
< / p >
< ul >
< li >
Now open the cave page for an existing cave, e.g. < a href = "http://expo.survex.com/augstb/4.htm" > augstb-4< / a > .
< / li >
< li >
Now you can see that at the top there is a bullet point link labelled "Edit" -
this is for editing entrances so don't touch it.< / li >
< li >
What you need is the line saying
< a href = "http://expo.survex.com/cave/1623-4/edit/" > "Edit this cave"< / a > at the bottom of the top left-hand menu.
It has a little icon of a pen next to it.< / li >
2020-03-01 23:17:02 +00:00
< li > Click on it. A form appears.< / li > <!-- a pirate steals your survey. -->
2020-03-01 22:22:21 +00:00
< li >
Scroll down the page - it is a long form - and look at the"Description file" and "Url" fields.
These are the critical fields to get right when you create your own cave using the New Cave form.
< / li >
< / ul >
< p > Effectively each field on the form is concatenated between tags to make an XML
page for the cave (or entrance). So each field you fill in on the form may contain arbitrary HTML. Be careful!< / p >
2017-12-26 01:43:50 +00:00
2020-03-01 22:22:21 +00:00
< h3 > Gotchas< / h3 >
< p > There is a problem in that when you create a cave for the first time it doesn't know about the cave, so the drop-down
menu of caves does not include itself.
So a new entrance has to be assigned to an existing cave (which is in the drop-down), and edited correctly later once troggle has
fully
absorbed the existence of your new cave.
2017-12-07 03:25:11 +00:00
2020-03-01 22:22:21 +00:00
< h3 > Detailed walk-through of an example< / h3 >
2020-03-01 23:17:02 +00:00
< p > TO BE DONE - in a separate page< / p >
2020-03-01 22:22:21 +00:00
2017-12-07 03:25:11 +00:00
< h2 > List of New Cave/Cave_data fields< / h2 >
2020-03-01 22:22:21 +00:00
< p > The full list of fields is documented: < a href = "caveentryfields.html" > the full list of data-entry fields< / a > when creating a cave.
2017-12-26 01:43:50 +00:00
2020-03-01 22:22:21 +00:00
< hr / >
< p > Back to the previous page in this sequence
< a href = "newrig.html" > New rigging guide< / a > .
< br / > Now go the the next page in this sequence < a href = "cavedescription.html" > Write the full cave descriptions with diagrams< / a > .
< hr / >
2017-12-07 03:25:11 +00:00
< / body >
< html >
