python & JS news updates

handbook/troggle/troglaptop.html

@@ -30,7 +30,7 @@ http://expo.survex.com/repositories/troggle/.git/tree/README.txt
 
 
 <h2 id="os">Installing linux</h2>
-<p>If you don't already know how to do this, then you should probably not be attempting to work on the troggle code. But in case you are an experienced linux user who has always had someone else set up the system for them, then Ubuntu is the easiest and more forgiving to install, either directly on the computer or inside WSL. Because we are using fairly old releases of Django, you will want Ubuntu-20.04
+<p>If you don't already know how to do this, then you should probably not be attempting to work on the troggle code. But in case you are an experienced linux user who has always had someone else set up the system for them, then Ubuntu is the easiest and more forgiving to install, either directly on the computer or inside WSL. Because we are using fairly old, stable releases of Django, you will want Ubuntu-20.04
 <ul>
 <li>Install in <a href="https://docs.microsoft.com/en-us/windows/wsl/install">WSL on Windows 10</a>.
 <li>Install <a href="https://ubuntu.com/download/desktop">Ubuntu 20.04 LTS</a>.
@@ -42,14 +42,18 @@ http://expo.survex.com/repositories/troggle/.git/tree/README.txt
 <a href="../computing/winlaptop.html">Windows expo laptop</a> description of WSL1 and WSL2. The default
 is that WSL2 will be installed, but all our practical experience so far is with WSL1.
 
+
 <h2 id="python">Installing python</h2>
-<p>Python is not installed by default usually, and in any case we need specific versions to be installed. For Ubuntu 20.04 the default is python3.9 but this is incompatible with standard debian Buster which is what is live on our server, so we also need python3.7 . If you are planning on helping the migration of troggle from debian Buster (v10) to Bullseye (v11) then you will also want python3.8 .
+<a href="https://xkcd.com/1987/"><img src="https://imgs.xkcd.com/comics/python_environment.png" align="right" hspace="20"  width="230" alt='XKCD python install'></a>
+
+<p>Python is not installed by default usually, and in any case we need specific versions to be installed. For Ubuntu 20.04 the default is python3.9 but this is incompatible with standard debian Buster which is what is live on our server, so we also need python3.7 . 
+<p>If you are planning on helping the migration of troggle from debian Buster (v10) to Bullseye (v11) then you will also want python3.8 .
 <pre><code>sudo apt install python3 python3-pip
+sudo apt install sqlite3 sqlite3-doc
+sudo apt install survex
 sudo apt install software-properties-common
 sudo add-apt-repository ppa:deadsnakes/ppa
 sudo apt install python3.7 python3.7-venv python3.7-doc binutils binfmt-support
-sudo apt install sqlite3 sqlite3-doc
-sudo apt install survex
 cd /usr/bin
 sudo ln -s python3 python
 sudo ln -s pip3 pip </code></pre>
@@ -332,7 +336,7 @@ and run the tests again:
 
 <pre><code>python  manage.py test -v 2</code></pre>
 
-<details><summary>Click on the triangle to see how to run the <var>folk</var> script.</summary>
+<details><summary>Click on the triangle to see how to run the <var>folk</var> script. You don't need to do this now.</summary>
 <font color="blue">
 The <var>folk</var> generation script is top of the list in
 
@@ -355,7 +359,7 @@ cd ../../troggle
 <br>- <var><a href="http://localhost:8000/stats">http://localhost:8000/stats</a></var>
 <br>- <var><a href="http://localhost:8000/people">http://localhost:8000/people</a></var> (takes a minute or so)
 <br>- <var><a href="http://localhost:8000/expofiles/surveyscans/2019/walletindex.html">http://localhost:8000/expofiles/surveyscans/2019/walletindex.html</a></var>
-<<br>- <var><a href="http://localhost:8000/survexfile/caves/">http://localhost:8000/survexfile/caves/</a></var>
+<br>- <var><a href="http://localhost:8000/survexfile/caves/">http://localhost:8000/survexfile/caves/</a></var>
 <br>- <var><a href="http://localhost:8000/expofiles/training-info/Idiots guide to accessing expo git.pptx">http://localhost:8000/expofiles/training-info/Idiots guide to accessing expo git.pptx</a></var>
 <br>- <var><a href="http://localhost:8000/1623/291/291.html">http://localhost:8000/1623/291/291.htm</a></var>
 <br>- <var><a href="http://localhost:8000/caves">http://localhost:8000/caves</a></var>

handbook/troggle/trogspeculate.html

@@ -31,6 +31,7 @@ Wikipedia list of javascript frameworks</a>.] With our deep historical perspecti
 we can expect <a href="https://www.circleid.com/posts/20201031-the-javascript-ecosystem/">this 
 menagerie to sort itself</a> out into a stable, standardised foundation 
 within the next couple of decades but probably not within the next 10 years.
+(ECMAscript 12 is definitely on the way to making these frameworks redundant.)
 <p>
 A web API to expose the troggle database (read-only) would allow some keen
 person to write a special-purpose app on a phone, e.g. an entrance-locator
@@ -53,6 +54,8 @@ enthusiast must have done this already surely  ? Ah yes, Brython.<br>
 <a href="https://pyodide.org/en/stable/">Pyodide</a> - full browser using webassembly (2021) and <br>
 <a href="https://skulpt.org/gallery.html">Skulpt</a> (which has, since 2017, a full-blown 
 <a href="https://anvil.works/features">commerical system(</a>) built on top of it - by a  CambridgeCL spinout)</br>
+<a href="https://www.theregister.com/2021/11/30/python_web_wasm/">WASM</a> - CPython in webassembly (2021)<br>
+
 <p>
 Which is fun, but not useful. And not just because it may be immature. None of
 this addresses <strong>our biggest problem: devising  something that can be