From: tla <tla@mit.edu>
Date: Sun, 27 Oct 2013 13:32:21 +0000 (+0100)
Subject: initial installation instructions for Stemmaweb
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=903cd6eed525838fcdf2dd6008fe90db52e77182;p=scpubgit%2Fstemmaweb.git

initial installation instructions for Stemmaweb
---

diff --git a/README b/README
deleted file mode 100644
index 922553b..0000000
--- a/README
+++ /dev/null
@@ -1 +0,0 @@
-Run script/stemmaweb_server.pl to test the application.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b5c4929
--- /dev/null
+++ b/README.md
@@ -0,0 +1,44 @@
+
+Stemmaweb - a Catalyst webservice for text tradition analysis
+=============================================================
+
+Stemmaweb is a web application, developed in Perl (using the Catalyst framework) and Javascript (using JQuery), 
+
+
+Installation 
+------------
+
+To run Stemmaweb you need a working Perl installation (5.12 or above)
+and, preferably, a working webserver. The following steps will get you
+set up to run the standalone service:
+
+* Ensure that the following software is installed (the list given is that of the relevant Ubuntu packages):
+  * gcc
+  * make
+  * libxml2-dev
+  * zlib1g-dev
+  * libexpat1-dev
+  * graphviz
+  * libssl-dev
+  * libgmp-dev
+* Install the following Perl modules:
+  * App::cpanminus
+  * Module::Install::Catalyst
+* Create a database for the storage of text tradition data. This can be anything supported by Perl's DBI.
+* Install the dependencies for Stemmaweb from this directory: 
+
+		cd /PATH/TO/stemmaweb && cpanm -S --installdeps .
+* Make a test directory and test the installation at http://localhost:3000/ :
+
+		script/maketestdb.pl
+		script/stemmaweb_server.pl
+* Replace the database settings in stemmaweb.conf with the settings for your database. If you are using MySQL, for example, the settings might look like this:
+
+		<model_args>
+		dsn dbi:mysql:dbname=stemmaweb
+		<extra_args>
+			user STEMMAWEB_USER
+			password STEMMAWEB_PASS
+		</extra_args>
+		</model_args>
+* (Optionally) configure Stemmaweb to run under FastCGI, Plack, or any other Catalyst-compatible application framework. See http://www.catalystframework.org for more information.
\ No newline at end of file