svn commit: r1213788 - in /incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager: registry.mdtext registry/ registry/language.mdtext

[al...@apache.org]

Author: alexdma
Date: Tue Dec 13 17:07:12 2011
New Revision: 1213788

URL: http://svn.apache.org/viewvc?rev=1213788&view=rev
Log:
STANBOL-402 : more content on ontology registries and registry language.

Added:
    incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry/
    incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry/language.mdtext
Modified:
    incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry.mdtext

Modified: incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry.mdtext
URL: http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry.mdtext?rev=1213788&r1=1213787&r2=1213788&view=diff
==============================================================================
--- incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry.mdtext (original)
+++ incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry.mdtext Tue Dec 13 17:07:12 2011
@@ -13,7 +13,7 @@ TODO
 
 ## Configuration
 
-Ontology registries (and, by extension, the libraries they reference) are configured by the Stanbol administrator via the Felix Web console. _Note that the following links assume Stanbol to be deployed on http://localhost:8080_
+Ontology registries (and, by extension, the libraries they reference) are configured by the Stanbol administrator via the Felix Web console. _Note that the following links assume Stanbol to be deployed on http://localhost:8080 ._
 
 1. Go to the [Felix console Configuration Manager](http://localhost:8080/system/console/configMgr) and select __Apache Stanbol Ontology Registry Manager__ (or follow this [direct link](http://localhost:8080/system/console/configMgr/org.apache.stanbol.ontologymanager.registry.impl.RegistryManagerImpl))
 2. Under __Registry locations__ you can add or remove the physical URIs of ontology registries, i.e. RDF resources that contain knowledge about ontology libraries.
@@ -28,11 +28,17 @@ To create a Registry, you simply need to
 
 Then upload the ontology on the Web and add it to the __Registry locations__ from the [Felix console Configuration](http://localhost:8080/system/console/configMgr/org.apache.stanbol.ontologymanager.registry.impl.RegistryManagerImpl).
 
+Note that not only can a single registry describe multiple libraries, but also multiple registries can describe the same library, each adding information on the ontologies referenced by it. Library descriptions are _monotonic_, in that registries can only _add_ information about libraries, never _remove_ any.
+
+### Access a cached ontology
+
+A cached ontology does not need to be loaded into an OntoNet scope or session in order to be available. It can be accessed at @/ontonet/{ontologyURI} .
+
 ### Service Endpoints
 
-Because the configuration of registries is a task for __administrators__, there are no RESTful APIs for modifying ontology registries.
+Because the configuration of registries is a task for __administrators__ and is performed through the Felix administration console, there are no RESTful services for modifying ontology registries. It is however possible to browse the known ontology libraries.
 
-- [__Libraries__](http://localhost:8080/ontonet/registry). If called from a Web browser, shows a list of known ontology libraries, and for each of them the caching state and the number of referenced ontologies. Supports only GET with no parameters, generates text/html only. 
+- [__Libraries__](http://localhost:8080/ontonet/registry). If called from a Web browser, shows a list of known ontology libraries, and for each of them the caching state and the number of referenced ontologies. _Note that this service does not provide information on the registries that describe these libraries; that is classified information for administrators._ This endpoint supports only GET with no parameters, and generates text/html only.
 
 ____
 _[Back to Ontology Manager](../ontologymanager.html)_
\ No newline at end of file

Added: incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry/language.mdtext
URL: http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry/language.mdtext?rev=1213788&view=auto
==============================================================================
--- incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry/language.mdtext (added)
+++ incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry/language.mdtext Tue Dec 13 17:07:12 2011
@@ -0,0 +1,25 @@
+Title: Ontology Registry Manager
+
+The following RDF code (in Turtle syntax) shows how to create an OWL individual for a library called <tt>SocialOntologies</tt> which contains the ontologies of [SIOC](http://sioc-project.org/ontology) and [Provenance](http://trdf.sourceforge.net/provenance/ns.html).
+
+    @prefix meta: <http://www.ontologydesignpatterns.org/schemas/meta.owl#> .
+    @prefix owl: <http://www.w3.org/2002/07/owl#> .
+    @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
+    @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
+    @prefix : <http://www.example.org/ontologies/registries#> .
+    @base <http://www.example.org/ontologies/registries> .
+    
+    :SocialOntologies rdf:type <http://www.ontologydesignpatterns.org/cpont/codo/coddata.owl#OntologyLibrary> ;
+              rdfs:label "Social Network Ontologies"^^xsd:string ;
+              owl:versionInfo "0.1"^^xsd:string ;
+              meta:hasOntology <http://rdfs.org/sioc/ns> ;
+              meta:hasOntology <http://trdf.sourceforge.net/provenance/ns.rdf> .
+
+You can also specify Library-Ontology relations the other way around, by stating them in the OWL individual that represents the ontology
+
+    <http://rdfs.org/sioc/ns> rdf:type <http://www.ontologydesignpatterns.org/cpont/codo/codkernel.owl#Ontology> ;
+              meta:isOntologyOf :SocialOntologies .
+
+____
+_[Back to RegistryOntology Manager](../registry.html)_
+_[Back to Ontology Manager](../../ontologymanager.html)_
\ No newline at end of file