Editing topics and associations - Revision history

Akivela: /* Editing occurrences */

2013-07-20T19:45:10Z

‎Editing occurrences

Akivela: /* Additional notes about Wandora's data model and used terminology */

2013-07-20T19:38:27Z

‎Additional notes about Wandora's data model and used terminology

Akivela: /* Editing variant names */

2013-07-20T19:29:18Z

‎Editing variant names

Akivela: /* Editing subject identifiers */

2013-07-20T19:25:45Z

‎Editing subject identifiers

Akivela at 19:19, 20 July 2013

2013-07-20T19:19:53Z

Akivela at 18:10, 20 July 2013

2013-07-20T18:10:04Z

Akivela: /* Editing variant names */

2013-05-22T14:14:58Z

‎Editing variant names

Akivela at 14:14, 22 May 2013

2013-05-22T14:14:03Z

Akivela at 14:12, 22 May 2013

2013-05-22T14:12:37Z

Akivela: Akivela moved page Editing topics to Editing topics and associations

2013-05-22T14:05:23Z

Akivela moved page Editing topics to Editing topics and associations

@@ Line 191: / Line 191: @@
 * '''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.
+* '''Modify occurrence with a regex...''' modifies an occurrence with a 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.

@@ Line 135: / Line 135: @@
 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.
+Wandora speaks of classes and instances while the Topic Maps standard speaks of '''types''' and instances. Reader should note that a '''type''' described in Topic map standard is equivalent to a concept of a '''class''' in Wandora.
 == Editing associations ==

@@ Line 96: / Line 96: @@
 * '''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.
+* '''Modify variant names with a regex''' is used to modify topic's variant names with a regular expression given by the user.
-* '''Remove new line characters''' deletes new line characters in variant names of current topic.
+* '''Remove new line characters''' deletes all 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 empty variant names''' deletes all zero length variant names in the 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.
+* '''Remove all variant names''' deletes all variant names in the topic.
-* '''Make display variants with base name''' copies topic's base name to all schema specified display variants.
+* '''Make display variants with a base name''' copies topic's base name to all 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.

@@ Line 69: / Line 69: @@
 * '''Remove references in subject identifiers''' modifies topic's subject identifiers by removing URL references. URL reference is a part of URL address that starts with a hash ('''#''') character.
 * '''Modify subject identifiers with a regex...''' modifies topic's subject identifiers with a given regular expression.
-* '''Fix subject identifiers''' modifies subject identifiers by replacing all illegal characters with underscore ('''_''') character.
+* '''Fix subject identifiers''' modifies subject identifiers by replacing all illegal characters with an underscore ('''_''') character.
-* '''Flatten identity''' removes all but one subject identifier in topic. Remaining subject identifier is arbitrary.
+* '''Flatten identity''' removes all but one subject identifier in topic. Remaining subject identifier is arbitrary. This feature is useful if the topic has merged many times and all subject identifiers all temporary.
 * '''Make subject identifier with a subject locator''' adds topic new subject identifier identical to topic's subject locator. If topic has no subject locator, no subject identifier is added.
 * '''Make subject identifier with a base name''' adds topic new subject identifier constructed using topic's base name and an URL body given by the user.
 * '''Make subject identifier with an occurrence''' adds topic new subject identifier constructed using topic's occurrence and an URL body given by the user.
 == Editing variant names ==

