Fresnel Forms Protégé plugin - Revision history

Lloyd Rutledge: /* User Manual */

2018-10-02T13:50:46Z

User Manual

Lloyd Rutledge: /* User Manual */

2018-10-02T13:46:05Z

User Manual

Lloyd Rutledge: images /* User Manual */

2018-10-02T13:43:36Z

images User Manual

Lloyd Rutledge: == User Manual == from auto-translated and cleaned ABI instruction PDF

2018-10-02T13:39:28Z

== User Manual == from auto-translated and cleaned ABI instruction PDF

Lloyd Rutledge: sort and nest /* Tips & Tricks */

2018-10-02T11:57:38Z

sort and nest Tips & Tricks

Lloyd Rutledge: /* Software Description */

2017-12-31T13:57:22Z

Software Description

Lloyd Rutledge: moved Fresnel Forms to Fresnel Forms Protégé plugin: Distinct from renewed MediaWiki extension

2017-12-31T13:50:41Z

moved Fresnel Forms to Fresnel Forms Protégé plugin: Distinct from renewed MediaWiki extension

Lloyd Rutledge: /* Installation Fresnel Forms for End Users */

2017-12-25T09:49:30Z

Installation Fresnel Forms for End Users

Lloyd Rutledge: == Publication == Lloyd Rutledge, Thomas Brenninkmeijer, Tim Zwanenberg, Joop van de Heijning, Alex Mekkering, J. N. Theunissen and Rik Bos. ''[http://link.springer.co/* Bachelors Thesis Document */

2017-12-22T13:17:34Z

== Publication == Lloyd Rutledge, Thomas Brenninkmeijer, Tim Zwanenberg, Joop van de Heijning, Alex Mekkering, J. N. Theunissen and Rik Bos. ''[http://link.springer.coBachelors Thesis Document

Lloyd Rutledge: http://is.cs.ou.nl/OWF/files/OU-ABI-30.pdf /* Bachelors Thesis Document */

2017-09-18T12:36:01Z

http://is.cs.ou.nl/OWF/files/OU-ABI-30.pdf Bachelors Thesis Document

@@ Line 129: / Line 129: @@
 The next option in the second mouse button menu is 'Add property, with which one can easily add a property to the clicked Lens. To do this, you must enter the name and URI of the property and the place (index) of the property in the lens box. The new Property in the list on the correct spot.
 === Appearance ===
@@ Line 135: / Line 137: @@
 The last option in the same menu is 'Edit CSS', in which five values for CSS style data can be filled in for a lens. This does not change the diagram, but this data gets included in the Fresnel file (see 'Save Fresnel').
 ===='Relabel' (property) ====

@@ Line 88: / Line 88: @@
 == User Manual ==
-===Startup ===
+=== Getting Started ===
 If, at the start of Protégé ,the tab of the plug-in is not among the other tabs in Protégé, the user must select the plug-in under 'Window >  Tabs'. Next, the user must load the desired ontology into Protégé via 'File > Open', either via a URL or a local file. After this, the user can navigate to the plug-in tab where the Start menu is displayed.
@@ Line 94: / Line 96: @@
 [[File:FFstartup.jpg]]
-===Default Fresnel ===
+====Default Fresnel ====
 The option 'default Fresnel' will generate a diagram that visually displays default Fresnel data for the loaded ontology. For each class, a lens is generated and represented by a 'box' in which all associated Properties appear in a list: the data properties in black, the object properties in blue. The lenses are structured hierarchically, in which the parent/child relations are indicated according to UML notation. The range of the object-Properties is visible when the mouse is above the specific lens box.
@@ Line 102: / Line 104: @@
 [[File:FFrange.jpg]]
-===Load Fresnel ===
+====Load Fresnel ====
 The 'Load Fresnel' option prompts the user to select an already existing Fresnel file. The file to be loaded must contain Fresnel data that fits with the already loaded ontology. If you want to read a Fresnel file that applies to another ontology, then first load that particular ontology into Protégé. After the file is selected, the diagram with the graphic representation of the Fresnel data displayed that the user last edited and saved. Hidden properties are displayed in gray, at the bottom of the list in the lens box (see 'Hide').
-===Save Fresnel ===
+====Save Fresnel ====
 The 'Save Fresnel' option will save the Fresnel data from the chart - either default or edited - into a local Fresnel file. If the diagram has been edited by the user, all graphical data such as positions of lens boxes, sequences of properties and more will also be stored.
-===Moving and adjusting order ===
+=== Structure ===
 The lens boxes can be moved by moving them with the mouse. Adjusting the order of the properties is done in the same way. When lens boxes are placed over each other, they will automatically be assigned a place so that there is no overlap.
@@ Line 116: / Line 120: @@
 [[File:FForder.jpg]]
-==='Hide' (Properties And Lenses) ===
+===='Hide' (Properties And Lenses) ====
 Clicking a property determines the visibility of a property (based on the Fresnel-property 'ShowProperties'). A property that should not be included will be grayed out after clicking. Also, a lens can be included or not and this one can do it by right-clicking the lens box button and the option 'Hide'. A lens that is not included are also grey.
@@ Line 122: / Line 126: @@
 [[File:FFhide.jpg]]
-==='Add Property' (lens) ===
+===='Add Property' (lens) ====
 The next option in the second mouse button menu is 'Add property, with which one can easily add a property to the clicked Lens. To do this, you must enter the name and URI of the property and the place (index) of the property in the lens box. The new Property in the list on the correct spot.
-=== 'Edit CSS' (lens) ===
+=== Appearance ===
 The last option in the same menu is 'Edit CSS', in which five values for CSS style data can be filled in for a lens. This does not change the diagram, but this data gets included in the Fresnel file (see 'Save Fresnel').
@@ Line 132: / Line 138: @@
 [[File:FFcss.jpg]]
-==='Relabel' (property) ===
+===='Relabel' (property) ====
 If you right-click on a property, a different menu is displayed specifically for the clicked property. The first option 'Relabel' Designates another value to the Fresnel-property ' abel'. The result is visible afterwards The Clicked property.
-==='Change type' (property) ===
+===='Change type' (property) ====
 The next option in the same 'Change type' menu provides a list of types for the property. If you make a different choice for the type, this is not displayed visually, but is included in the saved Fresnel file (see 'Save Fresnel').
-==='Hide' (property) ===
+===='Hide' (property) ====
 The next option in that menu does the same as a left mouse button on a property (see 'Hide').
-==='Edit CSS ' (property) ===
+===='Edit CSS ' (property) ====
 The last option in the menu, 'Edit CSS', gives the ability to fill in four values for CSS style data for a property. This does not change the diagram, but this data is included in the Fresnel file (see 'Save Fresnel').
 [[File:FFproperty.jpg]]

@@ Line 91: / Line 91: @@
 If, at the start of Protégé ,the tab of the plug-in is not among the other tabs in Protégé, the user must select the plug-in under 'Window >  Tabs'. Next, the user must load the desired ontology into Protégé via 'File > Open', either via a URL or a local file. After this, the user can navigate to the plug-in tab where the Start menu is displayed.
 ===Default Fresnel ===
 The option 'default Fresnel' will generate a diagram that visually displays default Fresnel data for the loaded ontology. For each class, a lens is generated and represented by a 'box' in which all associated Properties appear in a list: the data properties in black, the object properties in blue. The lenses are structured hierarchically, in which the parent/child relations are indicated according to UML notation. The range of the object-Properties is visible when the mouse is above the specific lens box.
 ===Load Fresnel ===
@@ Line 100: / Line 106: @@
 The 'Load Fresnel' option prompts the user to select an already existing Fresnel file. The file to be loaded must contain Fresnel data that fits with the already loaded ontology. If you want to read a Fresnel file that applies to another ontology, then first load that particular ontology into Protégé. After the file is selected, the diagram with the graphic representation of the Fresnel data displayed that the user last edited and saved. Hidden properties are displayed in gray, at the bottom of the list in the lens box (see 'Hide').
-===ave Fresnel ===
+===Save Fresnel ===
 The 'Save Fresnel' option will save the Fresnel data from the chart - either default or edited - into a local Fresnel file. If the diagram has been edited by the user, all graphical data such as positions of lens boxes, sequences of properties and more will also be stored.
@@ Line 107: / Line 113: @@
 The lens boxes can be moved by moving them with the mouse. Adjusting the order of the properties is done in the same way. When lens boxes are placed over each other, they will automatically be assigned a place so that there is no overlap.
 ==='Hide' (Properties And Lenses) ===
 Clicking a property determines the visibility of a property (based on the Fresnel-property 'ShowProperties'). A property that should not be included will be grayed out after clicking. Also, a lens can be included or not and this one can do it by right-clicking the lens box button and the option 'Hide'. A lens that is not included are also grey.
 ==='Add Property' (lens) ===
 The next option in the second mouse button menu is 'Add property, with which one can easily add a property to the clicked Lens. To do this, you must enter the name and URI of the property and the place (index) of the property in the lens box. The new Property in the list on the correct spot.
 'Edit CSS ' (lens)
 The last option in the same menu is 'Edit CSS', in which five values for CSS style data can be filled in for a lens. This does not change the diagram, but this data gets included in the Fresnel file (see 'Save Fresnel').
 ==='Relabel' (property) ===
 If you right-click on a property, a different menu is displayed specifically for the clicked property. The first option 'Relabel' Designates another value to the Fresnel-property ' abel'. The result is visible afterwards The Clicked property.
 'Change type' (property)
 The next option in the same 'Change type' menu provides a list of types for the property. If you make a different choice for the type, this is not displayed visually, but is included in the saved Fresnel file (see 'Save Fresnel').
@@ Line 127: / Line 143: @@
 The next option in that menu does the same as a left mouse button on a property (see 'Hide').
 'Edit CSS ' (property)
 The last option in the menu, 'Edit CSS', gives the ability to fill in four values for CSS style data for a property. This does not change the diagram, but this data is included in the Fresnel file (see 'Save Fresnel').

← Older revision		Revision as of 13:39, 2 October 2018
Line 85:		Line 85:
	## After selecting the ‘Expand all’ menu item select also the ‘rearrange’ menu item to be sure that the lenses do not overlap.		## After selecting the ‘Expand all’ menu item select also the ‘rearrange’ menu item to be sure that the lenses do not overlap.
	# In a form, for properties (not of type page) with multiple values, separate values by a comma. Separate URL's for an image property by a space, then a comma.		# In a form, for properties (not of type page) with multiple values, separate values by a comma. Separate URL's for an image property by a space, then a comma.
		+
		+	== User Manual ==
		+
		+	===Startup ===
		+
		+	If, at the start of Protégé ,the tab of the plug-in is not among the other tabs in Protégé, the user must select the plug-in under 'Window > Tabs'. Next, the user must load the desired ontology into Protégé via 'File > Open', either via a URL or a local file. After this, the user can navigate to the plug-in tab where the Start menu is displayed.
		+
		+	===Default Fresnel ===
		+
		+	The option 'default Fresnel' will generate a diagram that visually displays default Fresnel data for the loaded ontology. For each class, a lens is generated and represented by a 'box' in which all associated Properties appear in a list: the data properties in black, the object properties in blue. The lenses are structured hierarchically, in which the parent/child relations are indicated according to UML notation. The range of the object-Properties is visible when the mouse is above the specific lens box.
		+
		+	===Load Fresnel ===
		+
		+	The 'Load Fresnel' option prompts the user to select an already existing Fresnel file. The file to be loaded must contain Fresnel data that fits with the already loaded ontology. If you want to read a Fresnel file that applies to another ontology, then first load that particular ontology into Protégé. After the file is selected, the diagram with the graphic representation of the Fresnel data displayed that the user last edited and saved. Hidden properties are displayed in gray, at the bottom of the list in the lens box (see 'Hide').
		+
		+	===ave Fresnel ===
		+
		+	The 'Save Fresnel' option will save the Fresnel data from the chart - either default or edited - into a local Fresnel file. If the diagram has been edited by the user, all graphical data such as positions of lens boxes, sequences of properties and more will also be stored.
		+
		+	===Moving and adjusting order ===
		+
		+	The lens boxes can be moved by moving them with the mouse. Adjusting the order of the properties is done in the same way. When lens boxes are placed over each other, they will automatically be assigned a place so that there is no overlap.
		+
		+	==='Hide' (Properties And Lenses) ===
		+
		+	Clicking a property determines the visibility of a property (based on the Fresnel-property 'ShowProperties'). A property that should not be included will be grayed out after clicking. Also, a lens can be included or not and this one can do it by right-clicking the lens box button and the option 'Hide'. A lens that is not included are also grey.
		+
		+	==='Add Property' (lens) ===
		+
		+	The next option in the second mouse button menu is 'Add property, with which one can easily add a property to the clicked Lens. To do this, you must enter the name and URI of the property and the place (index) of the property in the lens box. The new Property in the list on the correct spot.
		+	'Edit CSS ' (lens)
		+	The last option in the same menu is 'Edit CSS', in which five values for CSS style data can be filled in for a lens. This does not change the diagram, but this data gets included in the Fresnel file (see 'Save Fresnel').
		+
		+	==='Relabel' (property) ===
		+
		+	If you right-click on a property, a different menu is displayed specifically for the clicked property. The first option 'Relabel' Designates another value to the Fresnel-property ' abel'. The result is visible afterwards The Clicked property.
		+	'Change type' (property)
		+	The next option in the same 'Change type' menu provides a list of types for the property. If you make a different choice for the type, this is not displayed visually, but is included in the saved Fresnel file (see 'Save Fresnel').
		+
		+	==='Hide' (property) ===
		+
		+	The next option in that menu does the same as a left mouse button on a property (see 'Hide').
		+	'Edit CSS ' (property)
		+	The last option in the menu, 'Edit CSS', gives the ability to fill in four values for CSS style data for a property. This does not change the diagram, but this data is included in the Fresnel file (see 'Save Fresnel').

@@ Line 73: / Line 73: @@
 == Tips & Tricks ==
-* To generate the project documentation locally, you can execute ‘mvn site’. After that, the resulting documentation will be present in the target/site folder of the source folder. The entry point for the documentation is index.html.
+# Documentation
-* Read the document ‘Userinterface instructie.docx’ before loading really large ontology’s like dbpedia.
+## To generate the project documentation locally, you can execute ‘mvn site’. After that, the resulting documentation will be present in the target/site folder of the source folder. The entry point for the documentation is index.html.
-* Before loading Fresnel, make sure Protégé has loaded the ontology the Fresnel style sheet was based on.
+## Read the document ‘Userinterface instructie.docx’ before loading really large ontology’s like dbpedia.
-* Show the superclass in the gui to prevent problems with inheriting attributes.
+# Before loading Fresnel, make sure Protégé has loaded the ontology the Fresnel style sheet was based on.
-* Make sure the lens boxes do not visibly overlap each other in the GUI. If they do, you may not be able to get the property menu when right clicking a property.
+# Opening ontologies
-* If you want to open an ontology a second time, open in a new window (might incur failure otherwise).
+## If you open a large ontology expand the lenses one by one. Do not activate the the right menu item ‘Expand all’
-* If you open a large ontology expand the lenses one by one. Do not activate the the right menu item ‘Expand all’
+## If you want to open an ontology a second time, open in a new window (might incur failure otherwise).
-* After selecting the ‘Expand all’ menu item select also the ‘rearrange’ menu item to be sure that the lenses do not overlap.
+# GUI
-* In a form, for properties (not of type page) with multiple values, separate values by a comma. Separate URL's for an image property by a space, then a comma.
+## Show the superclass in the gui to prevent problems with inheriting attributes.

← Older revision		Revision as of 13:57, 31 December 2017
Line 4:		Line 4:

	== Software Description ==		== Software Description ==
		+
		+	This is a deprecated version of Fresnel Forms. The functionality from this version is being merged into a renewed Semantic MediaWiki extension: ''[[Fresnel Forms SMW extension]]''.

	Fresnel Forms (FForms) is a plugin for the Protégé ontology editor that helps create Fresnel-defined interfaces, and exports them as semantic wiki's. FForms generates default Fresnel interface code for the ontology currently loaded in Protégé. This plugin then provide a GUI for editing Fresnel-defined interfaces. Finally, Fresnel Forms exports Fresnel-defined interfaces as semantic wikis. These wikis provide both browsing of existing data and form-based annotation interfaces for adding new data.		Fresnel Forms (FForms) is a plugin for the Protégé ontology editor that helps create Fresnel-defined interfaces, and exports them as semantic wiki's. FForms generates default Fresnel interface code for the ontology currently loaded in Protégé. This plugin then provide a GUI for editing Fresnel-defined interfaces. Finally, Fresnel Forms exports Fresnel-defined interfaces as semantic wikis. These wikis provide both browsing of existing data and form-based annotation interfaces for adding new data.

← Older revision	Revision as of 13:50, 31 December 2017
(No difference)

@@ Line 20: / Line 20: @@
 # Download and install these MediaWiki extensions:
 ## [http://semantic-mediawiki.org/ Semantic MediaWiki]
-## [http://www.mediawiki.org/wiki/Extension:Semantic_Forms Semantic Forms]
+## [https://www.mediawiki.org/wiki/Extension:Page_Forms Page Forms] (formerly [http://www.mediawiki.org/wiki/Extension:Semantic_Forms Semantic Forms])
 ## [http://www.mediawiki.org/wiki/Extension:ParserFunctions ParserFunctions]
 ## [http://www.mediawiki.org/wiki/Extension:Character_Escapes Character Escapes]

@@ Line 1: / Line 1: @@
-== Bachelors Thesis Document==
+== Publication ==
-Teun Theunissen, Joop van de Heijning and Alex Mekkering, ''[http://is.cs.ou.nl/OWF/files/OU-ABI-30.pdf "Fresnel Forms"]'', Bachelors Informatica Thesis, Team 30, Open University in the Netherlands, May 26th, 2016, Bachelors Thesis.
+Lloyd Rutledge, Thomas Brenninkmeijer, Tim Zwanenberg, Joop van de Heijning, Alex Mekkering, J. N. Theunissen and Rik Bos. ''[http://link.springer.com/chapter/10.1007/978-3-319-32667-2_4 From Ontology to Semantic Wiki – Designing Annotation and Browse Interfaces for Given Ontologies]'', Volume 9507 of the series Lecture Notes in Computer Science, pp 53-72, 16 April 2016.
 == Software Description ==