|
|
(One intermediate revision by one other user not shown) |
Line 1: |
Line 1: |
− | First look to the general information in the Manual.
| + | See https://github.com/leksah/leksah#getting-leksah |
− | | |
− | When you get the following error:
| |
− | src/IDE/Completion.hs:87:26:
| |
− | Not in scope: `sourceLanguageManagerGuessLanguage'</code>
| |
− | you have to install gtksourceview2 in a version > 2.4.0
| |
− | | |
− | When you get the following error:
| |
− | Linking dist/build/leksah/leksah ...
| |
− | /usr/bin/ld: cannot find -ledit
| |
− | collect2: ld returned 1 exit status</code>
| |
− | you have to install libedit development files.
| |
− | | |
− | The package type-level considered toxic!
| |
− | This package defines > 20000 newtypes for numbers and
| |
− | wastes a lot of space for metadata. So consider to
| |
− | unregister it, if you don't really need it.
| |
− | | |
− | == Installation of 0.6.1 on Windows from binary ==
| |
− | | |
− | There is a binary installer for Windows, that could be downloaded from [http://leksah.org leksah.org].
| |
− | Before using it, you need to install the [http://hackage.haskell.org/platform/ Haskell Platform] (tested with version 2009.2).
| |
− | | |
− | == Installation of 0.4.3 on Windows (Vista) from scratch ==
| |
− | | |
− | In the future when Leksah reaches production quality I hope we can provide a Windows installer.
| |
− | | |
− | 0. <tt>cabal-install</tt> was not working for me. Probably because currently there is no gtk2hs >= 0.10.0 on Hackage right now.
| |
− | | |
− | 1. Install your GHC from http://www.haskell.org/ghc. Duh. Mine was GHC 6.10.1.
| |
− | | |
− | 2. Install gtk2hs from http://www.haskell.org/gtk2hs/ or [http://sourceforge.net/project/showfiles.php?group_id=49207&package_id=42440 Sourceforge.net]. It was 0.10.0 when I checked.
| |
− | | |
− | 3. Install Cygwin with the online installer from http://www.cygwin.com/
| |
− | Select packages wget, curl and gcc-core in adition to the standard selection. I used the 1.7.0 version of Cygwin setup, but it is still beta.
| |
− | | |
− | 4*. Download darcs from http://wiki.darcs.net/DarcsWiki/Binaries, unpack it in under Program Files and add the path to your environment variables. The file I downloaded was darcsdir-cygwin-2.2.0.tar.bz2.
| |
− | | |
− | 5. Download the GHC sources from http://www.haskell.org/ghc. Open a Cygwin shell, make a directory Haskell, copy the source tarballs here and unpack them.
| |
− | | |
− | 6*. Download the binary and utf-8 packages from [http://hackage.haskell.org/packages/archive/pkg-list.html Hackage] and copy them to the Haskell folder. Open a Cygwin shell in Administrator mode and unpack the tar files. Go to the directories and do <tt>runhaskell Setup configure</tt>, <tt>runhaskell Setup build</tt>, <tt>runhaskell Setup install</tt>.
| |
− | | |
− | 7*. In the Haskell directory do a <tt>darcs get http://code.haskell.org/leksah</tt>. Go to the leksah directory and do a <tt>runhaskell Setup configure</tt>, <tt>runhaskell Setup build</tt>, <tt>runhaskell Setup install</tt>.
| |
− | | |
− | 7a) Although I probably didn't get this, previously some gtk error message was resolved by editting C:/Program Files/Gtk2Hs/0.10.0/etc/gtk-2.0/gtkrc and change the theme name from MS-Windows to Raleigh: <tt>gtk-theme-name = "Raleigh"</tt>
| |
− | | |
− | 8. You may wish to install a full Unicode monospace font if you want to use the source candy feature of leksah. e.g. [http://www.evertype.com/emono/ Everson Mono] or [http://dejavu-fonts.org/wiki/index.php?title=Download Deja Vu Sans Mono] (or perhaps the [http://www.gnu.org/software/freefont/ GNU FreeFont]s which are aesthetically pleasing to my eyes).
| |
− | | |
− | 9. Start leksah and give your Haskell directory as source root. Select the right font from Help/Prefs.
| |
− |
| |
− | 10. Have fun with leksah, but remember it is a beta version!
| |
− | | |
− | NB* I actually experienced a bit of a problem here, darcs was taking too much time. While in Cygwin, I cabal-installed it! Voila! So the starred portions are actually unnecessary, I think.
| |
− | | |
− | == Installation of 0.6.1 on Ubuntu 9.04 ==
| |
− | | |
− | Built in Ubuntu 9.04 using GHC 6.10.4 from
| |
− | [https://launchpad.net/~someone561/+archive/ppa Someone561's PPA]. cabal-install was bootstrapped using original ghc from the distribution, because of
| |
− | dependency problems. GHC 6.10.4 was installed afterwards.
| |
− | | |
− | === Install cabal-install from [http://hackage.haskell.org/trac/hackage/wiki/CabalInstall CabalInstall] ===
| |
− | === Upgrade GHC to 6.10.4 ===
| |
− | === Install gtk2hs ===
| |
− | $ sudo aptitude build-deb libghc6-gtk-dev
| |
− | $ sudo aptitude install libgtk2.0-dev libgtksourceview2.0-dev libcairo2-dev checkinstall
| |
− | | |
− | in gtk2hs sources:
| |
− | | |
− | $ ./configure
| |
− | $ make
| |
− | $ checkinstall
| |
− | | |
− | (say 'n' to question about making docs. checkinstall makes a deb package gtk2hs that could be easily uninstalled - normally you could do make install)
| |
− | | |
− | === Install Leksah using cabal ===
| |
− | | |
− | $ cd ~/.cabal/bin
| |
− | $ ./cabal update
| |
− | $ ./cabal install leksah
| |
− | Resolving dependencies...
| |
− | cabal: cannot configure regex-compat-0.92. It requires regex-base >=0.93
| |
− | For the dependency on regex-base >=0.93 there are these packages:
| |
− | regex-base-0.93 and regex-base-0.93.1. However none of them are available.
| |
− | regex-base-0.93 was excluded because regex-base-0.72.0.2 was selected instead
| |
− | regex-base-0.93 was excluded because leksah-0.6.0 requires regex-base ==0.72.0.2
| |
− | regex-base-0.93.1 was excluded because regex-base-0.72.0.2 was selected instead
| |
− | regex-base-0.93.1 was excluded because leksah-0.6.1 requires regex-base 0.72.0.2
| |
− | | |
− | To solve these dependency problems, we need to add some constraints to the installation process like so:
| |
− | | |
− | $ ~/.cabal/bin/cabal install --constraint='regex-posix ==0.72.0.3' --constraint='regex-compat ==0.71.0.1' leksah
| |
− | | |
− | === running the IDE ===
| |
− | | |
− | Leksah should now work. If you have problems running with config from older version, consider removing the old configuration:
| |
− | | |
− | $ rm ~/.leksah -r
| |
− | | |
− | To start the IDE:
| |
− | | |
− | $ export PATH=$PATH:~/.cabal/bin
| |
− | $ leksah
| |
− | | |
− | == Installation of 0.4.4.1 on Ubuntu 8.10 ==
| |
− | | |
− | Hello, I've installed Leksah 0.4.4.1 today in Ubuntu 8.10. This
| |
− | procedure is based on the one given in the manual, but uses GHC 6.10.2.
| |
− | Hope it will be useful. (Maciej Noszczyński)
| |
− | | |
− | <hask>
| |
− | # setup
| |
− | cd ~
| |
− | mkdir ghc-build
| |
− | cd ghc-build
| |
− | | |
− | # compile ghc 6.10.2
| |
− | sudo aptitude build-dep ghc6
| |
− | wget http://www.haskell.org/ghc/dist/6.10.2/ghc-6.10.2-src.tar.bz2
| |
− | wget http://www.haskell.org/ghc/dist/6.10.2/ghc-6.10.2-src-extralibs.tar.bz2
| |
− | tar jxf ghc-6.10.2-src.tar.bz2
| |
− | tar jxf ghc-6.10.2-src-extralibs.tar.bz2
| |
− | cd ghc-6.10.2/
| |
− | ./configure --prefix ~/ghc
| |
− | make
| |
− | make install
| |
− | cd ..
| |
− | | |
− | # cleanup and setup paths
| |
− | sudo aptitude remove ghc6
| |
− | export PATH=$PATH:/home/username/ghc/bin:/home/username/.cabal/bin
| |
− | (you should put this export into some startup file e.g. .bash_profile
| |
− | and source it when needed)
| |
− | | |
− | # gtk2hs from darcs (> 0.10.0) is needed for 6.10.2
| |
− | sudo aptitude install darcs
| |
− | darcs get --partial http://code.haskell.org/gtk2hs/
| |
− | aptitude install happy alex libglib2.0-dev libgtk2.0-dev
| |
− | libgtksourceview2.0-dev libgmp3-dev autoconf libtool
| |
− | cd gtk2hs
| |
− | autoreconf
| |
− | ./configure
| |
− | make
| |
− | sudo make install
| |
− | cd ..
| |
− | | |
− | # cabal install
| |
− | wget
| |
− | http://hackage.haskell.org/packages/archive/cabal-install/0.6.2/cabal-install-0.6.2.tar.gz
| |
− | tar zxf cabal-install-0.6.2.tar.gz
| |
− | cd cabal-install-0.6.2
| |
− | ./bootstrap.sh
| |
− | cd ..
| |
− | | |
− | # build and install Leksah
| |
− | wget
| |
− | http://hackage.haskell.org/packages/archive/leksah/0.4.4.1/leksah-0.4.4.1.tar.gz
| |
− | tar zxf leksah-0.4.4.1.tar.gz
| |
− | cd leksah-0.4.4.1
| |
− | mv leksah.cabal leksah.cabal.old
| |
− | sed -e 's/Cabal ==1.6.0.1/Cabal >=1.6.0.1/g' leksah.cabal.old > leksah.cabal
| |
− | cabal update
| |
− | cabal install binary
| |
− | cabal install utf8-string
| |
− | runhaskell Setup configure --user
| |
− | runhaskell Setup build
| |
− | runhaskell Setup install
| |
− | cd ..
| |
− | | |
− | # run the IDE
| |
− | leksah
| |
− | </hask>
| |
− | | |
− | == Running ==
| |
− | | |
− | To run Leksah after installation using cabal, you could use this simple script:
| |
− | #!/bin/bash
| |
− | | |
− | export PATH=$PATH:~/.cabal/bin
| |
− | leksah &> ~/leksah.log
| |
− | | |
− | Leksah outputs quite a lot of useful information to stdout at the moment, so it might
| |
− | be useful to watch the log by issuing
| |
− | $ tail -f ~/leksah.log
| |
− | in the terminal window.
| |
− | | |
− | If you want a nice icon for graphical environment shortcut, you could use ''data/leksah.png''.
| |
− | | |
− | '''WARNING''': Running leksah 0.6.1 from GNOME accelerator without terminal seemed to crash the whole X session
| |
− | for me (MNo) after a while of editing.
| |
− | If you have the same problem, you might be better off without output redirection ("&> ~/leksah.log") and
| |
− | setting accelerator type to "terminal program".
| |