WandoraWiki - Recent changes [en]

Wandora

2013-05-23T13:35:08Z

Wandora's configuration file

2013-05-23T13:17:51Z

Layer order and arranging layers

2013-05-23T12:37:26Z

‎Arranging Layers Example:

File:Arrange layers example3.gif

2013-05-23T12:17:05Z

Akivela uploaded a new version of "File:Arrange layers example3.gif"

File:Arrange layers example2.gif

2013-05-23T12:16:33Z

Akivela uploaded a new version of "File:Arrange layers example2.gif"

File:Arrange layers example1.gif

2013-05-23T12:14:59Z

Akivela uploaded a new version of "File:Arrange layers example1.gif"

Layer order and arranging layers

2013-05-23T12:04:26Z

Wandora

2013-05-23T11:00:21Z

Editing topics and associations

2013-05-22T14:14:58Z

‎Editing variant names:

Wandora

2013-05-22T14:09:37Z

‎Editing topics and associations:

Modifying occurrences

2013-05-22T14:09:23Z

Redirected page to Editing topics and associations

Modifying associations

2013-05-22T14:08:59Z

Redirected page to Editing topics and associations

Modifying topic classes

2013-05-22T14:08:24Z

Redirected page to Editing topics and associations

Modifying variant names

2013-05-22T14:07:59Z

Redirected page to Editing topics and associations

Modifying subject identifiers

2013-05-22T14:07:32Z

Redirected page to Editing topics and associations

Modifying subject locator

2013-05-22T14:07:13Z

Redirected page to Editing topics and associations

Modifying base name

2013-05-22T14:06:55Z

Redirected page to Editing topics and associations

Wandora

2013-05-22T14:05:59Z

‎Editing topics:

Editing topics

2013-05-22T14:05:24Z

Akivela moved page Editing topics to Editing topics and associations

Modifying subject identifiers

2013-05-22T14:04:39Z

Redirected page to Editing topics

Modifying subject locator

2013-05-22T14:04:22Z

Redirected page to Editing topics

Modifying base name

2013-05-22T14:03:56Z

Redirected page to Editing topics

Modifying base name

2013-05-22T14:03:20Z

Created page with "#REDIRECT Editing topics"

New page

#REDIRECT Editing topics

Modifying base name

2013-05-22T14:02:41Z

Akivela deleted page Modifying base name content was: "Topic's base name is modified by changing the contents of base name text field in topic panel. Emptying field removes the base name. Topic may have only one unsco..." (and the only contributor was "Akivela")

Editing topics

2013-05-22T14:01:40Z

‎Additional notes:

Editing topics

2013-05-22T13:59:44Z

Created page with "== Editing a base name == Topic's base name is modified by changing the contents of base name text field in topic panel. Emptying field removes the base name. Topic may have ..."

New page

== Editing a base name ==

Topic's base name is modified by changing the contents of base name text field in topic panel. Emptying field removes the base name. Topic may have only one unscoped base name in Wandora. This is little different compared to Topic Maps standard where topic may have multiple scoped base names. By default Wandora represents a topic using it's base name. It is recommended all topics have base name. Also, we strongly encourage you not to use new line characters in base names as Wandora's base name field does not support the character. Next image views [[Traditional topic panel]] with topic '''Schema type'''. Base name field has been marked with a red circle.

[[File:basename_traditional_topic_panel.gif|center]]

Base name is an unique topic property. If two topics have same base name, topics represents same subject and are merged immediately. If you change base name manually and new base name already exists in the topic map (or generally in any [[Layered_topic_map|layer]] of Wandora), Wandora confirms the base name change and consequent merge.

Addition to topic panel editing, base name can also be modified within a topic tree. Clicking the topic three times in the tree changes topic's base name label into an editable base name field.

'''Topics > Base name''' menu contains more advanced base name editing options. These advanced editing options include

* '''Regex replace''' allows you to modify base name with regular expressions.
* '''Remove new line characters''' simply removes all new line characters in topic's base name. This may be necessary if you have imported externally created topic map to Wandora.
* '''Remove base name''' removes topic's base name. Base name removal is necessary if you intend to create new base name for topic with '''Make base name with SI''' option for example.
* '''Make base name with SI''' creates a base name for topic. Base name is created with topic's subject identifier. Created base name is file part of subject identifier. This feature is useful if you have imported a RDF document and would like to name simple topic stubs created with RDF URIs. If topic already contains base name, base name creation fails. You have to remove old base name first.
* '''Make base name with occurrence''' creates a base name for the topic with user defined occurrence text. If topic already contains base name, base name creation fails silently. You have to remove old base name first.

These editing options may sound trivial if you consider modifying one base name. However, applying editing option to multiple topics at once is much more useful.

== Editing a subject locator ==

Subject locator is an URL resource that '''is''' the topic. Topic may have zero or one subject locator. If two topics have same subject locator, topics merge automatically.

To modify topic's subject locator open the topic to a topic panel such as [[Traditional topic panel]] and edit panel's subject locator field. Writing URL to the field adds subject locator to the topic. Emptying the field removes topic's subject locator. Next image views [[Traditional topic panel]] and subject locator field marked with a red circle.

[[File:sl_traditional_topic_panel.gif|center]]

Although Wandora's topic map model does not resolve subject locators, Wandora application resolves the URL and views a thumbnail or an icon for the resource. Thumbnail or icon is viewed above the subject locator field in traditional topic panel. Some resource types such as image or HTML document can be modified with context tools. 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. More detailed:

* '''[[OpenSL|Open SL]]''' forks external application, Internet Explorer by default and passes the subject locator url to the application.
* '''Check SL''' resolves subject locator URL and reports whether or not the URL resolves to a real internet resource. This is useful when you have to check if subject locators of an old topic map are still valid.
* '''Download SL''' downloads the subject locator resource to local file system but doesn't change topic's subject locator.
* '''Move subject locator''' downloads the subject locator resource to local file system and changes subject locator to point this local copy of SL resource.
* '''Move to fileserver''' uploads the internet resource of subject locator URL to user specified file server and changes the subject locator to the address given by file server. File server refers here to a [[Setting up Wandora Piccolo server|Wandora-Piccolo server]].
* '''Extract with SL''' contains submenus, one for each Wandora extractor. Selecting extractor in this context applies the extractor to the subject locator resource.
* '''Regex replace''' changes topic's subject locator with user specified regular expression.
* '''Remove SL''' removes topic's subject locator.
* '''Make SL with base name''' construct subject locator for the topic using base name and user specified URL body.
* '''Make SL with occurrence''' constructs subject locator for the topic using occurrence data and user specified URL body.

These editing options may sound trivial if you consider modifying one subject locator. However, applying editing option to multiple topics at once is much more useful.

== Editing subject identifiers ==

Each topic has one or more subject identifiers in Wandora. Subject identifiers are practically URLs referring to subject indicators i.e. resources that describe the subject. However, subject identifier URLs do not necessarily resolve, there is no real resource subject identifier refers. Subject identifiers are unique and topics with same same subject identifier are automatically merged.

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.

[[Image:Add_si.gif|center|Subject identifier is added to a topic with external dialog]]

Subject identifier is removed by right clicking the subject identifier and selecting '''Remove selected...'''. 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:

* '''Copy SIs''' copies topic's subject identifiers to clipboard. New line character is used as subject identifier separator.
* '''Paste SIs''' injects URLs in clipboard to current topic as subject identifiers. If subject identifier already exists in another topic, topics are instantly merged.
* '''Remove references in SIs''' modifies topic's subject identifiers by removing the URL reference. URL reference is a part of URL address that starts with '''#''' character.
* '''Regex replace SIs''' modifies topic's subject identifiers with user given regular expression.
* '''Fix SIs''' modifies subject identifiers by replacing all illegal characters with underscore ('''_''') character.
* '''Flatten identity''' removes all but one subject identifier in topic. Remaining subject identifier is arbitrary.
* '''Make SI with SL''' adds topic new subject identifier identical to topic's subject locator. If topic has no subject locator, no subject identifier is added.
* '''Make SI with base name''' adds topic new subject identifier constructed using topic's base name and user given URL body.
* '''Make SI with occurrence''' adds topic new subject identifier constructed using topic's occurrence and user given URL body.

