How be a Abelo developer
1. Open Development List
Join the Abelo Project: check out this guide and get involved in the official abelo development list !
2. Getting the source code
There are two ways to get the source code.
2.1. SVN Repository
svn co
http://svn.colivre.coop.br/svn/abelo/trunk abelo
2.2. Tarballs
On topic
MilestoneItems look to Achieved milestones and click on the tarball version wanted.
3. How to run the system
To run the system first solve the dependencies problems and follow the steps on "Running the system".
3.1. System Dependencies
Here we describe some dependencies of the system and how to solve it.
3.1.1. RCov
More information about rcov.
http://eigenclass.org/hiki.rb?rcov+0.1.0+prerelease
To install rcov on debian system run the command:
aptitude install rcov
3.1.2. libferret
The libferret isn't available as a debian package yet.
If you know how to build debian system you can get the source code fo this package here:
http://svn.debian.org/wsvn/pkg-ruby-extras/packages-wip/
If you don't now how to build a debian package you can install this lib with gem, using the command:
gem install ferret
3.1.3. libgettext
THe internacionalization solution used by abelo is gettext. So it's a dependence of the system.
On debian use the command.
aptitude install libgettext-ruby
3.2. About the system
3.2.1. Configure Database
See the file:
config/database.yml
and config your database.
We sugest sqlite3 database to development. So using sqlite3 your database.yml file will be something like this:
# MySQL (default setup). Versions 4.1 and 5.0 are recommended.
#
# Install the MySQL driver:
# gem install mysql
# On MacOS X:
# gem install mysql -- --include=/usr/local/lib
# On Windows:
# There is no gem for Windows. Install mysql.so from RubyForApache.
# http://rubyforge.org/projects/rubyforapache
#
# And be sure to use new-style password hashing:
# http://dev.mysql.com/doc/refman/5.0/en/old-client.html
development:
adapter: sqlite3
database: tmp/abelo_development.db
# Warning: The database defined as 'test' will be erased and
# re-generated from your development database when you run 'rake'.
# Do not set this db to the same as development or production.
test:
adapter: sqlite3
database: tmp/abelo_test.db
production:
adapter: sqlite3
database: tmp/abelo_production.db
3.2.2. Configuring Enviroment
On file:
config/envoriment.rb
Look at the line with the content
# ENV['RAILS_ENV'] ||= 'production'
In this case the line is commented so the system is going to use the development database to run. If it was uncomment the system is going to run on production mode using the production database.
3.2.3. Running the system
run the command:
rake db:migrate
If everything is all right, run the script
./script/server
The webrick server will run on port 3000.
Open your firefox
on the address:
localhost:3000
3.2.4. Running the test
run the command:
rake db:test:prepare
to create and prepare the database test.
after this run the command:
rake test
