Working with topic trees

From WandoraWiki
(Difference between revisions)
Jump to: navigation, search
 
(34 intermediate revisions by one user not shown)
Line 1: Line 1:
Topic tree is a GUI element used to select and browse topics in Wandora. Topics are arranged in the tree so that each branch is a subclass or instance of the root topic. In fact arrangement can be based to any binary relation or even any set of binary relations. One topic tree locates in the left part of the Wandora window. By default the root of this tree is Wandora's base topic '''Wandora class''' (http://www.wandora.net/core/wandoraclass). By default subclass branch is marked with folder icon and instance of branch with document icon. Each topic in the tree has a handle in left of the topic's base name. You can open the subtree by clicking the handle icon. It is not rare that the subtree hierarchy contains infinite loops. Each topic in the tree can be opened to topic panel by double clicking the topic name. To change topic's base name triple click the topic and the name label changes to a editable field. If you change the name and press enter topic is given a new base name you just entered to the field. Next we investigate more detailed tree's topic tools.
+
Topic tree is a user interface element used to select and browse topics in Wandora. One topic tree locates at the left column of Wandora window, below Topics tab. Topic tree views topics as a tree hierarchy. The tree has a root and branches of varying length. All tree nodes i.e. root, branches and leafs are topics. By default, topic's basename represents a topic in the tree. An example of topic tree is below.
  
If you right click a topic in the topic tree, a context menu is revealed. Context menu contains tools used to modify topics and topic map. Menu contains tools and submenus named
 
  
* Open topic
+
[[Image:topictree.gif|center]]
* New topic
+
 
* Delete topic
+
 
* Duplicate topic
+
Default root of the topic tree is a topic named as '''Wandora class'''. Root topic is connected to all instances and subclasses of the root topic. Class-instance and superclass-subclass relations are used to define the structure of a topic tree. A filled diamond icon is used to mark class-instance relation. A hollow triangle pointing left is used to mark superclass-subclass relation.
* Split topic
+
 
* Add to topic
+
To expand a topic in a tree mouse click the rightmost icon handle. When a topic is expanded, tree views topic's subclasses and instances. It is quite general that a topic tree contains cycles. To close a tree branch mouse click the rightmost handle icon near the root topic of the branch.
* Delete from topic
+
 
* Copy
+
If Wandora's topic map doesn't contain tree's root topic, a '''Create root topic''' button is shown instead of the tree. Root topic is created automatically by the application if the button is pressed. You can change the root topic of a tree by configuring tree tab. Right mouse click the tab and select menu option '''Configure tab'''. Also, you can set the tree to view other relations too. Right mouse click the tab and select menu option '''Configure types''', add new topic tree type, and add created type to your tree by configuring the tree again.
* Copy also
+
 
* Paste
+
To open any topic in a tree into a topic panel double click the topic. If you right click a topic in a tree, a context menu is revealed. Context menu contains powerful options to modify addressed topic. In some occasions menu options may have an effect to a wider collection of topics. Context menu contains tools and submenus to create new topics, split topics, add and modify topic's internals, copy topics, paste topics, etc.
* Paste also
+
 
* Subject locator
+
Sometimes a topic tree gets messy. To redraw the tree select context menu option '''Refresh tree'''.
* Subject identifiers
+
 
* Base name
+
Topic tree allows dragging too. Wandora user can drag topics in the tree. Drop location can be the tree itself or some other UI element in Wandora. If drop location is topic tree, Wandora moves the dropped topic under the drop location topic. For example, dropping an instance topic over an another topic, makes the dropped topic instance of another topic. Old relation is removed unless the user keeps CTRL key pressed during the drag and drop.
* Variant names
+
* Associations
+
* Refresh tree
+

Latest revision as of 18:27, 6 April 2015

Topic tree is a user interface element used to select and browse topics in Wandora. One topic tree locates at the left column of Wandora window, below Topics tab. Topic tree views topics as a tree hierarchy. The tree has a root and branches of varying length. All tree nodes i.e. root, branches and leafs are topics. By default, topic's basename represents a topic in the tree. An example of topic tree is below.


Topictree.gif


Default root of the topic tree is a topic named as Wandora class. Root topic is connected to all instances and subclasses of the root topic. Class-instance and superclass-subclass relations are used to define the structure of a topic tree. A filled diamond icon is used to mark class-instance relation. A hollow triangle pointing left is used to mark superclass-subclass relation.

To expand a topic in a tree mouse click the rightmost icon handle. When a topic is expanded, tree views topic's subclasses and instances. It is quite general that a topic tree contains cycles. To close a tree branch mouse click the rightmost handle icon near the root topic of the branch.

If Wandora's topic map doesn't contain tree's root topic, a Create root topic button is shown instead of the tree. Root topic is created automatically by the application if the button is pressed. You can change the root topic of a tree by configuring tree tab. Right mouse click the tab and select menu option Configure tab. Also, you can set the tree to view other relations too. Right mouse click the tab and select menu option Configure types, add new topic tree type, and add created type to your tree by configuring the tree again.

To open any topic in a tree into a topic panel double click the topic. If you right click a topic in a tree, a context menu is revealed. Context menu contains powerful options to modify addressed topic. In some occasions menu options may have an effect to a wider collection of topics. Context menu contains tools and submenus to create new topics, split topics, add and modify topic's internals, copy topics, paste topics, etc.

Sometimes a topic tree gets messy. To redraw the tree select context menu option Refresh tree.

Topic tree allows dragging too. Wandora user can drag topics in the tree. Drop location can be the tree itself or some other UI element in Wandora. If drop location is topic tree, Wandora moves the dropped topic under the drop location topic. For example, dropping an instance topic over an another topic, makes the dropped topic instance of another topic. Old relation is removed unless the user keeps CTRL key pressed during the drag and drop.

Personal tools