== Editing variant names ==

Variant names are scoped topic names. Scope is a set of topics and specify the type of a name. Usually the scope contains at least two topics, one for language and one for name type. However, scope may contain more than two topics or none topics. 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 are edited directly in the fields of a topic panel. Next image views a [[Traditional topic panel]] with a Variant name matrix marked with a red circle.

[[File:variant_names_traditional.gif|center]]

To view and edit variant names with non-schema scopes, user can right mouse click the '''Variant names''' box title and select context menu option '''View > View all scopes'''. Wandora changes the look of variant name panel and views now all variant names of the topic. Next image views alternative variant names editor available in [[Traditional topic panel]]. Alternative variant names editor can be used to edit variant names with non-schema scopes.

[[File:variant_names_traditional.gif|center]]

To add a topic a variant name with non-schema scope, right click the '''Variant names''' box title and select menu option '''Add variant name'''. Wandora opens up a dialog window for a non-schema scoped variant name. Next image illustrates an use case where Wandora user is adding a topic a variant name '''Non-schema variant name here''' with a single scope topic '''Schema type'''.

[[File:add_variant_name.gif|center]]

Notice, non-schema variant names are not viewed in variant name matrix. However, the number beside '''Variant names''' box title counts also non-schema variant names.

For more advanced variant name operations use tools in '''Topics > Variant names'''. Menu includes options:

* '''Copy all variant names''' copies topic's variant names to clipboard. Also invisible variants i.e. variant that are not specified with schema, are copied to clipboard. This can be used to check what kind of variant names topic has.
* '''Regex replace''' is used to modify topic's variant names with user given regular expression.
* '''Remove new line characters''' deletes new line characters in variant names of current topic.
* '''Remove variant name''' deletes variant name of given type and scope.
* '''Remove all empty variant names''' deletes all zero length variant names in topic.
* '''Remove all variant names''' deletes all variant names in topic. Also invisible variants i.e. variants that have not been defined in schema, are deleted.
* '''Make display variants with base name''' copies topic's base name to all schema specified display variants.

By default Wandora supports four language topics. These are Finnish, Swedish, English, and Language Independent. By default Wandora supports two name types: a Display name and a Sort name. Extending Wandora's language and the name type support is easy. To add Wandora a 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.

=== See also ===

* [[Transform variant names to topics and associations]]
* [[Add missing language scope to variant names]]
* [[Add missing display scope to variant names]]
* [[How to add another variant name language]]
* [[How to add another variant name type]]

== Editing topic classes and instances ==

Each topic may be related to zero or more class topics. Class-instance relation is used to express ''a type'' or ''a kind'' of a topic. Next image views traditional topic panel with a '''Schema type''' topic. Red circles mark topic's classes and instances.

[[File:traditional_topic_panel_class_instances.gif|center]]

Class is added to a topic by right clicking the title header '''Classes''' and selecting '''Add class'''. After selection, Wandora opens a pick-a-topic dialog used to address the topic class. Topic's class is deleted by selecting a row in the '''Classes''' table, right clicking the row, and selecting menu option '''Delete classes...'''. Multiple classes can be removed at once. Notice that deleting a class topic removes only class-instance relation. The topic itself is not removed.

Also '''Topics > Add to topic > Add class''' menu selection adds topic a class and '''Topics > Delete from topic > Delete classes''' deletes the class.

=== 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 '''Delete instances...'''.

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

=== Additional notes ===

Wandora models class-instance relations using internal data structures. Wandora doesn't contain a topic that represents the relation type or role types. This means that Wandora user can not use the relation '''class-instance''' nor role types '''class''' and '''instance''' in part of other relations. Wandora user can't set up a superclass of a '''class-instance''', for example.

Wandora speaks of classes and instances while the Topic map standard speaks of '''types''' and instances. Reader should understand that a '''type''' described in Topic map standard is equivalent to a concept of a '''class''' in Wandora.

== Editing associations ==

Associations link topics together into doubles, triplets etc. Association is a named hyper-edge connecting topics. In Wandora, an association is added by selecting '''Add association...'''. Association is modified by selecting association row in association table and selecting option '''Modify association...'''. Both options open up an association editor. Next image views Wandora's traditional topic panel of a topic '''In No Sense? Nonsense! (album)''' which appears to be one of '''The Art of Noise's''' album. Red circle marks associations where the album plays a role i.e. associations which somehow connect the album topic to other topics.

