Author: alexdma
Date: Tue Dec 13 16:33:05 2011
New Revision: 1213772
URL: http://svn.apache.org/viewvc?rev=1213772&view=rev
Log:
STANBOL-402 : more content on ontology registries
Modified:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/components.mdtext
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/ontologymanager/registry.mdtext
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext
Modified:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/components.mdtext
URL:
http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/components.mdtext?rev=1213772&r1=1213771&r2=1213772&view=diff
==============================================================================
--- incubator/stanbol/site/trunk/content/stanbol/docs/trunk/components.mdtext
(original)
+++ incubator/stanbol/site/trunk/content/stanbol/docs/trunk/components.mdtext
Tue Dec 13 16:33:05 2011
@@ -12,7 +12,7 @@ This is an overview of the major feature
* The [Rules](rules.html) component provides you with the means to re-factor
knowledge graphs, e.g. for supporting the schema.org vocabulary for Search
Engine Optimization.
-* The [Reasoners](reasoners.html) can be used to automatically infer
additional knowledge. It is used to infer new facts in the knowledge base, e.g.
if you have enhanced your entity "Paris", you can get "France" via a
"located-in" relation.
+* The [Reasoners](reasoners.html) can be used to automatically infer
additional knowledge. It is used to obtain new facts in the knowledge base,
e.g. if your enhanced content tells you about a shop located in "Montparnasse",
you can infer via a "located-in" relation that the same shop is located in
"Paris", in the "%C3%8Ele-de-France" and in "France".
* The [Ontology Manager](ontologymanager.html) is the facility to manage all
your ontologies i.e. the knowledge models you use to describe your metadata of
your content as well as knowledge about the semantics of your content.
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=1213772&r1=1213771&r2=1213772&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 16:33:05 2011
@@ -1,10 +1,10 @@
Title: Ontology Registry Manager
-Registry management is a facility of the Ontology Manager that allows Stanbol
__administrators__ to pre-configure sets of ontologies that Stanbol should load
and store, or simply be aware of, __before__ they are included in a part of the
ontology network (e.g. a scope or session). Via the registry manager, it is
possible to configure whether these ontologies should be loaded immediately
when Stanbol is initialized, or only when explicitly requested. The Ontology
Registry Manager is essentially an ontology bookmarker with caching support. It
is also possible to cache multiple versions of the same ontology if needed.
+Registry management is a facility for Stanbol __administrators__ to
pre-configure sets of ontologies that Stanbol should load and store, or simply
be aware of, _before_ they are included in a part of the ontology network (e.g.
a scope or session). Via the registry manager, it is possible to configure
whether these ontologies should be loaded immediately when Stanbol is
initialized, or only when explicitly requested. The Ontology Registry Manager
is essentially an ontology bookmarker with caching support. It is also possible
to cache multiple versions of the same ontology if needed.
## Glossary
-* A __Library__ is a collection of references to ontologies.
+* A __Library__ is a collection of references to ontologies, which can be
located anywhere on the Web. CMS administrators and knowledge managers can
create a library by any criterion, e.g. a library of all _W3C ontologies_, a
library of all the ontologies that describe a _social network_ (which can
include [SIOC](http://sioc-project.org/ontology),
[FOAF](http://xmlns.com/foaf/spec) etc.), a library of _ontology alignments_
(which includes ontologies that align DBPedia to Schema.org, GeoNames to
DBPedia, or a custom product ontology to GoodRelations).
* A __Registry__ is an RDF resource (i.e. an ontology itself) that describes
one or more libraries. It is the physical object that has to be accessed to
gain knowledge about libraries.
## Usage Scenarios
@@ -13,9 +13,26 @@ TODO
## Configuration
-Ontology registries (and, by extension, the libraries they reference) are
configured by the Stanbol administrator via the Felix Web console.
+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_
-* 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))
-* Under __Registry locations__ you can add or remove the physical URIs of
ontology registries, i.e. RDF resources that contain knowledge about ontology
libraries.
-* If you wish all the registry contents to be loaded altogether on startup,
uncheck the __lazy ontology loading__ box.
-* You can select one __Caching policy__ between Centralised (default) and
Distributed. In centralised caching, all the libraries that reference an
ontology with the same URI will share the very same version of that ontology.
In distributed caching, each library will reference its own version of each
ontology. Centralised caching is generally recommended, as distributed caching
allows multi-version ontology management, but occupies much more storage space,
depending on the amount of ontologies in common.
\ No newline at end of file
+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.
+3. If you wish all the registry contents to be loaded altogether on startup,
uncheck the __lazy ontology loading__ box.
+4. You can select one __Caching policy__ between Centralised (default) and
Distributed. In _Centralised_ caching, all the libraries that reference an
ontology with the same URI will share the very same version of that ontology.
In _Distributed_ caching, each library will reference its own version of each
ontology. Centralised caching is generally recommended, as distributed caching
allows multi-version ontology management, but occupies much more storage space,
depending on the amount of ontologies in common.
+
+## Usage
+
+### Setup an Ontology Registry
+
+To create a Registry, you simply need to make an OWL ontology with certain
types of axioms. See [Registry Language](registry/language.html) for examples
on how to create a Registry and add Library instances to it.
+
+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).
+
+### Service Endpoints
+
+Because the configuration of registries is a task for __administrators__,
there are no RESTful APIs for modifying ontology registries.
+
+- [__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.
+
+____
+_[Back to Ontology Manager](../ontologymanager.html)_
\ No newline at end of file
Modified:
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext
URL:
http://svn.apache.org/viewvc/incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext?rev=1213772&r1=1213771&r2=1213772&view=diff
==============================================================================
---
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext
(original)
+++
incubator/stanbol/site/trunk/content/stanbol/docs/trunk/rules/language.mdtext
Tue Dec 13 16:33:05 2011
@@ -48,4 +48,4 @@ or the following __SPARQL CONSTRUCT__ st
?z myont:hasSibling ?y}
____
-_[Back to Rules](rules.html)_
\ No newline at end of file
+_[Back to Rules](../rules.html)_
\ No newline at end of file
