diff --git a/handbook/computing/browsers-icons.jpg b/handbook/computing/browsers-icons.jpg new file mode 100644 index 000000000..c8ba2026a Binary files /dev/null and b/handbook/computing/browsers-icons.jpg differ diff --git a/handbook/computing/folkupdate.html b/handbook/computing/folkupdate.html index dbbc5a006..4ea67ffd9 100644 --- a/handbook/computing/folkupdate.html +++ b/handbook/computing/folkupdate.html @@ -23,7 +23,7 @@ This is adding an extra column to every line in the file.

Add new lines for new people, with the right number of columns. -

This process is tedious and error-prone and ripe for improvement especially as expo proceeds and youhave many more names to add. Adding a list of people from the bier book and their aliases (the name in brackets) would be a lot better, but some way to make sure that names match with previous years would be good. +

This process is tedious and error-prone and ripe for improvement especially as expo proceeds and you have many more names to add. Adding a list of people from the bier book and their aliases (the name in brackets) would be a lot better, but some way to make sure that names match with previous years would be good.

Contrary to what you might expect we find that it is much more reliable to edit this using a text editor rather than a spreadsheet program. @@ -33,23 +33,19 @@ Contrary to what you might expect we find that it is much more reliable to edit

The nerd needs to do this:

  1. Upload the edited copy of folk.csv to the server using the version control system. -
  2. Log in to the expo server and run the update script (see below for details) +
  3. Log in to the expo server and run the update script (see below)
  4. Watch any error messages scroll by.
  5. Look at the new folk list HTML file at http://expo.survex.com/folk/
  6. Re-run the import script until you have got rid of all the import errors.

This is how you login and run the script:

ssh  expo@expo.survex.com
-cd folk
+cd expoweb/folk
+chmod +w index.htm
 python ../scripts/make-folklist.py <folk.csv >index.htm
 
-

If there are no errors, you will just see this on your ssh session: - -

- -

And you will see the result online at http://expo.survex.com/folk/. +

If there are no errors, you will just see the prompt reappear in your ssh session +and you will see the result online at http://expo.survex.com/folk/.

It is recommended that the nerd does this locally on their own laptop first. It does not need to be an expo laptop, even a Windows 10 laptop is fine if the script is run in a WSL terminal. The only software you need to install is the default python package.


diff --git a/handbook/computing/hbmanual1.html b/handbook/computing/hbmanual1.html index 1907b396c..46e0def6f 100644 --- a/handbook/computing/hbmanual1.html +++ b/handbook/computing/hbmanual1.html @@ -47,15 +47,27 @@ so you cannot use "Edit this page". These pages will not show "Edit this page" i

Then once created, you can edit it the same way that you edit a pre-existing page.

Linking in New Pages

-

You link your new page into the handbook by editing another page in which you want to create a link. For example if you have created a new page describing your wonderful new sleeping bag/hammock technique, then you might want to add a link in to Expo Personal Gear List. Unfortunately the "create link" icon (a picture of 3 links of a chain) is disabled in the on-line editor so you would have to click on the HTML icon and insert the link by editing the HTML directly. +

You link your new page into the handbook by editing another page in which you want to create a link. For example if you have created a new page describing your wonderful new sleeping bag/hammock technique, then you might want to add a link in to Expo Personal Gear List. Unfortunately the "create link" icon (a picture of 3 links of a chain) is disabled in the on-line editor so you would have to click on the HTML icon and insert the link by editing the HTML directly using an <a href="filename"> tag.

Conventions

Encoding

+

Automated formatting

+

Filenames

+

Images

+ +

Tidying up and commiting the edits

'Edit This Page' edits the file served on the web but it does not update the file in the version control diff --git a/handbook/computing/manual.html b/handbook/computing/manual.html index 6bd5f84ef..862c90551 100644 --- a/handbook/computing/manual.html +++ b/handbook/computing/manual.html @@ -53,10 +53,10 @@ processes that a maintainer would want to do.

Version control system

We use a distributed revision control system (git, and formerly mercurial) for all the important data. (Note that we just use git: not GitHub, not GitLab, just git.) This means that many people can edit and merge their changes with the expo -server in Cambridge at the same time: including people still on expo in the Tatty Hut +server in Cambridge at the same time: inlcuding people still on expo in the Tatty Hut and those who have returned to the UK. Also anyone who is up to date can take their laptop somewhere and enter data even if they have no internet access, -and the updates can be merged when they get back to civilization. +and the updates will be merged when they get back to civilization.

In principle, survey notes can be typed into a laptop up on the plateau which would then get synchronised when it next gets internet access. @@ -65,9 +65,8 @@ then get synchronised when it next gets internet access. do not get modified, so they are kept as a plain directory of files 'expofiles'. The same goes for holiday photographs and GPS logs.

-

From 2012-2019 we used mercurial (aka 'hg'), but completed the move to git -before the 2020 expo.

- +

In 2019 we had half our version-controlled repositories under mercurial and half under git. +The intention is to move entirely to git before the 2020 expo.

Contents

    @@ -84,6 +83,7 @@ Appendices:

    Getting a username, password and key

    @@ -113,12 +113,12 @@ editing and keeps track of all changes so we can roll back and have branches if

    The site has been split into four parts:

    -

    We have migrated three of these to git but loser is still mercurial for a few more days. +

    We have migrated two of these to git but the other two still use mercurial.

    Updating cave pages

    diff --git a/handbook/computing/onlinesystems.html b/handbook/computing/onlinesystems.html index bb602cd94..4d6aa3aa2 100644 --- a/handbook/computing/onlinesystems.html +++ b/handbook/computing/onlinesystems.html @@ -6,7 +6,14 @@ +

    CUCC Expedition Handbook - Online overview

    +

    Expo Online Systems Overview

    The cave data and online publishing system (aka "the website") is now large and complicated. @@ -15,6 +22,7 @@ This page is the overview. The online systems manuals are split into these secti