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
