mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2025-01-19 01:12:39 +00:00
57 lines
3.3 KiB
HTML
57 lines
3.3 KiB
HTML
<!DOCTYPE html>
|
|
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
|
<title>CUCC Expedition Handbook: Online repositories</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
|
|
}
|
|
/* Use grey for system/programming/nerd pages as a visual reminder */
|
|
</style>
|
|
<h2 id="tophead">CUCC Expedition: Online repositories</h2>
|
|
<h1>Version-controlled repositories</h1>
|
|
|
|
<h3><a id="repositories">The repositories</a></h3>
|
|
|
|
<p>All the expo data is contained in 4 <var>repositories</var> or <var>repos</var> at
|
|
expo.survex.com:
|
|
|
|
|
|
<ul>
|
|
<li><a href="/repositories/loser/.git/"><var>:loser:</var></a> - the survex cave survey data (not live yet)</li>
|
|
<li><a href="/repositories/drawings/.git/"><var>:drawings:</var></a> - the tunnel and therion cave data and drawings (git)</li>
|
|
<li><a href="/repositories/expoweb/.git/"><var>:expoweb:</var></a> - the website pages, handbook, generation scripts (git)</li>
|
|
<li><a href="/repositories/troggle/.git/"><var>:troggle:</var></a> - the database/software part of the survey data management system - see <a href="../troggle/trogintro.html">notes on troggle</a> for further explanation (git)</li>
|
|
</ul>
|
|
<p>You can read or clone these without any control, but to write ("push") to them you will need to use <varssh://</var> and set up the <a href="keyexchange.html">key exchange</a>.
|
|
|
|
<p>So cavers wanting to upload their cave survey data have to use a machine on which they key is already set up. The <i>expo laptop</i> lives in the potato hut during expo and it is sometimes joined by the laptop '<i>aziraphale</i>'. These are both loaned machines running Linux. If you want to use your own laptop then
|
|
see the <a href="basiclaptop.html">minimal laptop setup</a>.
|
|
|
|
|
|
<h3 id="git">Version control system</a></h3>
|
|
<p>We use a distributed revision control system (<a href="https://git-scm.com/about/distributed">git</a>) for all the important data.
|
|
<p>Note that we just use git: not GitHub, not GitLab, just <a href="https://git-scm.com/about/distributed">git</a>.
|
|
<p>
|
|
This allows many people to edit and merge their changes at the same time. This includes people still on expo and those who have returned to the UK. Also anyone who is up
|
|
to date can take their laptop somewhere (e.g. topcamp) and enter data even if they have no Internet access,
|
|
and the updates will be merged when they get back to civilization.
|
|
</p>
|
|
<p>
|
|
We use a version control system because this keeps track of all changes so we can roll back mistakes. We also have multiple copies of the data on multiple machines for safety.
|
|
<p>
|
|
We use git because it is now the industry standard. In the past we have used <a href="https://en.wikipedia.org/wiki/Concurrent_Versions_System">cvs</a>, <a href="https://en.wikipedia.org/wiki/Apache_Subversion">subversion</a> and <a href="https://en.wikipedia.org/wiki/Mercurial">mercurial</a>.
|
|
|
|
<p>A version control system is inefficient for photos, GPS tracks and scanned survey notes which are large files that do not get modified. These are kept as a plain directory of files <a href="/expofiles"><var>/expofiles/</var></a>.
|
|
</p>
|
|
<hr />
|
|
Return to <a href="manual.html">Expo Data Maintenance manual</a><br>
|
|
Return to <a href="onlinesystems.html">Expo Systems Overview</a>
|
|
</body>
|
|
</html>
|
|
|