svn commit: r800206 - in /websites/staging/stanbol/trunk/content/stanbol/docs/trunk: components.html ontologymanager/registry.html rules/language.html

[bu...@apache.org]

Author: buildbot
Date: Tue Dec 13 16:33:23 2011
New Revision: 800206

Log:
Staging update by buildbot

Modified:
    websites/staging/stanbol/trunk/content/stanbol/docs/trunk/components.html
    websites/staging/stanbol/trunk/content/stanbol/docs/trunk/ontologymanager/registry.html
    websites/staging/stanbol/trunk/content/stanbol/docs/trunk/rules/language.html

Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/components.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/components.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/components.html Tue Dec 13 16:33:23 2011
@@ -69,7 +69,7 @@
 <p>The <a href="rules.html">Rules</a> component provides you with the means to re-factor knowledge graphs, e.g. for supporting the schema.org vocabulary for Search Engine Optimization. </p>
 </li>
 <li>
-<p>The <a href="reasoners.html">Reasoners</a> 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.</p>
+<p>The <a href="reasoners.html">Reasoners</a> 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".</p>
 </li>
 <li>
 <p>The <a href="ontologymanager.html">Ontology Manager</a> 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.</p>

Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/ontologymanager/registry.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/ontologymanager/registry.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/ontologymanager/registry.html Tue Dec 13 16:33:23 2011
@@ -51,22 +51,33 @@
   
   <div id="content">
     <h1 class="title">Ontology Registry Manager</h1>
-    <p>Registry management is a facility of the Ontology Manager that allows Stanbol <strong>administrators</strong> to pre-configure sets of ontologies that Stanbol should load and store, or simply be aware of, <strong>before</strong> 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.</p>
+    <p>Registry management is a facility for Stanbol <strong>administrators</strong> to pre-configure sets of ontologies that Stanbol should load and store, or simply be aware of, <em>before</em> 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.</p>
 <h2 id="glossary">Glossary</h2>
 <ul>
-<li>A <strong>Library</strong> is a collection of references to ontologies.</li>
+<li>A <strong>Library</strong> 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 <em>W3C ontologies</em>, a library of all the ontologies that describe a <em>social network</em> (which can include <a href="http://sioc-project.org/ontology">SIOC</a>, <a href="http://xmlns.com/foaf/spec">FOAF</a> etc.), a library of <em>ontology alignments</em> (which includes ontologies that align DBPedia to Schema.org, GeoNames to DBPedia, or a custom product ontology to GoodRelations).</li>
 <li>A <strong>Registry</strong> 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.</li>
 </ul>
 <h2 id="usage_scenarios">Usage Scenarios</h2>
 <p>TODO</p>
 <h2 id="configuration">Configuration</h2>
-<p>Ontology registries (and, by extension, the libraries they reference) are configured by the Stanbol administrator via the Felix Web console.</p>
-<ul>
+<p>Ontology registries (and, by extension, the libraries they reference) are configured by the Stanbol administrator via the Felix Web console. <em>Note that the following links assume Stanbol to be deployed on http://localhost:8080</em></p>
+<ol>
 <li>Go to the <a href="http://localhost:8080/system/console/configMgr">Felix console Configuration Manager</a> and select <strong>Apache Stanbol Ontology Registry Manager</strong> (or follow this <a href="http://localhost:8080/system/console/configMgr/org.apache.stanbol.ontologymanager.registry.impl.RegistryManagerImpl">direct link</a>)</li>
 <li>Under <strong>Registry locations</strong> you can add or remove the physical URIs of ontology registries, i.e. RDF resources that contain knowledge about ontology libraries.</li>
 <li>If you wish all the registry contents to be loaded altogether on startup, uncheck the <strong>lazy ontology loading</strong> box.</li>
-<li>You can select one <strong>Caching policy</strong> 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.</li>
+<li>You can select one <strong>Caching policy</strong> between Centralised (default) and Distributed. In <em>Centralised</em> caching, all the libraries that reference an ontology with the same URI will share the very same version of that ontology. In <em>Distributed</em> 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.</li>
+</ol>
+<h2 id="usage">Usage</h2>
+<h3 id="setup_an_ontology_registry">Setup an Ontology Registry</h3>
+<p>To create a Registry, you simply need to make an OWL ontology with certain types of axioms. See <a href="registry/language.html">Registry Language</a> for examples on how to create a Registry and add Library instances to it. </p>
+<p>Then upload the ontology on the Web and add it to the <strong>Registry locations</strong> from the <a href="http://localhost:8080/system/console/configMgr/org.apache.stanbol.ontologymanager.registry.impl.RegistryManagerImpl">Felix console Configuration</a>.</p>
+<h3 id="service_endpoints">Service Endpoints</h3>
+<p>Because the configuration of registries is a task for <strong>administrators</strong>, there are no RESTful APIs for modifying ontology registries.</p>
+<ul>
+<li><a href="http://localhost:8080/ontonet/registry"><strong>Libraries</strong></a>. 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. </li>
 </ul>
+<hr />
+<p><em><a href="../ontologymanager.html">Back to Ontology Manager</a></em></p>
   </div>
   
   <div id="footer">

Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/rules/language.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/rules/language.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/rules/language.html Tue Dec 13 16:33:23 2011
@@ -100,7 +100,7 @@
 
 
 <hr />
-<p><em><a href="rules.html">Back to Rules</a></em> </p>
+<p><em><a href="../rules.html">Back to Rules</a></em> </p>
   </div>
   
   <div id="footer">