Comparing version 28 and version 27 back

The Semantic Web on Rails Development (SWORD) plugin eases the development of semantic web applications. SWORD is a ruby-on-rails that provides scaffolding based on semantic web information.

h1. Overview

SWORD allows you to generate a controller, model and views for managing one type of semantic web data, such as a foaf:Person. The controller offers actions such as list all people, search a person, fetch online semantic web information about people, and show/edit/update specific people.  The generator also creates an ActiveRDF model for foaf:Person and basic views for each action.
Based on these files automatically generated files, the application developer can further configure, enhance, and develop his application.

h1. Example: a foaf editor and viewer

h2. current way of installing and trying SWORD

    $

First, haveyou rapperneed installed, see http://librdf.org.
    $ gemto install --include-dependencies'rapper' rails
    $from gemhttp://librdf.org. installOn --include-dependenciesDebian activerdf-rdflite
    $it's railsin test-app
    $the cd'raptor-utils' test-app/vendor/plugins
    $ bzr get http://bazaar.launchpad.net/~activerdf/sword/dev/ sword
    $ cd ../../
    $ ./script/generate scabbard person foaf http://xmlns.com/foaf/0.1/
    $ ./script/serverpackage.

First youThen create an (empty) rails app, and then you can download the SWORD plugin (the bzr repository only contains the plugin, not the full application anymore). After that you can create rails model, view and controller for a specific RDF Schema, of which you must provide a location. In the abovebelow example, a MVC iswill be created for FOAF::Person.

    $ have rapper installed, see http://librdf.org.
    $ gem install --include-dependencies rails
    $ gem install --include-dependencies activerdf-rdflite
    $ rails test-app
    $ cd test-app/vendor/plugins
    $ bzr get http://bazaar.launchpad.net/~activerdf/sword/dev/ sword
    $ cd ../../
    $ ./script/generate scabbard person foaf http://xmlns.com/foaf/0.1/
    $ ./script/server

Done! The application runs and is fully functional, allowing users to fetch foaf data from the web, to  search, display, and edit information about people.

h2. Generated files

The scabbard generator constructs the following files (for the example of foaf:Person):

    app/controllers/people_controller.rb
    app/models/person.rb
    app/views/people/edit.rhtml
    app/views/people/list.rhtml
    app/views/people/new.rhtml
    app/views/people/show.rhtml

h1. Getting involved

* code repository "online":https://launchpad.net/~activerdf/+branch/sword/dev, using "bazaar":http://bazaar-vcs.org
* bugs reports on http://launchpad.net/products/sword
* mailing list on http://lists.deri.org/mailman/listinfo/swaf