Maybe what you need is simply some fixes or workarounds in the imported data files, not in the python code.
You need to already know really quite a lot about what troggle does, and how it is used in practice. Also you will have installed quite a lot of the software such as tunnel, therion, survex etc. as documented in your bulk update laptop configuration. In particular read the information there about VS code and git. +
You need to already know really quite a lot about what troggle does, and how it is used in practice. Also you will have installed quite a lot of the software such as tunnel, therion, survex etc. as documented in your bulk update laptop configuration. In particular read the information there about VS code and git.
This page is a work in progess. Text will be moved here from @@ -47,7 +47,8 @@ http://expo.survex.com/repositories/troggle/.git/tree/README.txt
Before you do anything else, get yourself set up with a key-pair to access the software on the expo server properly. @@ -65,11 +66,8 @@ http://expo.survex.com/repositories/troggle/.git/tree/README.txt -
The install script (see below) will create the virtual environment. -
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:
-
sudo apt intall git
-
manually.
-
+
Do familiarise yourself with the directory structure on the expo server, which we will be duplicating (partly) as docmented in The Expo Server. We are not here doing a full install of all the software and scripts on the server, just the minimum to run, test and debug troggle on Django. +
There are two scripts in the troggle folder which will do semi-automatically what is described below. Have a look at
You will run os-trog24.04.sh just once to install the basics,and you will run venv-trog.sh just once initially. -
We have two configurations for the virtual environment: 'dev' which uses the latest python and Django for speed, and 'server' which mimics the versions currently running on the server. In December 2024 Django is 5 releases ahead of the version on the server (5.1 versus 3.2). Each has a list of ancilliary packages with the appropriate versions in dev.toml and server.toml. +
You will run os-trog24.04.sh just once to install all the basics,and you will run venv-trog.sh just once initially. +
We have two configurations for the virtual environment: 'dev' which uses the latest python and Django for speed, and 'server' which mimics the versions currently running on the server. [In December 2024 Django is 5 releases ahead of the version on the server (5.1 versus 3.2). Each has a list of ancilliary packages with the appropriate versions in dev.toml and server.toml.] venv-trog.sh deals with all this python-specific stuff, libraries and Django plug-ins. -
os-trog.sh 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. -
Do familiarise yourself with the directory structure on the expo server, which we will be duplicating (partly) as docmented in The Expo Server. We are not here doing a full install of all the software and scripts on the server, just the minimum to run, test and debug troggle on Django. -
[You will need to read this is you are doing anything even very slightly off the beaten tracke: WSL/Troggle].
- - -
The standard documentation for Ubuntu or debian below all works, but you should first skim the - Windows expo laptop configuration too. - - - -
os-trog.sh takes a few minutes initially, but then about an hour when it installs survex, therion and tunnel as these drag in a huge number of dependencies. + +
Yes, it is true that this would greatly speed up on-boarding new programmers. Or podman.
But there is the significant danger that containers would get copied around and deployed without being properly cleaned up:
resulting in configuration drift and a snowflake server situation.
@@ -106,7 +94,7 @@ provisioning so that systems are rebuilt cleanly. Configuring ubuntu
In your home folder run
~$ bash os-trog24.04.sh
-
copy it from the .git repo online to get hold of it.
+
copy it from the .git repo online to get hold of it. Run it in /home/username and it will create a folder expo and clone all the repositories into it after installing the software you need. It installs some of expofiles but not expofiles/photos/.