mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2025-12-08 23:04:35 +00:00
153 lines
8.4 KiB
HTML
153 lines
8.4 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>CUCC Expedition Handbook: Cave entry field</title>
|
|
<link rel="stylesheet" type="text/css" href="/css/main2.css" />
|
|
</head>
|
|
<body>
|
|
<h2 id="tophead">CUCC Expedition Handbook</h2>
|
|
|
|
<h1>Cave entry page fields</h1>
|
|
<p>There are a lot of fields on the 'new/edit cave' page and the 'new/edit entrance' page and
|
|
some of them are a quite mysterious. This page explains what they mean. The same fields appear in each cave_data/ xml file.</p>
|
|
<p>
|
|
Instructions on how to enter the data for new
|
|
caves and entrances, and especially how to add images/surveys so that they appear properly,
|
|
is to be found on the sequence of pages <a href="caveentry.html">starting here</a>.
|
|
</p>
|
|
|
|
|
|
<h3>Names of identifiers and files</h3>
|
|
<p>We used to use CAPITAL LETTERS for cave names, e.g. 2014-MF-03, but <b>lower case</b> for the names of files, e.g. 2014-mf-03.svx . However so many people have done the revere that we have stopped caring.
|
|
<p>However we do still always use lower case for entrance identifiers 'a', 'b', 'c' etc.
|
|
<p>So a new cave would be 2023-ZZ-01 and its entrances would be 2023-ZZ-01a, 2023-Z-01b and 2023-ZZ-01c.
|
|
<p>Our generic guidance for typing logbooks, handbook pages etc. applies particularly to cave descriptions and entrance descritpions where we have to be particularly picky about the formats and character encodings, so now read:
|
|
<a href="/handbook/computing/hbmanual1.html#conventions">expo typing conventions</a>.
|
|
|
|
<h2>List of New Cave/Cave_data fields</h2>
|
|
<p>The filename <em>must</em> be the name of the cave, with ".html" as a suffix, e.g. 1623-309.html or 1623-2024-XX-01.html . The filename is used by troggle to create the unique identifier for the cave, so don't screw this up.
|
|
<dl>
|
|
<dt>unofficial_number</dt>
|
|
<dd>(<i>Either this or kataster_number is required</i>). Initial temporary cave ID used until kataster number is allocated. (e.g. 2012-DD-01) If you do not give this (or the kataster_number if issued) then your cave <em>will not appear</em> in the caves list (<a href="http://expo.survex.com/caves">Main Index/caves</a>).</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>kataster_number</dt>
|
|
<dd>(<i>Either this or unofficial_number is required</i>). Offical number in Austrian kataster if one has been allocated.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>name</dt>
|
|
<dd>Ideally a name in German but any name will do, e.g. "Slippery Death Hole No.9"</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt>underground_description</dt>
|
|
<dd>This is the important bit. This will be the master description of the cave for public use. The description of what the cave is like (the description of the approach and entrance goes in entrance file). For a small cave this will be the entire description. For larger caves it will be the front page of the description, or a short intro, containing links to other pages with the cave description in. You can leave this field empty and put a filename in description_file instead, in which case that will be used. HTML freeform field.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>survey</dt>
|
|
<dd>Drawn-up surveys. Scans of paper surveys or images/PDFs of electronic surveys. Should include HTML to display current plan and elevation, with links to larger versions (See section on URLs and files). Could list links to multiple years of survey, or even a separate survey page if it's complicated enough. HTML freeform field.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>explorers</dt>
|
|
<dd>Club (CUCC) and year(s) of exploration. To distinguish from caves explored by foreign groups. Names can be given too if it was a small cave. HTML freeform field.</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt>equipment</dt>
|
|
<dd>For a small cave, summary of gear needed to descend. For longer caves it could be blank, a table, or just refer to the description/topos. Leave blank if this info is in the description. HTML freeform field.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>notes</dt>
|
|
<dd>Normally empty, but place for anything else that should be noted, such as info on cave maybe being a duplicate, or lost. Also used for notes on process of getting cave into Austrian kataster. (e.g. 'Too small to be in Kataster', 'Number applied for on 'date', awaiting allocated number).HTML freeform field.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dl>
|
|
<dt>references</dt>
|
|
<dd>References to documentation. Could be Journal articles or Logbook entries. Can be links if the docs are online. HTML freeform field.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>description_file</dt>
|
|
<dd>Filename: the name of top-level description file for this cave, when a separate file is used. Used instead of above entrance_description field for large caves with complex descriptions. Blank if the description is in the 'underground_description' field. </dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>survex_file</dt>
|
|
<dd>Name of top-level survex file for this cave. Relative to the 'loser' <a href="../computing/repos.html">survex repository</a>. So for most caves that's <tt>caves-{area}/cavenum/cavenum.svx</tt> e.g. 'caves-1623/204/204.svx'</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>areacode</dt>
|
|
<dd>The Kataster area (always 1623, 1624, 1626 or 1627). This will <em>always</em> be the first 4 characters of the filename. </dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>subarea</dt>
|
|
<dd>(<i>Obsolete</i> - but exists for some older caves) This
|
|
one is the CUCC-defined subareas shown in <a href="/areas.htm">this plan</a>.</dd>
|
|
</dl>
|
|
|
|
|
|
|
|
<dt>length</dt>
|
|
<dd>Cave length. Can be left blank and system should fill it in automatically from survey data (it doesn't yet) We should probably scrap this field.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>depth</dt>
|
|
<dd>Cave depth. Can be left blank and system should fill it in automatically from survey data (it doesn't yet) We should probably scrap this field.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>extent</dt>
|
|
<dd>Cave extent(as defined by survex. Not very useful. Best left blank and system could fill it in automatically from survey data (it doesn't yet). We should probably scrap this field.</dd>
|
|
</dl>
|
|
|
|
<dl>
|
|
<dt>kataster_code</dt>
|
|
<dd>The length/type/exploration code used in the Austrian kataster. <a href="/katast.htm">Look-up table here</a>.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>fully explored</dt>
|
|
<dd>'False' or 'True'.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>non_public</dt>
|
|
<dd>'False' or 'True'. True if the cave should only be visible to logged-in users. Caves
|
|
are normally public, so enter 'False' unless you know otherwise.</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>identified login</dt>
|
|
<dd>'Not editable. This is a visual indicator of whether you have logged in as a real person or logged in as e.g. 'expo'</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>who_are_you</dt>
|
|
<dd>Your name: the name of the person editing this information, who may not be an explorer or even
|
|
have ever visited the cave. This is only used in the version control history of the edits (new in 2025). e.g. <var>"Anathema Device <anathema@hut.expo>"</var></dd>
|
|
</dl>
|
|
|
|
|
|
<h4>Not visible on the form, but in the cave description file</h4>
|
|
<p>These fields are in the template file if filling that in manually - if you are a git user. <dl>
|
|
<dt>entrance</dt>
|
|
<dd>Enclosing tag for each entrance, containing an entranceslug ID and a letter (if more than one entrance)</dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>entranceslug</dt>
|
|
<dd>Internal ID to refer to each entrance instance in the entrance files (must be the same as that filename (e.g. 1623-161a in entrance_data/1623-161a.html). </dd>
|
|
</dl>
|
|
<dl>
|
|
<dt>letter</dt>
|
|
<dd>Leave blank for single-entrance cave. If there is more than one entrance then the letter needs to be given. This must be the same as the last character of the filename e.g. a for entrance_data/1623-161a.html or nothing at all for entrance_data/1623-114.html which has no letter.</dd>
|
|
</dl>
|
|
|
|
|
|
<h3>Template files for bulk entry</h3>
|
|
<p>
|
|
There are template files for you to fill-in when creating new caves and entrance in the online system. Download them:
|
|
<ul>
|
|
<li><a download href="../../templates/cave_data.html">cave_data template</a>
|
|
<li><a download href="../../templates/entrance_data.html">entrance_data template</a>
|
|
</ul>
|
|
These are XML files, not HTML files, using special tags which are used by the online system to create the webpages in combination with numerical survey data. Instructions are within each file. These are copies (and may be out of date), the master copies are in troggle/templates/dataformat/ .
|
|
</p>
|
|
<hr />
|
|
<p>Back to <a href="caveentry.html">Cave data entry</a>
|
|
<hr /></body>
|
|
<html>
|