expo/expoweb
1
0
Fork 0
mirror of https://expo.survex.com/repositories/expoweb/.git/ synced 2025-12-08 14:54:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

fixing mismatches in laptop setup docm

Browse Source
This commit is contained in:
Philip Sargent
2021-10-22 23:43:02 +03:00
parent cf4dc30251
commit 7ab44fec6d
6 changed files with 96 additions and 114 deletions
Download Patch File Download Diff File Expand all files Collapse all files

BIN
handbook/troggle/Django_Logo-420x180.png Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 13 KiB

31
handbook/troggle/trogdjangup.html
View File

@@ -23,21 +23,39 @@
<th>End of support</th>
<th>End of security fixes</th>
</tr>
<tr>
<td>4.2 LTS</td>
<td>April 2023</td>
<td>December 2023</td>
<td>April 2026</td>
</tr>
<tr>
<td>4.1</td>
<td>August 2022</td>
<td>April 2023</td>
<td>December 2023</td>
</tr>
<tr>
<td>4.0</td>
<td>December 2021</td>
<td>August 2023</td>
<td>April 2023</td>
</tr>
<tr>
<td>3.2 LTS</td>
<td>April 2021</td>
<td>3.2.8</td>
<td>December 2021</td>
<td>April 2024</td>
</tr>
<tr>
<td>3.1</td>
<td>3.1.7</td>
<td>3.1.13</td>
<td>April 2021</td>
<td>December 2021</td>
</tr>
<tr>
<td>3.0</td>
<td>3.0.13</td>
<td>3.0.14</td>
<td>August 2020</td>
<td>April 2021</td>
</tr>
@@ -47,12 +65,7 @@
<td>December 2019</td>
<td>April 2022</td>
</tr>
<tr class="unsupported">
<td>1.11 LTS <sup></td>
<td>1.11.29</td>
<td>December 2017</td>
<td>April 2020</td>
</tr>
</table>
</div>
<h4>Major, minor and releases</h4>

18
handbook/troggle/troglaptop.html
View File

@@ -17,13 +17,15 @@
your account will need to be added to the troggle project members list. Contact wookey at wookware dot org to get this set up.
<p>This page is a work in progess. Text will be moved here from
<img border="1" class="onright" width="150px" src='tricky-troggle.jpg' alt='troggle logo'/></a>
<pre>
http://expo.survex.com/repositories/troggle/.git/tree/README.txt
handbook/computing/yourlaptop.html
handbook/troggle/trogdjangup.html
</pre>
<img src="https://www.debian.org/logos/openlogo-100.jpg" align="right" hspace="20" alt='debian logo'>
<h2 id="os">Installing linux</h2>
<p>If you don't already know how to do this, then you should probably not be attempting this. 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
@@ -39,11 +41,11 @@ handbook/troggle/trogdjangup.html
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, so we also need python3.7,
and also python3.8 if you are planning on migrating troggle from debian Buster (v10) to Bullseye (v11).
<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, so we also need python3.7, if you are planning on migrating 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 python3.7
sudo apt install python3.8
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
@@ -77,12 +79,13 @@ cd ..
ls -tlA expo</pre></code>
<h2>Installing Django and troggle</h2>
<img src="Django_Logo-420x180.png" align="right" hspace="20" width='210' alt='django logo'>
<p>The important point to note
here is that unless you are doing something fairly trivial, or you are a git genius,
it is sensible to set up a python virtual environments to hold duplicate copies of both troggle and django code.
Then you will be able to check that your edited version of troggle runs with old, current
Then you will be able to check very quickly that your edited version of troggle runs with old, current
and pre-release versions of python and of django;
and you will more easily be able to manage problems with incompatible versions of django plugins.
and you will more easily be able to manage problems with incompatible versions of django plugins as installing and upgrading the dependent packages is very fast.
<h3 id="venv">Installing a venv</h3>
@@ -97,6 +100,7 @@ pip list -o</pre></code>
<p>The last command lists the default packages installed in the venv. This is for comparison later, after we
have installed troggle, django and dependencies. You will get a warning that you have an out of date version of pipbut this is as we want: we are using a version of pip appropriate for the older version of python within
the venv.
<img border="1" class="onright" width="150px" src='tricky-troggle.jpg' hspace="20" alt='troggle logo'/></a>
<p>The first time you do this you can't complete the pip installation of django as you have not yet got the
dependencies - because you have not yet cloned the troggle repo, so the first time it is easiest to just create requirements.txt yourself with a text editor.

4
handbook/troggle/trognotes.html
View File

@@ -64,8 +64,8 @@ to <a href="../computing/contribute.html#programming">get involved in the progra
<li>Use the online forms and reports together with 'survex' and 'therion' installed on your own laptop.
<li>Get the 'expoadmin' password and explore the live system online: watch the data change in real time
<li>Configure <a href="../computing/keyexchange.html">an ssh key</a> and <a href="../computing/fzconfig.html">Filezilla</a> or scp/sFTP.
<li>Configure a <a href="../computing/basiclaptop.html">minimal expo laptop</a>
<li>Configure a <a href="../computing/yourlaptop.html">basic expo laptop</a>
<li>Configure a <a href="../computing/basiclaptop.html">basic expo laptop</a>
<li>Configure a <a href="../computing/yourlaptop.html">more cave software on your laptop</a>
<li>Configure a <a href="troglaptop.html">troggle development machine</a> - a laptop where you have cloned the repos and installed django. Installing is the same as updating Django. See <a href="trogdjangup.html">Troggle: updating Django</a>.
</ol>