expoweb/handbook/caveentry.html

140 lines
3.7 KiB
HTML
Raw Normal View History

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<title>Cave entry fields</title>
</head>
<body>
<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, and how to enter new
caves and entrances, and especially how to add images/surveys so that they appear.</p>
<p>Effectively each field is concatenated to make an HTML
page for the cave (or entrance), so each field may contain arbitrary HTML.</p>
<p>You can either add caves (or entrances) using the web-interface, clicking on 'New Cave') or
'New Entrance'), or you can check out the 'expoweb' repository and just edit the files.</p>
<h2>File layout</h2>
<p>The caves in our site are stored as XML files under <tt>noscript/cave_data</tt> and in
files named <tt>area-cavenumber</tt>. Entrances are correspondingly
in <tt>noscript/entrance_data</tt> files, with the same naming convention, except that if
there is more than one entrance they have a,b,c suffixes. Any associated files, usually photos and surveys, are
stored under the area names <tt>1623</tt> or <tt>1626</tt>, then the cavenumber. An
understanding of this file layout is very important when writing the html so that images
appear as the URLs in the XML file should be relative URLs to the cave page, which appears
as <i>area/cavenumber</i>.</p>
<p>An example will make clear how this works</p>
<p>TODO - example of the filelayout</p>
<h2>List of New Cave/Cave_data fields</h2>
<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'.</dd>
</dl>
<dl>
<dt>caveslug</dt>
<dd>I.D. used to refer to this cave in entrance data files.</dd>
</dl>
<dl>
<dt>area</dt>
<dd>The Kataster area (always 1623 or 1626). It's important to get this right, especially
if near the border between the two areas. 1623 is our main area, but the border is not too far beyond the Stone
Bridge so since 2014 some of our caves are in 1626.</dd>
</dl>
<dl>
<dt>area</dt>
<dd>Yes - there really are two different fields, both called 'area'. Bonkers. This second
one is the CUCC-defined areas shown in <a href="/areas.htm">this plan</a>.</dd>
</dl>
<dl>
<dt>kataster_code</dt>
<dd>The length/depth code used in the Austrian kataster. This may be autogenerated if you
don't enter one.</dd>
</dl>
<dl>
<dt>kataster_number</dt>
<dd></dd>
</dl>
<dl>
<dt>unofficial_number</dt>
<dd></dd>
</dl>
<dl>
<dt>entrance</dt>
<dd></dd>
</dl>
<dl>
<dt>entranceslug</dt>
<dd></dd>
</dl>
<dl>
<dt>letter</dt>
<dd></dd>
</dl>
<dl>
<dt>explorers</dt>
<dd></dd>
</dl>
<dl>
<dt>underground_description</dt>
<dd></dd>
</dl>
<dl>
<dt>equipment</dt>
<dd></dd>
</dl>
<dl>
<dt>references</dt>
<dd></dd>
</dl>
<dl>
<dt>survey</dt>
<dd></dd>
</dl>
<dl>
<dt>kataster_status</dt>
<dd></dd>
</dl>
<dl>
<dt>underground_centre_line</dt>
<dd></dd>
</dl>
<dl>
<dt>notes</dt>
<dd></dd>
</dl>
<dl>
<dt>length</dt>
<dd></dd>
</dl>
<dl>
<dt>depth</dt>
<dd></dd>
</dl>
<dl>
<dt>extent</dt>
<dd></dd>
</dl>
<dl>
<dt>survex_file</dt>
<dd></dd>
</dl>
<dl>
<dt>description_file</dt>
<dd></dd>
</dl>
<dl>
<dt>url</dt>
<dd></dd>
</dl>
</body>
<html>