Annotation Tool

The PCPACK Annotation Tool provides a flexible approach to describing knowledge objects. The tool allows a page of information to be created and edited for each knowledge object (e.g. concept, attribute, task).

The tool uses dynamic-html which allows knowledge captured in other PCPACK tools to be automatically displayed in the annotation page.

The user can enter text or pictures to annotate what is known about that particular knowledge object. The tool is in a hypertext format, hence words can be highlighted and linked to other pages. This allows web-like knowledge-structures to be constructed that can be based on the hierarchies produced in the Ladder tool.

An example of an annotation page is shown below.


Annotation Templates

An important feature of the Annotation Tool is the use of annotation templates. An annotation template can be created for each class of knowledge objects. The structure of each page in the class can be set-up just once using the template for that class. On creation of a new page in the class, rather than have a blank page, the structure will be present based on the template.

An example of an annotation template is shown below.

As well as text, tables and images, annotation templates also include special commands (contained in square brackets). These commands automatically insert information from the knowledgebase into the page whenever it is opened. Some examples of these commands are shown in the following table.

 Example

Automatic Insert

[Objectclass]

Inserts the class to which the page's object belongs, e.g for the page "car" this would automatically insert "land-based vehicle".

[x-is a]

Inserts any knowledge objects that are types of the page's object. e.g. for the page "land-based vehicle" this would automatically insert "car", "lorry", "bicycle", etc.

[made of-x]

Inserts any knowledge objects that are linked by the "made of" relation. e.g. for the page "tyre" this would automatically insert "rubber compound".

[x-part of,B]

Inserts any knowledge objects that are linked by the "part of" relation as a bulleted list. e.g. for the page "car" this would automatically insert parts of the car, such as "chassis" and "engine" .

[Attribute-colour]

Inserts the value of the attribute "colour", e.g. for the page "polar bear" this would automatically insert "white".

[Markup]

Inserts a table showing where the object was marked-up using the Protocol Tool.

[Attributes]

Inserts a table showing all attributes and values associated with the page's object.

[Relations]

Inserts a table showing all the relationships that the object has with other objects.

Note: In this table, the items shown in italics are examples only, and are user-defined.


Basic Features

  • Easy-to-use html editor (or code editing option)
  • Automatic entries from the knowledgebase
  • Designable templates that inherit to descendents
  • Text, tables, images, hyperlinks


User Interface

The user interface of the Annotation Tool is explained below.



Other PCPACK tools:

Go to: Protocol Tool
Go to: Ladder Tool
Go to: Diagram Tool
Go to: Matrix Tool
Go to: Publisher Tool
Go to: Diagram Template Tool


Last modified: 22 July 2004