OWL Wiki Forms v0.1 instructions

Welcome to the OWL Wiki Forms instructions page. This page offers instructions for OWL Wiki Forms in the form of an example ontology editing session. It has a sequence of screen dumps with explanations. Users should be able to replicate this session after an OWL Wiki Forms v0.1 installation.

Source Ontology

This session is the entry of an ontology based on that of the ReSIST Courseware Ontology.

Online data browsing example

The following figure shows an example from this ontology: a data browsing page for a course at the Open University.

Protégé display of ontology

Here is a display from the ontology editing tool Protégé of the ReSIST Courseware Ontology. This shows the ontology that we will now used OWL Wiki Forms to enter on a semantic wiki.

owl:Class

Entering the class name

Go to the page Form:Category:owl:Class on your wiki and enter a new class name.

Form for owl:Class

Here you can enter values for various standard property. Here, we leave them empty and simply click "Save page".

Page display for an owl:Class

This is the page display that results after entering the new owl:Class. It shows table headers indicating that this is category represents and owl:Class.

owl:DatatypeProperty

Entering the datatype property name

Now go to the page Form:Owl:DatatypeProperty and enter the name for a new property.

Form for owl:DatatypeProperty

Enter some values for standard properties of this property. Be sure also to enter a value for Box order. In this example, we enter "Course" for rdfs:domain and select "Xsd:decimal" from the pull-down menu for rdfs:range. This has influence later on the generation of the form and infobox display for pages of type "Course". This is an OWL Wiki Forms property that determines the order in which property rows appear in forms and infoboxes. If this is left blank then the row will not appear at all. (In future version a blank Box order will no longer block inclusion).

Page display for an owl:DatatypeProperty

Generating the form and template for a class

Import code from Special:OWLwikiForms

To start the generation of the form and infobox for all classes, go to your wiki's special page Special:OWLwikiForms. Simply accessing this page will generate the XML import code in a file for you to download.

Save this file on your computer.

Import page on the wiki

Go to the page Special:Import on your wiki. Enter the pathname of your file in the filename field and click "Upload file".

The generated code for the new or updated form and infobox template have now been uploaded on your wiki. The form and template are ready for use.

Form and infobox for a page

Entering a page name as instance of a class

Go to Form page just generated or click to it from the import result display. Here the form page is Form:Course. Enter the name of a new instance for this class.

Form for an instance

Enter a number for the property.

Infobox for an instance

owl:ObjectProperty

Entering the object property name

Enter the name of a property (including the "Property:" wiki namespace) that you wish to make an object property.

Form for owl:ObjectProperty

As with the Form for owl:DatatypeProperty, enter values for "Box order" and (if desired) an rdfs:domain. Object property can have classes as ranges. In this example, we make "Course" the domain and "Person" the range to indicate that pages with a "Has-instructor" property are classes and what the property points to are persons.

Page display for owl:ObjectProperty

rdfs:range processing

Property value autocompletion

Because the property has-instructor has an rdfs:range of Person, autocompletion for this field uses names of instances of class Person on the wiki. However, this autocompletion is not exclusive: a value can be entered that is not the name of a person in the system.

Default forms in links to new pages

We have just entered as an instructor for the course a name that is not in the system. On MediaWiki, links to such non-existing pages have red font, as is the case here. This link is selected, and we see in the status bar on the bottom of the display that this link goes to a person form that adds a new person with this name. This is the result of processing the rdfs:range of Person that the property has-instructor has. Here, OWL Wiki Forms applies the Semantic Forms default form feature.

Default form called by link trigger

owl:SymmetricProperty processing

Checkbox for owl:SymmetricProperty

Here we enter a new property, give it a domain, range and box order, and indicate that it is symmetric by clicking on the owl:SymmetricProperty checkbox.

Adding annotation for a symmetric property

This figure shows the annotation of a page with the new symmetric property.

Annotation with default form link

Because we entered a non-existing page as the value for a property, that property's rdfs:range determines the default form triggered by the page's link.

New page across symmetric property displays symmetry

Starting a new page with a default form and using MediaWiki's "Show preview" feature shows how this page will appear with just the initial code. This display includes recognition of the symmetric property by showing the inference from the incoming annotation in the current infobox, even though the annotation is not on this page directly.