mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2024-12-04 23:52:23 +00:00
134 lines
8.4 KiB
HTML
134 lines
8.4 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>CUCC Expedition: Data Maintenance Manual</title>
|
|
<link rel="stylesheet" type="text/css" href="../css/main2.css" />
|
|
</head>
|
|
<body>
|
|
<h2 id="tophead">CUCC Expedition: Data Maintenance Manual</h2>
|
|
<h1>Expo Data Maintenance Manual</h1>
|
|
|
|
|
|
<h2><a id="manual">Oh No! Something has changed.</a></h2>
|
|
<p>It happens all the time,
|
|
<ul>
|
|
<li>somebody annoyingly links your new entrance to an existing cave
|
|
<li>or your new discovery is discovered to be the same as something explored in the 1980s
|
|
<li>or two people each created a new online wallet for the same trip
|
|
<li>or somebody didn't read the <a href="../survey/">survey manual</a> carefully enough (tsk.)
|
|
</ul>
|
|
<p>so now you need to fix things.
|
|
|
|
<p>Check the <a href="../survey/status.html">current status</a> of the expo data first.
|
|
|
|
<h2>Do not despair - no nerd needed</h2>
|
|
<p>OK, <em>probably</em> what you need is written up somewhere in the 7-stage
|
|
'<a href="../survey/newcave.html">complete process for recording cave data</a>',
|
|
possibly in one of the side-pages which you skipped through when you read it.
|
|
|
|
<h3>With a Basic Laptop</h3>
|
|
<p>You already have the <a href="#password">password</a>, so just using troggle web pages and a
|
|
<a href="basiclaptop.html">basic laptop</a> you can already do these things which have been "trogglized":
|
|
|
|
<ul>
|
|
<li>Edit any existing survex files, save them, and run survex on them <em>on the server</em>
|
|
<li>Create entirely new survex files, including creating intermediate subdirectories (see below)
|
|
<li>Edit the cave description text and technical data fields for existing caves
|
|
<li>Edit the entrance description text and technical data fields for existing caves
|
|
<li>Create new entrances on existing caves
|
|
<li>Reconnect an entrance to a different cave
|
|
<li>Edit HTML to add an existing uploaded photo into the description text for an extrance or cave
|
|
<li>Create entirely new caves in the system by filling out online forms
|
|
<li>Upload scanned notes to an online wallet
|
|
<li>Edit any HTML page in the online handbook: correct errors, update phone numbers
|
|
<li>Edit the HTML of any online expo logbook
|
|
</ul>
|
|
<p>See <a href="basiclaptop.html">configuring a Basic laptop</a>.
|
|
|
|
<h3>With a Survey Laptop</h3>
|
|
<p>A survey laptop has Tunnel and Therion, and you use it for cave survey production from raw data. Generally it is not what you use to fix things that have gone wrong - unless what is wrong is simply that something is missing because a job has not been done.
|
|
<p>See <a href="surveylaptop.html">configuring a Survey laptop</a>.
|
|
|
|
|
|
<h3>With a Bulk Update Laptop</h3>
|
|
<p>There are several standard data maintenance jobs that haven't yet got trogglized. So if:
|
|
<ul>
|
|
<li>We get a new Austrian kataster number for a cave, so we need to move and rename a lot of files
|
|
<li>A cave has got so big that we need to create sudirectories for the long and complicated cave descriptions in separate HTML files
|
|
<li>Some scanned notes have been uploaded into the wrong online wallet
|
|
</ul>
|
|
<p>See <a href="bulkupdatelaptop.html">configuring a Bulk Update laptop</a>.
|
|
|
|
we will need to use the things* installed on the <em>expo laptop</em> or on <a href="basiclaptop.html">your own laptop</a> if you are not in the potato hut on expo. <a href="fzconfig.html">Filezilla</a> will do most of what you need for moving files.
|
|
We also have <a href="uploading.html#android">andftp Android instructions</a> for file manipulation.
|
|
|
|
<p>While Filezilla (including the digital key) is enough for moving files in <a href="/expofiles">expofiles</a>, moving files in the version-controlled <a href="repos.html">repositories</a> means you need to find someone who knows git (see <a href="qstart-git.html">git cheatsheet</a>) to clean up everything after you have finished.
|
|
|
|
|
|
|
|
<p>* footnote: the 'things' include the <a href="keyexchange.html">digital key</a> that allows the laptop to be trusted by the server, as well as various installed software.
|
|
|
|
<h3>Data maintenance task list</h3>
|
|
<p>We have an online list of outstanding data maintenance tasks. See the <a href="contribute.html#surveydata">'Survey Data' to-do</a> list
|
|
|
|
|
|
<h3>Clever use of Survex file editor</h3>
|
|
<p>You will have seen this when following a link, e.g. from <a href="/survexfile/204">cave 204</a> to <a href="/survexfile/caves-1623/204/nearend/stitchthis.svx">stitchthis.svx</a>.
|
|
<p>But if you hand-edit the address bar in your browser to, say, <br /><a href="/survexfile/caves-1623/2020-W-01/mynewcave.svx">/survexfile/caves-1623/2020-W-01/mynewcave.svx</a> the page will load at that new address and pre-fill the editing window with default survex content. If you edit this in the webpage and then click the "Save this edited svx file' button (you will need to remove all the square brackets while you do that). This will create both the file 'mynewcave.svx' and the directory '2020-w-01' within the existing 'caves-1623' directory on the server in the <var>:loser:</var> repository directory.
|
|
<p>Note that you should have set the '*ref' field correctly to the number of the plastic wallet you are using.
|
|
|
|
<p>You will use this when creating a new survex file from your hand-written notes (but only after you have photographed them and put them in the plastic wallet in the potato hut of course).
|
|
|
|
<p>This is the method you will use when setting <a href="https://survex.com/docs/manual/genhowto.htm">'*equate' and '*export' survey points</a> between different cave surveys to link everything together later, and for adding missing *ref references, correcting the spelling of surveyors' surnames etc.
|
|
|
|
<p>You can also 'move' survex files by the method, with careful use of cut and paste, but you cannot delete them. Also you cannot save an empty file: it has to be a valid survex format and include the required fields *begin and *end.
|
|
|
|
<p>Always click the button: 'Run cavern on this svx file' after you have edited any survex file. This will check that there is no typo and so will not crash the bulk import of 1,200 survex files when troggle starts up.
|
|
|
|
<p>You can create new directories to any depth of nesting by this method - all at once.
|
|
|
|
<p>Editing or creating new survex files means that the <var>:loser:</var> using the form now (since April 2022) both saves the file and updates the version control repository. [Since March 2023, the form now also re-parses the survex data and updates the live database with people, survex blocks, *ref to wallet and surveyed-lengths.]
|
|
|
|
<h3>Clever use of the Cave editor</h3>
|
|
<em>[ New cleverness to be added in here]</em>
|
|
|
|
<p>Editing or creating cave description data files means that the <var>:expoweb:</var> repository will need to be updated [automation of this is a pending task].
|
|
|
|
<h3>Clever use of Entrance editor</h3>
|
|
<em>[ New cleverness to be added in here]</em>
|
|
|
|
<p>Editing or creating entrance description data files means that the <var>:expoweb:</var> repository will need to be updated [automation of this is a pending task].
|
|
|
|
<h3>Clever use of the Scan Upload form</h3>
|
|
<em>[ New cleverness to be added in here]</em>
|
|
|
|
<p>Editing or uploading scan files is in /expofiles/ and so not in a version-controlled repository [be extra careful].
|
|
|
|
<h3>Clever use of 'Edit this page'</h3>
|
|
<p>You can create new pages as well as edit existing pages. This is all documented in the <a href="hbmanual1.html">handbook editing manual</a>
|
|
<em>[ New cleverness to be added in here]</em>
|
|
|
|
<p>Editing or creating handbook or logbook HTML files automatically updates the <var>:expoweb:</var> repository .
|
|
|
|
|
|
|
|
<h3 id="password">The expo password</h3>
|
|
|
|
<p>The username is 'expo',
|
|
with a cavey:beery password. It is written on the notice-board inside the potato hut.
|
|
<b>This password is important</b> - keep it safe.
|
|
<p>The whole site <strong>will</strong> get hacked by spammers or worse if you are not careful with it. Use a secure method for passing it on to others that need to know (i.e not ordinary email), don't publish it anywhere, don't check it in to the data management system by accident. A lot of people use it and changing it is a pain for everyone so do take a bit of care.
|
|
</p>
|
|
|
|
<p>This password is all you need to log in to troggle. There is also an a systems account 'expoadmin' with a different password which enables the <a href="/controlpanel">import/export control panel</a> for re-importing <em>all</em> the input data files.
|
|
|
|
|
|
<hr />
|
|
Return to:
|
|
<a href="../computing/onlinesystems.html">expo online systems overview</a><br />
|
|
Troggle index:
|
|
<a href="../troggle/trogindex.html">Index of all troggle documents</a><br /><hr /></body>
|
|
</html>
|
|
|