2019-12-23 16:29:50 +00:00
|
|
|
<!DOCTYPE html>
|
2019-02-25 20:54:07 +00:00
|
|
|
<html>
|
|
|
|
|
<head>
|
2019-12-23 16:29:50 +00:00
|
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
2020-04-02 14:25:58 +01:00
|
|
|
<title>Handbook Troggle Intro</title>
|
2019-12-30 01:23:56 +00:00
|
|
|
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
2019-02-25 20:54:07 +00:00
|
|
|
</head>
|
2021-04-29 13:00:37 +01:00
|
|
|
<body>
|
|
|
|
|
<style>body { background: #fff url(/images/style/bg-system.png) repeat-x 0 0 }</style>
|
2019-02-25 20:54:07 +00:00
|
|
|
<h2 id="tophead">CUCC Expedition Handbook</h2>
|
2020-04-02 21:40:30 +01:00
|
|
|
<h1>Troggle - Maintenance Manuals</h1>
|
|
|
|
|
<p>Troggle is the software which runs the the expo cave survey data management and website.
|
2019-02-26 18:19:16 +00:00
|
|
|
|
2021-04-29 17:52:28 +01:00
|
|
|
<p>If you are looking for how to manage or correct cave survey data then this is not the right place. You want the
|
|
|
|
|
<a href="../computing/manual.html"><em>Data</em> Maintenance</a> manual.
|
2020-04-02 14:25:58 +01:00
|
|
|
|
2023-03-28 15:48:24 +01:00
|
|
|
<p>Troggle attempts to be an exemplar of best-practice in Research Software Engineering. See
|
|
|
|
|
<a href="https://society-rse.org/about/">The Society of Research Software Engineering</a> founded in 2019. See also the
|
|
|
|
|
<a href="https://www.software.ac.uk/about">the UK Software Sustainability Institute</a>.
|
|
|
|
|
<p><em>"From short, thrown-together temporary scripts to solving a specific problem, through an abundance of complex
|
|
|
|
|
spreadsheets analysing collected data, to the hundreds of software engineers and millions of lines of code behind
|
|
|
|
|
international efforts such as the Large Hadron Collider and the Square Kilometre Array, there are few areas of research
|
|
|
|
|
where software does not have a fundamental role."</em>
|
2021-04-29 17:52:28 +01:00
|
|
|
|
|
|
|
|
<p>This part of the handbook is intended for people maintaining the troggle <em>software</em>:
|
2020-07-09 23:48:02 +01:00
|
|
|
<a href="https://www.goodreads.com/book/show/1155986.The_Tricky_Troggle">
|
|
|
|
|
<img border="1" class="onright" width="150px" src='tricky-troggle.jpg' alt='git logo'/></a>
|
2019-12-04 23:39:41 +00:00
|
|
|
<ul>
|
2020-04-02 21:40:30 +01:00
|
|
|
<li><a href="../computing/newyear.html">Annual tasks</a>: preparing for next year, finishing last year.
|
|
|
|
|
<li><a href="../computing/regular.html">Regular tasks</a>: housekeeping as surveys are digitised.
|
2023-02-24 16:55:35 +00:00
|
|
|
<li><a href="trogimport.html">Reimporting data</a>: reloading the database from scratch.
|
2021-04-29 13:00:37 +01:00
|
|
|
<li><a href="trogdocm.html">Maintain troggle</a> itself. The code is public on repository <a href="../computing/repos.html">:troggle:</a>
|
2020-05-12 17:19:15 +01:00
|
|
|
<li><a href="scriptsother.html">Other scripts</a> - photos, folk, wallets - not integral parts of troggle.
|
2020-04-02 21:40:30 +01:00
|
|
|
<li><a href="trogarch.html">Troggle and database</a> architecture: how it all fits together
|
2020-05-12 15:53:37 +01:00
|
|
|
<li><a href="trogdesign.html">Design decisions</a> inc. troggle replacement e.g. new systems for <a href="menudesign.html">website menus</a>
|
2021-04-29 13:00:37 +01:00
|
|
|
|
2020-07-29 18:02:33 +01:00
|
|
|
<li><a href="trogdjango.html">Troggle and django</a> - Upgrading to later django versions
|
|
|
|
|
|
2021-04-29 17:52:28 +01:00
|
|
|
<li><a href="trognotes.html">Programmers' guide</a> - and index to other documentation
|
2019-12-04 23:39:41 +00:00
|
|
|
</ul>
|
2020-07-09 23:48:02 +01:00
|
|
|
<p>Troggle is completely unlike any other django installation: it has a database, but the database is rebuilt from files every time it starts.
|
2021-04-29 17:52:28 +01:00
|
|
|
<p>Most of the data entry into troggle happens during or just after the expedition: i.e. once a year.
|
2020-04-28 12:31:38 +01:00
|
|
|
|
2021-04-29 17:52:28 +01:00
|
|
|
|
|
|
|
|
><p>but do also scan
|
2021-04-12 23:07:38 +01:00
|
|
|
<ul>
|
|
|
|
|
<li><a href="trogindex.html">Index of all troggle documents</a> - list of everything you can do with troggle.
|
|
|
|
|
</ul>
|
|
|
|
|
|
|
|
|
|
|
2020-04-28 12:31:38 +01:00
|
|
|
<p>* "Troggle eats just one very big meal a year."
|
2020-07-09 23:48:02 +01:00
|
|
|
|
2019-02-25 20:54:07 +00:00
|
|
|
<hr />
|
2020-04-02 21:40:30 +01:00
|
|
|
Go on to: <a href="trogarch.html">Troggle architecture</a><br />
|
|
|
|
|
Return to: <a href="trogintro.html">Troggle intro</a><br />
|
2020-07-27 22:04:17 +01:00
|
|
|
Troggle index:
|
|
|
|
|
<a href="trogindex.html">Index of all troggle documents</a><br />
|
2021-04-29 13:00:37 +01:00
|
|
|
<hr /></body>
|
2019-02-25 20:54:07 +00:00
|
|
|
</html>
|
