expoweb/handbook/computing/folkupdate.html

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>CUCC Expedition Handbook: People Update</title>
<link rel="stylesheet" type="text/css" href="../../css/main2.css" />
</head>
<body>
<h2 id="tophead">CUCC Expedition Handbook</h2>
<h1>The list of people on expo</h1>

<p>These are nerd-instructions. Find a nerd if you think this needs to be done.

<h3 id="import">The folk list</a></h3>
<p>This is part of the <a href="newyear.html">"new expo year"</a> preparations.
The folk.csv file is stored on the server under version control in the <var>:expoweb:</var> <a href="../computing/repos.html">repository</a> in 
<code>expoweb/folk/folk.csv</code>

<p>Before expo starts the folk.csv file is updated. 

<p>Edit folk/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 are there, and a -1 for people who are there but didn't go caving. 
This is adding an extra column to every line in the file.
<p>
Add new lines for new people, with the right number of columns.

<p>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.

<p>
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.

<p>The nerd can log in using the 'expo' userid. 

<p>The nerd needs to do this:
<ol>
<li>Upload the edited copy of folk.csv to the server using the version control system.
<li>Log in to the expo server and run the update script (see below)
<li>Watch any error messages scroll by.
<li>Look at the new folk list HTML file at <a href="http://expo.survex.com/folk/">http://expo.survex.com/folk/</a>
<li>Re-run the import script until you have got rid of all the import errors.
</ol>
<p>This is how you login and run the script:
<pre><code>ssh  expo@expo.survex.com
cd expoweb/folk
chmod +w index.htm
python ../scripts/make-folklist.py &lt;folk.csv &gt;index.htm
</code></pre>
<p>If there are no errors, you will just see the prompt reappear in your ssh session 
and you will see the result online at <a href="http://expo.survex.com/folk/">http://expo.survex.com/folk/</a>.
<p>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.

<hr />

</body>
</html>
Documenting how to add a new year and new people in folk.csv and test that it works by running the databaseRest.py people command 2020-02-21 00:23:59 +00:00			`<!DOCTYPE html>`
			`<html>`
			`<head>`
			`<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />`
			`<title>CUCC Expedition Handbook: People Update</title>`
			`<link rel="stylesheet" type="text/css" href="../../css/main2.css" />`
			`</head>`
			`<body>`
			`<h2 id="tophead">CUCC Expedition Handbook</h2>`
			`<h1>The list of people on expo</h1>`

			`<p>These are nerd-instructions. Find a nerd if you think this needs to be done.`

			`<h3 id="import">The folk list</a></h3>`
			`<p>This is part of the <a href="newyear.html">"new expo year"</a> preparations.`
All links to repos now go to new page 2020-04-26 21:41:21 +01:00			`The folk.csv file is stored on the server under version control in the <var>:expoweb:</var> <a href="../computing/repos.html">repository</a> in`
Documenting how to add a new year and new people in folk.csv and test that it works by running the databaseRest.py people command 2020-02-21 00:23:59 +00:00			`<code>expoweb/folk/folk.csv</code>`

			`<p>Before expo starts the folk.csv file is updated.`

			`<p>Edit folk/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 are there, and a -1 for people who are there but didn't go caving.`
			`This is adding an extra column to every line in the file.`
			`<p>`
			`Add new lines for new people, with the right number of columns.`

grey banner and lots of to-do fixes, to do items all updated from scribbled notes on printout 2020-04-22 19:37:10 +01:00			`<p>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.`
Documenting how to add a new year and new people in folk.csv and test that it works by running the databaseRest.py people command 2020-02-21 00:23:59 +00:00
			`<p>`
			`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.`

			`<p>The nerd can log in using the 'expo' userid.`

			`<p>The nerd needs to do this:`
			`<ol>`
			`<li>Upload the edited copy of folk.csv to the server using the version control system.`
grey banner and lots of to-do fixes, to do items all updated from scribbled notes on printout 2020-04-22 19:37:10 +01:00			`<li>Log in to the expo server and run the update script (see below)`
Documenting how to add a new year and new people in folk.csv and test that it works by running the databaseRest.py people command 2020-02-21 00:23:59 +00:00			`<li>Watch any error messages scroll by.`
			`<li>Look at the new folk list HTML file at <a href="http://expo.survex.com/folk/">http://expo.survex.com/folk/</a>`
			`<li>Re-run the import script until you have got rid of all the import errors.`
			`</ol>`
			`<p>This is how you login and run the script:`
			`<pre><code>ssh expo@expo.survex.com`
grey banner and lots of to-do fixes, to do items all updated from scribbled notes on printout 2020-04-22 19:37:10 +01:00			`cd expoweb/folk`
			`chmod +w index.htm`
Documenting how to add a new year and new people in folk.csv and test that it works by running the databaseRest.py people command 2020-02-21 00:23:59 +00:00			`python ../scripts/make-folklist.py <folk.csv >index.htm`
			`</code></pre>`
grey banner and lots of to-do fixes, to do items all updated from scribbled notes on printout 2020-04-22 19:37:10 +01:00			`<p>If there are no errors, you will just see the prompt reappear in your ssh session`
			`and you will see the result online at <a href="http://expo.survex.com/folk/">http://expo.survex.com/folk/</a>.`
Documenting how to add a new year and new people in folk.csv and test that it works by running the databaseRest.py people command 2020-02-21 00:23:59 +00:00			`<p>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.`

			`<hr />`

			`</body>`
			`</html>`