diff --git a/handbook/troggle/troglaptop.html b/handbook/troggle/troglaptop.html index 5700b625a..51fe29f70 100644 --- a/handbook/troggle/troglaptop.html +++ b/handbook/troggle/troglaptop.html @@ -25,6 +25,23 @@ need to write any new software for what you need to do. Look at the tools and re
Maybe what you need is simply some fixes or workarounds in the imported data files, not in the python code. +
+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 on Windows. Ubuntu installs python and various essential python dev tools by default. +
The server is running fairly old, stable releases of Debian and Django, but you will probably want Ubuntu-24.04 which is compatible. +
Before you do anything else, get yourself set up with a key-pair to access the software on the expo server properly. +
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 git and set up the key-pair as documented in your bulk update laptop configuration. In particular read the information there about VS code and git. @@ -57,25 +74,11 @@ rm -fr trog-temp
expo.survex.com/repositories/troggle/.git/tree/README-
-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. Ubuntu installs python and various essential python dev tools by default. -
The server is running fairly old, stable releases of Debian and Django, but you will probably want Ubuntu-24.04 which is compatible. -
Before you do anything else, get yourself set up with a key-pair to access the software on the expo server properly. + +
This is up to you of course, but a suggested structure is like this ("~" means your own user home folder, e.g. /home/philip/):
@@ -117,22 +120,24 @@ provisioning so that systems are rebuilt cleanly. Configuring ubuntu
Set up the key-exchange first. You need to be able to ssh into the server to run this next bit.
-
+
+ On a new machine you need to configure your git identity. If your name is Anathema Device,then:
+ In your home folder run You absolutely need this so that you can upload your edited code to the git repo on the server. And currently the initial download and setup requires it too.
Follow this link to register a key with the expo server to get git access if you have
not already cloned the :troggle: repo.
- On a new machine you need to configure your git identity:
- On WSL you will need to check that the key that you paired is actually loaded:Set your indentity
+
+
git config --global user.email "anathema.device@example.com"
+git config --global user.name "Anathema Device"
+git config --global pull.rebase true
+
~$ bash os-trog24.04.sh
-
you will hve this in your troggle folder is you have copied it from _deploy (see instructions above) or you can copy it from the .git repo online to get hold of it. Run it in /home/username/expo and it will clone all the repositories into it after installing the software you need. It installs some of expofiles but not expofiles/photos/.
+
you will hve this in your troggle folder is you have copied it from _deploy (see instructions above) or you can copy it from the .git repo online to get hold of it. Run it in /home/anathema/expo and it will clone all the repositories into it after installing the software you need. It installs some of expofiles but not expofiles/photos/.
key exchange
Set your indentity
-
+
git config --global user.email "anathema.device@example.com"
-git config --global user.name "Anathema Device"
-git config --global pull.rebase true
-chmod 700 ~/.ssh/*
eval `ssh-agent`