mirror of
https://expo.survex.com/repositories/expoweb/.git/
synced 2026-02-24 21:25:19 +00:00
fixing mismatches in laptop setup docm
This commit is contained in:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user