Difference between revisions of "ProtegeDesktopUserDocs"

From Protege Wiki
Jump to: navigation, search
(Build status & release notes: updated build status to reflect new beta build)
 
(68 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<div class="orangeBox">
+
= Protege Desktop User Documentation =
<span class="orangeBoxTitle">Protege 4 User Documentation</span>
 
  
This page contains a collection of links to documentation for end users of the Protege 4.x series.
+
This page is the official documentation home for the '''Protege Desktop application versions 4, 5 and higher'''.
  
Please give us your feedback!  We have a mailing list specifically for discussion about Protege 4.x.  You can subscribe to the list via the list information page: http://mailman.stanford.edu/mailman/listinfo/p4-feedback.
 
  
 +
__TOC__
  
'''16 Jun 2010:''' Protege 4.1 beta release&nbsp;&nbsp;([[Protege_4.1_Beta_Release_Notes|more]])<br />
 
'''04 Mar 2010:''' Protege 4.1 alpha release&nbsp;&nbsp;([[Protege_4.1_Alpha_Release_Notes|more]])<br />
 
'''03 Dec 2009:''' Protege 4.0.2 patch release&nbsp;&nbsp;([[Protege 4.0.2 Release Notes|more]])<br/>
 
</div><br />
 
  
__TOC__
+
== Build status & release notes ==
  
== Protege 4 status ==
+
The latest version of Protege Desktop is '''5.5''':
  
=== Build status & release notes ===
+
* [https://github.com/protegeproject/protege-distribution/releases Release notes]
 +
* [[Install_Protege5|Installation instructions]]
 +
* [http://protege.stanford.edu/products.php#desktop-protege Download latest version of Protege]
  
The latest Protege 4 build is the '''[[Protege 4.1 Beta Release Notes|4.1 beta release (build 206)]]''' from July 30, 2010.
+
You may also download [[Protege_Desktop_Old_Versions|previous versions of Protege]] and read the complete list of release notes. Older Protege 5.0 beta release notes are available [[Protege_5.0_Beta_Release_Notes|here]].
  
To help you decide whether to update, we maintain a complete list of release notes for prior versions of Protege 4:
+
== Bugs & feature requests ==
  
* [[Protege 4.1 Alpha Release Notes|Protege 4.1 alpha builds]]
+
Before you report a bug or feature request, check the [http://protege-project.136.n4.nabble.com/ Protege mailing lists archives] to ensure it hasn't already been reported. If the item is not currently open or you have further information or a question about an existing item, please post a message on the [http://mailman.stanford.edu/mailman/listinfo/protege-user protege-user mailing list]. Give as much detail as possible (including examples or ontologies if possible) as this will help us track things down more quickly.
* [[Protege 4.0.2 Release Notes|Protege 4.0.2 patch release]], December 3, 2009
 
* [[Protege 4.0.1 Release Notes|Protege 4.0.1 patch release]], October 28, 2009
 
* [[P4 Release Announcement|Protege 4.0 release]], June 16th, 2009
 
* [http://protege.cim3.net/download/old-releases/4.0%20rc1/_ReleaseNotes_4.0_RC1.html Protege 4.0 RC1], June 1st, 2009
 
* [http://protege.cim3.net/download/old-releases/4.0%20betas/_ReleaseNotes_4.0_Betas.html Protege 4.0 beta builds]
 
* [[Protege 4 beta announcement|Protege 4.0 beta announcement]]
 
* [http://protege.cim3.net/download/old-releases/4.0%20alphas/_ReleaseNotes_4.0_Alphas.html Protege 4.0 alpha builds]
 
  
=== Bugs & feature requests ===
+
Current GitHub issue tracker: https://github.com/protegeproject/protege/issues?state=open
  
Before you report a feature request or potential bug, check the lists below to ensure it hasn't already been reported. If the item is not currently open or you have further information or a question about an existing item, please post a message on the [http://mailman.stanford.edu/mailman/listinfo/p4-feedback Protege 4 mailing list].  Give as much detail as possible (including examples or ontologies if possible) as this will help us track things down more quickly.
 
  
* [https://bmir-gforge.stanford.edu/gf/project/owleditor/tracker/?action=TrackerItemBrowse&tracker_id=121 Feature request tracker] - a searchable list of features that have been requested (and implemented)
+
== Frequently asked questions ==
  
* [https://bmir-gforge.stanford.edu/gf/project/owleditor/tracker/?action=TrackerItemBrowse&tracker_id=118 Bugtracker] - a searchable list of reported and resolved bugs
+
We've put together a wiki page to answer the [[Protege-OWL_4_FAQ | most commonly asked questions]] about Protege Desktop.
  
=== Documentation TODO list ===
 
  
To follow is list of considerations for improving Protege itself, the documentation, and this wiki.
+
== Getting started / tutorials ==
  
* Convert [http://www.co-ode.org/resources/tutorials/protege-owl-tutorial.php A Practical Guide Guide to Building Ontologies...] to a collection of Wiki pages so that the guide can be more easily shared, searched, modified, commented on, referenced by section, extended, etc.
+
The Getting started and tutorials have been moved to the [[Main_Page|main page]] of the wiki.
  
== Protege-OWL Editor ==
 
  
=== [[Protege-OWL_4_FAQ | Protege-OWL FAQ]] ===
+
== Editor features ==
  
We have put together a wiki page to answer the most commonly asked questions about the 4.x series of the Protege application:
+
* [[Protege4Features | Overview of features]] - a quick summary of the editor
 +
* [[Protege4Views | Protege views guide]] - a list of all of the default views that are distributed with Protege
 +
* [[Protege4Shortcuts | Protege menu guide]] - all of the default menus explained in detail (with keyboard shortcuts)
 +
* [[Protege4Preferences | Protege preferences guide]] - customizing Protege to your needs
 +
* [[Protege4NamingAndRendering|Naming and rendering of entities]] - a note on naming things in OWL and configuring Protege to support your naming conventions
 +
* [[Protege4ExpressionEditor | Protege expression editor]] - adding and editing OWL expressions in Protege
 +
* [[Manchester_OWL_Syntax|Manchester OWL Syntax]] - an overview of the default syntax used by Protege
 +
* [[DLQueryTab | DL Query tab]] - how to query using arbitrary class expressions in OWL
 +
* [[Importing_Ontologies_in_P41|OWL Imports]] -  modular ontology support in OWL and Protege
 +
* [[Protege4AxiomAnnotations|Axiom annotations]] - how to annotate at axiom level in Protege
 +
* [[Protege4OWLDiff|Protege OWL Diff]] - compare two versions of an ontology
  
=== Getting started / tutorials ===
+
== Advanced features ==
  
* [[Protege4GettingStarted | Getting started with the Protege-OWL editor]] - a short guide to the interface
+
* [[BeanShell | The Bean Shell]] - Making complex queries against an ontology.
* [[Protege4Pizzas10Minutes | Pizzas in 10 minutes: A demo of  modeling shortcuts]] - a quickstart guide to creating your first OWL ontology
+
* [[Protege4ClientServer | The Protege 4 Server]]
* [http://owl.cs.manchester.ac.uk/tutorials/protegeowltutorial/ A Practical Guide to Building OWL Ontologies using Protege 4 and CO-ODE Tools] - a substantial guide to OWL and ontology engineering
 
* Cody Burleson's [http://www.semanticfocus.com/blog/entry/title/introduction-to-semantic-web-vision-and-technologies-part-5-building-owl-ontologies-using-protege-4-screencast/ screencast] version of the tutorial listed directly above (it would be great if he got some encouragement for part 6).
 
  
=== Editor features ===
 
  
* [[Protege4Features | Overview of features]] - a quick summary of the editor
+
== Further setup / configuration ==
* [[Protege4Views | P4 views guide]] - a list of all of the default views that are distributed with P4
 
* [[Protege4Shortcuts | P4 menu guide]] - all of the default menus explained in detail (with keyboard shortcuts)
 
* [[Protege4Preferences | P4 preferences guide]] - customising P4 to your needs
 
* [[Protege4NamingAndRendering|Naming and rendering of entities]] - a note on naming things in OWL and configuring P4 to support your naming conventions
 
* [[Protege4ExpressionEditor | P4 expression editor]] - adding and editing OWL expressions in P4
 
* [[Manchester_OWL_Syntax|Manchester OWL Syntax]] - an overview of the default syntax used by P4
 
* [[DLQueryTab | DL Query tab]] - how to query using arbitrary class expressions in OWL
 
* [[P4AnonymousClasses|Anonymous classes]] - support in P4 for class expressions
 
* [[Importing_Ontologies_in_P41|OWL Imports]] -  modular ontology support in OWL and P4.1
 
* [[Protege4AxiomAnnotations|Axiom annotations]] - how to annotate at axiom level in Protege 4
 
 
 
=== Further setup / configuration ===
 
  
 
* [[ChangingTheHeapSize|Adding more memory]]
 
* [[ChangingTheHeapSize|Adding more memory]]
 
* [[EnablingDoubleClick|Double-clicking on OWL files]]
 
* [[EnablingDoubleClick|Double-clicking on OWL files]]
* [[ClearingP4Preferences|Dealing with P4 preferences problems]]
+
* [[ClearingP4Preferences|Dealing with Protege preferences problems]]
 +
* [[Working with firewalls and proxies]]
 +
 
  
 
== Plugins ==
 
== Plugins ==
Line 82: Line 66:
 
=== Finding plug-ins ===
 
=== Finding plug-ins ===
  
* From build 104 P4 will find plugins and updates for you. See our [[EnablePluginAutoUpdate|Auto Update]] page.
+
* Protege will find plugins and updates for you. See our [[EnablePluginAutoUpdate|Auto Update]] page.
  
* [[Protege-OWL_4.0 | Plugins for Protege 4.x OWL editor]] - the list of "Compatible Plugins" on this page is the result of a semantic query that gathers all plug-ins that have declared themselves compatible with the 4.x version of the Protege-OWL editor.
+
* [[Protege-OWL_4.0 | Plugins for Protege]] - the list of all plugins compatible with different versions is available [[Protege_Plugin_Library|here]].
  
* [http://www.co-ode.org/downloads/protege-x/plugins/ CO-ODE Protege 4.x Plugins] - the CO-ODE group at the University of Manchester is the biggest contributor of plug-ins to the Protege-OWL editor. This is a good place to go to download early releases and source code for CO-ODE developed plug-ins.
+
* [https://github.com/co-ode-owl-plugins CO-ODE Protege Plugins] - the CO-ODE group at the University of Manchester is the biggest contributor of plug-ins to the Protege editor. The CO-ODE plugins that are compatible with your installation of Protege will show up when going in the File menu -> Check for plugins
  
 
=== Advertising plug-ins ===
 
=== Advertising plug-ins ===
  
If you have developed a plug-in for Protege-OWL 4.x and you would like to contribute it to the community,
+
If you have developed a plug-in for Protege and you would like to contribute it to the community,
 
please see [[Protege4Contributing#Plugins|contributing plugins]].
 
please see [[Protege4Contributing#Plugins|contributing plugins]].
 +
  
 
== Contributing ==
 
== Contributing ==
  
 
Please see this page for details on how you can [[Protege4Contributing|contribute]].
 
Please see this page for details on how you can [[Protege4Contributing|contribute]].

Latest revision as of 14:19, December 22, 2021

Protege Desktop User Documentation

This page is the official documentation home for the Protege Desktop application versions 4, 5 and higher.



Build status & release notes

The latest version of Protege Desktop is 5.5:

You may also download previous versions of Protege and read the complete list of release notes. Older Protege 5.0 beta release notes are available here.

Bugs & feature requests

Before you report a bug or feature request, check the Protege mailing lists archives to ensure it hasn't already been reported. If the item is not currently open or you have further information or a question about an existing item, please post a message on the protege-user mailing list. Give as much detail as possible (including examples or ontologies if possible) as this will help us track things down more quickly.

Current GitHub issue tracker: https://github.com/protegeproject/protege/issues?state=open


Frequently asked questions

We've put together a wiki page to answer the most commonly asked questions about Protege Desktop.


Getting started / tutorials

The Getting started and tutorials have been moved to the main page of the wiki.


Editor features

Advanced features


Further setup / configuration


Plugins

Finding plug-ins

  • Protege will find plugins and updates for you. See our Auto Update page.
  • CO-ODE Protege Plugins - the CO-ODE group at the University of Manchester is the biggest contributor of plug-ins to the Protege editor. The CO-ODE plugins that are compatible with your installation of Protege will show up when going in the File menu -> Check for plugins

Advertising plug-ins

If you have developed a plug-in for Protege and you would like to contribute it to the community, please see contributing plugins.


Contributing

Please see this page for details on how you can contribute.