mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2024-11-25 08:41:54 +00:00
109 lines
5.3 KiB
HTML
109 lines
5.3 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
|
|
<title>Handbook placeholder page</title>
|
|
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
|
</head>
|
|
<body>
|
|
<h2 id="tophead">CUCC Expedition Handbook</h2>
|
|
|
|
<h1>Cave data file</h1>
|
|
<p>These files live in <span style="font-family: monospace">:expoweb:/cave_data/</span>
|
|
<p>The example full format below is of a very simple cave with hardly any fields filled in. The most vital field is
|
|
<code><url>augstb/4.htm</url> </code>
|
|
at the bottom as this shows that this file is <code>:expoweb:/cave_data/augstb/4.htm</code>
|
|
|
|
<!-- it would be nice to find something that colourises this in HTML -->
|
|
<pre><code><!-- Only put one cave in this file -->
|
|
<!-- If you edit this file, make sure you update the websites database -->
|
|
<html lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
|
|
</head>
|
|
<body>
|
|
<cave>
|
|
<non_public>True</non_public>
|
|
<caveslug>1623-4</caveslug>
|
|
<official_name>Ritscherbachhöhle</official_name>
|
|
<area>1623</area>
|
|
<area>11</area>
|
|
<kataster_code>1/T(W) +</kataster_code>
|
|
<kataster_number>4</kataster_number>
|
|
<unofficial_number></unofficial_number>
|
|
|
|
<entrance>
|
|
<entranceslug>1623-4</entranceslug>
|
|
<letter></letter>
|
|
</entrance>
|
|
|
|
<explorers>Höhlenforschervereinigung Altaussee, 1937</explorers>
|
|
<underground_description></underground_description>
|
|
<equipment></equipment>
|
|
<references></references>
|
|
<survey>Plan at 1:100 by Alfred Auer, 1968 </survey>
|
|
<kataster_status></kataster_status>
|
|
<underground_centre_line></underground_centre_line>
|
|
<notes></notes>
|
|
<length>12.3m</length>
|
|
<depth>1.07m</depth>
|
|
<extent></extent>
|
|
<survex_file></survex_file>
|
|
<description_file>augstb/4.htm</description_file>
|
|
<url>augstb/4.htm</url>
|
|
</cave>
|
|
</body>
|
|
</html>
|
|
</code></pre>
|
|
|
|
<!-- Yes we should not be using the <tt> "teletype" tag as it is deprecated. -->
|
|
<p>As you can see, this is an XML tag format similar to HTML but with tags defined to hold cave survey data. These files are processed by troggle in real-time to produce an HTML file on the fly which is sent to your browser so that it
|
|
looks <a href="http://expo.survex.com/augstb/4.htm">like this</a>
|
|
|
|
<p>An explanation of what the field names mean and how they are used is on
|
|
the <a href="caveentryfields.html">cave entry fields</a> page. There is not an exact correspondance between
|
|
the form and the file format however.
|
|
|
|
<p>When you fill in the online form you creating a file just like the one above: troggle takes the input data from the form and creates the file. Troggle also stores the cave information in it's live memory when you use the form method.
|
|
<p>If instead of using the form you create the file by hand and upload it to the server you will also need find a nerd to run the cave import procedure before troggle "knows" that the cave exists.
|
|
<h3>Cave entrances</h3>
|
|
<p>There is <a href="newentrancefile.html">an exactly analogous file</a> for cave entrances except that those files live in <span style="font-family: monospace">:expoweb:/entrance_data/</span>
|
|
|
|
<h2>File layout</h2>
|
|
<p>The caves in our site are stored as XML files in the directory <tt>:expoweb:/cave_data</tt> and in
|
|
files named <tt>:expoweb:/cave_data/{area}-{cavenumber}</tt>. Entrances are correspondingly
|
|
in <tt>:expoweb:/entrance_data</tt> files, with the same naming convention, except that if
|
|
there is more than one entrance they have a,b,c suffixes, e.g. <tt>:expoweb:/<b>entrance</b>_data/{area}-{cavenumber}b</tt>
|
|
<p></p>Any <em>associated files</em>, usually photos and surveys, are
|
|
stored under the area names <tt>:expoweb:/1623/{cavenumber}</tt> or <tt>:expoweb:/1626/{cavenumber}</tt>
|
|
Note that this is a different naming convention: caves and entrances have the {area} as <em>
|
|
part of the file name
|
|
</em>
|
|
whereas associated files have the {area} <em>as a directory</em> in which the files are stored.
|
|
<p>An
|
|
understanding of this file layout is very important when filling in the forms or writing the tags so that images
|
|
appear on the final published website. The URLs in the XML file <em>should be relative URLs</em> to the cave page, which <em>appears</em>
|
|
as <tt>cave/{area}/{cavenumber}</tt> on the website even though <em>internally</em> they are <tt>cave_data/{area}-{cavenumber}</tt> </p>
|
|
<hr />
|
|
<p>Back to the form-filling method
|
|
<a href="caveentry.html">the form-filling method</a> guide
|
|
<hr />
|
|
<div id="menu">
|
|
<ul id="links">
|
|
<li><a href="../index.htm">Expedition Handbook</a>
|
|
<ul>
|
|
<li><a href="../rig/rigit.html">Rigging guide</a></li>
|
|
<li><a href="../survey/index.htm">Surveying guide</a></li>
|
|
<li><a href="../look4.htm">Prospecting guide</a></li>
|
|
<li><a href="../rescue.htm">Rescue guide</a></li>
|
|
</ul></li>
|
|
<li><a href="../../infodx.htm">Main index</a></li>
|
|
|
|
<li><a href="../../index.htm">Expo Home</a></li>
|
|
<li><a href="https://camcaving.uk">CUCC Home</a></li>
|
|
</ul>
|
|
</div>
|
|
</body>
|
|
</html>
|