diff --git a/handbook/troggle/scriptscurrent.html b/handbook/troggle/scriptscurrent.html index d9e1753a6..c96b7a80d 100644 --- a/handbook/troggle/scriptscurrent.html +++ b/handbook/troggle/scriptscurrent.html @@ -24,10 +24,13 @@ p {

See index to the full list of these scripts at Other Scripts. This page only documents a sub-set which is not more fully documented elsewhere.

[This page should be split so that the obsolete stuff is recorded but doesn't get in the way.] +

Javascript

+

See the Expo server page for what javascript packages are used by some troggle pages (CaveView, jquery etc.). +

Makefiles

In :expoweb:/noinfo/ -

This coordinates running very essential updates but also includes redundant and obsolete stuff. It needs some serious attention. -

It coordinates producing the 3d surveys used in the cave description pages, updates the area pages, runs the folk script, runs the QM list generation within each of the cave pages that needs it, runs svxtrace, and reports on everything usign "bigbro" which we don't have any other reference to. +

This may be obsolete. It used to coordinate running essential updates but also definitely includes redundant stuff. It needs some serious attention. +

It coordinates producing the 3d surveys used in the cave description pages, updates the area pages, runs the folk script, runs the QM list generation within each of the cave pages that needs it, runs svxtrace, and reports on everything using "bigbro" which we don't have any other reference to. (Generation of the .3d files as required is now done by troggle.)

Wallets

Online wallets are initially maintained using the wallets.py script, but troggle also directly imports all the expofiles/surveyscans/ directories of scanned survey notes and produces reports on then. diff --git a/handbook/troggle/scriptsother.html b/handbook/troggle/scriptsother.html index cac4fc60e..c8ce72285 100644 --- a/handbook/troggle/scriptsother.html +++ b/handbook/troggle/scriptsother.html @@ -34,6 +34,7 @@

  • cavestats and smklengths extract overall lengths and depths from all the survex files
  • summarizecave.sh gets .3d file contents using survex
  • caves-tabular.html a re-sortable table of cave data +
  • JavaScript packages are used by some troggle pages. See the Expo server page.
  • Makefile coordinates running many of these scripts (needs maintenance) diff --git a/handbook/troggle/serverconfig.html b/handbook/troggle/serverconfig.html index 000916827..60682f25d 100644 --- a/handbook/troggle/serverconfig.html +++ b/handbook/troggle/serverconfig.html @@ -52,21 +52,33 @@ expoweb (repo)

    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 the photographic guide to the walk from the toll road car park. +

    CSS and JavaScript

    + +

    The expoweb repo contains all the HTML files and basic CSS files. The troggle 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 expoweb pages: CaveScript for showing 3D views of cave centreline data and openlayers for geographic mapping integration. These javascript packages are only documented in the configuration instructions, see below. +

    Server configuration: software

    + * These are essential to make troggle work at all. +

    The server configuration scripts are in troggle/debian/serversetup and are also +documented with notes in troggle/README.txt. It is intended that the full documentation will +be copied here in due course and that fully automated server setup scripts will be developed +

    The folder structure on the server is as shown below. It is all in the user folder for the user expo i.e. in @@ -142,7 +154,10 @@ expo └── webphotos └── ... -

    expofiles contains many important folders: +

    expofiles

    + +

    expofiles contains ~40GB of files which are published by the webserver but which are not parsed by troggle. 28GB of these are photographs in /expofiles/photos/ and there are over 4GB of scanned images of surveys in /expofiles/surveyscans/. There is a cleaned, complete copy of the documentation for the tunnelX cave plan drawing package in /expofiles/tunnelwiki/. +

    + └── 2021

    cron

    The server runs it's hourly, daily and weekly scripts using the anacron system. In