Installation

Linux (???)

Can someone write installation instructions for Linux? Please specify distro and version, how to install the necessary libs and gems, etc. Thanks!

Tested on Mac OSX 10.7 "Lion" and partially in OSX 10.8 "Mountain Lion"

You should have GCC 4.3+ to install the packages. Install Xcode from the Mac App Store and the command line applications [need more information here]. Now, install homebrew and the necessary formulas:

1. Install Homebrew /usr/bin/ruby -e "$(curl -fsSL https://raw.github.com/gist/323731)"
2. Install gtk+ brew install gtk+
3. Install gsl brew install gsl
4. Install gtksourceview brew install gtksourceview
5. Install librsvg brew install librsvg
6. Install imagemagick brew install imagemagick

There are some errors you might run into during the above process:

1. If gtk+ fails to install, try to set the LANG environment variable to "en_US.UTF-8" and run it again. export LANG="en_US.UTF-8"

2. If librsvg fails to install, try to set write permission to the following file(path might change based on current version that you're installing) chmod +w /usr/local/Cellar/gdk-pixbuf/2.23.5/lib/gdk-pixbuf-2.0/2.10.0/loaders.cache

3. The gsl (1.14.7) gem can fail to install due to the Homebrew library being on version 1.15. To resolve this, uninstall the library (brew uninstall gsl) and edit the formula (brew edit gsl) to download version 1.14. The md5 hash will need to be modified to be e1a600e4fe359692e6f0e28b7e12a96681efbe52 to match the 1.14 download.

4. If you have problems related to imagemagick after having installed it via the above method, use the following command: brew install imagemagick --disable-openmp --build-from-source, as said in #25 or originally in this Stackoverflow question.

5. There are some problems with gtksourceview in Mountain Lion due to the system having dropped some .pc files from /usr/lib/pkgconfig related to libxml2. The solution found in issue #25 by @smackesey was to install it via homebrew with brew install libxml2 and symlink the libxml2-0.pc file into the correct directory:

sudo ln -s /usr/local/Cellar/libxml2/2.9.0/lib/pkgconfig/libxml-2.0.pc /usr/lib/pkgconfig

This directs gtksourceview to the libxml version installed via Homebrew rather than the system version, which might cause problems. Please open an issue in the tracker if you find anything.

C. Clone the repository on Github and bundle install

1. Clone the SciRuby repository git clone https://github.com/SciRuby/sciruby.git

2. cd into it. cd sciruby

3. Install bundler if you already don't have it gem install bundler

4. Execute bundle install bundle install

5. Execute the rake task bundle exec rake newb