From 9e0e6c2c32e66b5c11b7e4d374ae3213a042d503 Mon Sep 17 00:00:00 2001 From: Philip Sargent Date: Fri, 20 Dec 2024 17:36:34 +0000 Subject: [PATCH] rearranged to make more sense - online edit of handbook/troggle/troglaptop.html [PosixPath('/home/philip/expoweb/handbook/troggle/troglaptop.html')] --- handbook/troggle/troglaptop.html | 53 +++++++++++++++++--------------- 1 file changed, 29 insertions(+), 24 deletions(-) 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. +

Installing linux

+debian logo +

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. +

Prerequisites

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
-debian logo -

Installing linux

-

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. + +

Directory (folder) structure

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. - + +

Set your indentity

+

On a new machine you need to configure your git identity. If your name is Anathema Device,then: + 

git config --global user.email "anathema.device@example.com"
+git config --global user.name "Anathema Device"
+git config --global pull.rebase true
+
+

In your home folder run
~$ 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

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. -

Set your indentity

-

On a new machine you need to configure your git identity: - 

git config --global user.email "anathema.device@example.com"
-git config --global user.name "Anathema Device"
-git config --global pull.rebase true
-
+

On WSL you will need to check that the key that you paired is actually loaded:

chmod 700 ~/.ssh/*
 eval `ssh-agent`