troggle documentation move para

This commit is contained in:
Philip Sargent
2020-07-09 23:48:02 +01:00
parent fc250d1b68
commit 63bc4103a7
3 changed files with 37 additions and 30 deletions

View File

@@ -37,9 +37,30 @@ The troggle software is written and maintained by expo members.
<li><a href="/survey_scans/2018%252343/">expo.survex.com/survey_scans/2018%252343/</a> - list of links to scanned notes for wallet #43 during the 2018 expo.
</ul>
<h3 id="troggle">Troggle - why we developed it</a></h3>
<p>Troggle..
<ol>
<li>Coherently publishes expo data by cave, by expedition, by person, by trip or by survey - without requiring duplicate data entry.
<li>Manages and safely archives the typed and scanned survey data, entrance data, trip records (logbooks) and expo records.
<li>Enforces consistency - making it easier to detect mistakes and omissions
<li>Publishes the "guidebook descriptions" of caves by a combination of online forms and uploading files.
<li>Supports the process of turning scribbled notes into finished cave surveys
<li>Generates prospecting guides so that we don't waste time looking at holes which have already been explored
<li>Reformats the webpages such that they have a coherent style and have a small menu at the top-left
hand corner. These are the handbook you are reading now and the historic records of past expeditions.
<li>Provides a way of editing individual pages of the handbook
for very quick and urgent changes.
[This is the "Edit this page" capability; see <a href="../computing/manual.html#editthispage"> for
how to use it</a> and <em>how to tidy up afterwards</em>].
</ol>
<h3 id="where">Troggle - where it gets the data</a></h3>
<p>
All the data of all kinds is stored in files. When troggle starts up it imports that data from the files. There are other scripts doing useful things (folk, wallets) and these too get their data from files. Troggle is completely unlike any other django installation: it has a database, but the database is rebuilt from files.
All the data of all kinds is stored in files. When troggle starts up it imports that data from the files. There are other scripts doing useful things (folk, wallets) and these too get their data from files.
<p>There is never any need to back up or archive the database as it is rebuilt from files. Rebuilding troggle and re-importing all the data takes about half an hour.