expo/expoweb
1
0
Fork 0
mirror of https://expo.survex.com/repositories/expoweb/.git/ synced 2024-11-22 07:11:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

Added Bank of Expo, Creating a SUrvex file, rearranged website manual a bit.

Browse Source
This commit is contained in:
Philip Sargent 2018-06-30 04:03:12 +01:00
parent 0d3399dfd3
commit 9f594cc3a9
10 changed files with 129 additions and 121 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

42
handbook/bankofexpo.html Normal file
View File

@ -0,0 +1,42 @@
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<title>CUCC Expedition Handbook: Bank of Expo</title>
<link rel="stylesheet" type="text/css" href="../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>The Bank of Expo</h1>
<p>This is not really a bank.
<p>This is an online system which does accounting. It keeps records of how expenses are allocated and who has paid what. You will be issued with an online username and password to access it when you pay your Expo deposit. Your transactions are not private: all transactions on all accounts are visible to any logged-on user.
<p><em>Please be respectful of this website as you'll find you can edit transactions that others have listed. This is to allow people to collaboratively add their combined expenses with all the complications that cavers bring to anything. However, it could be abused. Please don't. The admins can see records of who changed what and when. </em>
<p>BoC was originally designed for expedition use, where expenses are distributed by number of nights/car-passengers/beers. Being online helps accounting transparency, allows real-time review of creditors/debtors, and, if input permissions are devolved, reduces the burden on the treasurer. Due to its expedition origins it correctly handles exchange rates changing over time.
<p>The 2018 Bank of Expo is hosted at <a href="http://expo.survex.com/boe">expo.survex.com/boe</a>.
<p>Bank of Expo (and the same software running as Bank of CUCC for ordinary caving trips) was written by Stuart Bennett in Cambridge. He says:
<p>
<em>"BoC is a multi-user auditable online share-based accounting system. The `share-based' part is probably its distinguishing feature: absolute amounts are split evenly across the slates of implicated users and/or ring-fenced cost-pools. Transactions are automatically double-entry, and as real-world transactions are made against a real bank account, the
(manual) insertion of the transactions to BoC will correspondingly reduce the relevant slates. A useful feature is that the amounts shared can be in a variety of `currencies', whose exchange-rates are permitted to vary over time: this might be EUR per GBP, but also EUR per beer, or GBP per expo t-shirt, etc.
<p>
The split mechanism transparently underlies everything, but for user-friendliness there are various handy web-forms provided which generate the split tables (`Transaction Groups'). These range from a simple person-to-person swap, to a customizable `Event' with costs for various items being automatically squirrelled away into pre-set cost-pools."</em>
<p>Now read the online documentation at <a href="https://github.com/malc0/BoC">https://github.com/malc0/BoC</a> which has a link to a demonstration system that you can play with (CUCC meets 2014-15).
<p>
Here is the <a href="bocdoc.pdf">the original documentation</a> (PDF). It's a bit out of date: the instructions online largely replace Chapter 2.
<hr />
<ul id="links">
<li><a href="index.htm">Expedition Handbook</a>
<ul>
<li><a href="survey/index.htm">Surveying guide</a> - Overview</li>
<li><a href="look4.htm">Prospecting guide</a> &ndash; Overview</li>
<li><a href="rescue.htm">Rescue guide</a></li>
<li><a href="rigit.htm">Rigging guide</a></li>
<li><a href="photo.htm">Photography guide</a></li>
</ul></li>
<li><a href="../infodx.htm">Index to info/topics pages</a></li>
</ul>
</body>
</html>

BIN
handbook/bocdoc.pdf Normal file
View File

Binary file not shown.

35
handbook/expodata.html
View File

