Simple Knowledge Organisation Tool Files

A Simple Knowledge Organisation Tool (SKOT)
===============================================================================
This project is distributed as a jar file. You should be able to open the jar 
file directly or run `java -jar "SKOT.jar"` from the commandline. The program
will accept an optional single argument of a skot file to open. 

Starting:
When opened, the program will show a toolbar and three empty panes. The left 
pane is a word list, the middle pane contains the main diagram and the right
pane holds annotation details. To start, a list of comma-separated words can 
be entered in the entry box above the word list, and then dragged onto the 
diagram to make "blobs", which represent classes or instances. Blobs can be 
selected and moved around the diagram by clicking on them or dragging a box around
them. Extra blobs can be created quickly if needed by double-clicking on an 
empty space in the diagram and typing in a new name.

Relationships:
Blobs can be related to each other by using the different named relationship
buttons along the top. If some blobs are selected, then the relevant lines will 
be generated and the target blob for these lines can then be clicked on to complete
the operation. If no blobs are selected when the relationship button is clicked,
then the program will wait for a selection before creating the lines. 

There are a couple of extra restrictions on subclass and instantiation lines;
the program will try to avoid creating lines that create circular or transitive
subclass relationships. Blobs that are defined as named instances by being the 
subject of an instantiation line will be highlighted and should be unable to be the 
target of other lines.

Annotations:
The annotation pane on the right will show annotations for the most recently selected
object, or the ontology itself if no objects are selected. New annotations can be 
added by entering details on the blank annotation at the end of the list. Pressing
the edit button ("...") will bring up a window with more space to edit detailed 
annotations, and the delete button ("x") will delete that annotation. 

OWL Export:
Once the diagram structure is complete, the diagram can be exported to an OWL file
using the Export button. This will create a file with the same structure that can be
read by Protege. The ontology will have a base URI defined by the text field to 
the right of the toolbar.

OWL Import:
A *limited* import of OWL files is also available using the "Import OWL Entities"
button. This will grab a list of the defined classes in OWL file (apart from Thing)
and put them into the wordlist. New classes and relationships can be added, and when 
the file is exported back to OWL it will contain both the old ontology stucture 
and the newly added axioms.

Distribution
============

The project is currently distributed under LGPL -- sources should be available at 
https://subversion.assembla.com/svn/askot/ . The sources contain a Netbeans project,
and some of the files have sections that will be automatically updated by the 
Netbeans form editor, but these should be clearly marked.

Exceptions: Apache Commons libraries are distributed under the Apache License, 
OWL API files are always under the LGPL, the file ActionTableCellEditor.java
is always under the LGPL, and the icons in the resources/ folder are distributed
with a Creative Commons Attribution 2.5 license. See LICENSE.txt files for more 
information.