diff --git a/handbook/computing/todo.html b/handbook/computing/todo.html index faf066b0d..1410ea550 100644 --- a/handbook/computing/todo.html +++ b/handbook/computing/todo.html @@ -46,15 +46,17 @@ body {
  • Explain how to link a new cave into the other caves in troggle filesystem
  • Explain how to add photos with the correct URL format to sub-HTML files attached to New Caves +
  • explain how to put stuff in the wallet folder and how to look at expofiles/photos/xml/ +
    Scans and Drawings Uploads +
  • Add to user data manual how to upload to expofiles - in the "survey manual" +
  • Add in description of *where* to put the drawings files +
    • svx check
  • explain command line to run on newly typed survex file to check for format errors '$cavern xxxx.svx'
  • explain when to use svxtrace.py current scripts
  • Making an svx - explain how to make link to *ref to wallet folder -
  • explain how to put stuff in the wallet folder and how to look at expofiles/photos/xml/ -
  • Add to user data manual how to upload to expofiles - in the "survey manual" -
  • Add in description of *where* to put the drawings files

    • Wallets re-programming

    Things wallets.py might do in future @@ -102,10 +104,7 @@ body {
    Areas (these are the sub-areas)
  • Downgrade the "areas" aspect of the documentation as we don't use these now
    • -
    Prospecting Guides & slippy map & GPS tracks - -
  • Redesign to be used as overlay on phone/tablet using essentials.gpx data -
    • +

    Photos

    Fix the BINS package (Wookey is looking for replacement) @@ -154,9 +153,7 @@ body {
  • Be exhaustive in checking all the broken links between svx & wallets
    • -
    non-troggle scripts -
  • DOCUMENT them all - have we got ? //expofiles/unidentified_scripts/ ! -
    • +
    Makefile
  • Get it working ! How many of other scripts should be in it ? Should we do data imports to schedule too ? @@ -164,6 +161,13 @@ body {

    • Troggle

    +
    admin links to fix password/username ALL BROKEN +
  • Links on http://localhost:8000/accounts/login/ lead to 404s +
    • + + +http://localhost:8000/accounts/login/ +
    QM links in cave descriptions ALL BROKEN
  • There are HREF links to individual QMs in the cave description in e.g. 204 Swings and Roundabouts such as "At the bottom there is a climb down over boulders [C2001-204-45 C]." where the troggle URL fails completely. @@ -202,11 +206,7 @@ body {
    document cgit installation and config
  • as per Wookey on new server Debian 10
    • -
    document directory structure -
  • as per Julian's GitHub list - then close that issue. - Use 'tee' to create ascii art for this. -
    • permissions
  • do we need a cron job or has the group membership fix fixed it ? either way, document it.
  • Makefile - and permissions. diff --git a/handbook/troggle/trogimport.html b/handbook/troggle/trogimport.html index f753ad167..9fde240ab 100644 --- a/handbook/troggle/trogimport.html +++ b/handbook/troggle/trogimport.html @@ -17,21 +17,24 @@ The python stand-alone script databaseRest.py imports data from files Usage is 'python databaseReset.py <command> [runlabel]' where command is: - reset - normal usage: clear database and reread everything from files - time-consuming - caves - read in the caves - logbooks - read in the logbooks - people - read in the people from folk.csv - QMs - read in the QM csv files (older caves only) - reinit - clear database (delete everything) and make empty tables. Import nothing. - scans - the survey scans in all the wallets - survex - read in the survex files - all the survex blocks but not the x/y/z positions - survexpos - just the x/y/z Pos out of the survex files - - tunnel - read in the Tunnel files - which scans the survey scans too + test - testing... imports people and prints profile. Deletes nothing. profile - print the profile from previous runs. Import nothing. + - del - deletes last entry + - delfirst - deletes first entry + + reset - normal usage: clear database and reread everything from files - time-consuming + + init - clear database (delete everything) and make empty tables. Import nothing. + caves - read in the caves + people - read in the people from folk.csv + logbooks - read in the logbooks + QMs - read in the QM csv files (older caves only) + scans - the survey scans in all the wallets + drawings - read in the Tunnel & Therion files - which scans the survey scans too + survex - read in the survex files - all the survex blocks and entrances x/y/z - test - testing... - + dumplogbooks - Not used. write out autologbooks (not working?) + and [runlabel] is an optional string identifying this run of the script in the stored profiling data 'import-profile.json' diff --git a/handbook/troggle/troglaptop.html b/handbook/troggle/troglaptop.html index 5eb3ab101..836d182f6 100644 --- a/handbook/troggle/troglaptop.html +++ b/handbook/troggle/troglaptop.html @@ -309,42 +309,48 @@ explains what this does and gives extra command line options.

    Now run the test suite: 

    python manage.py test -v 3 --traceback
    -

    This will run the entire troggle test suite of over 70 tests (it takes only a few seconds). +

    This will run the entire troggle test suite of over 70 tests (it takes only a few seconds). -

    -If you get an error, and you probably will, have a look in the test file, e.g. for this error:
-FAIL: test_page_folk (troggle.core.TESTS.tests.PageTests) 
-look in the file      troggle/code/TESTS/tests.py in the class PageTests.
+
    
+If you get an error, and you probably will, have a look in the source code of the test, e.g. for this error:
+
+
    FAIL: test_page_folk (troggle.core.TESTS.tests.PageTests) 
    
+look in the file      
+troggle/code/TESTS/tests.py in the class PageTests.
 It will also say:
-  File "/mnt/c/EXPO/troggle/core/TESTS/tests.py", line 266, in test_page_folk
-which means that the asssert failure in on line 266 of troggle/code/TESTS/tests.py
-and that the failure function is test_page_folk()
+
      File "/mnt/c/EXPO/troggle/core/TESTS/tests.py", line 266, in test_page_folk
    
+which means that the asssert failure in on line 266 of troggle/code/TESTS/tests.py
+and that the failure function is test_page_folk() .
 If you look at this you will see that line 264 is:
-        response = self.client.get('/folk/index.htm')
+
     response = self.client.get('/folk/index.htm')
    
 
 so this file is missing. Duh. Of course it is. We downloaded troggle from git but we didn't run
-the standalone script to generate the folk list. It is top of the list in
-http://expo.survex.com/handbook/troggle/scriptscurrent.html#folk
+the standalone script to generate the folk list. 
+The quickest thing to do when installing troggle is to simply download a copy from the server:
+
     wget -O ../expoweb/folk/index.htm expo.survex.com/folk/index.htm
    
+and run the tests again:
 
+
    python  manage.py test -v 2
    
+
+
    Click on the triangle to see how to run the folk script.
+
+The folk generation script is top of the list in
+
+
+http://expo.survex.com/handbook/troggle/scriptscurrent.html#folk
+
    
 So do this:
+
     cd ../expoweb/folk
 python ../scripts/make-folklist.py index.htm
 cd ../../troggle
-
-Or just sFTP a copy from expo.survex.com
-
-and run the tests again:
-
-python  manage.py test -v 2
-
-Yeah if you were paying attention, you will see that this has done a git commit for a test file
-in the drawings repo locally.
-Sorry about that. the test harness does not yet undo that. So you will need ot manually reverse that commit: go into your favourite git tool. In VS code the command is Commit: Undo last commit
-
-If you have run the test suite several times you will need to undo several commits (and delete the files producd by the test suite).
-
 
    
-
    The test suite has over 70 tests but does not cover all of what troggle does and does not use any real data. You need to manually test these too, after you have done a full data import:
+
+
    
+
+
    The test suite now tidies up after itself, so there should not be any temporary files left behind or local git commits that you will need to clean up.
+
+
    The test suite has over 70 tests but does not cover all of what troggle does and does not use any real data. You need to manually test these too, after you have done a full data import:
 
    - http://localhost:8000/pathsreport
 
    - http://localhost:8000/stats
 
    - http://localhost:8000/people (takes a minute or so)