@ -1,35 +0,0 @@
<html>
<head>
<title>CUCC Expo Handbook: Developer info</title>
<link rel="stylesheet" type="text/css" href="../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>Expo Website - Developer/Maintainer info</h1>
<p>The website is now large and complicated with a lot (too many!) of
moving parts. This handbook section contains info for people doing
annual updates, server syncing, and troggle development work.</p>
<ul>
<li><a href="update.htm#update">Updating the website</a></li>
<li><a href="update.htm#checkout">Expo Website manual</a></li>
</ul>
<h2><a id="update">Updating the website - HOWTO</a></h2>
<h3>Adding a new year</h3>
<p>Edit noinfo/folk.csv, adding the new year to the end of the header
line, a new column, with just a comma (blank
cell) for people who weren't there, a 1 for people who were there, and
a -1 for people who were there but didn't go caving. Add new lines for
new people, with the right number of columns.</p>
<p>This proces is tedious and error-prone and ripe for improvement.
Adding a list of people, fro the bier book, and their aliases would be
a lot better, but some way to make sure that names match with previous
years would be
good.</p>
</body>
</html>

26
handbook/expozilla.xml
View File

@ -1,26 +0,0 @@
<?xml version="1.0" encoding="UTF-8"?>
<FileZilla3 version="3.34.0" platform="windows">
<Servers>
<Server>
<Host>expo.survex.com</Host>
<Port>22</Port>
<Protocol>1</Protocol>
<Type>0</Type>
<User>expo</User>
<Pass encoding="base64"></Pass>
<Logontype>1</Logontype>
<TimezoneOffset>0</TimezoneOffset>
<PasvMode>MODE_DEFAULT</PasvMode>
<MaximumMultipleConnections>0</MaximumMultipleConnections>
<EncodingType>Auto</EncodingType>
<BypassProxy>0</BypassProxy>
<Name>expo-uploads</Name>
<Comments />
<Colour>0</Colour>
<LocalDir />
<RemoteDir>1 0 4 home 4 expo 9 expofiles 7 uploads</RemoteDir>
<SyncBrowsing>0</SyncBrowsing>
<DirectoryComparison>0</DirectoryComparison>
</Server>
</Servers>
</FileZilla3>

6
handbook/index.htm
View File

@ -14,8 +14,7 @@
<li><a href="../primer.htm">Primer</a> - for new expedition members</li>
<li><a href="kitlist.html">Kit list</a> - Things to bring on expo.</li>
<li><a href="../travel.htm">How to get to Expo</a></li>
<li><a href="uploading.html">How to upload your photos</a></li>
<li><a href="bankofexpo.html">How to use the Bank of Expo</a></li>
</ul>
<dl>
@ -23,8 +22,11 @@
<dd>You fall and break your leg &ndash; probably need a little help to get out of the cave ? How would you feel if everyone at this stage took the rescue guide into Hilde's bar and started reading about what to do ? Not a happy prospect, is it &ndash; so in the hope that it is <strong>not</strong> you who gets hurt, we suggest you read this <strong>now</strong> so you know what to do. It may well help you if it <strong>is</strong> you who gets injured, and may even help prevent that from happening. So don't skip it !</dd>
<dt><a href="1staid.html">First Aid</a></dt>
<dd>Info on expo first aid kits and caving first aid course.</dd>
<dt><a href="meteo.htm">Weather</a></dt>
<dd>Unpredictable in the mountains. Local thunderstoms with rapid run-off are the biggest danger.</dd>
</dl>
<h2>Where and How</h2>
<dl>
<dt><a href="stool.htm">On a matter of stooling</a></dt>

6
handbook/kitlist.html
View File

