Opening a topic

From WandoraWiki
(Difference between revisions)
Jump to: navigation, search
(Modifying topic)
Line 10: Line 10:
  
  
== Modifying topic ==
+
==Modify basename==
  
Wandora offers a rich set of tools to modify topics and associations. Wandora allows you to
+
Topic's basename is modified by changing the contents of basename text field in topic panel. Emptying field removes the basename. Wandora topic may have only one unscoped basename. Wandora application represents topics with basename by default and it is recommended that all topic's have basename.
  
* Modify and delete topic's basename. Basename is modified by changing the contents of basename text field in topic panel. Wandora topic may have only one unscoped basename.
+
Addition to direct topic panel editing basename can also be modified within topic tree triple clicking topic in tree. Operation changes topic's basename label into an editable basename field.
* Modify and delete topic's subject locator. Subject locator is also modified by changing the contents of subject locator text field in topic panel. Wandora topic may contain only one subject locator. Subject locator is deleted when locator's text field is emptied.
+
 
* Modifying and deleting topic's variant names. Variant names operate as language and scope dependent topic names. This is slightly different from topic map standard where variant names play modest role compared to basenames. Variant names are modified directly in topic panel's text fields.
+
'''Topics->Basename''' menu contains more advanced basename editing options. Menu contains tool to remove new line characters in basename and subject identifier to basename and text data to basename transformations for example. Menu is located within top menu bar, context menu of topic table and topic tree. Each location targets different set of topics and basenames.
* Add and delete subject identifiers. Subject identifier fields in topic panel contain '''Delete''' button. Subject identifier is removed by cllicking the button. If you remove topic's last subject identifier default subject identifier is created to the topic as soon as the topic is used next time. '''Wandora requires each existing topic has at least one valid subject identifier.''' To add subject identifier to a topic right-click at the Subject Identiers title of identifier table and select '''Add subject identifier'''.
+
 
* Add and delete classes. Class topic describe type of the the topic. Class is added to a topic by right-clicking the title header '''Classes''' of class table and selecting '''Add class'''. Operation employs similar window as '''Open topic'''. Window is used to point the topic class. Class is deleted simply selecting row in class table, right-clicking the row and selecting '''Loose classes...'''. Multiple classes can be removed at once.
+
Note: Basenames with new line characters are tricky because Wandora's basename field does not support the character. We strongly encourage you to use basename's without new line characters.
* Add and delete instances. Instances and classes are symmetric. If '''A''' is a class of '''B''' then '''B''' is instance of '''A'''. Instance is added to a topic by right clicking the title header of Instances table and selecting '''Add instance...'''. Instance is deleted as classes by selecting row in instance table, right-clicking selected row and selecting '''Loose instances...'''.
+
 
* Add, modify and delete associations. Association is added by right clicking Associations header title and selecting '''Add schemaless association...''' or '''Add association...'''. Wandora employs simple schema to ease association creation and modification. Association schema defines what kind of associations are acceptable. Association schema is defined with topic map it self. Read more about the schema [[Schema|here]]. Till then you may add schemaless associations. Schemaless associations require you to pick up association's type, roles and players except the topic in question. 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.
+
 
* Add, modify and delete text datas. Text datas are equivalent to occurrences of topic map standard. Text data is a solid text block describing or associating the topic. Wandora does not support URL occurrences of the topic map standard. Text data is added to a topic by right clicking the Text data header title and selecting '''Add text data...'''. Text datas employ similar schema as associations. Schema defines what kind of text datas can be added to a topic. Read more about the schema [[Schema|here]].
+
==Modify subject locator==
 +
 
 +
Subject locator is an URL that represents the topic. Subject locators also modified by changing the contents of subject locator text field in topic panel. Wandora topic may contain only one subject locator. Subject locator is deleted when locator's text field is emptied.
 +
 
 +
 
 +
==Modifying variant names==
 +
 
 +
Variant names operate as language and scope dependent topic names. This is slightly different from topic map standard where variant names play modest role compared to basenames. Variant names are modified directly in topic panel's text fields.
 +
 
 +
 
 +
==Add and delete subject identifiers==
 +
 
 +
Subject identifier fields in topic panel contain '''Delete''' button. Subject identifier is removed by cllicking the button. If you remove topic's last subject identifier default subject identifier is created to the topic as soon as the topic is used next time. '''Wandora requires each existing topic has at least one valid subject identifier.''' To add subject identifier to a topic right-click at the Subject Identiers title of identifier table and select '''Add subject identifier'''.
 +
 
 +
 
 +
==Add and delete classes==
 +
 
 +
Class topic describe type of the the topic. Class is added to a topic by right-clicking the title header '''Classes''' of class table and selecting '''Add class'''. Operation employs similar window as '''Open topic'''. Window is used to point the topic class. Class is deleted simply selecting row in class table, right-clicking the row and selecting '''Loose classes...'''. Multiple classes can be removed at once.
 +
 
 +
 
 +
==Add and delete instances==
 +
 
 +
Instances and classes are symmetric. If '''A''' is a class of '''B''' then '''B''' is instance of '''A'''. Instance is added to a topic by right clicking the title header of Instances table and selecting '''Add instance...'''. Instance is deleted as classes by selecting row in instance table, right-clicking selected row and selecting '''Loose instances...'''.
 +
 
 +
 
 +
==Add, modify and delete associations==
 +
 
 +
Association is added by right clicking Associations header title and selecting '''Add schemaless association...''' or '''Add association...'''. Wandora employs simple schema to ease association creation and modification. Association schema defines what kind of associations are acceptable. Association schema is defined with topic map it self. Read more about the schema [[Schema|here]]. Till then you may add schemaless associations. Schemaless associations require you to pick up association's type, roles and players except the topic in question. 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.
 +
 
 +
 
 +
==Add, modify and delete text datas==
 +
 
 +
Text datas are equivalent to occurrences of topic map standard. Text data is a solid text block describing or associating the topic. Wandora does not support URL occurrences of the topic map standard. Text data is added to a topic by right clicking the Text data header title and selecting '''Add text data...'''. Text datas employ similar schema as associations. Schema defines what kind of text datas can be added to a topic. Read more about the schema [[Schema|here]].

Revision as of 18:36, 4 October 2006

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. 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 topic open in topic panel. Topic is closed by selecting Close topic from Topics menu or pressing Ctrl-W.


Contents

Modify basename

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

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

Topics->Basename menu contains more advanced basename editing options. Menu contains tool to remove new line characters in basename and subject identifier to basename and text data to basename transformations for example. Menu is located within top menu bar, context menu of topic table and topic tree. Each location targets different set of topics and basenames.

Note: Basenames with new line characters are tricky because Wandora's basename field does not support the character. We strongly encourage you to use basename's without new line characters.


Modify subject locator

Subject locator is an URL that represents the topic. Subject locators also modified by changing the contents of subject locator text field in topic panel. Wandora topic may contain only one subject locator. Subject locator is deleted when locator's text field is emptied.


Modifying variant names

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


Add and delete subject identifiers

Subject identifier fields in topic panel contain Delete button. Subject identifier is removed by cllicking the button. If you remove topic's last subject identifier default subject identifier is created to the topic as soon as the topic is used next time. Wandora requires each existing topic has at least one valid subject identifier. To add subject identifier to a topic right-click at the Subject Identiers title of identifier table and select Add subject identifier.


Add and delete classes

Class topic describe type of the the topic. Class is added to a topic by right-clicking the title header Classes of class table and selecting Add class. Operation employs similar window as Open topic. Window is used to point the topic class. Class is deleted simply selecting row in class table, right-clicking the row and selecting Loose classes.... Multiple classes can be removed at once.


Add and delete instances

Instances and classes are symmetric. If A is a class of B then B is instance of A. Instance is added to a topic by right clicking the title header of Instances table and selecting Add instance.... Instance is deleted as classes by selecting row in instance table, right-clicking selected row and selecting Loose instances....


Add, modify and delete associations

Association is added by right clicking Associations header title and selecting Add schemaless association... or Add association.... Wandora employs simple schema to ease association creation and modification. Association schema defines what kind of associations are acceptable. Association schema is defined with topic map it self. Read more about the schema here. Till then you may add schemaless associations. Schemaless associations require you to pick up association's type, roles and players except the topic in question. 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.


Add, modify and delete text datas

Text datas are equivalent to occurrences of topic map standard. Text data is a solid text block describing or associating the topic. Wandora does not support URL occurrences of the topic map standard. Text data is added to a topic by right clicking the Text data header title and selecting Add text data.... Text datas employ similar schema as associations. Schema defines what kind of text datas can be added to a topic. Read more about the schema here.