[[Image:traditional_topic_panel_associations.gif|center|Adding association to a topic]]

Adding association results empty association editor while Modify association fills editor fields with roles, players and type of the selected association. Association editor is used to add and modify one association at time. Next image views an association editor where type and roles have not been selected yet.

[[Image:schemaless_association_editor.gif|center|Adding association to a topic]]

To create an association the user must pick a type, player and role topics for the association. Association creation is discussed more detailed in [[Create new association]].

Wandora includes also more sophisticated association modification options. To reveal available options right click on association table. Context menu should contain at least:

* '''Delete associations...''' is used to remove selected associations in current topic table. Deletion is confirmed from Wandora user.
* '''Change type...''' is used to change association type topic of selected association in current topic table. Wandora asks new type topic with topic request dialog.
* '''Change role...''' is used to change one of the association roles of selected association in current topic table. Wandora asks which role is replaced and which topic replaces old role.
* '''Insert player...''' inserts user selected player (with user selected role) to selected associations. This option is especially handy if you need to add same player to numerous associations.
* '''Delete players...''' is used to remove selected columns i.e. players from selected associations. Note that your selection in association table really defines what players Wandora removes. Wandora confirms deletion from user.
* '''Swap players within''' changes player roles in selected associations. Option creates a symmetric association that has different role order. Option is useful when roles are somehow similar (for example ''neighbour-1'' and ''neighbour-2'') and you need to refactor large number of associations.
* '''Create symmetric associations...''' is similar to '''Swap players within''' but doesn't remove original associations.
* '''Delete symmetric associations...''' compares selected associations to all other associations in Wandora and deletes association if symmetric duplicate is found. Symmetric duplicate is an association with same players and roles but role order is different.
* '''Collect binary to n-ary...''' is used to change multiple binary associations into a single association with multiple players. To work properly all binary association should share one player.
* '''Split n-ary to binary...''' converts one association with multiple players to multiple binary associations. User must select one player as shared player. Shared player ties binary associations together.

== Editing occurrences ==

Occurrence is a solid text block associated to the topic. For historical reasons Wandora calls occurrences also as '''Text datas'''. Occurrence has a '''type''' and a '''scope'''. Type is a topic that describes the occurrence, '''date of birth''' for example. Scope is also a topic describing the occurrence. Usually scope specifies the language of the occurrence. Occurrence is added to a topic by selecting '''Add occurrence...''' menu option. Option opens a dialog window:

[[Image:Schemaless_textdata_editor.gif|center]]

Occurrence creation dialog has a button for occurrence type topic and text fields for all languages in Wandora schema. To create an occurrence, user has to select type topic and write text in one or more text fields, and finally click '''OK''' button.

Occurrence editor doesn't allow user to specify occurrence languages freely. This is usually enough as languages should not vary too much. To add occurrence of non-listed language, add your language topic as an instance to '''Wandora language'''. Read more [[How to add another variant name language|here]].

Topic map standard supports also URL occurrences addition to text occurrences. However, Wandora does '''not''' support URL occurrences as it is possible to set URL's external representation, the string representing URL, as the occurrence.

After occurrence creation Wandora user can edit occurrences. To edit single occurrence, user has to click the text field showing occurrence's first words and Wandora opens up an occurrence editor. Occurrence editor is shown below. Editor contains some additional features compared to creation dialog. For example, user can strip html elements in occurrence text with a menu option '''Edit > Strip HTML tags'''. '''Refine''' menu contains occurrence text classifiers and topic finders for example.

[[Image:occurrence_editor.gif|center|Editing occurrence after initial addition.]]

More advanced occurrence operations are found in '''Topics > occurrence''' menu of topic tables. These operations include:

* '''Delete occurrences with type''' removes occurrences of given type from context topics.
* '''Delete all occurrences''' removes all occurrences from context topics.
* '''Regex replace''' modifies occurrence text with given regular expression. This can be used to perform rather complicated search and replace operations for example.

See also page [[Refining occurrences]] for some advanced occurrence editing options.

Wandora

2013-05-22T13:54:32Z

‎Editing topics:

File:NewLayerExample.gif

2013-05-22T13:51:18Z

Akivela uploaded a new version of "File:NewLayerExample.gif"

File:Layer stack and three layers.gif

2013-05-22T13:48:24Z

Akivela uploaded "File:Layer stack and three layers.gif"

Creating new layers

2013-05-22T13:47:46Z

File:New layer memory.gif

2013-05-22T13:39:48Z

Akivela uploaded a new version of "File:New layer memory.gif"

Working with topic panels

2013-05-22T12:34:36Z

‎Changing topic panel's type:

File:Change topic panel type.gif

2013-05-22T12:33:13Z

Akivela uploaded "File:Change topic panel type.gif"

Working with topic panels

2013-05-22T12:32:39Z

‎Maximizing topic panels:

Wandora

2013-05-22T12:22:19Z

‎Topic panels:

Working with topic panels

2013-05-22T12:01:59Z

‎Maximizing topic panel:

@@ Line 1: / Line 1: @@
-This page collects Wandora documentation. Documentation is a work in progress and incomplete. Also note some documentation may be out of date as the application is developed intensely. If you need any specific help, write your question to the [http://www.wandora.org/wandora/forum/index.php discussion forum]. Additional help may be available on the [http://www.wandora.org/wandora/tv/ wandoratv] (Flash required). Would you like to edit this wiki, send an email to {{wandora email address}} with your name and information about how you'd like to contribute. Remember to add keyword WANDORA to the title of your email.
+This page collects Wandora documentation. Documentation is a work in progress and incomplete. Also note some documentation may be out of date as the application is developed actively. If you need any specific help, write your question to the [http://www.wandora.org/wandora/forum/index.php discussion forum]. Additional help may be available on the [http://www.wandora.org/wandora/tv/ wandoratv] (Flash required). Would you like to edit this wiki, send an email to {{wandora email address}} with your name and information about how you'd like to contribute. Please, remember to add keyword WANDORA to the title of your email.
-'''Have you visited Wandora wiki before? As you may notice, we have moved the content from old Documentation page here and removed the old front page of the wiki. Official front page of the Wandora project is now the page at http://www.wandora.org/'''.
+'''Have you visited Wandora wiki before? As you may notice, we have moved the content from old Documentation page here and removed the old front page of the wiki. From now on the official front page of the Wandora project is the page at http://www.wandora.org/'''.
 == Introduction ==

