Setting up the developer work enviroment

This document describes how to set up the basic work environment for Talia, so that you don't have to build any gems, and all the dependent packages can be used directly from the Source code version. Note that the talia_core is now in a separate git repository - see TaliaCoreRepo

Prerequisites

  • Ruby
  • Rails
  • Git
  • Bazaar (for ActiveRDF) (now only needed for re-syncing with the official ActiveRDF sources)
  • MySQL

Required Gems

  • mysql
  • builder
  • meta_project
  • uuidtools
  • progressbar

Using GIT

Talia is now using GitHub for the source control. If you haven't used GIT before, you may want to check out one of the following:

How to check out the sources

You can easily check out the sources from GitHub?, but you should remember some things:

  • You will need to update the submodules (which are a bit like svn externals) to get the included plugins
  • You may likely want to work on a different branch - the default branch is a generic default version.

Example: Checkout for discovery

Attention: This example uses the collaborator URL, which does not work for "outsiders" 

cd $TALIA_ROOT # This is the home directory for the entire project
git clone git@github.com:net7/talia.git talia_app
... bla bla ...
cd talia_app
; now we need to switch to the discovery branch 
git checkout --track -b discovery origin/discovery
; now we need to get the submodules
git submodule init
git submodule update

Now you'll be on the "discovery" branch, and have all the plugins that are connected to the source.

Installing Redland

(You'll only need to do this if you want to use the Redland RDF store)

In most Linux distributions you should be able to find a package for Redland or rdflib. Mac users can use MacPorts? to install the redland library, but you must enable the correct database driver(s) as (a) variant(s) for the port. This will also attempt to install the respective database (e.g. mysql) with MacPorts. If have already installed MySQL (for example from the downloadable binaries), you can also try to compile Redland manually.

At least the MacPorts version does not contain the language bindings for Redland. You can install it manually (The ruby calls are just to check the installation/adapter): 

tar xvzf redland-bindings-xxx.tgz
cd redland-bindings-xxx
./configure --with-ruby
cd ruby
make
ruby -I. -Ilib example.rb file:../data/dc.rdf rdfxml
make install
ruby example.rb file:../data/dc.rdf rdfxml

Once you have installed the bindings, you should be able to use the redland-mysql-adapter in ActiveRDF with: 

ConnectionPool.add(adapter = ConnectionPool.add_data_source :type => :redland,
           :name => 'dbl', :location => :mysql,
           :new => 'yes', :host => 'localhost', :database => 'rt',
           :user => 'root', :password => '12345')

Loading Demo Data

TBC