@ -1,4 +1,3 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
@ -162,7 +161,8 @@ these in rapid succession and combination! It can be really chilly
<li>Water bottle/bladder.</li>
<li>Toiletries - toothbrush, toothpaste, soap etc.</li>
<li>Flannel &amp; towel.</li>
<li>Glasses/contact lenses &amp; spares if you need them.</li>
<li>Glasses &amp; spares if you need them.</li>
<li>Contact lenses - get enough daily use-once ones. The upper caves are very dusty.</li>
<li>Bivvy bag - emergency shelter anywhere. The plateau can become
unfriendly very quickly. Erin and Earl had to resort to bivvy bags when
caught by a storm on the Hinter in 1999. You could use the one from
@ -185,6 +185,7 @@ these in rapid succession and combination! It can be really chilly
<li>Extras
<ul>
<li>Camera/phone.</li>
<li>GPS - or good GPS app on your phone. For surface surveying and finding entrances.</li>
<li>Walking pole(s) for walking across the plateau. Useful for
balance when stepping across big holes. Most people seem to just use
one as two get in the way on the scrambly bits. </li>
@ -193,7 +194,6 @@ one as two get in the way on the scrambly bits. </li>
</ul></li>
<li>Excessive
<ul>
<li>GPS.</li>
<li>Tablet/netbook/laptop - can be used for data entry/prospecting guide info.</li>
<li>Spare stuff - suppose you break (eek!) your jammer? There is a climbing
shop in the next town.</li>

1
handbook/survey/index.htm
View File

@ -56,6 +56,7 @@ detailed topics.</p>
<!-- do we cover the full QM list here ? -->
</ul></li>
<li><a href="http://expo.survex.com/expofiles/presentations/cave_surveying_20130626.pdf">2013 Training Course</a> a slide-pack of a surveying course using Steinbruckhohle as the example</li>
<li><a href="how_to_make_a_survex_file.pdf">How to create a survex file</a></li>
<li><a href="more.htm">More resources</a> on surveying</li>
</ul>

4
handbook/treasurer.html
View File

@ -19,6 +19,7 @@
<UL>
<LI>Income and Expenditure </LI>
<LI>The Bank of Expo </LI>
<LI>The Expo Bills </LI>
</UL>
@ -82,7 +83,8 @@
<P>CUCC and Expo have separate bank accounts, often administered by separate people; both are run to break even over the year. Expo works in partnership with CUCC to prevent unnecessary duplication of resources; CUCC equipment is used on Expo and <I>vice-versa</I>. Apart from these mutual efficiency gains, Expo and CUCC do not subsidise each other.</P>
<H3>The Bank of Expo</H3>
<p>This is an online system which does accounting. It is not a bank: it just keeps records of how expenses are allocated and who has paid what. See the <a href="bankofexpo.html">Bank of Expo</a> webpage for a longer description and all the documentation.
<H3>The Expo Bills</H3>
<P>The bill each person receives depends on:</P>

114
handbook/update.htm
View File

