diff --git a/handbook/troggle/troglaptop.html b/handbook/troggle/troglaptop.html index dd0499375..2ed23b939 100644 --- a/handbook/troggle/troglaptop.html +++ b/handbook/troggle/troglaptop.html @@ -56,11 +56,34 @@ Windows Subsystem for Linux now packaged as a Microsoft Store app</a>, </ul> </ul> <p>Before you do anything else, get yourself set up with a <a href="../computing/keyexchange.html">key-pair</a> to access the software on the expo server properly. + +<h3>Directory (folder) structure</h3> +<p>This is up to you of course, but a suggested structure is like this ("~" means your own user home folder, e.g. <var>/home/philip/</var>): +<ul> + <li>~/expo + <ul> + <li>~/expo/troggle + <li>~/expo/expoweb + <li>~/expo/drawings + <li>~/expo/loser<br><br> + <li>~/expo/p13d5/ - python3.13 Django 5 (dev) + <li>~/expo/p11d3/ - python3.11 Django 3.2 (server mimic) + + </ul> +</ul> +<p>The install script (see below) will create the dev and server-mimic folders which will be virtual environments. + <p>Before the install scripts work on a bare Ubuntu installation, you will need to have git installed. This is in-built on Ubuntu 24.04 but on other (and earlier) Linux distros you will need to do: + <br><var>sudo apt intall git</var> +<br> manually. + <p>There are two scripts in the <var>troggle</var> folder which will do semi-automatically what is described below. Have a look at <ul> <li><var>os-trog.sh</var> <li><var>venv-trog.sh</var> </ul> +which you can read without installing by looking at:<br> + + <p>You will run <var>os-trog.sh</var> just once to install the basics, but you will run <var>venv-trog.sh</var> every time you fire up a new python version/django version combination or play with the versions of the imported packages as listed in <var>requirements.txt</var>. <p><var>os-trog.sh</var> takes a few minutes initially, but then about an hour when it installs therion and tunnel as these drag in a huge number of dependencies. <h3>Files and directories</h3>