2
0
mirror of https://expo.survex.com/repositories/troggle/.git synced 2024-11-22 07:11:52 +00:00
Mirror of Troggle Repo but with issue tracking etc. https://expo.survex.com
Go to file
2014-09-10 23:46:05 +01:00
core Add 107 to notable caves (noting that this is hard-coded into 2014-07-28 01:21:24 +01:00
docsEtc [svn] Draft of paper for ICS. 2009-05-13 05:51:21 +01:00
export no need to export cavetab2 anymore 2012-06-10 17:20:57 +01:00
flatpages allow extensions to be capatalised 2012-08-14 15:05:15 +02:00
helper decorator to check if user is logged in if settings.PUBLIC_SITE 2011-05-02 02:13:27 +01:00
imagekit [svn] Switch from photologue to imagekit. Less bloat. 2009-05-13 06:24:52 +01:00
media Added redmund style for jquery-ui 2011-07-10 23:40:52 +01:00
parsers Allow comma in starcommands (*,fix) (comma is default valid *set blank) 2014-07-01 02:26:26 +01:00
profiles [svn] Brief code cleanup. 2009-07-03 05:31:49 +01:00
registration Document 'cavesnew' option in databasereset.py - which just reads in 2013-10-07 23:45:59 +01:00
templates Prospecting guide and images and few minor other things. 2013-08-01 17:00:01 +02:00
wiki Note that the instructions for adding a survey are all wrong. 2012-08-05 00:35:02 +02:00
__init__.py [svn] Initial troggle checkin 2009-05-13 05:13:38 +01:00
.hgignore Prospecting guide and images and few minor other things. 2013-08-01 17:00:01 +02:00
databaseReset.py Change databasereset to use 'caves' instead of 'cavesnew' for reloading the cave database 2014-07-28 00:18:10 +01:00
localsettingspotatohut.py Set potato hut localsettingsfile to have correct URLs 2014-07-23 09:47:48 +01:00
localsettingsserver.py Remove spurious real password from example localsettingserver.py file. 2014-06-26 02:35:37 +01:00
localsettingsubuntu.py Prospecting guide and images and few minor other things. 2013-08-01 17:00:01 +02:00
localsettingswindows.py Change database syntax to modern format as old style no longer 2013-07-02 18:13:27 +01:00
manage.py remove all the DOS linefeeds 2011-07-11 02:10:22 +01:00
middleware.py remove all the DOS linefeeds 2011-07-11 02:10:22 +01:00
modelviz.py modelviz added 2009-09-11 09:04:59 +01:00
README.txt Update the README file a bit - still needs work. 2014-09-10 23:46:05 +01:00
settings.py Prospecting guide and images and few minor other things. 2013-08-01 17:00:01 +02:00
urls.py Tidy up urls file a little 2014-05-14 20:46:59 +01:00
utils.py undosify lineends 2011-07-11 01:49:03 +01:00

Troggle is an application for caving expedition data management, originally created for use on Cambridge University Caving Club (CUCC)expeditions and licensed under the GNU Lesser General Public License.

Troggle has been forked into two projects. The original one is maintained by Aron Curtis and is used for Erebus caves. The CUCC variant uses files as the definitive data, not the database and lives at expo.sruvex.com/troggle.

Troggle setup
==========

Python, Django, and Database setup
-----------------------------------
Troggle requires Django 1.4 or greater, and any version of Python that works with it.
Install Django with the following command:

apt-get install python-django  (on debian/ubuntu)

If you want to use MySQL or Postgresql, download and install them. However, you can also use Django with Sqlite3, which is included in Python and thus requires no extra installation.



Troggle itself
-------------
Choose a directory where you will keep troggle, and svn check out Troggle into it using the following command:

svn co http://troggle.googlecode.com/svn/


If you want to work on the source code and be able to commit, you will need to use https instead of http, and your google account will need to be added to the troggle project members list. Contact aaron dot curtis at cantab dot net to get this set up.

Next, you need to fill in your local settings. Copy either localsettingsubuntu.py or localsettingsserver.py to a new file called localsettings.py. Follow the instructions contained in the file to fill out your settings.


Setting up tables and importing legacy data
------------------------------------------
Run "python databaseReset.py reset" from the troggle directory.

Once troggle is running, you can also log in and then go to "Import / export" data under "admin" on the menu.

Adding a new year/expedition requires adding a column to the
noinfo/folk.csv table - a year doesn't exist until that is done.


Running a Troggle server
------------------------
For high volume use, Troggle should be run using a web server like apache. However, a quick way to get started is to use the development server built into Django.

To do this, run "python manage.py runserver" from the troggle directory.