<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>CUCC Expedition Handbook: Online systems presentation</title>
<link rel="stylesheet" type="text/css" href="/css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook - Online systems presentation</h2>

<h1>CUCC Austria Expeditions: Slides</h1>

<h3>Expo Computer &amp; website - Wookey's Presentation 22 Aug 2015</h3>

<p>Original presentation is <a href="http://wookware.org/talks/expocomputer/#/">online</a>.
This copy includes corrections of fact as of April 2020 [in square brackets].
</p>

<table class="trad"><tbody><tr><td style="padding:0 30px">
<p>The annual CUCC expedition to Austria lasts around five weeks each summer
and concentrates mainly on new exploration in the high alpine karst of the
<span lang="de-at">Loser</span> plateau (about 80km E of <span
lang="de-at">Salzburg).</span> Recent large projects are:

    <h3>Data Storage<br>
    </h3>
    <ul>
        <li>Version-controlled <a href="../computing/repos.html">repositories</a><br>
        </li>
        <ul>
            <li>website ('expoweb')<br>
            </li>
            <li>troggle<br>
            </li>
            <li>loser</li>
            <li>drawings (tunneldata)</li>
        </ul>
        <li>expofiles - just files</li>
        <ul>
            <li>photos</li>
            <li>presentations</li>
            <li>posters</li>
            <li>maps</li>
            <li>documents</li>
        </ul>
    </ul>

<h3>Website Structure [as in 2015]</h3>
<ul>
<li>Static web pages
<ul>
<li>indexes, festering, background, handbook<
</ul>

    <li>Generated web pages
    <ul>
    
<li>prospecting guide
</ul>
<li>Troggle pages
<ul>
<li>cave pages,survey scans, logbook entries, triplists
<li>Troggle also 'wraps' the other [static] stuff <br>
</ul>
</ul>
    <h3>WEBSITE LAYOUT [as in 2015]</h3>
    <ul>
        <li>
            <b>
            <i>years</i>
            </b> has per-year info (reports, lists, policy, logbooks)</li>
            <li>
                <b>
                <i>handbook</i>
                </b> contains handbook</li>
                <li>1626, 1623 are the [Austrian kataster] areas</li>
                <li>
                    <b>
                    <i>noinfo</i>
                </b>&nbsp; - dir used to be hidden on public web<br>
            </li>
            <ul>
                <li>scripts are in <i>noinfo/</i>  [or  <i>scripts/</i> ]
            </li>
        </ul>
        <li>generated files are regenerated with 'Make' in expoweb dir<br>&nbsp; (click on 'others'-&gt; 'Regenerate website' is the same)</li>
        <ul>
            <li>prospecting guide is in <i>noinfo/prospecting_guide_scripts</i> [broken]
            </font>
        </li>
    </ul>
    <li>folk is people list, now generated from <i>folk/folk.csv</i> by <i>scripts/make-folklist.py</i>
    <br>
</li>
</ul>
    <h3>Editing [as in 2015]</h3>
    Don't try to edit generated files.<br>
    Can edit in various ways:
    <ul>
        <li>In expo file manager (best)<br>
        </li>
        <li>Live on website (not recommended)<br>
        </li>
        <li>(Clone and) edit on another computer</li>
    </ul>
    <p>You always have to commit [version control] afterwards, however you edited.
    
    <h3>Managing Files</h3>

<b>EVERYTHING should be on the website!</br>
(HUGE BINARIES SHOULD NOT BE IN version control)</b>

<li>Info should go in the website handbook (as html, or PDF)
<li>Layout files edited every year make sense as ODT docs: <br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;(survey index, labels, accounting procedure)
<li>Link from website, store in website or <i>expofiles/uploads</i>
<li>Don't just create a random doc and leave it in 'Desktop'.
<li>Think about where some info would be found<br>

    <h3>Survex Dataset</h3>


        <li>caves</li>
        <li>surface</li>
        <li>surface/terrain<br>
        </li>
        <li>fixedpts</li>
        <li>template: example files<br>
        </li>
    <li>docs/datamaintenance.txt has some rules.<br>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Should be in the handbook</font>
    </li>
    <li>
        surface/caves connected by ents.svx, which is generated by make-ents.py, which <br>
        &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;fishes out every point marked with *entrance in the dataset.&nbsp; <br>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;ARGE do this wrong, with *fix in cave</font>
    </li>
    <li>
        all* make various groupings of data</font>
        <br>
    </li>
</ul>
    <h3>Adding a CAVE</h3>
    <ul>
        <li>Location<br>
        </li>
        <li>Photo</li>
        <li>Survey data</li>
        <li>Survey notes<br>
        </li>
        <li>Description</li>
        <ul>
            <li>rigging guide<br>
            </li>
        </ul>
        <li>Tag status</li>
        <li>Question marks<br>
        </li>
        <li>Drawn up (paper/tunnel/therion)<br>
        </li>
    <li>[Now go to the current documentation for <a href="../survey/newcave.html">adding a cave</a>]
    </ul>

<p>You are not finished until all of these are done
    <h3>Actually adding a cave (1)</h3>
    <ul>
    <li>Survey data [as survex file] in loser/caves/&lt;number&gt;
    <li>Simple caves go in:<ul>
    <li>location, name, description in expoweb/1623/cave_data/
    </ul>
    <li>Complex caves go in:
    <ul>
    <li>expoweb/1623/&lt;cavenumber&gt;/
    </ul>
    <li>[Now go to the current documentation for <a href="../survey/newcave.html">adding a cave</a>]
</ul>
    <h3>Actually adding a cave (2)</h3>
    <ul>
 <li>Notes go into physical survey folder. 
 <li>Scans go into expofiles/surveyscans/&lt;year&gt;/&lt;year&gt;-&lt;folderID&gt;</font>
    
<li>QMs don't seem to have a plan. Needs standardising [now as ;QM in .svx files]


    <li>Caves with no number are called &lt;year&gt;-&lt;initials&gt;-&lt;nn&gt; and go in file expoweb/cave_data/&lt;kataster_area&gt;-&lt;year&gt;-&lt;initials&gt;-&lt;nn&gt; [e.g. <i>1623-2018-dm-07.html</i>]
    <li>[Now go to the current documentation for <a href="../survey/newcave.html">adding a cave</a>]
</ul>
    <h3>Troggle&nbsp;</h3>
    <p><a href="https://www.djangoproject.com/">Django</a>-based.
    <li>URL list filter /cave, /expedition, /survey
    <li>Templates for pages
    <li>Processors to generate them<br>

<li>Parsers to read in from website files.
<li>Database back end (mysql)<br>


<li>The files are the 'real' database.
<li>Run <i>databaseReset.py reset</i> <br>

    <h3>Troggle updating</h3>

<li>For a new year, edit expoweb/noinfo/folk.csv
<li>This is the thing that 'creates' a new 'expedition' (not the logbook!)<br>

<li>Run <i>databaseReset.py reset 
to reparse everything.
<br><br>
</ul>
</table>
<br>
Return to <a href="onlinesystems.html">Systems Overview</a>
<hr />
</body>
</html>