README - Mezuro Plugin ====================== Mezuro is a source code tracking platform based on Noosfero social networking platform with Mezuro Plugin actived to access Kalibro Web Service. INSTALL ======= Dependences ----------- See the Noosfero INSTALL (and HACKING) file. After install Noosfero, you must install Mezuro dependences: $ gem install --no-ri --no-rdoc nokogiri -v 1.5.0 $ gem install --no-ri --no-rdoc wasabi -v 2.0.0 $ gem install --no-ri --no-rdoc savon -v 0.9.7 $ gem install --no-ri --no-rdoc googlecharts $ gem uninstall rack $ gem install --no-ri --no-rdoc rack -v 1.0.1 *with RVM* if you want to use RVM (Ruby Version Manager) environment, just run: $ plugins/mezuro/script/install/install-rvm.sh Enable Mezuro Plugin -------------------- Also, you need to enable Mezuro Plugin at your Noosfero installation: cd ./script/noosfero-plugins enable mezuro Install Service --------------- To run Mezuro (Noosfero with Mezuro Plugin), you need to install the Kalibro Service. For that, see: https://gitorious.org/kalibro/kalibro/blobs/master/INSTALL Configure Service Address ------------------------- Addictionaly, copy service.yml.example to service.yml and define your Kalibro Service address: $ cd /plugin/mezuro $ cp service.yml.example service.yml If you install Kalibro Service at localhost, just keep the default adress: http://localhost:8080/KalibroService/ Set Licences list ----------------- $ cd /plugin/mezuro $ cp licence.yml.example licence.yml Apply Mezuro Theme --------------------- (Our RVM install script already do that) If you want, you can use the Mezuro default theme: $ cd public/designs/themes && rm -f default $ git clone git://gitorious.org/mezuro/mezuro-theme.git $ ln -s mezuro-theme/ default && cd ../../../ Active Mezuro Plugin on Noosfero Environment -------------------------------------------- As a Noosfero administrator user, go to administrator panel: - Click on "Enable/disable plugins" option - Click on "Mezuro Plugin" check-box DEVELOPMENT =========== Get the Mezuro (Noosfero with Mezuro Plugin) development repository: $ git clone https://gitorious.org/+mezuro/noosfero/mezuro $ cd mezuro $ git checkout mezuro Running Mezuro tests -------------------- $ rake test:noosfero_plugins:mezuro or just: $ rake test:noosfero_plugin_mezuro:units $ rake test:noosfero_plugin:mezuro:functionals Get Involved ============ If you found any bug and/or want to collaborate, please send an e-mail to paulo@softwarelivre.org LICENSE ======= Copyright (c) The Author developers. See Noosfero license. AUTHORS ======= Please, see the Mezuro AUTHORS file. ACKNOWLEDGMENTS =============== The authors have been supported by organizations: University of São Paulo (USP) FLOSS Competence Center http://ccsl.ime.usp.br Brazilian National Research Council (CNPQ) http://www.cnpq.br/