expoweb/handbook/update.htm
2012-08-14 19:01:16 +02:00

42 lines
2.9 KiB
HTML

<html>
<head>
<title>CUCC Expedition Handbook: Updating the website</title>
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>Updating the website - HOWTO</h1>
<p>Simple <a href = "checkin.htm">instructions</a> for updating website</p>
<p>Please refer to <a href="http://www.srcf.ucam.org/caving/wiki/Expo_website_manual" target="_blank">the latest web updating guide in CUCC website</a></p>
<hr />
<p>DExpo data is kept in a number of different locations.</p>
<dl> <dt>Loser</dt> <dd>Contains the survex data. Mercurial repository ssh://expo@seagrass.goatchurch.org.uk/loser</dd> <dt>Expoweb</dt> <dd>Contains the current website. Mercurial repository ssh://expo@seagrass.goatchurch.org.uk/expoweb</dd> <dt>Tunnel data</dt> <dd>Contains the tunnel data. Mercurial repository ssh://expo@seagrass.goatchurch.org.uk/tunneldata</dd> <dt>Troggle</dt> <dd>Contains the unfinished Django based website. Mercurial repository https://goatchurch@troggle.googlecode.com/hg/ troggle</dd> <dt>Scanned notes</dt> <dd>Scans of survey notes and drawn up surveys. Can be got via rsync.</dd> </dl>
<p>Mercurial is a distributed revision control system. On expo this means that many people can edit and merge their changes with each other either when they can access the internet. Mercurial is over the top for scanned survey notes, which do not get modified, so they are kept as a plain directory of files.</p>
<p>If you run windows, you are recommended to install <a href="http://bitbucket.org/tortoisehg/stable/wiki/Home">Tortoise Hg</a>, which nicely interfaces with windows explorer.</p>
<h2>Get the repositories</h2>
<h3>Mercurial</h3>
<h4>Linux</h4>
<p>hg clone RepositoryURL</p>
<h4>Windows</h4>
<p>Install<a href="http://bitbucket.org/tortoisehg/stable/wiki/Home">Tortoise Hg</a>. In windows explorer right click, select Tortoise Hg .. and click Clone repository. <br />Set the source path to RepositoryURL <br />Set the destination to somewhere on your local harddisk. <br />Press clone.</p>
<h3>RSync</h3>
<h4>Linux</h4>
<p>rsync -av expoimages expo@seagrass.goatchurch.org.uk:</p>
<h4>Windows</h4>
<p>Not sure yet</p>
<h2>The website conventions bit</h2>
<p>This is likely to change with structural change to the site, with style changes which we expect to implement and with the method by which the info is actually stored and served up.</p>
<p>... and it's not written yet, either :-)</p>
<ul>
<li>Structure</li>
<li>Info for each cave &ndash; automatically generated by <tt>make-indxal4.pl</tt></li>
<li>Contents lists &amp; relative links for multi-article publications like journals. Complicated by expo articles being in a separate hierarchy.</li>
<li>Translations</li>
<li>Other people's work - the noinfo hierarchy.</li>
<li>Style guide for writing cave descriptions: correct use of boldface (<em>once</em> for each passage name, at the primary definition thereof; other uses of the name should be links to this, and certainly should not be bold.) </li>
</ul>
<hr />
</body>
</html>