expo/expoweb
1
0
Fork 0
mirror of https://expo.survex.com/repositories/expoweb/.git/ synced 2025-12-08 14:54:28 +00:00
Code Issues Packages Projects Releases Wiki Activity

rearranged to make more sense - online edit of handbook/troggle/troglaptop.html [PosixPath('/home/philip/expoweb/handbook/troggle/troglaptop.html')]

Browse Source
This commit is contained in:
Philip Sargent
2024-12-20 17:36:34 +00:00
parent cee76a364e
commit 9e0e6c2c32
1 changed files with 29 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

53
handbook/troggle/troglaptop.html
View File

@@ -25,6 +25,23 @@ need to write any new software for what you need to do. Look at the tools and re
<p>Maybe what you need is simply some fixes or workarounds in the imported data files, not in the python code. <p>Maybe what you need is simply some fixes or workarounds in the imported data files, not in the python code.
<h2 id="os">Installing linux</h2>
<img src="https://www.debian.org/logos/openlogo-100.jpg" align="right" hspace="20" alt='debian logo'>
<p>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.
<p>The server is running fairly old, stable releases of Debian and Django, but you will probably want Ubuntu-24.04 which is compatible.
<ul>
<li>Linux machine
<ul>
<li>Install <a href="https://ubuntu.com/download/desktop">Ubuntu 24.04 LTS</a>
</ul>
<li>Windows 10 or 11 machine
<ul>
<li>Configure &#9775; <a href="../computing/wsllaptop.html">WSL on a WIndows laptop</a>. The standard documentation for Ubuntu or debian below all works, but you should first skim the
&#9728; <a href="../computing/winlaptop.html">Windows expo laptop</a> configuration too.
</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>Prerequisites</h3> <h3>Prerequisites</h3>
<p>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 <a href="../computing/bulkupdatelaptop.html">your bulk update laptop configuration</a>. In particular read the information there about VS code and git. <p>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 <a href="../computing/bulkupdatelaptop.html">your bulk update laptop configuration</a>. In particular read the information there about VS code and git.
@@ -57,25 +74,11 @@ rm -fr trog-temp</code></pre>
<pre> <pre>
<a href="http://expo.survex.com/repositories/troggle/.git/tree/README.txt">expo.survex.com/repositories/troggle/.git/tree/README</a> <a href="http://expo.survex.com/repositories/troggle/.git/tree/README.txt">expo.survex.com/repositories/troggle/.git/tree/README</a>
</pre> </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 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.
<p>The server is running fairly old, stable releases of Debian and Django, but you will probably want Ubuntu-24.04 which is compatible.
<ul>
<li>Linux machine
<ul>
<li>Install <a href="https://ubuntu.com/download/desktop">Ubuntu 24.04 LTS</a>
</ul>
<li>Windows 10 or 11 machine
<ul>
<li>Configure &#9775; <a href="../computing/wsllaptop.html">WSL on a WIndows laptop</a>. The standard documentation for Ubuntu or debian below all works, but you should first skim the
&#9728; <a href="../computing/winlaptop.html">Windows expo laptop</a> configuration too.
</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 id="folders">Directory (folder) structure</h3> <h3 id="folders">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>): <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>):
@@ -117,22 +120,24 @@ provisioning so that systems are rebuilt cleanly. <a href="http://www.cuyc.org.u
<h2 id="git">Configuring ubuntu</h2> <h2 id="git">Configuring ubuntu</h2>
<p>Set up the key-exchange first. You need to be able to ssh into the server to run this next bit. <p>Set up the key-exchange first. You need to be able to ssh into the server to run this next bit.
<h4>Set your indentity</h4>
<p>On a new machine you need to configure your git identity. If your name is <em>Anathema Device</em>,then:
<pre><code>git config --global user.email "<font color=blue>anathema.device@example.com</font>"
git config --global user.name "<font color=blue>Anathema Device</font>"
git config --global pull.rebase true
</code></pre>
<p>In your home folder run <br> <p>In your home folder run <br>
~$ <var>bash os-trog24.04.sh</var> ~$ <var>bash os-trog24.04.sh</var>
<br>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 <var>/home/username/expo</var> and it will clone all the repositories into it after installing the software you need. It installs some of <var>expofiles</var> but not <var>expofiles/photos/</var>. <br>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 <var>/home/<font color=blue>anathema</font>/expo</var> and it will clone all the repositories into it after installing the software you need. It installs some of <var>expofiles</var> but not <var>expofiles/photos/</var>.
<h4>key exchange</h4> <h4>key exchange</h4>
<p>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. <p>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.
<p>Follow this link to <a href="../computing/keyexchange.html">register a key with the expo server</a> to get git access if you have <p>Follow this link to <a href="../computing/keyexchange.html">register a key with the expo server</a> to get git access if you have
not already cloned the <var>:troggle:</var> repo. not already cloned the <var>:troggle:</var> repo.
<h4>Set your indentity</h4>
<p>On a new machine you need to configure your git identity:
<pre><code>git config --global user.email "<font color=blue>anathema.device@example.com</font>"
git config --global user.name "<font color=blue>Anathema Device</font>"
git config --global pull.rebase true
</code></pre>
<p>On WSL you will need to check that the key that you paired is actually loaded:<pre><code>chmod 700 ~/.ssh/* <p>On WSL you will need to check that the key that you paired is actually loaded:<pre><code>chmod 700 ~/.ssh/*
eval `ssh-agent` eval `ssh-agent`