Quickstart - Revision history

Akivela: /* Info Fields */

2016-05-10T12:39:43Z

‎Info Fields

Akivela: /* Finder */

2015-06-07T11:53:29Z

‎Finder

Akivela: /* Topic Tree */

2015-06-07T11:47:25Z

‎Topic Tree

Akivela: /* Button Bar */

2015-06-07T11:36:15Z

‎Button Bar

Akivela: /* Topic Tree */

2015-06-05T13:37:53Z

‎Topic Tree

Akivela: /* Button Bar */

2015-06-05T13:34:16Z

‎Button Bar

Akivela: /* Button Bar */

2015-06-05T13:23:11Z

‎Button Bar

Akivela: /* Tips */

2013-07-19T09:16:11Z

‎Tips

Akivela at 12:37, 3 February 2013

2013-02-03T12:37:25Z

Akivela: /* Finder */

2012-07-12T19:06:29Z

‎Finder

← Older revision		Revision as of 12:39, 10 May 2016
Line 93:		Line 93:
	== Info Fields ==		== Info Fields ==

−	Last but not least there is a info field strip in the bottom of the Wandora window. The leftmost information snippet is a base name of the current open topic. Second field contains topic's layer distribution of the current topic. Topic distribution '''1:0:0''' indicates how the inspected topic merges between layers. Third field contains name of current layer. Two icons on the right edge indicate current topic panel type and embedded server status. Clicking the topic panel type icon reveals a pop-up menu used to change the type of topic panel. Clicking on the server status icon starts and stops the [[Embedded HTTP server\|embedded HTTP server]].	+	Last but not least there is a info field strip in the bottom of the Wandora window. The leftmost information snippet is a base name of the current open topic. Second field contains topic's layer distribution of the current topic. Topic distribution '''1:0:0''' indicates how the inspected topic merges between layers. Third field contains name of current layer. Two icons on the right edge indicate current topic panel type and embedded server status. Clicking the topic panel type icon reveals a pop-up menu used to change the type of selected topic panel. Clicking on the server status icon starts and stops the [[Embedded HTTP server\|embedded HTTP server]].

@@ Line 42: / Line 42: @@
 == Finder ==
-Although topic tree offers very efficient method to browse and select topics there may be topics in the topic map that can not be reached with the topic tree. Finder offers another way to find topics. Finder tab locates beside the Topics tab.
+Although topic tree offers very efficient method to browse and select topics there may be topics in the topic map that can not be reached with the topic tree. Finder offers another way to locate topics. Finder tab locates beside the default topic tree.
-Finder is simply a free text search to the topic map. You may search with any topic element or element combination. Search result appears below the search field. Double clicking a topic in the search result opens the topic into the topic panel. Right clicking a topic opens context menu with a large number of topic tools. Below is an example of finder where user has searched with word '''title'''. Search results locate below the search word field. Search result contains topics including word '''title''' in their base name. To open search result topic for detailed inspection you can double click the topic for example. Wandora contains also more sophisticated search dialog you can open with menu '''Edit > Search'''.
+Finder is a free text search for the topic map. The user may search for topics with any topic element or element combination. Search result appears below the search field. Double clicking a topic in the search result opens the topic into the topic panel. Right clicking a topic opens context menu with a large number of topic tools. Below is an example of finder where user has searched with word '''title'''. Search results locate below the search word field. Search result contains topics including word '''title''' in their base name. To open search result topic for detailed inspection you can double click the topic for example. Wandora contains also more sophisticated search dialog you can open with menu '''Edit > Search'''.
 Image below views Wandora's finder tab.

@@ Line 31: / Line 31: @@
 == Topic Tree ==
-Topic tree is one of the most convenient and most used UI element in Wandora. Topic tree is used to browse and select topics. Topic tree is similar to file and folder hierarchy but contains topics instead of files, and the arranging principle is based to topic relations.
+Topic tree is one of the most convenient and most used UI element in Wandora. Topic tree is used to browse and select topics. Topic tree is similar to file and folder hierarchy but contains topics and the topic hierarchy is based to relations between topics. By default the topics are arranged along '''type-of''' and '''super-sub-class''' relation in the tree. The icon looking like a hollow triangle represents '''super-sub-class''' relation between topics. The icon looking like a filled rectangle represents '''type-of''' relation between the topics.
-When you open the application there is a default topic tree in top-left corner. Tree's root node is '''Wandora class''' and there is only one branch below. By default topics are arranged in the tree along '''type-of''' and '''super-sub-class''' relation. The "hollow triangle" icon represents '''super-sub-class''' relation between topics. "Filled rectangle" icon represents '''type-of''' relation between topics.
+At the startup Wandora's window contains default topic tree in the top-left corner. Tree's root node is topic '''Wandora class''' and the root node has only one branch.
-Clicking the handle opens subtree of the topic. Double clicking a topic in the tree opens the topic into the topic panel. Right clicking a topic in the topic tree reveals a context menu with a large number of topic tools. Below is an example of topic tree with '''Wandora class''' and '''Schema type''' topics open. Notice that '''Schema type''' is a subclass of '''Wandora class'''. Visible topics are part of Wandora's base ontology. Base ontology contains Wandora's [[Schema|schema]] topics for example.
+Mouse clicking the handle beside topic name opens the branch of the topic. Double clicking a topic in the tree opens the topic into the topic panel. Right clicking a topic in the topic tree reveals a context menu with a large number of topic tools. Topic tools can be used to manipulate the topic, copy parts of the topic and so forth. Below is an example of a topic tree with '''Wandora class''' and '''Schema type''' topics open. Notice that '''Schema type''' is a subclass of '''Wandora class'''. Visible topics are part of Wandora's base ontology. Base ontology contains Wandora's [[Schema|schema]] topics for example.

@@ Line 25: / Line 25: @@
 [[File:quickstart_buttonbar.gif|center]]
-To open a topic in Wandora, press the leftmost button in the button bar. Wandora opens a dialog window to select a topic. The window has several options to locate the topic. Different options have been placed into separate tabs. Available topic selection methods include tree selection, regular expression search, similarity search, query and TMQL. Next images views the open topic dialog when it is opened for the first time.
+To open a topic in Wandora, press the leftmost button in the button bar. The button has an icon representing circle with a gap. Wandora opens a dialog window to select a topic. The window has several options to locate the topic. Different options have been placed into separate tabs. Available topic selection methods include tree selection, regular expression search, similarity search, query and TMQL. Next image views the topic selection dialog when it is opened for the first time. The topic selection dialog is used when ever the user is expected to select a topic.
 [[Image:Quickstart_selecttopic_window.gif|center]]

@@ Line 31: / Line 31: @@
 == Topic Tree ==
-Topic tree is one of the most convenient and most used GUI element in Wandora. Topic tree is used to browse and select topics. Topic tree is similar to file and folder hierarchy but contains topics instead of files, and the arranging principle is based to topic relations.
+Topic tree is one of the most convenient and most used UI element in Wandora. Topic tree is used to browse and select topics. Topic tree is similar to file and folder hierarchy but contains topics instead of files, and the arranging principle is based to topic relations.
 When you open the application there is a default topic tree in top-left corner. Tree's root node is '''Wandora class''' and there is only one branch below. By default topics are arranged in the tree along '''type-of''' and '''super-sub-class''' relation. The "hollow triangle" icon represents '''super-sub-class''' relation between topics. "Filled rectangle" icon represents '''type-of''' relation between topics.

@@ Line 21: / Line 21: @@
 == Button Bar ==
-Button bar at the top of the window contains at least '''Open''' and arrow buttons. Arrow buttons behave like WWW browser's back and forward except that history contains topics. Back button recalls previous topic in the Topic panel and right button restores next topic in the history. If there is no topic in the history to restore the arrow button is disabled. Right clicking the arrow button reveals context menu of history topics. Selecting a topic in menu opens the topic in a topic panel.
+Button bar at the top of the window contains some useful tools. First button from the left is '''Open topic''' button. It opens a dialog window to select and open topics. Arrow buttons behave like WWW browser's back and forward buttons except that browser history contains topics. The back button recalls the previous topic in the topic panel and the right button restores the next topic in the history. Arrow button is disabled is there is no topic available in the history. Right clicking the arrow button reveals a context menu of history topics. Selecting a topic in the menu opens the topic in a topic panel. Next image describes the tools found in the button bar.
 [[File:quickstart_buttonbar.gif|center]]
-Button bar contains also '''Open''' button. Button opens a '''Select topic''' window with '''Topics''', '''Finder''', and '''Select''' tabs used to specify the topic to be opened. Topics tab contains topic tree. To open a topic with topic tree, find and select the topic and click '''OK'''. Select tab contains simple search fields to locate a topic with topic's subject identifier, subject locator or basename. To open a topic with the select tab, enter topic's identifier into the search field, press '''find''', and click '''OK''' if search result field indicates successful match. Unfortunately you can't use wild cards or other advanced match operations within the search field of '''Select topic''' window.
+To open a topic in Wandora, press the leftmost button in the button bar. Wandora opens a dialog window to select a topic. The window has several options to locate the topic. Different options have been placed into separate tabs. Available topic selection methods include tree selection, regular expression search, similarity search, query and TMQL. Next images views the open topic dialog when it is opened for the first time.
-−
-'''Select topic''' window is very common GUI element in Wandora. It is generally used to request a topic. For example adding a class topic tool requests the class topic with '''Select topic''' window. Below is an example of '''Select topic''' window.
 [[Image:Quickstart_selecttopic_window.gif|center]]
 == Topic Tree ==

← Older revision		Revision as of 09:16, 19 July 2013
Line 118:		Line 118:
	* Try to drag and drop stuff. In Wandora you can drag topics and text snippets.		* Try to drag and drop stuff. In Wandora you can drag topics and text snippets.

−	To get more familiar with Wandora you might want to see [[Documentation\|available documentation]] now. Or maybe you want to watch tutorials on [http://www.wandora.org~~/wandora~~/tv/ wandoratv].	+	To get more familiar with Wandora you might want to see [[Documentation\|available documentation]] now. Or maybe you want to watch tutorials on [http://www.wandora.org/tv/ wandoratv].

@@ Line 6: / Line 6: @@
 * '''File''' menu contains options to Open and Save Wandora projects, options to import and export topic maps and RDF documents for example.
 * '''Edit''' menu contains usual Select, Cut, Copy and Paste options.
-* '''View''' menu is used to select topic panel and control how topic panel views current topic. Menu controls how a topic is represented in Wandora also.
+* '''View''' menu is used to control topic panels and how a topic panel views a topic.
 * '''Topics''' menu contains tools to create and modify topics and associations. These tools usually take the topic in topic panel as a context. To modify a specific topic under mouse pointer use context menu opened with right mouse button.
 * '''Layers''' menu contains options to control topic map layers and the layer stack. Layers are Wandora's way to separate and organize topic maps.
@@ Line 80: / Line 80: @@
 [[Image:layerstack_example.gif|center]]
-== Topic Panel ==
+== Topic Panels ==
-Topic panel covers the right column of Wandora window. Topic panel is an user interface  used to view topics more detailed. To open a topic to the topic panel, double click a topic in the topic tree, for example. Topic panel is changed with menu option '''View > Topic panels'''. Available topic panels include '''Traditional topic panel''', '''Tabbed topic panel''', '''Graph topic panel''', '''Custom topic panel''', '''Treemap topic panel''', '''Processing topic panel''' and '''R topic panel'''. By default topic is viewed with '''Traditional topic panel'''.
+Topic panels cover the right column of Wandora window. A topic panel is used to view topics more detailed. Sometimes they can be used to modify a topic, too. Wandora can view several topic panels at once but only one topic panel is active at a time. To open new topic panel, select a menu option topic under '''View > Add topic panel'''. To close a topic panel, click the cross (X) icon top right corner of the topic panel. To open a topic to the topic panel, double click a topic in the topic tree, for example. Available topic panels include '''Traditional topic panel''', '''Tabbed topic panel''', '''Graph topic panel''', '''Custom topic panel''', '''Treemap topic panel''', '''Processing topic panel''' and '''R topic panel'''. By default topic is viewed with '''Traditional topic panel'''.
 Traditional topic panel collects and views topic's internal structure: