Skip to content

Latest commit

 

History

History
125 lines (81 loc) · 5.56 KB

readme.md

File metadata and controls

125 lines (81 loc) · 5.56 KB
Raw

WebVOWL Integration

This is an attempt to integrate the OWL visualization VOWL into WebProtégé. We believe this could be a valuable extension because VOWL received positive feedback as a comprehensive and understandable ontology visualization.

Where can I find the specification and a demo?

You can find everything at http://vowl.visualdataweb.org/

WebProtégé

XDP

eXtreme Design for WebProtégé (XDP) is an extension to standard WebProtégé supporting the use of Ontology Design Patterns (ODPs) and the eXtreme Design ontology engineering method. In order to run XDP you will, in addition to the codebase held in this repository, need to run an instance of XdpServices that the extension uses to search and browse for ODPs, and return ODP metadata and OWL representations. Additionally, the XdpShared package holding shared data classes used for communication needs to be installed in the local Maven repository in order for either of the two projects to build.

By default XdpServices runs on port 7777, and by default XDP looks for it on localhost at that port. If you run XdpServices on another machine or port, please update src/main/resources/edu/stanford/bmir/protege/web/server/xd/XdpService.properties to reflect this.

What is WebProtégé?

WebProtégé is a free, open source collaborative ontology development environment for the Web.

It provides the following features:

  • Support for editing OWL 2 ontologies
  • A default simple editing interface, which provides access to commonly used OWL constructs
  • Full change tracking and revision history
  • Collaboration tools such as, sharing and permissions, threaded notes and discussions, watches and email notifications
  • Customizable user interface
  • Customizable Web forms for application/domain specific editing
  • Support for editing OBO ontologies
  • Multiple file formats for upload and download of ontologies (supported formats: RDF/XML, Turtle, OWL/XML, OBO, and others)

WebProtégé runs as a Web application. End users access it through their Web browsers. They do not need to download nor install any software. We encourage end users to use our hosted solution at: http://webprotege.stanford.edu

This README file

This README file describes how to build and run WebProtege. This file is intended for developers or administrators who want to use WebProtege locally.

If you have downloaded the webprotege war file from GitHub, and would like to deploy it on your own server, please follow the instructions at: http://protegewiki.stanford.edu/wiki/WebProtegeAdminGuide

If you would like to build WebProtege yourself, or if you are developing a plugin for WebProtege, please read the information below.

Dependencies

  1. mongoDB URL: http://www.mongodb.org/

You also need Java (1.6 or later), Maven, and a servlet container, such as tomcat.

Building WebProtege for Use on Local Host

Open a terminal in the webprotege directory and type

mvn package

WebProtege will be built as a .war file in the target directory. By default, the WebProtege data directory (where WebProtege stores project data etc.) is /data/webprotege. If you want to change this location you can specify a different location at build time using -Ddata.directory=<YOURPATH>. For example,

mvn -Ddata.directory=/mypath/mydirectory package

or on Windows

mvn -Ddata.directory=C:\mypath\mydirectory package

data.directory is a configuration property. You may want to change some of the other WebProtege configuration properties. You can do this when building by specifying the relevant property as a command line argument as above.

For a detailed list of supported properties please see webprotege.properties

Running

DevMode can be started with:

mvn gwt:run

Note that, if you need to override any default property values then you must specify these as arguments (otherwise default values will be used). For example,

mvn -Ddata.directory=/mypath/mydirectory gwt:run

WebProtege can also be deployed into into tomcat by copying the .war file to the webapps folder in your tomcat installation.

Note: you need mongodb to run WebProtege. Please make sure mongodb is running. Find more information at: http://protegewiki.stanford.edu/wiki/WebProtegeAdminGuide#Install_mongoDB

Building WebProtege for Deployment on your Servers

The above steps build WebProtege for local testing on your machine (localhost). For deployment to another machine for production use you should active the deployment profile. To do this include -Pdeployment as an argument. You MUST also include a value for the property application.host, which is the domain name where you will deploy WebProtege. If you do not include this property value the build will fail with an error message. For example,

mvn -Pdeployment -Dapplication.host=mycompany.com package

Configuration

WebProtege can be configured and customized in different ways, e.g. UI layout, email, etc. Please find more information here: http://protegewiki.stanford.edu/wiki/WebProtegeAdminGuide#Configuration_and_Customization_.28optional.29

Documentation

More documentation at: http://protegewiki.stanford.edu/wiki/WebProtege