Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
iQvoc - A SKOS(-XL) Vocabulary Management System for the Semantic Web

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.md

iQvoc

Gem Version Build Status Code Climate

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
$ heroku config:add HEROKU=true RAILS_ENV=heroku RACK_ENV=heroku SECRET_KEY_BASE=$(bundle exec rake secret)
$ 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.

  1. Configure your database via config/database.template.yml. Don't forget to rename it to database.yml
  2. Run bundle install
  3. Run bundle exec rake db:create to create the database
  4. Create the necessary tables by running rake db:migrate
  5. Load some base data by running rake db:seed
  6. Make sure you have got config/secrets.yml in place
  7. Boot up the app using bundle exec rails s (or passenger start if you use passenger)
  8. Log in with "admin@iqvoc" / "admin" or "demo@iqvoc" / "cooluri" (cf. step #5)
  9. Visit the Users section and change the default passwords

Background Jobs

Note that some features like "Import" and "Export" exposed in the Web UI store their workload as jobs. You can either issue a job worker that runs continuously and watches for new jobs via

$ rake jobs:work

or process jobs in a one-off way (in development or via cron):

$ rake jobs:workoff

Compatibility

iQvoc is fully compatible with Ruby 1.9, 2.0, 2.1 and JRuby 1.7 (in Ruby 1.9-mode).

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.

Versioning

Releases will follow a semantic versioning format:

<major>.<minor>.<patch>

For more information on SemVer, visit http://semver.org/.

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 [iqvoc@lists.innoq.com] 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 Poltergeist for integration tests with JavaScript support.

Maintainer & Contributors

iQvoc was originally created and is being maintained by innoQ Deutschland GmbH.

License

Copyright 2014 innoQ Deutschland GmbH.

Licensed under the Apache License, Version 2.0.

Something went wrong with that request. Please try again.