| 13 | | |
| 14 | | == Installing GenI == |
| 15 | | |
| 16 | | GenI can be installed either with or without a GUI. ''We strongly recommend doing the installation in two phases, first without the GUI and second with''. The GUI can be a bit tricky to install, so this two-phase approach should at least get you up and running with a console version fairly quickly. |
| 17 | | |
| 18 | | === Step 1: Install the non-graphical interface === |
| 19 | | |
| 20 | | 1. Install GHC 6.8.3 binary from [http://www.haskell.org/ghc/ GHC site] (Eric uses GHC 6.10; also, does the Haskell Platform work?) |
| 21 | | 1. Install [http://hackage.haskell.org/trac/hackage/wiki/CabalInstall cabal-install] |
| 22 | | 1. {{{cabal update}}} |
| 23 | | 1. {{{cabal install cabal-install}}} |
| 24 | | 1. {{{cabal install GenI}}} |
| 25 | | 1. make sure ${HOME}/.cabal/bin is in your path |
| 26 | | 1. make sure it works |
| 27 | | * {{{geni --unit-test}}} |
| 28 | | * {{{geni --help}}} for more details |
| 29 | | * Either retrieve the GenI tarball from hackage or darcs get the latest source and... |
| 30 | | * {{{geni -m examples/ej/macros -l examples/ej/lexicon -s examples/ej/suite}}} |
| 31 | | |
| 32 | | The instructions above assume you want the latest stable version of GenI. If you want to install the darcs version, instead of executing {{{cabal install GenI}}}, you can do {{{cd GenI; cabal install}}} |
| 33 | | |
| 34 | | === Step 2: Install with GUI === |
| 35 | | |
| 36 | | Warning, this part can be a little hairy because of the wxHaskell installation process. |
| 37 | | |
| 38 | | You can also customize this [wiki:GenI_installation_script]. |
| 39 | | |
| 40 | | 1. Please make sure you can install GenI without the GUI first. |
| 41 | | * If you do not succeed at installing without the GUI, '''stop''' and ask for help! |
| 42 | | * Doing so will help us to refine our install instructions, and most importantly save you a lot of time! |
| 43 | | 1. Install graphviz |
| 44 | | 1. Install wxWidgets 2.8 |
| 45 | | {{{ |
| 46 | | # easy way: ubuntu 9.04 (Jaunty) |
| 47 | | sudo aptitude install libwxgtk2.8-dev libglut-dev |
| 48 | | # NB: not sure if the libglut-dev is really necessary |
| 49 | | |
| 50 | | # hard way: elsewhere |
| 51 | | ./configure --enable-unicode |
| 52 | | make |
| 53 | | make install |
| 54 | | }}} |
| 55 | | 1. Install wxcore by hand |
| 56 | | * http://hackage.haskell.org/packages/archive/wxcore/0.11.1.2/wxcore-0.11.1.2.tar.gz |
| 57 | | * {{{runhaskell Setup configure; runhaskell Setup build; sudo runhaskell Setup install}}} |
| 58 | | 1. {{{cabal install GenI --flags=gui}}} |
| 59 | | 1. On MacOS X: |
| 60 | | * {{{cd ~/.cabal/bin; macosx-app geni}}} |
| 61 | | * make sure ${HOME}/.cabal/bin/geni.app/Contents/MacOS is in your path, before ${HOME}/.cabal/bin |
| 62 | | * Contact us on the MailingList if you need extra help. |
