expo/expoweb
1
0
Fork 0
mirror of https://expo.survex.com/repositories/expoweb/.git/ synced 2026-02-14 02:16:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

Cross referencing javascript packages in handbook

Browse Source
This commit is contained in:
Philip Sargent
2021-03-21 21:46:21 +00:00
parent 824dea8a7d
commit d0a41d386c
3 changed files with 29 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
handbook/troggle/serverconfig.html
View File

@@ -52,21 +52,33 @@ expoweb (repo)
<p>The handbook illustrates the i/t/l idiom whereby an image file (i) is displayed with a paragraph of text as an HTML file (l) and there is a thumbnail image (t) which is included in another document, e.g. see <a href="../../1623/walkin.htm">the photographic guide to the walk from the toll road car park</a>.
<h4 id="js">CSS and JavaScript</a></h3>
<p>The <var>expoweb</var> repo contains all the HTML files and basic CSS files. The <var>troggle</var> repo contains the HTML templates, CSS and some javscript for the troggle report pages generated dynamically. There are also javascript packages installed directly on the operating system which are used by some <var>expoweb</var> pages: <var>CaveScript</var> for showing 3D views of cave centreline data and <var>openlayers</var> for geographic mapping integration. These javascript packages are only documented in the configuration instructions, see below.
<h3 id="what">Server configuration: software</a></h3>
<ul>
<li>apache webserver
<li>MySQL database
<li>apache webserver *
<li>MySQL/MariaDB database *
<li>packaged javascript *
<li>expofiles *
<li>cgit (live webpage showing git status of repos)
<li>Makefile
<li>Makefile (obsolete?)
<li>bins
<li>expofiles
<li>ssh
<li>cron
<li>xapian (search function)
<li>boe
</ul>
* These are essential to make troggle work at all.
<p>The server configuration scripts are in <var>troggle/debian/serversetup</var> and are also
documented with notes in <var>troggle/README.txt</var>. It is intended that the full documentation will
be copied here in due course and that fully automated server setup scripts will be developed
<ul>
<li>to create a development server running locally on a personal machine
<li>to install the master system following a new operating system install on the public server
</ul>
<p>The folder structure on the server is as shown below. It is all
in the user folder for the user <var>expo</var> i.e. in
@@ -142,7 +154,10 @@ expo
└── webphotos
└── ...</textarea></code>
<p><var>expofiles</var> contains many important folders:
<h4 id="expofiles">expofiles</a></h3>
<p><var>expofiles</var> contains ~40GB of files which are published by the webserver but which are not parsed by troggle. 28GB of these are photographs in <var>/expofiles/photos/</var> and there are over 4GB of scanned images of surveys in <var>/expofiles/surveyscans/</var>. There is a cleaned, complete copy of the documentation for the <var>tunnelX</var> cave plan drawing package in <var>/expofiles/tunnelwiki/</var>.
<p>
<code><textarea id="folders" rows="30" cols="40">
expofiles
@@ -286,7 +301,7 @@ expofiles
│   ├── 2017
│   ├── 2018
│   ├── 2019
│   ├── 2020
│   ├── 2021
│   └── 90Surveybookkh
├── terrain
├── training-info
@@ -331,7 +346,7 @@ expofiles
├── 2017
├── 2018
├── 2019
└── 2020</textarea></code>
└── 2021</textarea></code>
<h3>cron</h3>
<p>The server runs it's hourly, daily and weekly scripts using the anacron system. In