@@ Line 1: / Line 1: @@
-Wandora keeps all important settings in specific options file. These settings include
+Wandora keeps all important settings in a specific options file. These important settings include
 * Window's initial size and location in screen
@@ Line 6: / Line 6: @@
 * Layer settings
 * Saved database connection settings
-* Activated extract, export and import tools
+* Default extract, export and import tools
 * Class paths for tools
 * Saved regular expressions

@@ Line 5: / Line 5: @@
 * Use submenus in '''Layers > [[ArrangeLayers|Arrange layers]]'''.
-== Arranging Layers Example ==
+== Arranging layers example ==
-Lets say we have two layers in Wandora, layer1 and layer2. Both layers contain a topic with subject identifier of http://www.wandora.net/Finland representing concept of our home country Finland. Due to merge rule these two topics merge in Wandora. Now lets assume that both topics have different base name. Topic in layer1 has a base name '''Suomi''' while the topic in layer layer2 has a base name '''Finland'''. Both are valid base names and the question is which base name should Wandora use for the merged topic? Remember that topics may contain only one unscoped base name in Wandora. The answer to the question lies in the order of layer1 and layer2. When layer1 is above layer2 merged topic has base name '''Suomi''' and when the layer1 is below the layer2 merged topic has base name '''Finland'''. This applies not only to base names but also variant names and occurrences of same type and scope.
+Lets say we have added two layers in Wandora. These layer are labeled as '''layer1''' and '''layer2'''. Both layers contain a topic with subject identifier of http://www.wandora.net/Finland representing a concept of country Finland. As both topics contain same subject identifier, topics merge in Wandora. Now lets say that both topics have different base name. Topic in '''layer1''' has a base name '''Suomi''' while the topic in layer '''layer2''' has a base name '''Finland'''. Which base name Wandora views for the merged topic? When '''layer1''' is above '''layer2''' the merged topic has a base name '''Suomi''' and when the '''layer1''' is below the '''layer2''' the merged topic has a base name '''Finland'''.
 [[Image:arrange_layers_example1.gif|center]]
-Ok, now we switch the layer order and bring layer2 to the top. Topic's base name changes automatically to '''Finland''' as the topic in layer2 has different base name than the topic in layer1.
 [[Image:arrange_layers_example2.gif|center]]
-Let's delete the base name in layer2. The base name from layer1 pops up in red. The color indicates the base name does not originate current layer and you can't change it directly. Yes, you can override the base name again but the ''lower'' base name stays intact and pop ups again if you delete the overlaying name. To change the ''lower'' base name you need to activate the layer base name origins. Layer distribution 1:1:0 hints which layer to choose.
 [[Image:arrange_layers_example3.gif|center]]
-Analogy drawn earlier between the layer concept of Wandora and graphic design applications may lighten the effect of layer order also. In graphic design applications the graphic element in top layer overlays the elements in lower layers. Similarly the base name in Wandora's top layer overlays base name's of merged topics in lower layers. Similarly the occurrence text of top layer overlays the occurrence of merged topics in lower layers.

@@ Line 1: / Line 1: @@
-Layer stack is an ordered set of layers. Layer's position in the stack reflects to the topic resolution in Wandora. Layer order in the stack has an effect to the topics and associations in Wandora. General rule is that a topic inherits properties from the top layer consisting the topic property. Top property overlays all other properties in lower layers.
+Layer stack is an ordered set of layers. Each layer contains topics and associations. If two layers contain a topic with a same subject identifier, these topics merge. Wandora views a merged topic that inherits it's properties from both topics. Inherited properties include topic names, occurrences and associations. Wandora's topic map model is limited and a topic may contain only one base and one subject locator in Wandora. Now, what happens if two layers contain a topic with a same subject identifier, and both topics have different base name. Which base name is viewed in the merged topic. The answer relates to the order of layers in the layer stack. Wandora solves topic properties from top to down and a base name locating top layer hides a base name locating lower layer. Same applies to subject locators, occurrences and variant names. If both merged topics carry an occurrence with same scope, the merged topic views only an occurrence from the higher layer. The occurrence in lower layer is hidden.
-To arrange layer order in the stack you can
+Saying this, it is clear that the user may want to switch layer order. To arrange topic map layer order in the layer stack Wandora user can
 * Drag and drop layers.
 * Use submenus in '''Layers > [[ArrangeLayers|Arrange layers]]'''.

@@ Line 1: / Line 1: @@
 This page collects Wandora documentation. Documentation is a work in progress and incomplete. Also note some documentation may be out of date as the application is developed intensely. If you need any specific help, write your question to the [http://www.wandora.org/wandora/forum/index.php discussion forum]. Additional help may be available on the [http://www.wandora.org/wandora/tv/ wandoratv] (Flash required). Would you like to edit this wiki, send an email to {{wandora email address}} with your name and information about how you'd like to contribute. Remember to add keyword WANDORA to the title of your email.
-'''Have you visited Wandora wiki before? As you may notice, we have moved the content from old Documentation page here and removed the old front page of wiki. Official front page of Wandora project is the page at http://www.wandora.org/'''.
+'''Have you visited Wandora wiki before? As you may notice, we have moved the content from old Documentation page here and removed the old front page of the wiki. Official front page of the Wandora project is now the page at http://www.wandora.org/'''.
 == Introduction ==
