For directions on installing Touche, see that installation docs in the top level of this repository.

Using the Touche repository in a live system. After cloning the repository, it should be in a location that is not directly accessible to the web server you've installed. The easiest way to use the repository is to set up symbolic links in the right locations to the files inside. Here are the links that need to be done (all directories are relative to the contest user and assume the repository is in a directory named src):

mkdir public_html
ln -s ~/src/develop develop
ln -s ~/src/public_html public_html/develop
ln ~/src/createcontest.php public_html/createcontest.php
ln ~/src/createcontest2.php public_html/createcontest2.php
ln ~/src/index.html public_html/index.html
ln -s ~/src/dbcreate.sql public_html/dbcreate.sql
ln -s ~/src/readme public_html/readme
ln -s ~/src/lib public_html/lib    

suexec and userdir options must be active within Apache. We cannot use symbolic links for the createcontest scripts since they are directly executed by the web server and we use suexec, which doesn't work over links and so it needs to be hard linked. This probably isn't an issue since the two locations are probably on the same mount point. Otherwise, you'll have to use a copy instead. If you use a copy, be sure that any time those scripts are updated that they get copied into the web server spot properly and that can be easy to forget when using version control since it might not explicitly remind to do so.

More documents should be created and pointed to with this README!!!