@@ Line 15: / Line 15: @@
 '''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.
+* '''Make base name with a subject identifier''' creates a base name for topic. Base name is created using topic's subject identifier. Created base name is the file part of a subject identifier. This feature is useful if you have imported an RDF document and would like to name topic stubs created with URIs. If topic already contains a base name, base name creation fails. You have to remove old base name first.
-* '''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.
+* '''Make base name with an occurrence''' creates a base name for the topic using an occurrence. If topic already contains a base name, base name creation fails silently. You have to remove old base name first.
-* '''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.
+* '''Modify base name with a regex''' allows you to modify base name with regular expressions.
-* '''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.
+* '''Remove new line characters''' removes all new line characters found in topic's base name. This may be necessary if you have imported a topic map to Wandora. Wandora can't view new line characters in base names.
-* '''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.
+* '''Collapse white spaces''' removes all additional white space characters after a white space. In other words, two or more sequential white space characters are replaced with a single white space character.
 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.
@@ Line 38: / Line 41: @@
 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.
+* '''[[OpenSL|Open subject locator...]]''' forks external application (handling URL addresses) and passes the subject locator url to the application. Usually the computer opens up a WWW browser with a page that has the subject locator URL.
-* '''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.
+* '''Check subject locator...''' 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.
+* '''Download subject locator''' downloads the subject locator resource to a local file system but doesn't change topic's subject locator. This is handy if you want to inspect the subject locator resource closer with an application in your local computer.
-* '''Move subject locator''' downloads the subject locator resource to local file system and changes subject locator to point this local copy of SL resource.
+* '''Download and change subject locator''' downloads the subject locator resource to a local file system and changes the subject locator to point downloaded copy of subject locator 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 subject locator''' contains submenus, one for each Wandora extractor that handles URLs. Selecting an extractor in this context applies the extractor to the subject locator URL.
-* '''Extract with SL''' contains submenus, one for each Wandora extractor. Selecting extractor in this context applies the extractor to the subject locator resource.
+* '''Modify subject locator with a regex...''' changes topic's subject locator with a user specified regular expression. Wandora uses [http://docs.oracle.com/javase/tutorial/essential/regex/ Java's regular expressions].
-* '''Regex replace''' changes topic's subject locator with user specified regular expression.
+* '''Remove subject locator...''' removes topic's subject locator.
-* '''Remove SL''' removes topic's subject locator.
+* '''Make subject locator with a base name''' construct subject locator for the topic using topic's base name and an URL body specified by the user.
-* '''Make SL with base name''' construct subject locator for the topic using base name and user specified URL body.
+* '''Make subject locator with an occurrence''' constructs subject locator for the topic using topic's occurrence and an URL body specified by the user.
-* '''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.
+These editing options may sound trivial if you consider modifying one subject locator. However, applying editing options 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.
+Each topic has one or more subject identifiers in Wandora. Each topic must have at least one subject identifier. Subject identifiers are practically URLs referring to subject indicators i.e. resources that describe the subject. However, subject identifier URLs do not necessarily resolve. In other words there is no real resource the subject identifier refers. Subject identifiers are unique and topics with same subject identifier are merged automatically.
-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.
+Topic panel doesn't allow direct edition of subject identifiers. To change a subject indentifier the user needs to add the changed subject identifier to the topic as a new one and then remove the old subject identifier. This rather illogical order of actions is required because topic must always contain 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.
+Subject identifier is removed by right clicking the subject identifier and selecting '''Remove selected subject identifiers...'''. 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.
+* '''Copy subject identifiers''' copies topic's subject identifiers to the system clipboard. New line character is used as a 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.
+* '''Paste subject identifiers''' injects URLs in the system clipboard to the current topic as subject identifiers. If pasted subject identifier already exists in any other 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.
+* '''Remove references in subject identifiers''' modifies topic's subject identifiers by removing URL references. URL reference is a part of URL address that starts with a hash ('''#''') character.
-* '''Regex replace SIs''' modifies topic's subject identifiers with user given regular expression.
+* '''Modify subject identifiers with a regex...''' modifies topic's subject identifiers with a given regular expression.
-* '''Fix SIs''' modifies subject identifiers by replacing all illegal characters with underscore ('''_''') character.
+* '''Fix subject identifiers''' 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 subject identifier with a subject locator''' 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 subject identifier with a base name''' adds topic new subject identifier constructed using topic's base name and an URL body given by the user.
-* '''Make SI with occurrence''' adds topic new subject identifier constructed using topic's occurrence and user given URL body.
+* '''Make subject identifier with an occurrence''' adds topic new subject identifier constructed using topic's occurrence and an URL body given by the user.
 == 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.
+Variant names are scoped topic names. Scope is a set of topics and specify the type of a name. Usually a scope contains at least two topics, one for language and one for name type. By default, [[Traditional topic panel]] views variant names in a name field matrix that has language paragraphs. Orientation of the name field matrix is changed with an option '''View > Flip name matrix''' found in a context menu of Variant names title header. Variant names are edited directly in the fields of a [[Traditional topic panel]]. Next image views a [[Traditional topic panel]] with a Variant name matrix marked with a red circle.
@@ Line 82: / Line 84: @@
-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 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 a 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'''.

@@ Line 1: / Line 1: @@
 This page is part of Wandora's documentation and covers editing of topics, topic's internal structures and associations. [[Traditional topic panel]] is used as the default editor although it is possible to edit topics and association in other topic panels too.
-== Editing a base name ==
+== Editing base names ==
 Topic's base name is modified by changing the contents of base name text field in topic panel. Emptying field removes the base name. 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.
@@ Line 24: / Line 24: @@
-== Editing a subject locator ==
+== Editing subject locators ==
 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.
@@ Line 104: / Line 104: @@
 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.
-=== Additional tips in editing variant names ===
+=== Additional tips for editing variant names ===
 * [[Transform variant names to topics and associations]]

← Older revision		Revision as of 14:14, 22 May 2013
Line 83:		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 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'''.		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:14, 22 May 2013
Line 1:		Line 1:
−	This page ~~tells about~~ editing topics, topic's internal structures and associations. [[Traditional topic panel]] is used as the default editor although it is possible to edit topics and association in other topic panels too.	+	This page is part of Wandora's documentation and covers editing of topics, topic's internal structures and associations. [[Traditional topic panel]] is used as the default editor although it is possible to edit topics and association in other topic panels too.

	== Editing a base name ==		== Editing a base name ==

← Older revision		Revision as of 14:12, 22 May 2013
Line 1:		Line 1:
		+	This page tells about editing topics, topic's internal structures and associations. [[Traditional topic panel]] is used as the default editor although it is possible to edit topics and association in other topic panels too.
		+
	== Editing a base name ==		== Editing a base name ==