summaryrefslogtreecommitdiff
path: root/src/server/README
diff options
context:
space:
mode:
authorbjorn <bjorn@bringert.net>2008-10-20 12:56:08 +0000
committerbjorn <bjorn@bringert.net>2008-10-20 12:56:08 +0000
commit9b8f50534c6497ee54c7eb90bf022010fc803dca (patch)
treec78f039c405d06e2cc512c9d8e46ba5430389fff /src/server/README
parentcec2b61af0a9dc392df20dbb601bb33858aac502 (diff)
Update gf-server instructions and configuration.
Diffstat (limited to 'src/server/README')
-rw-r--r--src/server/README42
1 files changed, 24 insertions, 18 deletions
diff --git a/src/server/README b/src/server/README
index 7e93cd41f..de3b19a20 100644
--- a/src/server/README
+++ b/src/server/README
@@ -1,49 +1,55 @@
== Requirements ==
-- cabal
+- cabal-install
* See quick installation instructions at the bottom of
http://hackage.haskell.org/trac/hackage/wiki/CabalInstall
- FastCGI development kit
- * MacPorts: sudo port install fcgi
-
-- Haskell packages: fastcgi, json, utf8-string
- * cabal install fastcgi json utf8-string
+ (MacPorts) $ sudo port install fcgi
- GF installed as a Cabal package
- * (cd ../.. && cabal install)
- * Maybe need to remove "-beta" from the Version field in ../../GF.cabal
+ $ (cd ../.. && cabal install)
-== Building ==
-- Build gf.fcgi
+== Building ==
-$ make
+- Build pgf.fcgi. This will use cabal to install the dependencies (cgi, fastcgi, json, utf8-string).
+ $ make
- Build small example grammar:
-
-$ make food
-
+ $ make food.pgf
+ $ cp food.pgf grammar.pgf
== Running (lighttpd) ==
- Install lighttpd
- - MacPorts:
- $ sudo port install lighttpd
+ (MacPorts) $ sudo port install lighttpd
- Run lighttpd:
- $ lighttpd -f lighttpd.conf -D
+ $ make run
+
+
+== Testing ==
- First test from the command-line, since debugging is harder from the AJAX UI:
- $ curl 'http://localhost:41296/gf/translate?input=this+fish&cat=Item&from=FoodEng'
+ $ curl 'http://localhost:41296/pgf/grammar.pgf/translate?input=this+fish&cat=Item&from=FoodEng'
+
+- Non-GWT AJAX UI:
+ See http://localhost:41296/simple-client.html
+
+- GWT AJAX UI:
+ See http://localhost:41296/gwt-client/www/se.chalmers.cs.gf.gwt_translate.Translate/Translate.html
+
+
-- Go to http://localhost:41296/simple-client.html in your web browser.
== Running (Apache) ==
+Note: This is more complicated, and the instructions may not be up to date.
+
- Make sure that your web server supports FastCGI. For Apache on OS X,
do this: