mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2026-04-01 06:31:38 +01:00
Minimal laptop setup - the gateway drug
This commit is contained in:
73
handbook/computing/basiclaptop.html
Normal file
73
handbook/computing/basiclaptop.html
Normal file
@@ -0,0 +1,73 @@
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<title>CUCC Expedition Handbook: Programmers manual</title>
|
||||
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
||||
</head>
|
||||
<body>
|
||||
<h2 id="tophead">CUCC Expedition Handbook - Minimal laptop</h2>
|
||||
|
||||
<h1>Setting up a minimal machine to work with Expo data</h1>
|
||||
|
||||
<h2>Overview</h2>
|
||||
|
||||
<p>You need to do this:</p>
|
||||
<ol>
|
||||
<li><a href="#configuration">Register an SSH key</a> with an expo nerd (i.e 'get a login').</li>
|
||||
<li>Install <a href="#software">git version control software</a> to download ("clone"), view and edit caving data.</li>
|
||||
<li>Clone three <a href="../manual.html#repositories">expo repositories</a> so you have the files on your machine.</li>
|
||||
<li>Install survex, and therion or tunnel for editing cave data.
|
||||
</ol>
|
||||
|
||||
<p>Once you have got this working, and if it doesn't do what you want or you don't understand how to use it,
|
||||
look at the <a href="yourlaptop.html">full laptop configuration</a> for everything else.
|
||||
And please <b>write some documentation for the next person</b> in your situation.
|
||||
|
||||
<h3>Cheat lists and quick reminders</h3>
|
||||
<ul>
|
||||
<li>Quick <a href="qstart-git.html">reminders for using git</a> at the command line.
|
||||
<li>Quick <a href="../manual.html#quickstart">reminders for using rsync</a> at the command line.
|
||||
</ul>
|
||||
|
||||
<h2 id="software">Software</h2>
|
||||
<p>Download this software (short list):
|
||||
<ul>
|
||||
<li><a href="https://git-scm.com/">git</a> - version control system</li>
|
||||
<li><a href="https://survex.com/download.html">Survex</a>, including the Aven visualisation tool.
|
||||
<li><a href="https://github.com/CaveSurveying/tunnelx">Tunnel</a>: 2.5D cave drawing program based on Survex-compatible data which can also read PocketTopo files. (Generally called 'tunnel' even though the project and executable is actually 'tunnelx'.)
|
||||
<li><a href="https://therion.speleo.sk/">Therion</a> - Therion processes survey data and generates maps or 3D models of caves.
|
||||
</ul>
|
||||
|
||||
<h2 id="configuration">Configuration</h2>
|
||||
|
||||
<p>Follow this link to <a href="keyexchange.html">register a key with the expo server</a> to get upload (i.e. read/write) access.
|
||||
Do this first, Without it none of git, mercurial, scp, ftp or rsync will work.
|
||||
|
||||
<p>On a Windows machine you will need to configure pageant (the putty authentication agent)
|
||||
to <a href="https://blog.shvetsov.com/2010/03/making-pageant-automatically-load-keys.html">run at startup to load your key</a>.
|
||||
Note that you are loading your <em>private</em> key, the .ppk file, into pageant and that this key never leaves your laptop.</p>
|
||||
|
||||
<ul>
|
||||
|
||||
<li><a href="../tortoise/tortoise-win.htm">Installing PuTTy</a>.</li>
|
||||
<li><a href="winlaptop.html#hard">A Windows laptop for expo</a> - PuTTy and WSL here.</li>
|
||||
</ul>
|
||||
<p>When using Windows please, please be <a href="http://expo.survex.com/handbook/survey/getin.htm#filenames">excessively
|
||||
careful when naming files and survex names</a> and be <a href="../manual.html#quickstart">exceptionally careful when using rsync</a>.
|
||||
|
||||
<h3>Learning how to use this software</h3>
|
||||
|
||||
<ul>
|
||||
<li>Using Survex, Tunnel and Therion, see the <a href="http://expo.survex.com/handbook/survey/">Expo Handbook - Surveying section</a>.
|
||||
<li>For more detailed configuration, explanations and help see the <a href="yourlaptop.html#configuration">full laptop</a> instructions
|
||||
</ul>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<hr />
|
||||
|
||||
</body>
|
||||
</html>
|
||||
75
handbook/computing/qstart-git.html
Normal file
75
handbook/computing/qstart-git.html
Normal file
@@ -0,0 +1,75 @@
|
||||
<!DOCTYPE html>
|
||||
<html>
|
||||
<head>
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<title>Handbook placeholder page</title>
|
||||
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
||||
</head>
|
||||
<body>
|
||||
<h2 id="tophead">CUCC Expedition Handbook - Git Quick</h2>
|
||||
|
||||
<h1>Quick Reminder - Git</h1>
|
||||
<h2>Version Control Software Reminders</h2>
|
||||
<p>This is NOT a tutorial. This is a set of reminders for people who already know all this stuff.
|
||||
|
||||
<p>Since 2019 all use of version control software requires that you
|
||||
have <a href="keyexchange.html">key-pair setup</a> already set up before any of this will work on your own machine.
|
||||
|
||||
<p><font style="font-size: big; color:red"><b>NOT CHECKED _ TO BE EDITED BY A git NERD TO MAKE IT WORK. DO NOT DO THIS UNTIL THAT HAS BEEN DONE</b>
|
||||
- check that you can get ssh working before trying to run git too</font>
|
||||
|
||||
<p>If you can get to the <i>expo laptop</i> try these commands on that first as the key exchange has already been done.
|
||||
<dl>
|
||||
<dt>expoweb (The data management system)</dt>
|
||||
<dd>
|
||||
<tt>git clone ssh://expo@expo.survex.com/expoweb</tt> (read/write)<br />
|
||||
<tt>git clone http://expo.survex.com/repositories/home/expo/expoweb/</tt> (read-only checkout)
|
||||
</dd>
|
||||
|
||||
<dt>troggle (The data management system backend)</dt>
|
||||
<dd>
|
||||
<tt>git clone ssh://expo@expo.survex.com/troggle</tt> (read/write)<br />
|
||||
<tt>git clone http://expo.survex.com/repositories/home/expo/troggle/</tt> (read-only checkout)
|
||||
</dd>
|
||||
|
||||
<dt>loser (The survey data)</dt>
|
||||
<dd>
|
||||
<tt>git clone ssh://expo@expo.survex.com/loser</tt> (read/write)<br />
|
||||
<tt>git clone http://expo.survex.com/repositories/home/expo/loser/</tt> (read-only)
|
||||
</dd>
|
||||
|
||||
<dt>drawings</dt>
|
||||
<dd>
|
||||
<tt>git clone ssh://expo@expo.survex.com/drawings</tt> (read/write)<br />
|
||||
<tt>git clone http://expo.survex.com/repositories/home/expo/drawings/</tt> (read-only)
|
||||
</dd>
|
||||
</dl>
|
||||
<h3><a id="gitwindows">Using git in Windows</a></h3>
|
||||
|
||||
|
||||
<p>Once you've downloaded and installed a git client, the first step is to create what is called a checkout of the data management system. This creates a copy on your machine which you can edit to your heart's content. The command to initially check out ('clone') the entire expo data management system is:</p>
|
||||
|
||||
<p><tt>git clone ssh://expo@expo.survex.com/expoweb</tt></p>
|
||||
|
||||
<p>for subsequent updates</p>
|
||||
|
||||
<p><tt>git update</tt></p>
|
||||
|
||||
<p>will generally do the trick.</p>
|
||||
|
||||
<p><tt>ssh://expo@expo.survex.com/expoweb</tt></p>
|
||||
|
||||
<p>After you've made a change, commit it to you local copy with:</p>
|
||||
|
||||
<p><tt>git commit</tt> (you can specify filenames to be specific)</p>
|
||||
|
||||
<p>The first time you do this on a Windows machineit will probably not work as it does not recognise the server.
|
||||
Fix this by running putty (downloading it from <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/">https://www.chiark.greenend.org.uk/~sgtatham/putty/</a>), and connecting to the server 'expo@expo.survex.com' (on port 22). Confirm that this is the right server.
|
||||
If you succeed in getting a shell prompt then ssh connection are working and git should be able to clone the repo, and send changes back.</p>
|
||||
|
||||
|
||||
<hr />
|
||||
</ul>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
@@ -35,10 +35,10 @@ have <a href="keyexchange.html">key-pair setup</a> already set up before any of
|
||||
<tt>hg clone http://expo.survex.com/repositories/home/expo/loser/</tt> (read-only)
|
||||
</dd>
|
||||
|
||||
<dt>tunneldata (The Tunnel drawings)</dt>
|
||||
<dt>drawings</dt>
|
||||
<dd>
|
||||
<tt>hg clone ssh://expo@expo.survex.com/tunneldata</tt> (read/write)<br />
|
||||
<tt>hg clone http://expo.survex.com/repositories/home/expo/expoweb/</tt> (read-only)
|
||||
<tt>hg clone ssh://expo@expo.survex.com/drawings</tt> (read/write)<br />
|
||||
<tt>hg clone http://expo.survex.com/repositories/home/expo/drawings/</tt> (read-only)
|
||||
</dd>
|
||||
</dl>
|
||||
<h3><a id="Mercurialinwindows">Using Mercurial/TortoiseHg in Windows</a></h3>
|
||||
@@ -84,13 +84,6 @@ then restart nautilus <tt>nautilus -q</tt>. If it works, you'll be able to see t
|
||||
|
||||
|
||||
<hr />
|
||||
|
||||
<div id="menu">
|
||||
<ul id="links">
|
||||
<li><a href="index.htm">Expedition Handbook</a>
|
||||
</li>
|
||||
<li><a href="../../infodx.htm">Main index</a></li>
|
||||
|
||||
</ul>
|
||||
</div>
|
||||
</body>
|
||||
|
||||
@@ -176,12 +176,5 @@ a wiki on github discussing workflows to generate centerlines, GEOTIFF and QGIS
|
||||
|
||||
<hr />
|
||||
|
||||
<div id="menu">
|
||||
<ul id="links">
|
||||
<li><a href="../index.htm">Handbook</a>
|
||||
|
||||
<li><a href="../../infodx.htm">Main index</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
</body>
|
||||
</html>
|
||||
|
||||
Reference in New Issue
Block a user