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
|
|
|
|
|
or you can check out the 'expoweb' repository 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>
|
|
|
|
|
<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>
|
