expoweb/handbook/troggle/trogintro.html

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Handbook Troggle Intro</title>
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
</head>
<body><style>body { background: #fff url(/images/style/bg-system.png) repeat-x 0 0 }</style>
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>Troggle - what it is</h1>
<img class="onright" width="300px" src='tricky-troggle.jpg' alt='git logo'/>
<p>Troggle is the software which runs the the expo cave survey data management and website. 

<ul>
<li>Troggle <a href="training/begin.html">initial training: for complete beginners</a>
<li>For day to day cave survey work on the expo laptop, see: the expo <a href="../survey/newcave.html">survey handbook</a> (not the place to start learning)
<li>For what you can do with troggle: <a href="trogreports.html">expo data management with troggle reports</a>.
<li>For data management using your laptop: set up <a href="../computing/basiclaptop.html">your own laptop</a>.
<li>For the history of expo use of computers, see: <a href="../website-history.html">website and troggle history</a>.
<li>For system maintenance, see: the <a href="../troggle/trogmanual.html">system maintainers manual</a>.
</ul>

<h3 id="what">Troggle - what it does</a></h3>
 

<p>Troggle manages all cave and expo data in a logical and maintainable way 
and publishes it on the web. 
<p>
The troggle software is written and maintained by expo members.

<p>Examples of troggle-generated pages from data:
<ul>
<li><a href="/caves">expo.survex.com/caves</a> - list of caves surveyed and links to guidebook descriptions
<li><a href="/pubs.htm">expo.survex.com/pubs.htm</a> -  reports, accounts and logbooks
<li><a href="/expedition/2018">expo.survex.com/expedition/2018</a> - Members on expo 2018: . Scroll down for a list of all the data typed in from survey trips.
<li><a href="/survexfile/caves/">expo.survex.com/survexfile/caves/</a> - List of caves with all the surveys done for each.
<li><a href="/survexfile/caves-1623/115/cucc/futility.svx">expo.survex.com/survexfile/caves-1623/115/cucc/futility.svx</a> - Cave survey data from 1983 in Schnellzughohle. 
<li><a href="/survey_scans/">expo.survex.com/survey_scans/</a> - List of all scanned original survey notes.
<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>
<p>If you want to find out how to do something using troggle, then you may find it the 
<a href="../computing/manual.html">data maintenance manual</a> or the
<a href="../troggle/trogmanual.html">system maintenance manual</a>

<h3 id="why">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>Encourages consistency - making it easier to detect inconsistencies and omissions, and making mistakes visible
<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="who">Troggle - who uses it?</a></h3>
<p>The "use-case" users are described in <a href="trogusers.html">Who needs to know What and When</a>.

<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. 

<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 on the server takes about 5 minutes (as of November 2021).

<hr />
Go on to: 
<a href="trogstatus.html">troggle status</a><br />
Return to: 
<a href="../computing/onlinesystems.html">expo online systems overview</a><br />
Troggle index: 
<a href="trogindex.html">Index of all troggle documents</a><br /><hr />
</body>
</html>
Restructuring troggle notes and creation of troggle documentation directory in the handbook 2020-04-02 14:25:58 +01:00			`<!DOCTYPE html>`
			`<html>`
			`<head>`
			`<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />`
			`<title>Handbook Troggle Intro</title>`
			`<link rel="stylesheet" type="text/css" href="../../css/main2.css" />`
			`</head>`
grey banner and lots of to-do fixes, to do items all updated from scribbled notes on printout 2020-04-22 19:37:10 +01:00			`<body><style>body { background: #fff url(/images/style/bg-system.png) repeat-x 0 0 }</style>`
Restructuring troggle notes and creation of troggle documentation directory in the handbook 2020-04-02 14:25:58 +01:00			`<h2 id="tophead">CUCC Expedition Handbook</h2>`
more troggle pages dismemberment 2020-04-02 21:40:30 +01:00			`<h1>Troggle - what it is</h1>`
Better explanation of repos and tricky troggle 2020-04-28 12:31:38 +01:00			`<img class="onright" width="300px" src='tricky-troggle.jpg' alt='git logo'/>`
Restructuring troggle notes and creation of troggle documentation directory in the handbook 2020-04-02 14:25:58 +01:00			`<p>Troggle is the software which runs the the expo cave survey data management and website.`

			`<ul>`
expo training 2023-03-21 17:33:27 +00:00			`<li>Troggle <a href="training/begin.html">initial training: for complete beginners</a>`
			`<li>For day to day cave survey work on the expo laptop, see: the expo <a href="../survey/newcave.html">survey handbook</a> (not the place to start learning)`
Fix mistakes in prev commit: trog reports 2022-02-19 23:13:52 +00:00			`<li>For what you can do with troggle: <a href="trogreports.html">expo data management with troggle reports</a>.`
Troggle programmers guide - beginnings 2021-04-29 17:52:28 +01:00			`<li>For data management using your laptop: set up <a href="../computing/basiclaptop.html">your own laptop</a>.`
Restructuring troggle notes and creation of troggle documentation directory in the handbook 2020-04-02 14:25:58 +01:00			`<li>For the history of expo use of computers, see: <a href="../website-history.html">website and troggle history</a>.`
Troggle programmers guide - beginnings 2021-04-29 17:52:28 +01:00			`<li>For system maintenance, see: the <a href="../troggle/trogmanual.html">system maintainers manual</a>.`
Restructuring troggle notes and creation of troggle documentation directory in the handbook 2020-04-02 14:25:58 +01:00			`</ul>`

Generating more outline troggle documentation 2020-04-03 01:06:35 +01:00			`<h3 id="what">Troggle - what it does</a></h3>`
Restructuring troggle notes and creation of troggle documentation directory in the handbook 2020-04-02 14:25:58 +01:00

			`<p>Troggle manages all cave and expo data in a logical and maintainable way`
			`and publishes it on the web.`
			`<p>`
			`The troggle software is written and maintained by expo members.`

			`<p>Examples of troggle-generated pages from data:`
			`<ul>`
			`<li><a href="/caves">expo.survex.com/caves</a> - list of caves surveyed and links to guidebook descriptions`
			`<li><a href="/pubs.htm">expo.survex.com/pubs.htm</a> - reports, accounts and logbooks`
			`<li><a href="/expedition/2018">expo.survex.com/expedition/2018</a> - Members on expo 2018: . Scroll down for a list of all the data typed in from survey trips.`
			`<li><a href="/survexfile/caves/">expo.survex.com/survexfile/caves/</a> - List of caves with all the surveys done for each.`
			`<li><a href="/survexfile/caves-1623/115/cucc/futility.svx">expo.survex.com/survexfile/caves-1623/115/cucc/futility.svx</a> - Cave survey data from 1983 in Schnellzughohle.`
			`<li><a href="/survey_scans/">expo.survex.com/survey_scans/</a> - List of all scanned original survey notes.`
			`<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>`
Troggle programmers guide - beginnings 2021-04-29 17:52:28 +01:00			`<p>If you want to find out how to do something using troggle, then you may find it the`
			`<a href="../computing/manual.html">data maintenance manual</a> or the`
			`<a href="../troggle/trogmanual.html">system maintenance manual</a>`
Generating more outline troggle documentation 2020-04-03 01:06:35 +01:00
expo training 2023-03-21 17:33:27 +00:00			`<h3 id="why">Troggle - why we developed it</a></h3>`
troggle documentation move para 2020-07-09 23:48:02 +01:00
			`<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.`
django documentaiton updates 2021-03-30 01:42:41 +01:00			`<li>Encourages consistency - making it easier to detect inconsistencies and omissions, and making mistakes visible`
troggle documentation move para 2020-07-09 23:48:02 +01:00			`<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>`

expo training 2023-03-21 17:33:27 +00:00			`<h3 id="who">Troggle - who uses it?</a></h3>`
New index to all troggle pages 2020-07-27 01:42:09 +01:00			`<p>The "use-case" users are described in <a href="trogusers.html">Who needs to know What and When</a>.`
troggle documentation move para 2020-07-09 23:48:02 +01:00
Generating more outline troggle documentation 2020-04-03 01:06:35 +01:00			`<h3 id="where">Troggle - where it gets the data</a></h3>`
			`<p>`
troggle documentation move para 2020-07-09 23:48:02 +01:00			`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.`
Generating more outline troggle documentation 2020-04-03 01:06:35 +01:00
improving install docum 2021-10-27 19:25:37 +01:00			`<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 on the server takes about 5 minutes (as of November 2021).`
Generating more outline troggle documentation 2020-04-03 01:06:35 +01:00
Restructuring troggle notes and creation of troggle documentation directory in the handbook 2020-04-02 14:25:58 +01:00			`<hr />`
more troggle pages dismemberment 2020-04-02 21:40:30 +01:00			`Go on to:`
			`<a href="trogstatus.html">troggle status</a><br />`
			`Return to:`
Moving online systems overview and computing manual pages 2020-04-09 19:13:18 +01:00			`<a href="../computing/onlinesystems.html">expo online systems overview</a><br />`
New index to all troggle pages 2020-07-27 01:42:09 +01:00			`Troggle index:`
			`<a href="trogindex.html">Index of all troggle documents</a><br /><hr />`
Restructuring troggle notes and creation of troggle documentation directory in the handbook 2020-04-02 14:25:58 +01:00			`</body>`
			`</html>`