Opening a topic

Revision as of 18:33, 22 October 2007

In order to take a closer look at the topic you need to open it into a topic panel. There exists many different procedures to open a topic for detailed inspection in Wandora. Topic is opened for example:

• Clicking Open or Arrow button in button bar.
• Selecting Open topic from Topics menu or pressing Ctrl-O.
• Double clicking topic in topic tree or topic table.
• Selecting Open topic in context menu opened in topic tree.
• Selecting Open in context menu opened in topic table.

Some times it may be necessary to close the topic in topic panel. Topic is closed by selecting Close topic from Topics menu or pressing Ctrl-W.

Modifying base names

Topic's base name is modified by changing the contents of base name text field in topic panel. Emptying field removes the base name. Wandora topic may have only one unscoped base name. Wandora application represents topics with base name by default and it is recommended that all topic's have base name.

Addition to direct topic panel editing base name can also be modified within topic tree triple clicking the topic in tree. Operation changes topic's base name label into an editable base name field.

Topics > Base name menu contains more advanced base name editing options. Menu contains tool to remove new line characters in base name and tool to make base name out of subject identifier for example.

We strongly encourage you not to use new line characters in base name's as Wandora's base name field does not support the character.

Modifying subject locators

Common method to modify subject locator is to a open topic to topic panel and edit subject locator field. Emptying the field removes topic's subject locator. Topic may contain only one subject locator in Wandora.

Subject locator icon is shown at the top of topic panel. Subject locator icon depends on the type of subject locator file. If subject locator resolves image, subject locator icon views the image. Right clicking the image icon reveals context menu with tools for the subject locator. For images the context menu contains tools to resize image, copy image, save image etc.

Advanced subject locator tools locate in Topics > Subject locator menu. Advanced tools enable the user to check subject locator URL, download subject locator files and construction of subject locators for example.

Modifying variant names

Variant names operate as language and scope dependent topic names. This is slightly different from the topic map standard where variant names play modest role compared to base names. Variant names are modified directly in topic panel.

For more advanced variant name operations use tools in Topics > Variant names.

By default Wandora supports four scopes (ie. languages) of Finnish, Swedish, English, and Language Independent. By default Wandora also supports two name types of Display name and Sort name. Extending the language and the name type support is very easy. To add another language add new instance topic to Wandora language topic. To add another name type add new instance to topic Wandora variant name version. Both Wandora language and Wandora variant name version are instances of Schema type topic. Although Wandora views only variant names of registered scopes and types, other names remain intact in the topic map.

By default topic panel's variant name matrix has language paragraphs. Orientation of name matrix is changed with Flip name matrix tool found in context menu of Variant names title header.

Variant names should not contain new line characters because Wandora's variant name field contain single row.

Modifying subject identifiers

Topic panel doesn't allow direct edition of subject identifiers. To change subject indentifier you need to add new subject identifier to the topic and then remove the old one. This rather illogical order of actions is required because topic must always hold at least one subject identifier. If you remove topic's last subject identifier a default subject identifier is added to the topic.

Subject identifier is removed by clicking Delete button beside the identifier. Subject identifier is added to a topic by selecting Add subject identifier in context menu of the Subject Identiers title header.

More advanced tools to modify subject identifiers is found in Topics > Subject identifiers menu.

Modifying topic classes

Class is a topic that describes the type of the topic. Each topic may contain zero or more classes.

Class is added to a topic by right-clicking the title header Classes and selecting Add class. Operation employs pick-a-topic-type window used to point the topic class. Topic's class is deleted selecting a row in the class table, right-clicking the row and selecting Loose classes.... Multiple classes can be removed at once.

Also Topics > Add to topic > Add class menu selection adds topic a class and Topics > Delete from topic > Loose classes deletes the class but leaves the class topic intact.

Modifying topic instances

Instance is added to a topic by right clicking the title header of Instances table and selecting Add instance.... Instance is deleted by selecting row in the instance table, right-clicking selected row and selecting Loose instances....

Also menu selections Topics > Add to topic > Add instance and Topics >Delete from topic > Loose instances can be used to add and delete instances.

Modifying associations

Associations are perhaps the most important feature of topics. Associations links topics together into doubles, triplets etc.

Association is added to a topic by selecting Add schemaless association... or Add association... in context menu of Associations header. Wandora employs simple schema to ease association creation and modification. Association schema defines what kind of associations are acceptable, ie. types, roles and players of allowed associations. Association schema is defined with instances and subclasses of Schema type topic. Guidelines to build a modest schema are outside the scope of this text. Read more about the schema here.

Building a working schema for associations may be extravagant for small or ad hoc projects. Schemaless associations give you a moderate convention to add and modify associations without explisit schema definitions. Schemaless associations force you to pick separately association's roles, players and type.

Right-clicking the association row reveals powerful operations to modify association. You may for example change association's type and roles as well as delete the association.

Modifying occurrences

Wandora does not support URL occurrences of the topic map standard. In Wandora occurrence is a solid text block associated to the topic.

Occurrence is added to a topic by selecting Add schemaless text data... or Add text data.... Occurrences employ similar schema as associations. Occurrence schema defines what kind of occurrences can be added to a topic i.e. the types of allowed occurrences. Read more about the schema here. As schema creation is rather difficult schemaless occurrence addition is also allowed.

More advanced occurrence operations are found in Topics > occurrence menu of topic tables.