mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2024-12-01 14:21:56 +00:00
101 lines
4.8 KiB
HTML
101 lines
4.8 KiB
HTML
<!DOCTYPE html>
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||
<title>Cambridge University Caving Club Expedition Handbook.</title>
|
||
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
|
||
</head>
|
||
<body>
|
||
<h2 id="tophead">CUCC Expedition Handbook</h2>
|
||
|
||
<body>
|
||
<h1>Windows: TortoiseHg and PuTTy</h1>
|
||
|
||
<p> THIS ARTICLE TO BE SPLIT - PuTTy STUFF VALID BUT Hg SHORTLY TO BE OBSOLETE</p?
|
||
<p>Struggling to get TortoiseHg to work on Windows (v10)? Here’s a quick guide which I hope explains how to sort it all
|
||
out.</p>
|
||
|
||
<p>First you need to set up <a href="../computing/keyexchange.html">keys</a> so that you can use ssh.
|
||
Until you can do that there is no point in doing anything else. This is <i>particularly difficult</i>
|
||
on Windows which requires <a href="https://rperki.blogspot.com/2015/06/install-puttypageant-on-win-10.html">extra software to be installed and configured</a>.
|
||
Allow an afternoon at least to get this bit to work as it is poorly documented.
|
||
To get the keys set up on the server you will have to wait for an already-authenticated nerd to do it for you so this is not a quick job.
|
||
|
||
<p>First download and install both <a href="http://tortoisehg.bitbucket.io/">TortoiseHg</a>
|
||
and <a href="http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html">PuTTy</a>. Then run PuTTy;</p>
|
||
|
||
<h2>PuTTy:</h2>
|
||
<p>Upon opening PuTTy, you’ll be greeted with a screen similar to this;</p>
|
||
|
||
<div style="text-align: center">
|
||
<img src="expoputtyscreen.png" alt="PuTTy Configuration Screen" />
|
||
<p class="caption">PuTTy Configuration Screen</p></div>
|
||
|
||
<p>Type <tt>expo@expo.survex.com</tt> into the box under Host Name, and type a
|
||
name into the box under 'Saved Sessions' then click 'Save' (in the
|
||
above case called 'Expo' – this means you don’t have to type in
|
||
expo@expo.survex.com each time you use PuTTy. You simply click on
|
||
'Expo' then 'Load'). Then click 'Open'.</p>
|
||
|
||
<p>Don’t worry if you can’t see anything happening onscreen as you type in the password,
|
||
this is what’s supposed to happen; so just type in the password and press the return/enter key.</p>
|
||
|
||
<p>Done! At some point you may come across a Windows popup which asks
|
||
you to verify the address you're attempting to log into (at which
|
||
point you select 'hells-to-the-yeah', or equivalent).
|
||
|
||
<p>You have now made sure that your computer will be happy to log on using TortoiseHg.
|
||
To log out of PuTTy, type 'logout', then press the return/enter key.</p>
|
||
|
||
<p><b>Note that when connecting in the potato hut in Austria</b>, you now use exactly the same procedure.
|
||
|
||
|
||
<h2>TortoiseHg:</h2>
|
||
|
||
<p>To open up TortoiseHg, simply open a folder somewhere on your desktop (you can make a new folder if you want, to keep things neat), and right click in the folder and select “Hg Workbench”</p>
|
||
<div style="text-align: center">
|
||
<img src="expoWorkbenchopen.png" alt="Accessing the Workbench" />
|
||
<p class="caption">Accessing the Hg Workbench</p></div>
|
||
|
||
<p>Once this opens up, go to File>Clone Repository, and you should get the following;</p>
|
||
|
||
<div style="text-align: center">
|
||
<img src="expoRepositoryScreen.png" width="75%" height="50%" alt="Hg Workbench" />
|
||
<p class="caption">Hg Workbench</p></div>
|
||
|
||
<p>At which point type <tt>ssh://expo@expo.survex.com/loser</tt> into
|
||
the 'Source' box (in this case I have specified a particular folder on
|
||
the server; 'loser', I suggest you do the same for now). You may also
|
||
choose where you want the repository to be created by clicking
|
||
'Browse' next to the 'Destination' box. As far as I recall, you don't
|
||
need to edit anything in the box where it says 'Hg command'. Click 'Clone'!</p>
|
||
|
||
|
||
<p>Voila! If you're now looking at the following screen or similar,</p>
|
||
|
||
<div style="text-align: center">
|
||
<img src="expoRepositoryScreen2.png" width="75%" height="50%" alt="Hg Workbench Linked" />
|
||
<p class="caption">Hg Workbench Linked</p></div>
|
||
|
||
<p>That will have cloned the /loser/ repository to your laptop.
|
||
<p>
|
||
If you want to update the handbook or other parts of the website you will also need to clone the /expoweb/ repository.
|
||
You can scan what's in the repositories (read only) using your web browser:
|
||
|
||
<ul>
|
||
<li><a href="/repositories/home/expo/loser/graph/">loser</a> - the survex cave survey data (hg)</li>
|
||
<li><a href="/cgit/drawings/.git/log">drawings</a> - the tunnel and therion cave data and drawings (git)</li>
|
||
<li><a href="/repositories/home/expo/expoweb/graph">expoweb</a> - the website pages, handbook, generation scripts (hg)</li>
|
||
<li><a href="/cgit/troggle/.git/log">troggle</a> - the database/software part of the survey data management system - see <a href="../computing/troggle-ish.html">notes on troggle</a> for further explanation (git)</li>
|
||
</ul>>
|
||
|
||
|
||
<p>If anything seems unclear, please email me at elmo2058@gmail.com, and I will reinstall things
|
||
on my own machine to see where things get confusing.
|
||
</p>
|
||
|
||
|
||
<hr />
|
||
</body>
|
||
</html>
|