@ -8,36 +8,33 @@
<h1>Expo Website Manual</h1>
<p>The website is now large and complicated with a lot of aspects. This handbook section contains info at various levels: simple 'How to add stuff' information for the typical expoer, more detailed info for cloning it onto your own machine for more significant edits, and structural info on how it's all put together for people who want/need to change things. [This manual is now so big that it is being restructured and split up. Much of it is obsolete.]</p>
<p>We have <a href="http://wookware.org/talks/expocomputer/#/"an Overview Presentation</a> on how the cave data, handbook and website are constructed and managed. It contains material which will be merged into this website manual.
<p>We have <a href="http://wookware.org/talks/expocomputer/#/">an Overview Presentation</a> on how the cave data, handbook and website are constructed and managed. It contains material which will be merged into this website manual.
<ul>
<li><a href="#photos">Uploading your photos and GPS tracks</a></li>
<li><a href="#logbooks">Uploading typed logbooks</a></li>
<li><a href="#update">Updating the website</a></li>
<li><a href="#manual">Expo Website manual</a></li>
<li><a href="expodata.html">Expo website developer info</a></li>
</ul>
<h2><a id="update">Updating the website - overview</a></h2>
<p>Short <a href="checkin.htm">command-line instructions</a> for updating the website
(on the expo machine). Thius is a memory job for experts, not beginners.</p>
(on the expo machine). This is a memory jog for experts, not beginners.</p>
<p>You can update the site via the troggle pages, by editing pages
online via a browser ("Edit this page" on the menu on the left), by
editing them locally on disk, or by checking out the relevant part to
editing them on the server remotely, or by checking out the relevant part to
your computer and editing it there. Which is best depends on your
knowledge and what you want to do. For simple addition of cave or
survey data troggle is recommended. For other edits it's best if you
can edit the files directly rather than using the 'edit this page'
button, but that means you either need to be on expo with the expo
computer, or be able to check out a local copy. If neither of these
survey data troggle ("edit this page") is recommended. For other edits it's best if you
can edit the files directly but that means you either need to be on expo with the expo
computer, or be able to check out a local copy using the version control system. If neither of these
apply then using the 'edit this page' button is fine.</p>
<p>It's important to understand that everything on the site (except things under
'expofiles') is stored in a distributed version control system (DVCS)
(called '<a href=#mercurial>Mercurial</a>' and accessed by most people
using software called 'TortoiseHg'), which means that every edited
which means that every edited
file needs to be 'checked in' after editing. The Expo website manual
goes into more detail about this, below. This stops us losing data and
makes it very hard for you to screw anything up permanently, so don't
@ -46,13 +43,20 @@ problem. It also means that several people can work on the site on
different computers at once and normally merge their changes
easily.</p>
<p>Increasing amounts of the site are autogenerated, not static files,
<p>Increasing amounts of the site are autogenerated by troggle, and are not static files,
so you have to edit the base data, not the generated file (e.g cave
pages, QM lists, expo members list, prospecting pages). All
pages, QM (queston mark) lists, expo members list, prospecting pages). All
autogenerated files say 'This file is autogenerated - do not edit' at
the top - so check for that before wasting time on changes that will
just be overwritten</p>
<h3 id="mercurial">DVCS - version control</a></h3>
<p>We use a distributed revision control system (DVCS) for all the important data. On expo this means that many people can edit and merge their changes with the expo server in the Tatty Hut even if there is no internet access. Also anyone who is up to date with the Tatty Hut can take their laptop somewhere where there is internet access and update expo.survex.com - which will then get all the updates done by everyone on expo.
</p>
<p>In principle, survey notes can be typed into a laptop up on the plateau which is then synchronised with the Tatty Hut on returning to base.
</p>
<p>A DVCS is inefficient for scanned survey notes, which are large files that do not get modified, so they are kept as a plain directory of files 'expofiles'. The same goes for holiday photographs and GPS logs.</p>
<h2><a id="manual">Expo website manual</a></h2>
<p>Editing the expo website is an adventure. Until 2007, there was no
@ -73,7 +77,7 @@ processes that a maintainer would want to do.</p>
<li><a href="#howitworks">How the website works</a></li>
<li><a href="#quickstart">Quick start</a></li>
<li><a href="#editingthewebsite">Editing the website</a></li>
<li><a href="#Mercurialinwindows">Using Mercurial/TortoiseHg in Windows</a></li>
<li><a href="#Mercurialinwindows">Using version control software in Windows</a></li>
<li><a href="#expowebupdate">The expoweb-update script</a></li>
<li><a href="#cavepages">Updating cave pages</a></li>
<li><a href="#updatingyears">Updating expo year pages</a></li>
@ -85,7 +89,7 @@ processes that a maintainer would want to do.</p>
</ol>
Appendices:
<ul>
<li><a href="website-history">History of the website</a></li>
<li><a href="website-history.html">History of the website</a></li>
</ul>
<h3><a id="usernamepassword">Getting a username and password</a></h3>
@ -99,16 +103,16 @@ Appendices:
<h3><a id="repositories">The repositories</a></h3>
<p>All the expo data is contained in 4 Mercurial repositories at
expo.survex.com. This is currently hosted on a server at the university. Mercurial* is a distributed version control system which allows collaborative editing and keeps track of all changes so we can roll back and have branches if needed.</p>
<p>All the expo data is contained in 4 "repositories" at
expo.survex.com. This is currently hosted on a server at the university. We use a distributed version control system (DVCS) to manage these repositories because this allows simultaneous collaborative editing and keeps track of all changes so we can roll back and have branches if needed.</p>
<p>The site has been split into four parts:</p>
<ul>
<li>expoweb - the website itself, including generation scripts</li>
<li>troggle - the database-driven part of the website</li>
<li>loser - the survex survey data</li>
<li>tunneldata - the tunnel (and therion) data and drawings</li>
<li><a href="http://expo.survex.com/repositories/home/expo/expoweb/graph">expoweb</a> - the website itself, including generation scripts</li>
<li><a href="http://expo.survex.com/repositories/home/expo/troggle/graph/">troggle</a> - the database-driven part of the website</li>
<li><a href="http://expo.survex.com/repositories/home/expo/loser/graph/">loser</a> - the survex survey data</li>
<li><a href="http://expo.survex.com/repositories/home/expo/tunneldata/graph/">tunneldata</a> - the tunnel (and therion) data and drawings</li>
</ul>
@ -157,23 +161,29 @@ below for details on that.</p>
<dt>expofiles (all the big files and documents)</dt>
<p>Photos, scans (logbooks, drawn-up cave segments) (This was about
60GB of stuff in 2017 which you probably don't actually need locally).<p> To sync
60GB of stuff in 2017 which you probably don't actually need locally).
<p>If you don't need an entire copy of all 60GB, then it is probably best to use Filezilla to copy just a small part of the filesystem to your own machine and to upload the bits you add to or edit.
Instructions for installing and using Filezilla are found in the expo user instructions for uploading photographs: <a href="uploading.html">uploading.html</a>.
<p> To sync all
the files from the server to local expofiles directory:</p>
<p><tt>rsync -av expo@expo.survex.com:expofiles /home/expo</tt></p>
<p>To sync the local expofiles directory back to the server:</p>
<p>To sync the local expofiles directory back to the server (but only if your machine runs Linux):</p>
<p><tt>rsync --dry-run --delete-after -a /home/expo/expofiles expo@expo.survex.com</tt></p>
then CHECK that the list of files it produces matches the ones you absolutely intend to delete forever! ONLY THEN do:
<p><tt>rsync -av /home/expo/expofiles expo@expo.survex.com:</tt></p>
<p>(do be <b>incredibly</b> careful not to delete piles of stuff then rsync back, or to get the directory level of the command wrong - as it'll all get deleted on the server too, and we may not have backups!). It's <b>absolutely vital</b>Use rsync --dry-run --delete-after -a first to check what would be deleted. If you are using rsync from a Windows machine you will <em>not</em> get all the files as some filenames are incompatible with Windows: see more detail under <a href="Mercurialinwindows">Using Mercurial/TortoiseHg in Windows</a> below.</p>
<p>(do be <b>incredibly</b> careful not to delete piles of stuff then rsync back, or to get the directory level of the command wrong - as it'll all get deleted on the server too, and we may not have backups!). It's <b>absolutely vital</b>Use rsync --dry-run --delete-after -a first to check what would be deleted.
<p>(We have an issue with rsync not using the appropriate user:group attributes for files pushed back to the server. This may not cause any problems, but watch out for it.)</p>
<p>If you are using rsync from a Windows machine you will <em>not</em> get all the files as some filenames are incompatible with Windows. What will happen is that rsync will invisibly change the names as it downloads them from the Linux expo server to your Windows machine, but then it forgets what it has done and tries to re-upload all the renamed files to the server even if you have touched none of them. Now there won't be any problems with simple filenames using all lowercase letters and no funny characters, but we have nothing in place to stop anyone creating such a filename somewhere in that 60GB or of detecting the problem at the time. So don't do it. If you have a Windows machine use Filezilla not rsync.
<p>(We may also have an issue with rsync not using the appropriate user:group attributes for files pushed back to the server. This may not cause any problems, but watch out for it.)</p>
</dl>
<h3><a id="editingthewebsite">Editing the website</a></h3>
<p>To edit the website fully, you need a Mercurial client such as TortoiseHg. Some (static text) pages can be edited directly on-line using the 'edit this page link' which you'll see if you are logged into troggle. In general dynamically-generated pages can not be edited in this way, but forms are provided for some page-types like 'caves'.</p>
<p>To edit the website fully, you need to use the disributed version control system (DVCM) software which is currently mercurial/TortoiseHg. Some (static text) pages can be edited directly on-line using the 'edit this page link' which you'll see if you are logged into troggle. In general the dynamically-generated pages, such as those describing caves which are generated from the cave survey data, can not be edited in this way, but forms are provided for some types of these like 'caves'.</p>
<p>What follows is for Linux. If you are running Windows then see below <a href="#Mercurialinwindows">Using Mercurial/TortoiseHg in Windows</a>.
@ -261,6 +271,7 @@ editing these files.</p>
<p>(If you remember something about CAVETAB2.CSV for editing caves, that was
superseded in 2012).</p>
<p>This may be a useful reminder of what is in a survex file <a href="survey/how_to_make_a_survex_file.pdf">how to create a survex file</a>.
<h3><a id="updatingyears">Updating expo year pages</a></h3>
@ -302,26 +313,18 @@ superseded in 2012).</p>
T/U: Jess 1 hr, Emma 0.5 hr
</pre>
<hr>
<h3>Adding a new year</h3>
<p>Edit noinfo/folk.csv, adding the new year to the end of the header
line, a new column, with just a comma (blank
cell) for people who weren't there, a 1 for people who were there, and
a -1 for people who were there but didn't go caving. Add new lines for
new people, with the right number of columns.</p>
<h3><a id="photos">Uploading photos and GPS tracks</a></h3>
<p>Photos are stored in the general file area of the site under <br /><a
href="http://expo.survex.com/expofiles/photos/">http://expo.survex.com/expofiles/photos/</a></p>
<p>GPS tracks over the surface of the plateau (GPX files from your handheld GPS or phone) are stored in the general file area of the site under <br /><a
href="http://expo.survex.com/expofiles/gpslogs/">http://expo.survex.com/expofiles/gpslogs/</a></p>
<p>
They are each organised by year, and by photographer (walker). </p>
<p>They are much more conveniently viewed at <br /> <a
href="http://expo.survex.com/photos/">http://expo.survex.com/photos/</a><br />
or<br />
<a href="http://expo.survex.com/gpslogs/">http://expo.survex.com/gpslogs/</a><br />
because the website scripts create a much friendlier interface
</p>
The directory names are like this: "2014/YourName/" (i.e no spaces, CamelCase for names).
<p>See <a href="uploading.html">Photo/GPS/File Upload Instructions</a> for instructions on intalling and using software to do this uploading - for all types of operating system.</p>
<p>This proces is tedious and error-prone and ripe for improvement.
Adding a list of people, fro the bier book, and their aliases would be
a lot better, but some way to make sure that names match with previous
years would be
good.</p>
<h3><a id="tickingoff">Ticking off QMs</a></h3>
@ -371,13 +374,24 @@ http://expo.survex.com/expo/surveys/surveytable.html http://expo.survex.com/surv
<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 />
<h2><a id="mercurial">Mercurial and TortoiseHG</a></h2>
<p>Mercurial is a distributed revision control system. On expo this means that many people can edit and merge their changes with the Mercurial server in the Tatty Hut even if there is no Internet access. Also anyone who is up to date with the Tatty Hut can take their laptop somewhere where there is Internet access and update expo.survex.com - which will then get all the updates done by everyone on expo.
<h3><a id="photos">Uploading photos and GPS tracks</a></h3>
<p>Photos are stored in the general file area of the site under <br /><a
href="http://expo.survex.com/expofiles/photos/">http://expo.survex.com/expofiles/photos/</a></p>
<p>GPS tracks over the surface of the plateau (GPX files from your handheld GPS or phone) are stored in the general file area of the site under <br /><a
href="http://expo.survex.com/expofiles/gpslogs/">http://expo.survex.com/expofiles/gpslogs/</a></p>
<p>
They are each organised by year, and by photographer (walker). </p>
<p>They are much more conveniently viewed at <br /> <a
href="http://expo.survex.com/photos/">http://expo.survex.com/photos/</a><br />
because the website script creates a much friendlier interface
</p>
<p>In principle, survey notes can be typed into a laptop up on the plateau which is then synchronised with the Tatty Hut on returning to base.
</p>
<p>Mercurial is inefficient for scanned survey notes, which are large files that do not get modified, so they are kept as a plain directory of files 'expofiles'.</p>
The directory names are like this: "2014/YourName/" (i.e no spaces, CamelCase for names).
<p>See <a href="uploading.html">Photo/GPS/File Upload Instructions</a> for ordeinary expo user instructions on how to do this .</p>
<hr />
</body>
</html>

16
handbook/uploading.html
View File

@ -8,7 +8,15 @@
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>Uploading photos and GPS tracks</h1>
<h2>The end-result you are trying to achieve</h2>
What you are trying to do is to get your happy holiday snaps appear properly indexed with all the others from the previous decades of expo history. You can see them all here: <br /> <a
href="http://expo.survex.com/photos/">http://expo.survex.com/photos/</a><br />
which is the end result. But all you have to do is to upload the photos to the right place. A hidden script does the hard work to make it all look nice.
<p>If you are really lazy (or really a beginner) you can use the initial simple method for the photos you have taken of cave entrances [for cave survey and prospecting purposes] so long as you label the filenames of the photos very carefully and tell an admin/nerd what you have done.
<h2>Simple instructions</h2>
<ol>
<li>Use the Expo laptop in the tatty hut. Get someone to show you how to do it.
</ol>
@ -34,15 +42,15 @@
</ul>
<h2 id="init">Using Filezilla initially</h2>
<p>The expo website has a big section under 'home/expo/expofiles/' that is <b>not under version control</b>. This is dangerous as there is no backup. If you overwrite some important files with your holiday snaps then we are in big trouble. This is where we store big files that we don't want to keep multiple versions of.
<p>The expo website has a big section under 'home/expo/expofiles/' that is <b>not under version control</b>. This is dangerous as there is no backup. If you overwrite some important files with your holiday snaps then we are in big trouble. This is where we store big files that we don't want to keep multiple versions of which is why it is not under verson control.
<p>So beginners should always put all their files into the folder
<pre>/home/expo/expofiles/uploads/</pre> and ask an admin to move them to the right place. The configuration which you just did (if you followed <a href="fzconfig.html">the instructions</a>) will set you up pointing at the correct folder automatically.
<pre>/home/expo/expofiles/uploads/</pre> and then ask an admin to move them to the right place. The configuration which you just did (if you followed <a href="fzconfig.html">the instructions</a>) will set you up pointing at the correct folder automatically.
<p>
To make the admin's life easier, create your own folder in <pre>/home/expo/expofiles/uploads/</pre> with your name like this: <pre>/home/expo/expofiles/uploads/YourName/</pre> and put your files into that folder. ("YourName" should have no spaces, hyphens or underline characters.) So that the admin knpows who is responsible. And for goodness sake please don't upload lots of duplicate photos: cull them first to just the good ones.
<h2>Experienced users</h2>
<p>OK the person you have been asking to move the files to the right place is getting fed up and now wants you to put the uploaded photos in the right place yourself. This is where they go:
<p>OK the admin/nerd you have been asking to move the files to the right place is getting fed up and now wants you to put the uploaded photos in the right place yourself. This is where they go:
<pre>
directory: /home/expo/expofiles/<b>photos</b>/2018/YourName/
@ -82,7 +90,7 @@ available for windows too:
<p>Both scp and cadaver give you an 'explorer-like' interface (although winscp can
give you a norton-commander-style 2-pane UI as well).</p>
<h3>Using rsync</h3>
<p>No, don't use rsync for this. Really don't. It's too liable to delete everything.
<p>No, don't use rsync for this. Really don't. It's too liable to delete everything or to overwrite files which are not changed at all because of the incompatibilities between Linux and Windows filename conventions (uppercase and lowercase are automagically converted and rsync gets it wrong).
<hr />
</body>
</html>