iQvoc
iQvoc is a vocabulary management tool that combines easy-to-use human interfaces with Semantic Web interoperability.
iQvoc supports vocabularies that are common to many knowledge organization systems, such as:
- Thesauri
- Taxonomies
- Classification schemes
- Subject heading systems
iQvoc provides comprehensive functionality for all aspects of managing such vocabularies:
- import of existing vocabularies from a SKOS representation
- multilingual display and navigation in any Web browser
- editorial features for registered users
- publishing the vocabulary in the Semantic Web
iQvoc is built with state-of-the-art technology and can be easily customized according to user's needs.
Setup
Heroku
You can easily setup your iQvoc instance in under 5 minutes, we wanted to make this process really easy. In order to deploy to heroku you need to have an account and heroku toolbelt installed.
$ bundle install
$ heroku create
$ bundle exec rake heroku:config
$ git push heroku master
$ heroku run rake db:migrate
$ heroku run rake db:seed
$ heroku restart
heroku open
opens your app in the browser.
Remember to visit the Users section and change the default passwords!
Custom
We recommend running iQvoc as a Rails engine. Running the cloned source code is possible but any modifications would require a fork.
- Configure your database via
config/database.template.yml
. Don't forget to rename it todatabase.yml
- Run
bundle install
- Run
bundle exec rake db:create
to create the database - Create the necessary tables by running
rake db:migrate
- Load some base data by running
rake db:seed
- Run
bundle exec rake setup:generate_secret_token
- Boot up the app using
bundle exec rails s
(orpassenger start
if you use passenger) - Log in with "admin@iqvoc" / "admin" or "demo@iqvoc" / "cooluri" (cf. step #5)
- Visit the Users section and change the default passwords
Compatibility
iQvoc is fully compatible with Ruby 1.9, 2.0 and JRuby 1.7.
Customization
There are many hooks providing support for your own classes and configuration. The core app
also works as a Rails Engine. The config residing in lib/iqvoc.rb
provides a basic
overview of the possibilities.
Documentation
Documentation resources can be found in the wiki.
Contributing
If you want to help out there are several options:
- Found a bug? Just create an issue on the GitHub Issue tracker and/or submit a patch by initiating a pull request
- You're welcome to fix bugs listed under Issues
- Proposal, discussion and implementation of new features on our mailing list [email protected] or on the issue tracker
If you make changes to existing code please make sure that the test suite stays green. Please include tests to your additional contributions.
Tests can be run via bundle exec rake test
. We're using capybara-webkit for integration tests with JavaScript support.
Maintainer & Contributors
iQvoc was originally created and is being maintained by innoQ Deutschland GmbH.
- Robert Glaser (mrreynolds)
- Till Schulte-Coerne (tillsc)
- Frederik Dohr (FND)
License
Copyright 2013 innoQ Deutschland GmbH
Licensed under the Apache License, Version 2.0