View source for 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 [http://courseware.rkbexplorer.com/ontologies/courseware ReSIST Courseware Ontology].

=== Online data browsing example ===

The following figure shows an example from this ontology: a [http://data.open.ac.uk/page/course/m366.html data browsing page for a course at the Open University].

http://is.cs.ou.nl/OWF/files/Slide0003_image003.png

=== Protégé display of ontology ===

Here is a display from the ontology editing tool Protégé of the [http://courseware.rkbexplorer.com/ontologies/courseware ReSIST Courseware Ontology].  This shows the ontology that we will now used OWL Wiki Forms to enter on a semantic wiki.

http://is.cs.ou.nl/OWF/files/Slide0006_image005.png

== owl:Class ==


=== Entering the class name ===

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

http://is.cs.ou.nl/OWF/files/Slide0007_image009.png

=== Form for owl:Class ===

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

http://is.cs.ou.nl/OWF/files/Slide0008_image011.png

=== 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.

http://is.cs.ou.nl/OWF/files/Slide0009_image013.png

== owl:DatatypeProperty ==


=== Entering the datatype property name  ===

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

http://is.cs.ou.nl/OWF/files/Slide0010_image015.png

=== 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).

http://is.cs.ou.nl/OWF/files/Slide0011_image017.png

=== Page display for an owl:DatatypeProperty ===

http://is.cs.ou.nl/OWF/files/Slide0016_image019.png

== 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.  

http://is.cs.ou.nl/OWF/files/File_download.png

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".   

http://is.cs.ou.nl/OWF/files/Import_pages.png

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.

http://is.cs.ou.nl/OWF/files/Slide0019_image022.png

== 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.

http://is.cs.ou.nl/OWF/files/Slide0020_image024.png

=== Form for an instance ===

Enter a number for the property.

http://is.cs.ou.nl/OWF/files/Slide0021_image026.png

=== Infobox for an instance ===

http://is.cs.ou.nl/OWF/files/Slide0022_image028.png

== 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.

http://is.cs.ou.nl/OWF/files/Slide0023_image030.png

=== Form for owl:ObjectProperty  ===

As with the [[#Form for owl:DatatypeProperty|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.

http://is.cs.ou.nl/OWF/files/Slide0024_image032.png

=== Page display for owl:ObjectProperty ===

http://is.cs.ou.nl/OWF/files/Slide0025_image034.png

== 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.

http://is.cs.ou.nl/OWF/files/Slide0026_image036.png

=== 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.

http://is.cs.ou.nl/OWF/files/Slide0027_image038.png

=== Default form called by link trigger ===

http://is.cs.ou.nl/OWF/files/Slide0028_image040.png

== 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.

http://is.cs.ou.nl/OWF/files/Slide0029_image042.png

=== Adding annotation for a symmetric property ===

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

http://is.cs.ou.nl/OWF/files/Slide0030_image044.png

=== 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.

http://is.cs.ou.nl/OWF/files/Slide0031_image046.png

=== 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.

http://is.cs.ou.nl/OWF/files/Slide0032_image048.png