@@ Line 56: / Line 56: @@
 == Editing topics and associations ==
-Wandora has a rich set of topic, association and occurrence editing features. Wandora user may edit single topic in a topic panel. Modifying an association takes place in separate dialog window, association editor. Similarly, modifying an occurrence takes place in a separate editor. See also tutorial videos on [http://www.wandora.org/wandora/tv/ wandoratv].
+Wandora has a rich set of topic, association and occurrence editing features. Usually a topic is edited in a topic panel but Wandora features a group editions too. Editing an association takes place in a separate association editor. Similarly, modifying an occurrence takes place in an occurrence editor resembling a simple text editor. For editing tips see also tutorial videos on [http://www.wandora.org/wandora/tv/ wandoratv] (Flash required).
 * [[Editing topics and associations]]

@@ Line 1: / Line 1: @@
 == Editing a base name ==
@@ Line 81: / Line 83: @@
 To view and edit variant names with non-schema scopes, user can right mouse click the '''Variant names''' box title and select context menu option '''View > View all scopes'''. Wandora changes the look of variant name panel and views now all variant names of the topic. Next image views alternative variant names editor available in [[Traditional topic panel]]. Alternative variant names editor can be used to edit variant names with non-schema scopes.
 To add a topic a variant name with non-schema scope, right click the '''Variant names''' box title and select menu option '''Add variant name'''. Wandora opens up a dialog window for a non-schema scoped variant name. Next image illustrates an use case where Wandora user is adding a topic a variant name '''Non-schema variant name here''' with a single scope topic '''Schema type'''.

← Older revision		Revision as of 14:09, 22 May 2013
Line 59:		Line 59:

	* [[Editing topics and associations]]		* [[Editing topics and associations]]
−
−	* [[Modifying base name]]
−	* [[Modifying subject locator]]
−	* [[Modifying subject identifiers]]
−	* [[Modifying variant names]]
−	* [[Modifying topic classes]]
−	* [[Modifying associations]]
−	* [[Modifying occurrences]]

	== Topic panels ==		== Topic panels ==

@@ Line 1: / Line 1: @@
-Occurrence is a solid text block associated to the topic. For historical reasons Wandora calls occurrences also as '''Text datas'''. Occurrence has a '''type''' and a '''scope'''. Type is a topic that describes the occurrence, '''date of birth''' for example. Scope is also a topic describing the occurrence. Usually scope specifies the language of the occurrence. Occurrence is added to a topic by selecting '''Add occurrence...''' menu option. Option opens a dialog window:
+#REDIRECT [[Editing topics and associations]]
-−
-−
-[[Image:Schemaless_textdata_editor.gif|center]]
-−
-−
-Occurrence creation dialog has a button for occurrence type topic and text fields for all languages in Wandora schema. To create an occurrence, user has to select type topic and write text in one or more text fields, and finally click '''OK''' button.
-−
-Occurrence editor doesn't allow user to specify occurrence languages freely. This is usually enough as languages should not vary too much. To add occurrence of non-listed language, add your language topic as an instance to '''Wandora language'''. Read more [[How to add another variant name language|here]].
-−
-Topic map standard supports also URL occurrences addition to text occurrences. However, Wandora does '''not''' support URL occurrences as it is possible to set URL's external representation, the string representing URL, as the occurrence.
-−
-After occurrence creation Wandora user can edit occurrences. To edit single occurrence, user has to click the text field showing occurrence's first words and Wandora opens up an occurrence editor. Occurrence editor is shown below. Editor contains some additional features compared to creation dialog. For example, user can strip html elements in occurrence text with a menu option '''Edit > Strip HTML tags'''. '''Refine''' menu contains occurrence text classifiers and topic finders for example.
-−
-−
-[[Image:occurrence_editor.gif|center|Editing occurrence after initial addition.]]
-−
-−
-More advanced occurrence operations are found in '''Topics > occurrence''' menu of topic tables. These operations include:
-−
-* '''Delete occurrences with type''' removes occurrences of given type from context topics.
-* '''Delete all occurrences''' removes all occurrences from context topics.
-* '''Regex replace''' modifies occurrence text with given regular expression. This can be used to perform rather complicated search and replace operations for example.
-−
-See also page [[Refining occurrences]] for some advanced occurrence editing options.
-−
-−
-== See also ==
-−
-* [[Modifying base name]]
-* [[Modifying subject locator]]
-* [[Modifying subject identifiers]]
-* [[Modifying variant names]]
-* [[Modifying topic classes and instances]]
-* [[Modifying associations]]

@@ Line 1: / Line 1: @@
-Associations link topics together into doubles, triplets etc. Association is a named hyper-edge connecting topics. In Wandora, an association is added by selecting '''Add association...'''. Association is modified by selecting association row in association table and selecting option '''Modify association...'''. Both options open up an association editor. Next image views Wandora's traditional topic panel of a topic '''In No Sense? Nonsense! (album)''' which appears to be one of '''The Art of Noise's''' album. Red circle marks associations where the album plays a role i.e. associations which somehow connect the album topic to other topics.
+#REDIRECT [[Editing topics and associations]]
-−
-−
-[[Image:traditional_topic_panel_associations.gif|center|Adding association to a topic]]
-−
-−
-Adding association results empty association editor while Modify association fills editor fields with roles, players and type of the selected association. Association editor is used to add and modify one association at time. Next image views an association editor where type and roles have not been selected yet.
-−
-−
-[[Image:schemaless_association_editor.gif|center|Adding association to a topic]]
-−
-−
-To create an association the user must pick a type, player and role topics for the association. Association creation is discussed more detailed in [[Create new association]].
-−
-Wandora includes also more sophisticated association modification options. To reveal available options right click on association table. Context menu should contain at least:
-−
-* '''Delete associations...''' is used to remove selected associations in current topic table. Deletion is confirmed from Wandora user.
-* '''Change type...''' is used to change association type topic of selected association in current topic table. Wandora asks new type topic with topic request dialog.
-* '''Change role...''' is used to change one of the association roles of selected association in current topic table. Wandora asks which role is replaced and which topic replaces old role.
-* '''Insert player...''' inserts user selected player (with user selected role) to selected associations. This option is especially handy if you need to add same player to numerous associations.
-* '''Delete players...''' is used to remove selected columns i.e. players from selected associations. Note that your selection in association table really defines what players Wandora removes. Wandora confirms deletion from user.
-* '''Swap players within''' changes player roles in selected associations. Option creates a symmetric association that has different role order. Option is useful when roles are somehow similar (for example ''neighbour-1'' and ''neighbour-2'') and you need to refactor large number of associations.
-* '''Create symmetric associations...''' is similar to '''Swap players within''' but doesn't remove original associations.
-* '''Delete symmetric associations...''' compares selected associations to all other associations in Wandora and deletes association if symmetric duplicate is found. Symmetric duplicate is an association with same players and roles but role order is different.
-* '''Collect binary to n-ary...''' is used to change multiple binary associations into a single association with multiple players. To work properly all binary association should share one player.
-* '''Split n-ary to binary...''' converts one association with multiple players to multiple binary associations. User must select one player as shared player. Shared player ties binary associations together.
-−
-−
-== See also ==
-−
-* [[Modifying base name]]
-* [[Modifying subject locator]]
-* [[Modifying subject identifiers]]
-* [[Modifying variant names]]
-* [[Modifying topic classes and instances]]
-* [[Modifying occurrences]]

← Older revision		Revision as of 14:08, 22 May 2013
Line 1:		Line 1:
−	#REDIRECT [[~~Modifying topic classes~~ and ~~instances~~]]	+	#REDIRECT [[Editing topics and associations]]

@@ Line 1: / Line 1: @@
-Variant names are scoped topic names. Scope is a set of topics and specify the type of a name. Usually the scope contains at least two topics, one for language and one for name type. However, scope may contain more than two topics or none topics. 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 are edited directly in the fields of a topic panel. Next image views a [[Traditional topic panel]] with a Variant name matrix marked with a red circle.
+#REDIRECT [[Editing topics and associations]]
-−
-−
-[[File:variant_names_traditional.gif|center]]
-−
-−
-To view and edit variant names with non-schema scopes, user can right mouse click the '''Variant names''' box title and select context menu option '''View > View all scopes'''. Wandora changes the look of variant name panel and views now all variant names of the topic. Next image views alternative variant names editor available in [[Traditional topic panel]]. Alternative variant names editor can be used to edit variant names with non-schema scopes.
-−
-−
-[[File:variant_names_traditional.gif|center]]
-−
-−
-To add a topic a variant name with non-schema scope, right click the '''Variant names''' box title and select menu option '''Add variant name'''. Wandora opens up a dialog window for a non-schema scoped variant name. Next image illustrates an use case where Wandora user is adding a topic a variant name '''Non-schema variant name here''' with a single scope topic '''Schema type'''.
-−
-−
-[[File:add_variant_name.gif|center]]
-−
-−
-Notice, non-schema variant names are not viewed in variant name matrix. However, the number beside '''Variant names''' box title counts also non-schema variant names.
-−
-For more advanced variant name operations use tools in '''Topics > Variant names'''. Menu includes options:
-−
-* '''Copy all variant names''' copies topic's variant names to clipboard. Also invisible variants i.e. variant that are not specified with schema, are copied to clipboard. This can be used to check what kind of variant names topic has.
-* '''Regex replace''' is used to modify topic's variant names with user given regular expression.
-* '''Remove new line characters''' deletes new line characters in variant names of current topic.
-* '''Remove variant name''' deletes variant name of given type and scope.
-* '''Remove all empty variant names''' deletes all zero length variant names in topic.
-* '''Remove all variant names''' deletes all variant names in topic. Also invisible variants i.e. variants that have not been defined in schema, are deleted.
-* '''Make display variants with base name''' copies topic's base name to all schema specified display variants.
-−
-By default Wandora supports four language topics. These are Finnish, Swedish, English, and Language Independent. By default Wandora supports two name types: a Display name and a Sort name. Extending Wandora's language and the name type support is easy. To add Wandora a 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.
-−
-−
-== See also ==
-−
-* [[Transform variant names to topics and associations]]
-* [[Add missing language scope to variant names]]
-* [[Add missing display scope to variant names]]
-* [[How to add another variant name language]]
-* [[How to add another variant name type]]
-* [[Modifying base name]]
-* [[Modifying subject locator]]
-* [[Modifying subject identifiers]]
-* [[Modifying topic classes and instances]]
-* [[Modifying associations]]
-* [[Modifying occurrences]]

← Older revision		Revision as of 14:07, 22 May 2013
Line 1:		Line 1:
−	#REDIRECT [[Editing topics]]	+	#REDIRECT [[Editing topics and associations]]

← Older revision		Revision as of 14:06, 22 May 2013
Line 1:		Line 1:
−	#REDIRECT [[Editing topics]]	+	#REDIRECT [[Editing topics and associations]]

@@ Line 1: / Line 1: @@
-Each topic has one or more subject identifiers in Wandora. Subject identifiers are practically URLs referring to subject indicators i.e. resources that describe the subject. However, subject identifier URLs do not necessarily resolve, there is no real resource subject identifier refers. Subject identifiers are unique and topics with same same subject identifier are automatically merged.
+#REDIRECT [[Editing topics]]
-−
-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.
-−
-[[Image:Add_si.gif|center|Subject identifier is added to a topic with external dialog]]
-−
-Subject identifier is removed by right clicking the subject identifier and selecting '''Remove selected...'''. 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:
-−
-* '''Copy SIs''' copies topic's subject identifiers to clipboard. New line character is used as subject identifier separator.
-* '''Paste SIs''' injects URLs in clipboard to current topic as subject identifiers. If subject identifier already exists in another topic, topics are instantly merged.
-* '''Remove references in SIs''' modifies topic's subject identifiers by removing the URL reference. URL reference is a part of URL address that starts with '''#''' character.
-* '''Regex replace SIs''' modifies topic's subject identifiers with user given regular expression.
-* '''Fix SIs''' modifies subject identifiers by replacing all illegal characters with underscore ('''_''') character.
-* '''Flatten identity''' removes all but one subject identifier in topic. Remaining subject identifier is arbitrary.
-* '''Make SI with SL''' adds topic new subject identifier identical to topic's subject locator. If topic has no subject locator, no subject identifier is added.
-* '''Make SI with base name''' adds topic new subject identifier constructed using topic's base name and user given URL body.
-* '''Make SI with occurrence''' adds topic new subject identifier constructed using topic's occurrence and user given URL body.
-−
-== See also ==
-−
-* [[Modifying base name]]
-* [[Modifying subject locator]]
-* [[Modifying variant names]]
-* [[Modifying topic classes and instances]]
-* [[Modifying associations]]
-* [[Modifying occurrences]]

@@ Line 1: / Line 1: @@
-Subject locator is an URL resource that '''is''' the topic. Topic may have zero or one subject locator. If two topics have same subject locator, topics merge automatically.
+#REDIRECT [[Editing topics]]
-−
-To modify topic's subject locator open the topic to a topic panel such as [[Traditional topic panel]] and edit panel's subject locator field. Writing URL to the field adds subject locator to the topic. Emptying the field removes topic's subject locator. Next image views [[Traditional topic panel]] and subject locator field marked with a red circle.
-−
-−
-[[File:sl_traditional_topic_panel.gif|center]]
-−
-−
-Although Wandora's topic map model does not resolve subject locators, Wandora application resolves the URL and views a thumbnail or an icon for the resource. Thumbnail or icon is viewed above the subject locator field in traditional topic panel. Some resource types such as image or HTML document can be modified with context tools. 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. More detailed:
-−
-* '''[[OpenSL|Open SL]]''' forks external application, Internet Explorer by default and passes the subject locator url to the application.
-* '''Check SL''' resolves subject locator URL and reports whether or not the URL resolves to a real internet resource. This is useful when you have to check if subject locators of an old topic map are still valid.
-* '''Download SL''' downloads the subject locator resource to local file system but doesn't change topic's subject locator.
-* '''Move subject locator''' downloads the subject locator resource to local file system and changes subject locator to point this local copy of SL resource.
-* '''Move to fileserver''' uploads the internet resource of subject locator URL to user specified file server and changes the subject locator to the address given by file server. File server refers here to a [[Setting up Wandora Piccolo server|Wandora-Piccolo server]].
-* '''Extract with SL''' contains submenus, one for each Wandora extractor. Selecting extractor in this context applies the extractor to the subject locator resource.
-* '''Regex replace''' changes topic's subject locator with user specified regular expression.
-* '''Remove SL''' removes topic's subject locator.
-* '''Make SL with base name''' construct subject locator for the topic using base name and user specified URL body.
-* '''Make SL with occurrence''' constructs subject locator for the topic using occurrence data and user specified URL body.
-−
-These editing options may sound trivial if you consider modifying one subject locator. However, applying editing option to multiple topics at once is much more useful.
-−
-== See also ==
-−
-* [[Modifying base name]]
-* [[Modifying subject identifiers]]
-* [[Modifying variant names]]
-* [[Modifying topic classes and instances]]
-* [[Modifying associations]]
-* [[Modifying occurrences]]

← Older revision		Revision as of 14:03, 22 May 2013
(One intermediate revision by one user not shown)
Line 1:		Line 1:
−	#REDIRECT Editing topics	+	#REDIRECT [[Editing topics]]

@@ Line 106: / Line 106: @@
 By default Wandora supports four language topics. These are Finnish, Swedish, English, and Language Independent. By default Wandora supports two name types: a Display name and a Sort name. Extending Wandora's language and the name type support is easy. To add Wandora a 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.
-=== See also ===
+=== Additional tips in editing variant names ===
 * [[Transform variant names to topics and associations]]
@@ Line 113: / Line 113: @@
 * [[How to add another variant name language]]
 * [[How to add another variant name type]]
 == Editing topic classes and instances ==
@@ Line 133: / Line 132: @@
 Also menu selections '''Topics > Add to topic > Add instance''' and '''Topics >Delete from topic > Delete instances''' can be used to add and delete instances.
-=== Additional notes ===
+=== Additional notes about Wandora's data model and used terminology ===
 Wandora models class-instance relations using internal data structures. Wandora doesn't contain a topic that represents the relation type or role types. This means that Wandora user can not use the relation '''class-instance''' nor role types '''class''' and '''instance''' in part of other relations. Wandora user can't set up a superclass of a '''class-instance''', for example.

← Older revision		Revision as of 13:54, 22 May 2013
Line 57:		Line 57:

	Wandora has a rich set of topic, association and occurrence editing features. Wandora user may edit single topic in a topic panel. Modifying an association takes place in separate dialog window, association editor. Similarly, modifying an occurrence takes place in a separate editor. See also tutorial videos on [http://www.wandora.org/wandora/tv/ wandoratv].		Wandora has a rich set of topic, association and occurrence editing features. Wandora user may edit single topic in a topic panel. Modifying an association takes place in separate dialog window, association editor. Similarly, modifying an occurrence takes place in a separate editor. See also tutorial videos on [http://www.wandora.org/wandora/tv/ wandoratv].
		+
		+	* [[Editing topics]]

	* [[Modifying base name]]		* [[Modifying base name]]

@@ Line 5: / Line 5: @@
 The concept of layers and layer stack in Wandora is similar to the layer concept of many graphic creation and manipulation applications such as Adobe's PhotoShop where single image may contain multiple layers and graphics designer manipulates one layer at a time. Layer implementation in graphic application ables the designer to isolate finished image parts from unfinished and enables rapid versioning. This is the motivation behind Wandora's layer implementation also. To make designer's life easier.
-Wandora's layer stack locates in bottom left corner of Wandora window. When you start Wandora, application reads topic map from '''conf/wandora.xtm''' and creates the layer  '''Base''' for it.
+Wandora's layer stack locates in bottom left corner of Wandora window. When you start Wandora, application reads topic map from '''conf/wandora.xtm''' and creates the layer  '''Base''' for it. Next image views a layer stack with three layers. Layer '''Base''' is active.
 To create another layer you can
@@ Line 12: / Line 16: @@
 * Select '''Layers > [[NewLayer|New layer]]''' or press '''ALT+N'''. This opens a layer creating dialog used to define layer type and properties.
-Wandora supports multiple different data storage options for topic maps. Usually memory stored topic map, i.e. Memory topic map is sufficient. However, the amount of memory limits also the size of potential topic maps. Database storage option is available for large topic maps with millions of topics and associations. Wandora also introduces special topic map constructs used to stack multiple topic maps into a single topic map, to filter and to mirror existing topic maps. Current version of Wandora supports next layer types, i.e. topic maps:
+Wandora supports multiple different data storage options for topic maps. Usually memory stored topic map, i.e. Memory topic map is sufficient. However, the amount of memory limits also the size of potential topic maps. Database storage option is available for large topic maps with millions of topics and associations. Wandora also introduces special topic map constructs used to stack multiple topic maps into a single topic map, to filter and to mirror existing topic maps. Current version of Wandora supports next layer types:
 * [[Layered topic map]]s
@@ Line 20: / Line 24: @@
 * [[Linked topic map]]s
 * [[Remote topic map]]s

@@ Line 22: / Line 22: @@
 == Changing topic panel's type ==
-To change topic panel's type select a topic panel and mouse click the topic panel icon bottom-right corner of Wandora window. Wandora views a list of available topic panel types and you can select the type you want. Next image views Wandora user changing a Traditional topic panel (with Occurrence type topic) to Graph topic panel.
+To change topic panel's type select a topic panel and mouse click the topic panel icon bottom-right corner of Wandora window. Wandora views a list of available topic panel types and you can select the type you want. Next image views Wandora user changing the active Traditional topic panel (with Occurrence type topic open) to Graph topic panel.
 == Different topic panels ==

← Older revision		Revision as of 12:32, 22 May 2013
(2 intermediate revisions by one user not shown)
Line 19:		Line 19:

	To maximize a topic panel you can press the rectangle icon that locates upper-right corner of topic panel's title bar. Once a topic panel is maximized, it covers the topic panel area completely and other topic panels are not visible. To restore topic panel's original position and size after maximization, mouse click the rectangle icon again.		To maximize a topic panel you can press the rectangle icon that locates upper-right corner of topic panel's title bar. Once a topic panel is maximized, it covers the topic panel area completely and other topic panels are not visible. To restore topic panel's original position and size after maximization, mouse click the rectangle icon again.
		+
		+	== Changing topic panel's type ==
		+
		+	To change topic panel's type select a topic panel and mouse click the topic panel icon bottom-right corner of Wandora window. Wandora views a list of available topic panel types and you can select the type you want. Next image views Wandora user changing a Traditional topic panel (with Occurrence type topic) to Graph topic panel.
		+
		+	== Different topic panels ==
		+
		+	* [[Traditional topic panel]]
		+	* [[Tabbed topic panel]]
		+	* [[Graph topic panel]]
		+	* [[Custom topic panel]]
		+	* [[Treemap topic panel]]
		+	* [[R topic panel]]
		+	* [[Processing topic panel]]
		+
		+	__NOTOC__

@@ Line 68: / Line 68: @@
 == Topic panels ==
-Topic panel is Wandora's UI element to view and edit topics. Wandora supports several different topic panel types. Topic panels are managed with menu options under '''View'''. Wandora can view several topic panels simultaneously. Traditional topic panel views all topic elements in a table while tabbed panel views topic details in separate tabs. Graph topic panel is used for graph visualizations. Custom topic panel is based on user specific queries related to the current topic.
+Topic panel is Wandora's user interface element to view and edit topics. Wandora supports several different topic panel types. Topic panels are managed with menu options under '''View'''. Wandora can view several topic panels simultaneously. Traditional topic panel views all topic elements in a table while tabbed panel views topic details in separate tabs. Graph topic panel is used for graph visualizations. Custom topic panel is based on user specific queries related to the current topic.
 * [[Working with topic panels]]

← Older revision		Revision as of 12:01, 22 May 2013
(One intermediate revision by one user not shown)
Line 4:		Line 4:

	To delete any dockable, mouse click the X button that locates right-upper corner of the dockable window. Alternatively choose a menu option under '''View > Close'''. Menu contains a list of all opened topic panels, and selecting a submenu item closes the panel. Selecting menu option '''View > Close current''' closes only active topic panel. Active topic panel has blue title bar. Choosing a menu option '''View > Close all''' closes all topic panels.		To delete any dockable, mouse click the X button that locates right-upper corner of the dockable window. Alternatively choose a menu option under '''View > Close'''. Menu contains a list of all opened topic panels, and selecting a submenu item closes the panel. Selecting menu option '''View > Close current''' closes only active topic panel. Active topic panel has blue title bar. Choosing a menu option '''View > Close all''' closes all topic panels.
		+

	[[File:docking_topic_panel.gif\|center]]		[[File:docking_topic_panel.gif\|center]]
		+
		+	== Moving topic panels ==
		+
		+	You can change the location and size of topic panels by dragging. To move a topic panel requires that there exists more than one topic panel. A single topic panel can not be moved nor re-sized. It always covers the available size and is always maximized. To move a topic panel, press left mouse button over the title bar of the topic panel, keep mouse button pressed and move the mouse pointer. Wandora views visual clues about possible locations. Notice, a topic panel can't never move outsize Wandora window.
		+
		+	== Resizing topic panels ==
		+
		+	To re-size a topic panel, find a gap between it and it's neighbor, and press mouse button while the mouse pointer changes to an arrow line. Then drag the gap to the location that suits you best. If you re-size one topic panel, another topic panel is re-sized too.
		+
		+	== Maximizing topic panels ==
		+
		+	To maximize a topic panel you can press the rectangle icon that locates upper-right corner of topic panel's title bar. Once a topic panel is maximized, it covers the topic panel area completely and other topic panels are not visible. To restore topic panel's original position and size after maximization, mouse click the rectangle icon again.