You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@stanbol.apache.org by bu...@apache.org on 2012/02/22 14:25:20 UTC
svn commit: r805778 [1/2] - in /websites/staging/stanbol/trunk: ./
content/stanbol/docs/trunk/enhancer/
content/stanbol/docs/trunk/enhancer/chains/
content/stanbol/docs/trunk/enhancer/engines/
Author: buildbot
Date: Wed Feb 22 13:25:20 2012
New Revision: 805778
Log:
Staging update by buildbot for stanbol
Modified:
websites/staging/stanbol/trunk/ (props changed)
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/chainmanager.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/defaultchain.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/executionplan.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/graphchain.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/index.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/listchain.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/weightedchain.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/contentitem.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/enhancementenginemanager.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/geonamesengine.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/index.html
websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/keywordlinkingengine.html
Propchange: websites/staging/stanbol/trunk/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Wed Feb 22 13:25:20 2012
@@ -1 +1 @@
-1292157
+1292276
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/chainmanager.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/chainmanager.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/chainmanager.html Wed Feb 22 13:25:20 2012
@@ -20,7 +20,7 @@
-->
<link href="/stanbol/css/stanbol.css" rel="stylesheet" type="text/css">
- <title>Apache Stanbol - ChainManager</title>
+ <title>Apache Stanbol - Chain Manager</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="icon" type="image/png" href="/stanbol/images/stanbol-logo/stanbol-favicon.png"/>
</head>
@@ -56,10 +56,10 @@
</div>
<div id="content">
- <h1 class="title">ChainManager</h1>
- <p>The ChainManager provides name based access to all active <a href="index.html">Enhancement Chain</a> and their ServiceReferences. This interface is typically used by components that need to lookup Chains based on their name. However the ChainsTracker implementation can also be used to track specific Chains.</p>
-<h3 id="chainmanager_interface">ChainManager interface</h3>
-<p>This is the Java API providing access to registered Chains in the ways as described above. This interface includes the following methods:</p>
+ <h1 class="title">Chain Manager</h1>
+ <p>The ChainManager provides name based access to all active <a href="index.html">Enhancement Chains</a> and their ServiceReferences. This interface is typically used by components that need to lookup Chains based on their name. However the ChainsTracker implementation can also be used to track specific Chains.</p>
+<h2 id="chainmanager_interface">ChainManager interface</h2>
+<p>This is the Java API providing access to registered chains in the ways as described above. This interface includes the following methods:</p>
<div class="codehilite"><pre><span class="cm">/** Constant for the name of the DefaultChain */</span>
<span class="n">DEFAULT_CHAIN_NAME</span> <span class="o">:</span> <span class="n">String</span>
<span class="cm">/** Getter for all names with active Chains */</span>
@@ -85,7 +85,7 @@
<p>There are two implementations of this interface available:</p>
-<h4 id="chainmanager_service">ChainManager Service</h4>
+<h3 id="chainmanager_service">ChainManager Service</h3>
<p>This is an implementation of the ChainManager interface that is registered as OSGI service. It can be used e.g. by using the @Reference annotation</p>
<div class="codehilite"><pre><span class="nd">@Reference</span>
<span class="n">ChainManager</span> <span class="n">chainManager</span>
@@ -93,8 +93,8 @@
<p>This service is provided by the "org.apache.stanbol.enhancer.chainmanger" module and is included in all Stanbol launchers.</p>
-<h4 id="chainstracker">ChainsTracker</h4>
-<p>This is an Utility similar to the standard OSGI ServiceTracker that allows to track some/all Chains. It also supports the usage of a ServiceTrackerCustomizer so that users of that utility can directly react to changes of tracked Chains.</p>
+<h3 id="chainstracker">ChainsTracker</h3>
+<p>This is an utility similar to the standard OSGI ServiceTracker that allows to track some/all chains. It also supports the usage of a ServiceTrackerCustomizer so that users of this utility can directly react to changes of tracked chains.</p>
<div class="codehilite"><pre><span class="c1">//track only "myChain" and "otherChain"</span>
<span class="n">ChainsTracker</span> <span class="n">tracker</span> <span class="o">=</span> <span class="k">new</span> <span class="n">ChainsTracker</span><span class="o">(</span>
<span class="n">context</span><span class="o">,</span> <span class="s">"myChain"</span><span class="o">,</span><span class="s">"otherChain"</span><span class="o">);</span>
@@ -106,7 +106,7 @@
</pre></div>
-<p>For most users the ChainManager service is sufficient and preferable. Direct use of the ChainTracker is only recommended if one needs only to track some specific chains and especially if one needs to get notified an changes of such chains.</p>
+<p>For most users the ChainManager service is sufficient and preferable. Direct use of the ChainsTracker is only recommended if one needs only to track some specific chains and especially if one needs to get notified an changes of such chains.</p>
</div>
<div id="footer">
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/defaultchain.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/defaultchain.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/defaultchain.html Wed Feb 22 13:25:20 2012
@@ -20,7 +20,7 @@
-->
<link href="/stanbol/css/stanbol.css" rel="stylesheet" type="text/css">
- <title>Apache Stanbol - DefaultChain</title>
+ <title>Apache Stanbol - Default Chain</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="icon" type="image/png" href="/stanbol/images/stanbol-logo/stanbol-favicon.png"/>
</head>
@@ -56,27 +56,27 @@
</div>
<div id="content">
- <h1 class="title">DefaultChain</h1>
- <p>Implementation that keeps track of all currently active <a href="../engines">EnhancementEngine</a> and registers itself as a Chain service with the "stanbol.enhancer.chain.name=default" an service ranking of Integer.MIN_VALUE.</p>
+ <h1 class="title">Default Chain</h1>
+ <p>This implementation that keeps track of all currently active <a href="../engines">Enhancement Engines</a> and registers itself as a chain service with the "stanbol.enhancer.chain.name=default" and the service ranking of Integer.MIN_VALUE.</p>
<p>This will cause this chain to be returned by the ChainManager.getDefault() method if users:</p>
<ul>
-<li>do not deactivate this Chain (see below)</li>
-<li>configure an other Chain with the "stanbol.enhancer.chain.name=default" and an higher service ranking</li>
+<li>do not deactivate this chain (see below)</li>
+<li>configure an other chain with the "stanbol.enhancer.chain.name=default" and a higher service ranking</li>
</ul>
<p>The Chain returned by ChainManager.getDefault() is the one used for requests that do not specify a chain. This are enhancement requests to the "/engines" and "/enhancer" endpoint.</p>
-<h3 id="configuration">Configuration</h3>
+<h2 id="configuration">Configuration</h2>
<p>This chain can be enabled/disabled by using the "stanbol.enhancer.chain.default.enabled"</p>
-<p><img alt="DefaultChain Configuration" src="enhancer-defaultchain-config.png" title="Configuration Options for the Default Chain" /></p>
+<p><img alt="DefaultChain Configuration" src="enhancer-defaultchain-config.png" title="Configuration options for the Default Chain" /></p>
<p>This chain does not support the configuration of the name nor the service ranking. The name is fixed to "default" and the service ranking is Integer.MIN_VALUE</p>
<p>Note that the DefaultChain does not actually implement the Chain interface, but only registers an instance of the AllActiveEnginesChain on activation.
The implementation is part of the "org.apache.stanbol.enhancer.chain.allactive" module.</p>
-<h3 id="calculation_of_the_executionplan">Calculation of the ExecutionPlan</h3>
-<p>This chain considers all currently active <a href="../engines">EnhancementEngine</a>s. The ExecutionPlan is calculated by using the value for the "org.apache.stanbol.enhancer.engine.order" property provided by the EnhancementEngine:</p>
+<h2 id="calculation_of_the_executionplan">Calculation of the ExecutionPlan</h2>
+<p>This chain considers all currently active <a href="../engines">Enhancement Engines</a>. The ExecutionPlan is calculated by using the value for the "org.apache.stanbol.enhancer.engine.order" property provided by the EnhancementEngine:</p>
<ul>
-<li>Engines with a lower order are executed before Engines with a higher value</li>
+<li>Engines with a lower order are executed before engines with a higher value</li>
<li>Engines with the same order may be executed simultaneously if the EnhancementJobMananger and the EnhancementEngine do support this feature.</li>
</ul>
-<p>The DefaultChain ensures therefore that the default behavior of the Stanbol Enhancer does not change after the introduction of EnhancementChains. This is because the WeightedJobManager as used previously followed exactly the same rules.</p>
+<p>The DefaultChain ensures that the default behavior of the Stanbol Enhancer does not change after the introduction of EnhancementChains. This is because the WeightedJobManager as used previously followed exactly the same rules.</p>
<p>However after the introduction of EnhancementChains users can now easily change the default behavior.</p>
</div>
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/executionplan.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/executionplan.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/executionplan.html Wed Feb 22 13:25:20 2012
@@ -20,7 +20,7 @@
-->
<link href="/stanbol/css/stanbol.css" rel="stylesheet" type="text/css">
- <title>Apache Stanbol - ExecutionPlan</title>
+ <title>Apache Stanbol - Execution Plan</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="icon" type="image/png" href="/stanbol/images/stanbol-logo/stanbol-favicon.png"/>
</head>
@@ -56,29 +56,29 @@
</div>
<div id="content">
- <h1 class="title">ExecutionPlan</h1>
- <p>The ExecutionPlan is represented as an RDF graph following the ExecutionPlan Ontology. It needs to be provided by the <a href="index.html">Enhancement Chain</a> and is used by the <a href="../enhancementjobmanager.html">EnhancementJobManager</a> to enhance <a href="../contentitem.html">ContentItem</a>s and to write the <a href="../executionmetadata.html">ExecutionMetadata</a>.</p>
+ <h1 class="title">Execution Plan</h1>
+ <p>The ExecutionPlan is represented as an RDF graph following the ExecutionPlan ontology. It needs to be provided by the <a href="index.html">Enhancement Chain</a> and is used by the <a href="../enhancementjobmanager.html">EnhancementJobManager</a> to enhance <a href="../contentitem.html">ContentItems</a> and to write the <a href="../executionmetadata.html">ExecutionMetadata</a>.</p>
<h2 id="executionplan_ontology">ExecutionPlan Ontology</h2>
-<p>The RDFS schema used for the execution plan is defined as follows.</p>
+<p>The RDFS schema used for the execution plan is defined as follows:</p>
<p><img alt="Execution Plan" src="executionplan.png" title="Overview of the Execution Plan Ontology" /></p>
<ul>
<li>Namespace: ep : http://stanbol.apache.org/ontology/enhancer/executionplan#</li>
-<li><strong>ep:ExecutionPlan</strong> : Represent an execution plan defined by all linked execution nodes.<ul>
+<li><strong>ep:ExecutionPlan</strong> : Represents an execution plan defined by all linked execution nodes.<ul>
<li><strong>ep:hasExecutionNode</strong> (domain: ep:ExecutionPlan; range: ep:ExecutionNode; inverseOf: ep:inExecutionPlan): links the execution plan with all the execution nodes.</li>
-<li><strong>ep:chain</strong> (domain: ep:ExecutionPlan; range: xsd:string): The name of the Chain this execution plan is used for.</li>
+<li><strong>ep:chain</strong> (domain: ep:ExecutionPlan; range: xsd:string): The name of the chain this execution plan is used for.</li>
</ul>
</li>
<li><strong>ep:ExecutionNode</strong> : Class used for all Nodes representing the execution of an Enhancement Engine.<ul>
<li><strong>ep:inExecutionPlan</strong> (domain: ep:ExecutionNode; range: ep:ExecutionPlan ;inverseOf: ep:hasExecutionNode): functional property that links the execution node with an execution plan</li>
-<li><strong>ep:engine</strong> (domain: ep:ExecutionNode; range: xsd:string): The property used to link to the Enhancement Engine by the name of the engine.</li>
+<li><strong>ep:engine</strong> (domain: ep:ExecutionNode; range: xsd:string): The property is used to link to the Enhancement Engine by the name of the engine.</li>
<li><strong>ep:dependsOn</strong> (domain: ep:ExecutionNode; range: ep:ExecutionNode) Defines that the execution of this node depends on the completion of the referenced one.</li>
<li><strong>ep:optional</strong> (domain: ep:ExecutionNode; range: xsd:boolean) Can be used to specify that the execution of this <a href="../engines">EnhancementEngine</a> is optional. If this property is set to TRUE an engine will be marked as executed even if it execution was not possible (e.g. because an engine with this name was not active) or the execution failed (e.g. because of the Exception). </li>
</ul>
</li>
</ul>
-<p>Note the the data for the ep:ExecutionPlan and the ep:hasExecutionNode/ep:inExecutionPlan typically need not to be parsed as configuration of a Chain. This information are typically automatically added based on the assumption that all ep:ExecutionNode parsed in the configuration for a chain are member of the execution plan for such chain. Therefore this information is typically added by the Chain itself when the configuration is parsed and validated.</p>
-<h4 id="example">Example:</h4>
-<p>This example shows an ExecutionPlan with three nodes for the "langId", "ner", "dbpediaLinking" "geonamesLinking" and "zemanta" engine. Note that this names refer to actual <a href="../engines">EnhancementEngine</a> Services registered with the current OSGI Environment.</p>
+<p>Note: the data for the ep:ExecutionPlan and the ep:hasExecutionNode/ep:inExecutionPlan typically need not to be parsed as configuration of a Chain. This information are typically automatically added based on the assumption that all ep:ExecutionNode parsed in the configuration for a chain are member of the execution plan for such a chain. Therefore, this information is typically added by the chain itself when the configuration is parsed and validated.</p>
+<h3 id="example">Example</h3>
+<p>This example shows an ExecutionPlan with the nodes for the "langId", "ner", "dbpediaLinking" "geonamesLinking" and "zemanta" engine. Note that this names refer to actual <a href="../engines">EnhancementEngine</a> Services registered with the current OSGI Environment.</p>
<p>This example assumes that</p>
<ul>
<li>"langId" is the singleton instance of <a href="../engines/langidengine.html">LangIdEnhancementEngine</a></li>
@@ -87,7 +87,7 @@
<li>"geonamesLinking" is an instance of the <a href="../engines/namedentitytaggingengine.html">NamedEntityTaggingEngine</a> configured to use the geonames.org ReferencedSite</li>
<li>"zemanta" is the singleton instance of the <a href="../engines/zemantaengine.html">ZemantaEnhancementEngine</a></li>
</ul>
-<p>The RDF graph of such a chain would look:</p>
+<p>The RDF graph of such a chain would look</p>
<div class="codehilite"><pre>urn:execPlan
rdf:type ep:ExecutionPlan
ep:hasExecutionNode urn:node1, urn:node2, urn:node3, urn:node4, urn:node5
@@ -96,7 +96,7 @@
urn:node1
rdf:type stanbol:ExecutionNode
ep:inExecutionPlan urn:execPlan
- stanbol:engine langId
+ ep:engine langId
urn:node2
rdf:type ep:ExecutionNode
@@ -124,16 +124,16 @@ urn:node5
</pre></div>
-<p>This plan defines that the "langId" and the "zemanta" engine do not depend on anything and can therefore be executed from the start (even in parallel if the JobManager execution this chains supports this). The execution of the "ner" engine depends on the extraction of the language and the execution of the entity linking to dbpedia and geonames depends on the "ner" engine. Note that the execution of the "dbpediaLinking" and "geonamesLinking" could be also processed in parallel.</p>
-<h4 id="executionplan_utility">ExecutionPlan Utility:</h4>
-<p>The Enhancer MUST also define an Utility that provides the following utility</p>
+<p>This plan defines that the "langId" and the "zemanta" engine do not depend on anything and can therefore be executed from the start (even in parallel if the JobManager execution of these chains supports this). The execution of the "ner" engine depends on the extraction of the language and the execution of the entity linking to dbpedia and geonames depends on the "ner" engine. Note that the execution of the "dbpediaLinking" and "geonamesLinking" could be also processed in parallel.</p>
+<h2 id="executionplan_utility">ExecutionPlan Utility</h2>
+<p>The Enhancer MUST also define an utility that provides the following:</p>
<div class="codehilite"><pre><span class="cm">/** Getter for the list of executable ep:ExecutionNodes */</span>
<span class="o">+</span> <span class="n">getExecuteable</span><span class="o">(</span><span class="n">Graph</span> <span class="n">executionPlan</span><span class="o">,</span> <span class="n">Set</span><span class="o"><</span><span class="n">NonLiteral</span><span class="o">></span> <span class="n">completed</span><span class="o">)</span> <span class="o">:</span> <span class="n">Collection</span><span class="o"><</span><span class="n">NonLiteral</span><span class="o">></span>
</pre></div>
-<p>This method takes an execution plan and the list of already executed nodes as input and return the list of ExecutionNodes that can be executed next. The existing utility methods within the EnhancementEngineHelper can be used to retrieve further information from the ex:ExecutionNode's returned by this method.</p>
-<p>Typically code using this utility will look like this (pseudo code)</p>
+<p>This method takes an execution plan and the list of already executed nodes as input and return the list of ExecutionNodes that can be executed next. The existing utility methods within the EnhancementEngineHelper can be used to retrieve further information from the ex:ExecutionNodes returned by this method.</p>
+<p>The code using this utility will look like this (pseudo code):</p>
<div class="codehilite"><pre><span class="n">Graph</span> <span class="n">executionPlan</span> <span class="o">=</span> <span class="n">chain</span><span class="o">.</span><span class="na">getExecuctionPlan</span><span class="o">();</span>
<span class="n">Map</span><span class="o"><</span><span class="n">String</span><span class="o">,</span> <span class="n">EnhancementEngine</span><span class="o">></span> <span class="n">engines</span> <span class="o">=</span> <span class="n">enhancementEngineManager</span><span class="o">.</span><span class="na">getActiveEngines</span><span class="o">(</span><span class="n">chain</span><span class="o">);</span>
<span class="n">Collection</span><span class="o"><</span><span class="n">NonLiteral</span><span class="o">></span> <span class="n">executed</span> <span class="o">=</span> <span class="k">new</span> <span class="n">HashSet</span><span class="o"><</span><span class="n">NonLiteral</span><span class="o">>();</span>
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/graphchain.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/graphchain.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/graphchain.html Wed Feb 22 13:25:20 2012
@@ -20,7 +20,7 @@
-->
<link href="/stanbol/css/stanbol.css" rel="stylesheet" type="text/css">
- <title>Apache Stanbol - GraphChain</title>
+ <title>Apache Stanbol - Graph Chain</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="icon" type="image/png" href="/stanbol/images/stanbol-logo/stanbol-favicon.png"/>
</head>
@@ -56,32 +56,32 @@
</div>
<div id="content">
- <h1 class="title">GraphChain</h1>
- <p>The GraphChain allows to directly configure the ExecutionPlan returned by the Chain.getExecutionPlan() method. This means on the one hand that it allows to configure any kind of execution process on the other hand its usage also requires a lot of knowledge about the <a href="../engines">EnhancementEngine</a>s and the ExecutionPlan model form the user.</p>
-<p>Typically it is a good practice to start with other - more simple to use - Chain implementation such as the <a href="weightedchain.html">Weighted Chain</a> and only afterwards convert this configuration to a GraphChain to configure optimizations to the enhancement process such as to allow more Engines to be executed in parallel.</p>
-<h3 id="configuration">Configuration</h3>
-<p>The GraphChain supports two variants to configure the ExecutionPlan</p>
-<h4 id="graphresource">GraphResource</h4>
-<p>A GraphResource is a RDF file available via the DataFileProvider. The easiest way is to copy the RDF file defining the ExecutionPlan to the "/sling/datafile" directory within the Stanbol home directory. The configuration of the GraphChain needs than only to refer to that file such as:</p>
+ <h1 class="title">Graph Chain</h1>
+ <p>The GraphChain allows to directly configure the ExecutionPlan returned by the Chain.getExecutionPlan() method. This means on the one hand that it allows to configure any kind of execution process on the other hand its usage also requires a lot of knowledge about the <a href="../engines">EnhancementEngine</a>s and the ExecutionPlan model.</p>
+<p>Typically it is a good practice to start with other - more simple to use - Chain implementation such as the <a href="weightedchain.html">Weighted Chain</a> and only afterwards convert this configuration to a GraphChain to configure optimizations to the enhancement process such as to allow more engines to be executed in parallel.</p>
+<h2 id="configuration">Configuration</h2>
+<p>The GraphChain supports two variants to configure the ExecutionPlan.</p>
+<h3 id="graphresource">GraphResource</h3>
+<p>A GraphResource is an RDF file available via the DataFileProvider. The easiest way is to copy the RDF file defining the ExecutionPlan to the "/sling/datafile" directory within the Stanbol home directory. The configuration of the GraphChain needs then only to refer to that file such as:</p>
<div class="codehilite"><pre><span class="na">stanbol.enhancer.chain.graph.graphresource</span><span class="o">=</span><span class="s">myExecutionPlan.rdf</span>
</pre></div>
-<p>The used RDF encoding is guessed by the file extension. If the extension is not recognized the format can be also parsed as additional parameter</p>
+<p>The used RDF encoding is guessed by the file extension. If the extension is not recognized, the format can be also parsed as additional parameter</p>
<div class="codehilite"><pre><span class="na">stanbol.enhancer.chain.graph.graphresource</span><span class="o">=</span><span class="s">myExecutionPlan.something;format=application/rdf+xml</span>
</pre></div>
-<p>The GraphCain will track for that file and activate itself as soon as the file gets available. Removing the file, waiting some seconds and providing the new version afterwards should also work. Just replacing the file will not work, because the DataFileProvider does not have supports for updates. In such cases it might be needed to deactivate/activate the GraphChain.</p>
-<h4 id="chainlist">ChainList</h4>
-<p>This allows to directly configure the ExecutionPlan as value of the "stanbol.enhancer.chain.graph.chainlist" property. Both arrays and Collections are supported. </p>
-<p><em>NOTE</em>: As soon as a graph resource is configures the ChainList is ignored. This is even true if the configured GraphResource is currently not available!</p>
-<p>The Syntax is defined as follows:</p>
+<p>The GraphCain will track for that file and activate itself as soon as the file gets available. Removing the file, waiting some seconds and providing the new version afterwards should also work. Just replacing the file will not work, because the DataFileProvider does not have support for updates. In such cases it might be needed to deactivate/activate the GraphChain.</p>
+<h3 id="chainlist">ChainList</h3>
+<p>This allows to directly configure the ExecutionPlan as value of the "stanbol.enhancer.chain.graph.chainlist" property. Both arrays and collections are supported. </p>
+<p><em>Note:</em> As soon as a graph resource is configured the ChainList will be ignored. This is even true if the configured GraphResource is currently not available!</p>
+<p>The syntax is defined as follows:</p>
<div class="codehilite"><pre>{engine-name};[optional];[dependsOn={engine-name1},{engine-name2}]
</pre></div>
-<p>The following Example shows how this Syntax can be used to define an ExecutionPlan.</p>
+<p>The following example shows how this syntax can be used to define an ExecutionPlan.</p>
<div class="codehilite"><pre>metaxa;optional
langId;dependsOn=metaxa
ner;dependsOn=langId
@@ -92,8 +92,8 @@ refactor;dependsOn=geonames,dbpedia-link
</pre></div>
-<p>Not that the internal oder of the list does not influence the resulting ExecutionPlan. Only the "dependsOn" properties are used to determine the execution order of the Engines and if Engines can be executed in parallel.</p>
-<p>Within an osgi configuration file (org.apache.stanbol.enhancer.chain.graph.impl.GraphChain-myGraphChain.config) this would look like</p>
+<p><em>Note:</em> The internal oder of the list does not influence the resulting ExecutionPlan. Only the "dependsOn" properties are used to determine the execution order of the engines and if engines can be executed in parallel.</p>
+<p>Within an OSGI configuration file (org.apache.stanbol.enhancer.chain.graph.impl.GraphChain-myGraphChain.config) this would look like</p>
<div class="codehilite"><pre><span class="na">stanbol.enhancer.chain.graph.chainlist</span><span class="o">=</span><span class="s">[</span>
<span class="na">"metaxa;optional","langId;dependsOn\</span><span class="o">=</span><span class="s">metaxa","ner;dependsOn\=langId",</span>
<span class="na">"zemanta;optional","dbpedia-linking;dependsOn\</span><span class="o">=</span><span class="s">ner",</span>
@@ -102,18 +102,18 @@ refactor;dependsOn=geonames,dbpedia-link
</pre></div>
-<p><em>NOTE:</em> the whole test MUST BE in a single line within the .config file</p>
-<p>A better visual expression provides this screenshot of the Apache Feilx Webconsole showing the dialog for the same configuration</p>
-<p><img alt="GraphChain configuration Dialog with configured ChainList" src="enhancer-graphchain-config.png" title="A ChainList allows to define one ExecutionNodes per line. The ExecutionPlan is calculated based on the dependsOn properties. The ordering of the list element has no influence on the ExecutionPlan." /></p>
-<h3 id="execution">Execution</h3>
-<p>In contrast to other Chain implementation the ExecutionPlan must not be calculated but is directly parsed by the user. This provides the most possible freedom in defining how the execution should take place.</p>
-<h4 id="optional_engines">Optional Engines</h4>
-<p>The execution of optional engines is not mandatory. If they are not active or the execution fails the enhancement process continues. For users it is important to not that even Engines that depend on an optional Engine that was not executed will be called.</p>
+<p><em>Note:</em> The whole test MUST BE in a single line within the .config file.</p>
+<p>A better visual expression provides this screenshot of the Apache Felix web console showing the dialog for the above configuration</p>
+<p><img alt="GraphChain configuration dialog with configured ChainList" src="enhancer-graphchain-config.png" title="A ChainList allows to define one ExecutionNode per line. The ExecutionPlan is calculated based on the dependsOn properties. The ordering of the list element has no influence on the ExecutionPlan." /></p>
+<h2 id="execution">Execution</h2>
+<p>In contrast to other chain implementations the ExecutionPlan must not be calculated but is directly parsed by the user. This provides the most possible freedom in defining how the execution should take place.</p>
+<h3 id="optional_engines">Optional Engines</h3>
+<p>The execution of optional engines is not mandatory. The enhancement process will continue, even if they are not active or their execution fail. For users it is important to know, that even engines that depend on an optional engine that was not executed will be called.</p>
<p>Given the above example this means that even if the 'metaxa' engine can not be executed the 'langId' will be called by the EnhancementJobManager.</p>
-<h4 id="parallel_execution">Parallel Execution</h4>
-<p>Engines are executed as soon as all Engines they dependOn have completed. This also includes if optional engines where skipped (because they are not active) or failed. This means that in most cases several EnhancementEngines can be executed in parallel.</p>
-<p>Given the above Example both the 'zemanta' and the 'metaxa' engine are executed as soon as the enhancement process starts.
-When 'metaxa' finished the 'langid' engine is called. After the 'langid' finishes its work the EnhancementJobManager calls the 'ner' engine. After that both the 'dbpedia-linking' and the 'geonames' engine are called. At this time three engines might run simultaneously assuming that 'zemanta' has not finished yet. Before the 'refactor' engine can be executed it need to wait for all this engines to complete.</p>
+<h3 id="parallel_execution">Parallel Execution</h3>
+<p>Engines are executed as soon as all engines they depend on have completed. This also includes if optional engines were skipped (because they are not active) or failed. This means that in most cases several EnhancementEngines can be executed in parallel.</p>
+<p>Given the above example, both the 'zemanta' and the 'metaxa' engine are executed as soon as the enhancement process starts.
+When 'metaxa' is finished, the 'langid' engine is called. After the 'langid' finishes its work, the EnhancementJobManager calls the 'ner' engine. After that both the 'dbpedia-linking' and the 'geonames' engine are called. At this time three engines might run simultaneously assuming that 'zemanta' has not finished yet. Before the 'refactor' engine can be executed it need to wait for all these engines to complete.</p>
<p>Note that for parallel execution to be activated both the used EnhancementJobManager and the different engines must support asynchronous enhancement.</p>
</div>
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/index.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/index.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/index.html Wed Feb 22 13:25:20 2012
@@ -57,20 +57,20 @@
<div id="content">
<h1 class="title">Enhancement Chains</h1>
- <p>An Enhancement Chain defines how Content parsed to the Stanbol Enhancer is processed. More concrete it defines what <a href="../engines">EnhancementEngine</a>s and in what order are used to process <a href="../contentitem.html">ContentItem</a>s. Chains are not responsible for the actual processing of ContentItems. They provide the <a href="executionplan.html">ExecutionPlan</a> to the <a href="../enhancementjobmanager.html">EnhancementJobManger</a> that does the actual processing of the ContentItem.</p>
-<p>In the RESTful API enhancement chains can be accessed by there name under</p>
+ <p>An Enhancement Chain defines how content parsed to the Stanbol Enhancer is processed. More concretely it defines which <a href="../engines">EnhancementEngines</a> and in what order are used to process <a href="../contentitem.html">ContentItems</a>. Chains are not responsible for the actual processing of ContentItems. They provide the <a href="executionplan.html">ExecutionPlan</a> to the <a href="../enhancementjobmanager.html">EnhancementJobManger</a> that does the actual processing of the ContentItem.</p>
+<p>In the RESTful API enhancement chains can be accessed by their name under</p>
<div class="codehilite"><pre>http://{host}:{port}/{stanbol-path}/enhancer/chain/{chain-name}
</pre></div>
-<p>Enhancement requestes issued to </p>
+<p>Enhancement requests issued to </p>
<div class="codehilite"><pre>http://{host}:{port}/{stanbol-path}/enhancer
http://{host}:{port}/{stanbol-path}/engines
</pre></div>
<p>are processed by using the default enhancement chain.</p>
-<p>When using the Java API Chains can be looked up as OSGI services. The <a href="chainmanager.html">ChainManager</a> service is designed to ease this by providing a API that allows to access Chains by their name. Because Chains are not responsible to perform the actual execution but only provide the <a href="executionplan.html">ExecutionPlan</a> one needs to also lookup an EnhancementJobManager instance to enhance a contentItem</p>
+<p>When using the Java API Chains can be looked up as OSGI services. The <a href="chainmanager.html">ChainManager</a> service is designed to ease this by providing an API that allows to access Chains by their name. Because Chains are not responsible to perform the actual execution but only provide the <a href="executionplan.html">ExecutionPlan</a> one needs to also lookup an EnhancementJobManager instance to enhance a ContentItem.</p>
<div class="codehilite"><pre><span class="nd">@Reference</span>
<span class="n">EnhancementJobManager</span> <span class="n">jobManager</span><span class="o">;</span>
@@ -94,7 +94,7 @@ http://{host}:{port}/{stanbol-path}/engi
<p>To enhance a ContentItem with the default chain the "enhanceContent(ContentItem ci)" can be used.</p>
<h2 id="chain_interface">Chain Interface</h2>
-<p>The Chain interface is very simplistic. It only defines three methods.</p>
+<p>The Chain interface is very simplistic. It defines just the following three methods:</p>
<div class="codehilite"><pre><span class="cm">/** Getter for the name of the Chain */</span>
<span class="o">+</span> <span class="n">getName</span><span class="o">()</span> <span class="o">:</span> <span class="n">String</span>
<span class="cm">/** Getter for the execution plan */</span>
@@ -112,40 +112,40 @@ http://{host}:{port}/{stanbol-path}/engi
<p>within the activate method of the Chain. There is also an AbstractChain implementation provided by the servicesapi module of the Stanbol Enhancer that already implements this functionality.</p>
-<p>The getEngines method returns the name of all <a href="../engines">EnhancementEngine</a>s referenced by a Chain. Note that this method returns a Set. This method is intended to allow fast access to the referenced engines and does not provide any information about the execution order.</p>
-<p>Components that need to know the details about a Chain need to process the <a href="executionplan.html">ExecutionPlan</a> returned by the getExectuonPlan() method. The <a href="executionplan.html">ExecutionPlan</a> is represented as an RDF graph following the ExecutionPlan Ontology. It formally describes how a ContentItem must be processed by the EnhancementJobManager. For details see the documentation for the <a href="executionplan.html">ExecutionPlan</a>.</p>
-<p>For Chain implementation it is important that the returned Graph holding the execution plan MUST BE read-only AND final. Meaning that a change in the configuration of a Chain MUST NOT change the graph returned by calls to the getExecutionPlan method.</p>
-<p>Because the configuration of a Chain might change at any time EnhancementJobManager implementation MUST retrieve the execution plan once and than use this instance for the whole enhancement process. Because of the above requirement that the execution plan is stored in an read-only and final Graph this ensures that the plan can not change even for long lasting enhancement processes. Therefore any change to the configuration of a chain will not influence ongoing enhancement processes.</p>
+<p>The getEngines method returns the name of all <a href="../engines">EnhancementEngines</a> referenced by a Chain. Note that this method returns a Set. This method is intended to allow fast access to the referenced engines and does not provide any information about the execution order.</p>
+<p>Components that need to know the details about a Chain need to process the <a href="executionplan.html">ExecutionPlan</a> returned by the <code>getExecutionPlan()</code> method. The <a href="executionplan.html">ExecutionPlan</a> is represented as an RDF graph following the ExecutionPlan ontology. It formally describes how a ContentItem must be processed by the EnhancementJobManager. For details see the documentation for the <a href="executionplan.html">ExecutionPlan</a>.</p>
+<p>For any Chain implementation it is important that the returned Graph holding the execution plan MUST BE read-only AND final. This means, that a change in the configuration of a Chain MUST NOT change the graph returned by calls to the getExecutionPlan method.</p>
+<p>Because the configuration of a Chain might change at any time, the EnhancementJobManager implementation MUST retrieve the execution plan once and then use this instance for the whole enhancement process. Because of the above requirement that the execution plan is stored in a read-only and final Graph this ensures that the plan can not change even for long lasting enhancement processes. Therefore any change to the configuration of a chain will not influence the ongoing enhancement processes.</p>
<h2 id="enhancement_chain_management">Enhancement Chain Management</h2>
<p>This section describes how Enhancement Chains are managed by the Stanbol Enhancer and how they can be selected/accessed. It also describes how the "default" Chain is determined.</p>
-<p>For every Stanbol Enhancer a single Chain MUST BE present. If this is not the case enhance request MUST throw a ChainException with an according error message. However typically multiple EnhancementChains will be configured. </p>
+<p>For every Stanbol Enhancer a single Chain MUST BE present. If this is not the case enhance requests MUST throw a ChainException with an according error message. However typically multiple EnhancementChains will be configured. </p>
<h3 id="chain_name_conflicts">Chain Name Conflicts</h3>
-<p>Chains are identified by the value of the "stanbol.enhancer.chain.name" property - the name of the chain. If more than one Chain do use the same name, than the normal OSGI procedure to select the default service is used. This means that</p>
+<p>Chains are identified by the value of the "stanbol.enhancer.chain.name" property - the name of the chain. If more than one Chain do use the same name, then the normal OSGI procedure to select the default service is used. This means that</p>
<ol>
<li>the Chain with the highest "service.ranking" and</li>
<li>the Chain with the lowest "service.id"</li>
</ol>
<p>will be selected on requests for a given Chain name. Via the RESTful service API there is no possibility to call the other chains for a given name. However the ChainManager interface allows to access all registered services for a given name.</p>
<h3 id="default_chain">Default Chain</h3>
-<p>The second important concept of the Chain management is the definition of the "default chain". The default Chin is used for enhancement requests that do not specify a Chain. This is true for requests to the "/engines" and "/enhancer" RESTful services as well as API calls to the "EnhancementJobManager.enhanceContent(ContentItem ci)" method.</p>
+<p>The second important concept of the Chain management is the definition of the "default chain". The default Chain is used for enhancement requests that do not specify a Chain. This is true for requests to the "/engines" and "/enhancer" RESTful services as well as API calls to the "EnhancementJobManager.enhanceContent(ContentItem ci)" method.</p>
<p>The default Chain is determined by the following rules:</p>
<ol>
-<li>the Chain with the name "default". If more than one Chain is present with that name, than the above rules for resolving name conflicts apply. If none</li>
-<li>the Chain with the highest "service.ranking". If several have the same ranking</li>
-<li>the Chain with the lowest "service.id"</li>
+<li>the Chain with the name "default". If more than one Chain is present with that name, than the above rules for resolving name conflicts apply. If none,</li>
+<li>the Chain with the highest "service.ranking". If several have the same ranking,</li>
+<li>the Chain with the lowest "service.id".</li>
</ol>
<p>If no chain is active a ChainException with an according message MUST BE thrown.</p>
-<p>All Stanbol launchers are configured with the <a href="defaultchain.html">Default Chain</a> enabled. This registers itself with the name "default" and the lowest possible service ranking - Integer.MIN_VALUE. This default provides a Chain that considered all currently active <a href="../engines">EnhancementEngine</a>s and sorts them based on there ordering information (see the <a href="weightedchain.html#calculation_of_the_executionplan">Calculation of the Execution Plan based on the EnhancementEngine Ordering</a> for details).</p>
+<p>All Stanbol launchers are configured with the <a href="defaultchain.html">Default Chain</a> enabled. This registers itself with the name "default" and the lowest possible service ranking - Integer.MIN_VALUE. This default provides a Chain that considers all currently active <a href="../engines">EnhancementEngines</a> and sorts them based on their ordering information (see the <a href="weightedchain.html#calculation_of_the_executionplan">Calculation of the Execution Plan based on the EnhancementEngine Ordering</a> for details).</p>
<h3 id="chainmanager_interface">ChainManager interface</h3>
-<p>The <a href="chainmanager.html">ChainManager</a> is the management interface for EnhancementChains that can be used by components to lookup chains based on their name. It also provides a getter for the default chain. There is also OSGI ServiceTracker like implementation that can be used to track only chains with specific names and to get even notified on any change of such chains.</p>
+<p>The <a href="chainmanager.html">ChainManager</a> is the management interface for EnhancementChains that can be used by components to lookup chains based on their name. It also provides a getter for the default chain. There is also an OSGI ServiceTracker like implementation that can be used to track only chains with specific names and to get even notified on any change of such chains.</p>
<h2 id="chain_implementations">Chain implementations</h2>
<p>The following Chain implementations are included within the default Stanbol Enhancer distribution:</p>
<ul>
-<li><strong><a href="defaultchain.html">DefaultChain</a></strong>: Implementation that includes all currently active EnhancementEngine. If enabled it registers itself under the name "default" with the service ranking Integer.MIN_VALUE. This makes this chain to the default chain as long users do not deactivate it or register an other chain with the name "default".</li>
+<li><strong><a href="defaultchain.html">DefaultChain</a></strong>: This implementation includes all currently active EnhancementEngines. If enabled it registers itself under the name "default" with the service ranking Integer.MIN_VALUE. This makes this chain to the default chain as long users do not deactivate it or register an other chain with the name "default".</li>
<li><strong><a href="listchain.html">ListChain</a></strong>: Implementation that creates the ExecutionPlan by chaining the EnhancementEngines in the exact order as specified by the parsed list. This Chain does not support parallel execution of engines.</li>
<li><strong><a href="weightedchain.html">WeightedChain</a></strong>: This Chain implementation takes a List of Engines names as input and uses the "org.apache.stanbol.enhancer.engine.order " metadata provided by such engines to calculate the ExecutionGraph.</li>
-<li><strong><a href="graphchain.html">GraphChain</a></strong>: This Chain implementation is based on a ExecutionGraph parsed os configuration.</li>
-<li><strong>SingleEngineChain</strong>: An Adapter that allows to execute a single EnhancementEngine within a Chain. This types of Chains will not be registered as OSGI service. Instances will be created on request for single EnhancementEngines and directly parsed to the <a href="../enhancementjobmanager.html">EnhancementJobManager</a> implementation. </li>
+<li><strong><a href="graphchain.html">GraphChain</a></strong>: This Chain implementation is based on a ExecutionGraph parsed as configuration.</li>
+<li><strong>SingleEngineChain</strong>: An Adapter to execute a single EnhancementEngine within a Chain. This type of Chain will not be registered as OSGI service. Instances will be created on request for single EnhancementEngines and directly parsed to the <a href="../enhancementjobmanager.html">EnhancementJobManager</a> implementation.</li>
</ul>
</div>
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/listchain.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/listchain.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/listchain.html Wed Feb 22 13:25:20 2012
@@ -20,7 +20,7 @@
-->
<link href="/stanbol/css/stanbol.css" rel="stylesheet" type="text/css">
- <title>Apache Stanbol - ListChain</title>
+ <title>Apache Stanbol - List Chain</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="icon" type="image/png" href="/stanbol/images/stanbol-logo/stanbol-favicon.png"/>
</head>
@@ -56,30 +56,29 @@
</div>
<div id="content">
- <h1 class="title">ListChain</h1>
- <p>The List Chain creates the ExecutionPlan based on the exact order of the configured <a href="../engines">EnhancementEngine</a>s. This provides users with a simple possibility configure the exact oder in that the referenced EnhancementEngines are called during the enhancement process of a content item. However the ListChain can not support parallel execution of engines a considerable disadvantage in contrast to the <a href="graphchain.html">GraphChain</a>.</p>
-<p>A typical usage scenario would be that users start of with configuring a ListChain and later optimize the execution by migrating functional configuration to <a href="graphchain.html">GraphChain</a>s.</p>
-<h3 id="configuration">Configuration</h3>
-<p>The property "stanbol.enhancer.chain.list.enginelist" is used to provide the list of engine names. This configuration MUST BE parsed as an Array as string because the ordering if the configured entries is central for the configuration.</p>
-<p>In addition it is possible to define Engines as optional. This allows to specify that the enhancement process should not fail if an Engine is not active or fails while processing a content item.</p>
-<p>The syntax to define an Engine as optional is as follows</p>
+ <h1 class="title">List Chain</h1>
+ <p>The ListChain creates the ExecutionPlan based on the exact order of the configured <a href="../engines">EnhancementEngines</a>. This provides users with a simple possibility to configure the exact oder in which the referenced EnhancementEngines are called during the enhancement process of a content item. However the ListChain can not support parallel execution of engines - a considerable disadvantage in contrast to the <a href="graphchain.html">GraphChain</a>.</p>
+<p>A typical usage scenario would be that users start of with configuring a ListChain and later optimize the execution by migrating functional configuration to a <a href="graphchain.html">GraphChain</a>.</p>
+<h2 id="configuration">Configuration</h2>
+<p>The property "stanbol.enhancer.chain.list.enginelist" is used to provide the list of engine names. This configuration MUST BE parsed as an array as string because the ordering of the configured entries is essential for the configuration.</p>
+<p>In addition it is possible to define engines as optional. This allows to specify that the enhancement process should not fail if an engine is not active or fails while processing a content item.</p>
+<p>The syntax to define an engine as optional is as follows below <em>(Both variants make the execution of the engine with the name <name> optional.)</em>:</p>
<div class="codehilite"><pre><name>;optional
<name>;optional=true
</pre></div>
-<p>both variants result that the execution of the engine with the name <name> is optional.</p>
-<p>The following figure shows the configuration dialog for ListCahins as provided by the Apache Felix Web Console.</p>
-<p><img alt="Configuration Dialog for the ListChain" src="enhancer-listchain-config.png" title="Sceenshot of the Configuration Dialog for a ListChain with required and optional Engines" /></p>
-<p>It is also possible to configure a ListChain by directly installing a configuration with the name "{classname}-{configName}.config". Note that the {configName} needs not to be the same as the name of the chain. The {configName} is just used by the OSGI environment to distinguish different configuration for {classname}.</p>
+<p>The following figure shows the configuration dialog for ListChains as provided by the Apache Felix Web Console.</p>
+<p><img alt="Configuration dialog for the ListChain" src="enhancer-listchain-config.png" title="Screenshot of the configuration dialog for a ListChain with required and optional engines" /></p>
+<p>It is also possible to configure a ListChain by directly installing a configuration with the name "{classname}-{configName}.config". Note that the {configName} needs not to be the same as the name of the chain. The {configName} is just used by the OSGI environment to distinguish different configurations for {classname}.</p>
<p>To create the same configuration as in the above screenshot the file would need to look like this:</p>
<div class="codehilite"><pre><span class="na">stanbol.enhancer.chain.name</span><span class="o">=</span><span class="s">"list"</span>
<span class="na">stanbol.enhancer.chain.list.enginelist</span><span class="o">=</span><span class="s">["metaxa;optional","langid","ner","dbpediaLinking"]</span>
</pre></div>
-<h3 id="calculation_of_the_executionplan">Calculation of the ExecutionPlan</h3>
-<p>The ExecutionPlan is created based on the exact order of the <a href="../engines">EnhancementEngine</a>s provided by the "stanbol.enhancer.chain.list.enginelist" property. The configuration MUST contain at least a single engine. In addition no engine MUST be mentioned twice.</p>
+<h2 id="calculation_of_the_executionplan">Calculation of the ExecutionPlan</h2>
+<p>The ExecutionPlan is created based on the exact order of the <a href="../engines">EnhancementEngines</a> provided by the "stanbol.enhancer.chain.list.enginelist" property. The configuration MUST contain at least a single engine. In addition no engine MUST be mentioned twice.</p>
</div>
<div id="footer">
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/weightedchain.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/weightedchain.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/chains/weightedchain.html Wed Feb 22 13:25:20 2012
@@ -20,7 +20,7 @@
-->
<link href="/stanbol/css/stanbol.css" rel="stylesheet" type="text/css">
- <title>Apache Stanbol - WeightedChain</title>
+ <title>Apache Stanbol - Weighted Chain</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="icon" type="image/png" href="/stanbol/images/stanbol-logo/stanbol-favicon.png"/>
</head>
@@ -56,34 +56,33 @@
</div>
<div id="content">
- <h1 class="title">WeightedChain</h1>
- <p>The Wighted Chain takes a list of <a href="../engines">EnhancementEngine</a> names as input and uses the "org.apache.stanbol.enhancer.engine.order" metadata of the configured Engines to calculate the ExecutionPlan.</p>
-<p>This Chain is designed for easy configuration - just a list of the engine names - but has limited possibilities to control the execution order.</p>
-<h3 id="configuration">Configuration</h3>
-<p>The property "stanbol.enhancer.chain.weighted.chain" is used to provide the list of engine names. Both Arrays and Collections are supported as values.</p>
-<p>In addition it is possible to define Engines as optional. This allows to specify that the enhancement process should not fail if an Engine is not active or fails while processing a content item.</p>
-<p>The syntax to define an Engine as optional is as follows</p>
+ <h1 class="title">Weighted Chain</h1>
+ <p>The WeightedChain takes a list of <a href="../engines">EnhancementEngine</a> names as input and uses the "org.apache.stanbol.enhancer.engine.order" metadata of the configured Engines to calculate an ExecutionPlan.</p>
+<p>This chain is designed for easy configuration - just a list of the engine names - but has limited possibilities to control the execution order.</p>
+<h2 id="configuration">Configuration</h2>
+<p>The property "stanbol.enhancer.chain.weighted.chain" is used to provide the list of engine names. Both arrays and collections are supported as values.</p>
+<p>In addition it is possible to define engines as optional. This allows to specify that the enhancement process should not fail if an engine is not active or fails while processing a content item.</p>
+<p>The syntax to define an Engine as optional is as follows <em>(Both variants make the execution of the engine with the name <name> optional.)</em>:</p>
<div class="codehilite"><pre><name>;optional
<name>;optional=true
</pre></div>
-<p>both variants result that the execution of the engine with the name <name> is optional.</p>
-<p><img alt="Configuration Dialog for the WeightedCahin" src="enhancer-weightedchain-config.png" title="Sceenshot of the Configuration Dialog for a WeightedChain with two required and one optional Engine" /></p>
-<h3 id="calculation_of_the_executionplan">Calculation of the ExecutionPlan</h3>
-<p>It is important to note that the ordering of the list has no influence on the ExecutionPlan because the order of execution of the configured <a href="../engines">EnhancementEngine</a>s is calculated only by using the value for the "org.apache.stanbol.enhancer.engine.order" property provided by the EnhancementEngine:</p>
+<p><img alt="Configuration dialog for the WeightedCahin" src="enhancer-weightedchain-config.png" title="Screenshot of the configuration dialog for a WeightedChain with two required and one optional engine" /></p>
+<h2 id="calculation_of_the_executionplan">Calculation of the ExecutionPlan</h2>
+<p>It is important to note that the ordering of the list has no influence on the ExecutionPlan because the order of execution of the configured <a href="../engines">EnhancementEngines</a> is calculated only by using the value of the "org.apache.stanbol.enhancer.engine.order" property provided by the EnhancementEngine:</p>
<ul>
-<li>Engines with a lower order are executed before Engines with a higher value</li>
-<li>Engines with the same order may be executed simultaneously if the EnhancementJobMananger and the EnhancementEngine do support this feature.</li>
+<li>Engines with a lower order are executed before engines with a higher value</li>
+<li>Engines with the same order may be executed simultaneously if the EnhancementJobManager and the EnhancementEngine do support this feature.</li>
</ul>
<p>The WeightedCahin follows exactly the same algorithm as the WeightedJobManager used to decide the execution order of all active EnhancementEngines. However the WeightedChain will only consider configured chains and ignore others.</p>
-<p>The following image shows the ExecutionPlan as calculated based on the above configuration</p>
-<p><img alt="ExecutionPlan for the keyword chain" src="enhancer-weightedchain-allactive.png" title="The ExecutionPlan is calculated based on the 'order' information of the Enhancement Engines. In this case first 'metaxa' is used to convert any type of content to plain text; second the 'langid' engine is used to detect the language and third the Words mentioned in the text are used to lookup entities in DBpedia.org" /></p>
+<p>The following image shows the ExecutionPlan as calculated based on the above configuration.</p>
+<p><img alt="ExecutionPlan for the keyword chain" src="enhancer-weightedchain-allactive.png" title="The ExecutionPlan is calculated based on the 'order' information of the Enhancement Engines. In this case first 'metaxa' is used to convert any type of content to plain text; second the 'langid' engine is used to detect the language and third the words mentioned in the text are used to lookup entities in DBpedia.org" /></p>
<p>If some of the Enhancement Engines are not available this will be visualized as follows. If you parse content by using the RESTful interface similar information will be available via the the Execution Metadata included in the metadata of the enhanced content item.</p>
-<p><img alt="Optional Engine is inactive" src="enhancer-weightedchain-optionalinactive.png" title="The optional 'metaxa' engine is inactive. The engine can still be executed however content other than plain text will bot get enhanced" /></p>
+<p><img alt="Optional Engine is inactive" src="enhancer-weightedchain-optionalinactive.png" title="The optional 'metaxa' engine is inactive. The engines can still be executed however content other than plain text will bot get enhanced" /></p>
<p>This shows that the optional engine 'metaxa' is currently not available. The chain can be still used however the functionality provided by this optional engine will not be available. In this case only requests for plain text files could be processed.</p>
-<p>The following figure shows a situation where a required engine is not active. Requests to this chain will fail until all required engines are active.</p>
-<p><img alt="Requried Engine is inactive" src="enhancer-weightedchain-requiredinactive.png" title="The required 'langid' engine is not active. Because of this requests to this chain will fail." /></p>
+<p>The next figure shows a situation where a required engine is not active. Requests to this chain will fail until all required engines are active.</p>
+<p><img alt="Required Engine is inactive" src="enhancer-weightedchain-requiredinactive.png" title="The required 'langid' engine is not active. Because of this requests to this chain will fail." /></p>
</div>
<div id="footer">
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/contentitem.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/contentitem.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/contentitem.html Wed Feb 22 13:25:20 2012
@@ -103,7 +103,7 @@
<p>returns the same blob instance.</p>
<h3 id="metadata_of_the_contentitem">Metadata of the ContentItem</h3>
<p>The metadata of the ContentItem is managed by a lockable MGraph. This is basically a normal <code>java.util.Collections</code> for triples. The only RDF specific method is the support for filtered iterators which support wildcards for subjects, predicates and objects.</p>
-<p>This graph is used to store all enhancement results as well as metadata about the content item (such as content parts) and the enhancement process (see <a href="executionmetadata.html">execution metadata</a>.</p>
+<p>This graph is used to store all enhancement results as well as metadata about the content item (such as content parts) and the enhancement process (see <a href="executionmetadata.html">execution metadata</a>).</p>
<h3 id="readwrite_locks">Read/Write locks</h3>
<p>During the Apache Stanbol enhancement process as executed by the <a href="enhancementjobmanager.html">enhancement job manager</a> components running in multiple threads need to access the state of the <em>ContentItem</em>. Because of that the content item provides the possibility to acquire locks.</p>
<div class="codehilite"><pre><span class="cm">/** Getter for the ReadWirteLock of a ContentItem */</span>
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/enhancementenginemanager.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/enhancementenginemanager.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/enhancementenginemanager.html Wed Feb 22 13:25:20 2012
@@ -20,7 +20,7 @@
-->
<link href="/stanbol/css/stanbol.css" rel="stylesheet" type="text/css">
- <title>Apache Stanbol - EnhancementEngineManager</title>
+ <title>Apache Stanbol - Enhancement Engine Manager</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="icon" type="image/png" href="/stanbol/images/stanbol-logo/stanbol-favicon.png"/>
</head>
@@ -56,8 +56,8 @@
</div>
<div id="content">
- <h1 class="title">EnhancementEngineManager</h1>
- <p>The EnhancementEngineManager provides name based access to all active <a href="index.html">EnhancementEngine</a>s and their ServiceReferences. This interface is typically used by components that need to lookup EnhancementEngiens based on their name. However the EngineTracker implementation can also be used to track specific EnhancementEngines.</p>
+ <h1 class="title">Enhancement Engine Manager</h1>
+ <p>The EnhancementEngineManager provides name based access to all active <a href="index.html">EnhancementEngine</a>s and their ServiceReferences. This interface is typically used by components that need to lookup EnhancementEngines based on their name. However the EngineTracker implementation can also be used to track specific EnhancementEngines.</p>
<h3 id="enhancementenginemanager_interface">EnhancementEngineManager interface</h3>
<p>This is the Java API providing access to registered EnhancementEngines in the ways as described above. This interface includes the following methods:</p>
<div class="codehilite"><pre><span class="cm">/** Getter for all names with active engines */</span>
@@ -88,9 +88,9 @@
</pre></div>
-<p>This service is provided by the "org.apache.stanbol.enhancer.enginemanger" module and is included in all Stanbol launchers.</p>
+<p>This service is provided by the "org.apache.stanbol.enhancer.enginemanager" module and is included in all Stanbol launchers.</p>
<h4 id="enginestracker">EnginesTracker</h4>
-<p>This is an Utility similar to the standard OSGI ServiceTracker that allows to track some/all EnhancementEngines. It also supports the usage of a ServiceTrackerCustomizer so that users of that utility can directly react to changes of tracked EnhancementEngines.</p>
+<p>This is an utility similar to the standard OSGI ServiceTracker which allows to track some/all EnhancementEngines. It also supports the usage of a ServiceTrackerCustomizer so that users of that utility can directly react to changes of tracked EnhancementEngines.</p>
<div class="codehilite"><pre><span class="c1">//track only "myEngine" and "otherEngine"</span>
<span class="n">EnginesTracker</span> <span class="n">tracker</span> <span class="o">=</span> <span class="k">new</span> <span class="n">EnginesTracker</span><span class="o">(</span>
<span class="n">context</span><span class="o">,</span> <span class="s">"myEngine"</span><span class="o">,</span><span class="s">"otherEngine"</span><span class="o">);</span>
@@ -102,8 +102,8 @@
</pre></div>
-<p>For most users the EnhancementEgingeManager service is sufficient and preferable. Direct use of the EngineTracker is only recommended if one needs only to track some specific engines and especially if one needs to get notified an changes of such engines.</p>
-<p>The implementation of the <a href="http://svn.apache.org/repos/asf/incubator/stanbol/trunk/enhancer/chain/weighted/src/main/java/org/apache/stanbol/enhancer/chain/weighted/impl/WeightedChain.java">WeightedChain</a> is a good example for the intended usage of the EnginesTracker.</p>
+<p>For most users the EnhancementEngineManager service is sufficient and preferable. Direct use of the EngineTracker is only recommended if one needs only to track some specific engines and especially if one needs to get notified an changes of such engines.</p>
+<p>The implementation of the <code><a href="http://svn.apache.org/repos/asf/incubator/stanbol/trunk/enhancer/chain/weighted/src/main/java/org/apache/stanbol/enhancer/chain/weighted/impl/WeightedChain.java">WeightedChain</a></code> is a good example for the intended usage of the EnginesTracker.</p>
</div>
<div id="footer">
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/geonamesengine.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/geonamesengine.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/geonamesengine.html Wed Feb 22 13:25:20 2012
@@ -57,9 +57,9 @@
<div id="content">
<h1 class="title">The Geonames Enhancement Engine</h1>
- <p>This engine creates fise:EntityAnnotations based on the http://geonames.org dataset. It does not directly work on the parsed content, but processes named entities extracted by some NLP (natural language processing) engine. This engine creates EnityAnnotations for Features found for named entities in the geonames.org data set. In addition it adds EntityAnnotations for the continent, country and administrative regions for entities with an high confidence level.</p>
+ <p>This engine creates fise:EntityAnnotations based on the http://geonames.org dataset. It does not directly work on the parsed content, but processes named entities extracted by some NLP (natural language processing) engine. This engine creates EntityAnnotations for Features found for named entities in the geonames.org data set. In addition it adds EntityAnnotations for the continent, country and administrative regions for entities with an high confidence level.</p>
<h2 id="processed_annotations_input">Processed Annotations (Input)</h2>
-<p>This engine consumes fise:TextAnnotations of type dbpedia:Place. More concrete it filters for enhancements that confirm to the following two requirements and consumes the text selected by the TextAnnotations:</p>
+<p>This engine consumes fise:TextAnnotations of type dbpedia:Place. More concretely it filters for enhancements which confirm to the following two requirements and consumes the text selected by the TextAnnotations:</p>
<div class="codehilite"><pre>?textAnnotation rdf:type fise:TextAnnotation .
?textAnnotation dc:type dbpedia:Place
?textAnnotation fise:selected-text ?text
@@ -186,7 +186,7 @@ The following example shows the entity h
<h3 id="aadm1_-_a_county">A.ADM1 - A county</h3>
-<p>Now three enhancement describing the different hierarchies of administrative regions within Austria. First the "Bundesland", next the "Stadtteil" and last the "Gemeindebezirk".</p>
+<p>Now three enhancements describing the different hierarchies of administrative regions within Austria. First the "Bundesland", next the "Stadtteil" and last the "Gemeindebezirk".</p>
<div class="codehilite"><pre>urn:enhancement:entity-hierarchy-enhancement:id3
a fise:EntityAnnotation , fise:Enhancement ;
fise:confidence
Modified: websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/index.html
==============================================================================
--- websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/index.html (original)
+++ websites/staging/stanbol/trunk/content/stanbol/docs/trunk/enhancer/engines/index.html Wed Feb 22 13:25:20 2012
@@ -57,8 +57,8 @@
<div id="content">
<h1 class="title">Enhancement Engines</h1>
- <p>Enhancement engines are the components that are responsible to enhance <a href="../contentitem.html">content items</a>. They are called by the <a href="../enhancementjobmanager.html">Enhancement Job Manager</a>. Enhancement engines do have full access to the parsed content items. They are expected to modify their state.</p>
-<p>The RESTful interface of an enhancement engine can be accessed by</p>
+ <p>Enhancement engines are the components responsible to enhance <a href="../contentitem.html">content items</a>. They are called by the <a href="../enhancementjobmanager.html">Enhancement Job Manager</a>. Enhancement engines do have full access to the parsed content items. They are expected to modify their state.</p>
+<p>The RESTful interface of an enhancement engine can be accessed via</p>
<div class="codehilite"><pre>http://{host}:{port}/{stanbol-root}/enhancer/engine/{engine-name}
</pre></div>
@@ -68,7 +68,7 @@
</pre></div>
-<p>When using the Java API enhancement engines can be liked up as OSGI services. The <a href="enhancementenginemanager.html">Enhancement Engine Manager</a> service is designed to ease this by providing a API that allows to access enhancement engine by their name.</p>
+<p>When using the Java API, enhancement engines can be linked up as OSGI services. The <a href="enhancementenginemanager.html">Enhancement Engine Manager</a> service is designed to ease this by providing an API that allows to access enhancement engine by their name.</p>
<h2 id="enhancement_engine_interface">Enhancement Engine Interface</h2>
<p>The interface for enhancement engines contains the following three methods:</p>
<div class="codehilite"><pre><span class="cm">/** Getter for the value of the "stanbol.enhancer.engine.name" property */</span>
@@ -76,7 +76,7 @@
<span class="cm">/** Checks if this engine can enhance the parsed content item */</span>
<span class="o">+</span> <span class="n">canEnhance</span><span class="o">(</span><span class="n">ContentItem</span> <span class="n">ci</span><span class="o">)</span> <span class="o">:</span> <span class="kt">int</span>
<span class="cm">/** Enhances the parsed content item */</span>
-<span class="o">+</span> <span class="n">computeEnhacements</span><span class="o">(</span><span class="n">ContentItem</span> <span class="n">ci</span><span class="o">)</span>
+<span class="o">+</span> <span class="n">computeEnhancements</span><span class="o">(</span><span class="n">ContentItem</span> <span class="n">ci</span><span class="o">)</span>
<span class="cm">/** The property used for the name of an engine */</span>
<span class="n">PROPERTY_NAME</span> <span class="o">:</span> <span class="n">String</span>
@@ -94,9 +94,9 @@
</pre></div>
-<p>The <code>canEnahnce(ContentItem ci)</code> method is used by the <a href="../enhancementjobmanager.html">Enhancement Job Manager</a> to check if an engine is able to process a <a href="../contentitem.html">Content Item</a>. Calling this method MUST NOT change the state of the content item and this method MUST also NOT acquire a write lock on the content item.</p>
-<p>The <code>computeEnhacements(ContentItem ci)</code> starts the processing of the parsed content item by the engine. It is expected to change the state of the parsed content item. Engines that support asynchronous processing need to take care to correctly apply read/write locks when reading/writing information from/to the content item. Engines that return <code>ENHANCE_SYNCHRONOUS</code> on calls to <code>canEnhance(..)</code> do not need to use locks. They can trust that they have exclusive read/write access to the content item.</p>
-<p>Enhancement engins do have full access to the content item. Theoretically, they would be even allowed to delete all metadata as well as all content parts from the parsed content item. However typically the do only</p>
+<p>The <code>canEnhance(ContentItem ci)</code> method is used by the <a href="../enhancementjobmanager.html">Enhancement Job Manager</a> to check if an engine is able to process a <a href="../contentitem.html">Content Item</a>. Calling this method MUST NOT change the state of the content item and this method MUST also NOT acquire a write lock on the content item.</p>
+<p>The <code>computeEnhancements(ContentItem ci)</code> starts the processing of the parsed content item by the engine. It is expected to change the state of the parsed content item. Engines that support asynchronous processing need to take care to correctly apply read/write locks when reading/writing information from/to the content item. Engines that return <code>ENHANCE_SYNCHRONOUS</code> on calls to <code>canEnhance(..)</code> do not need to use locks. They can trust that they have exclusive read/write access to the content item.</p>
+<p>Enhancement engines do have full access to the content item. Theoretically, they would be even allowed to delete all metadata as well as all content parts from the parsed content item. However typically the do only</p>
<ul>
<li>read existing content parts</li>
<li>add new content parts</li>
@@ -105,7 +105,7 @@
</ul>
<p>Both the <code>canEnhance(..)</code> and <code>computeEnhancements(..)</code> methods MUST be called by the <a href="../enhancementjobmanager.html">Enhancement Job Manager</a> after all the executions of all enhancement engines this one depends on are completed. This dependencies are defined by the <a href="../chains/executionplan.html">Execution Plan</a> used by the enhancement job manager to enhance the content item. Implementors of enhancement engines can therefore trust that all metadata expected to be added by other enhancement engines are already present within the metadata of the parsed content items when <code>canEnhance(..)</code> or <code>computeEnhancements(..)</code> is called.</p>
<h3 id="services_properties_interface">Services Properties Interface</h3>
-<p>This interface is implemented by most of the current enhancement engines. It allows engines to expose additional properties to other component. This interface defines a single method</p>
+<p>This interface is implemented by most of the current enhancement engines. It allows engines to expose additional properties to other components. This interface defines a single method</p>
<div class="codehilite"><pre><span class="cm">/** Getter for the ServiceProperties */</span>
<span class="n">Map</span><span class="o"><</span><span class="n">String</span><span class="o">,</span><span class="n">Object</span><span class="o">></span> <span class="n">getServiceProperties</span><span class="o">();</span>
</pre></div>
@@ -113,7 +113,7 @@
<p>but also predefines the property <code>ENHANCEMENT_ENGINE_ORDERING = "org.apache.stanbol.enhancer.engine.order"</code> that can be used by enhancement engine implementations to specify their typical ordering within the enhancement process.</p>
<h3 id="engine_ordering_information">Engine Ordering Information</h3>
-<p>By implementing the ServicesProperties interface enhancement engines do have the possibility to expose additional metadata to other components. The services properties interface defines only a single method</p>
+<p>By implementing the ServicesProperties interface, enhancement engines do have the possibility to expose additional metadata to other components. The services properties interface defines only a single method</p>
<div class="codehilite"><pre><span class="cm">/** Getter for the ServiceProperties */</span>
<span class="n">Map</span><span class="o"><</span><span class="n">String</span><span class="o">,</span><span class="n">Object</span><span class="o">></span> <span class="n">getServiceProperties</span><span class="o">();</span>
</pre></div>
@@ -121,44 +121,44 @@
<p>and is implemented by most of the current enhancement engines. Its currently only use is to provide information about the engine ordering within the enhancement process. This information is exposed by using the key "org.apache.stanbol.enhancer.engine.order" that is defined as value by the constant <code>ENHANCEMENT_ENGINE_ORDERING</code> defined directly by the services properties interface. Values are expected to be integer within the ranges </p>
<ul>
-<li><strong>ORDERING_PRE_PROCESSING</strong>: All values >= 200 are considered for engines that do some kind of preprocessing of the Content. This includes e.g. the conversation of media formats such as extracting the plain text from HTML, keyframes from videos, wave form from mp3 ...; extracting metadata directly encoded within the parsed content such as ID3 tags from MP3 or RDFa, microdata provided by HTML content.</li>
-<li><strong>ORDERING_CONTENT_EXTRACTION</strong>: This range includes values form < 200 and >= 100 and shall be used by enhancement engine that need to analyze the parsed content to extract additional metadata. Examples would be Language detection, Natural Language Processing, Named Entity Recognition, Face Detection in Images, Speech to text â¦</li>
+<li><strong>ORDERING_PRE_PROCESSING</strong>: All values >= 200 are considered for engines that do some kind of preprocessing of the content. This includes e.g. the conversion of media formats such as extracting the plain text from HTML, keyframes from videos, wave form from mp3 ...; extracting metadata directly encoded within the parsed content such as ID3 tags from MP3 or RDFa, microdata provided by HTML content.</li>
+<li><strong>ORDERING_CONTENT_EXTRACTION</strong>: This range includes values form < 200 and >= 100 and shall be used by enhancement engines that need to analyze the parsed content to extract additional metadata. Examples would be Language detection, Natural Language Processing, Named Entity Recognition, Face Detection in Images, Speech to text â¦</li>
<li><strong>ORDERING_EXTRACTION_ENHANCEMENT</strong>: This range includes values from < 100 and >= 1 and shall be used by enhancement engines to provide semantic lifting of preexisting enhancement such as linking named entities extracted by an NER engine with entities defines in a controlled vocabulary or lifting artist names, song titles ... extracted from mp3 files with the according Entities defined in an music database.</li>
<li><strong>ORDERING_DEFAULT</strong>: This represents the value 0 and shall be used as default value for all enhancement engines that do not provide ordering information or do not implement the ServicesProperties interface.</li>
<li><strong>ORDERING_POST_PROCESSING</strong>: This range includes valued form < 0 and >= -100 and is intended to be used by all enhancement engines that do post processing of enhancement results such as schema translation, filtering of Enhancements ...<br />
</li>
</ul>
<p>The engine ordering information as described here are used by the <a href="../chains/defaultchain.html">Default Chain</a> and the <a href="../chains/weightedchain.html">Weighted Chain</a> to calculate the <a href="../chains/executionplan.html">Execution Plan</a>.</p>
-<p>Basically this features allows the implementor of an enhancement engine to define the correct position of his engine within an typical enhancement chain and therefore ensure that users that add this engine to a enhancer installation to immediately use this engine with the <a href="../chains/defaultchain.html">Default Chain</a>.</p>
+<p>Basically this features allows the implementor of an enhancement engine to define the correct position of his engine within an typical enhancement chain and therefore ensure that users who add this engine to an enhancer installation to immediately use this engine with the <a href="../chains/defaultchain.html">Default Chain</a>.</p>
<p>However, the engine ordering is not the only possibility for users to control the execution order. Enhancement chain implementations such as the <a href="../chains/listchain.html">List Chain</a> and the <a href="../chains/graphchain.html">Graph Chain</a> do also allow to directly define the oder of execution. For these chains the ordering information provided by enhancement engines are ignored.</p>
<h2 id="enhancement_engine_management">Enhancement Engine Management</h2>
<p>This section describes how enhancement engines are managed by the Apache Stanbol Enhancer and how they can be selected/accessed through the <a href="../enhancementjobmanager.html">Enhancement Job Manager</a> and executed in an <a href="../chains">Enhancement Chain</a>.</p>
<p>Enhancement engines are registered as OSGi services and managed by using the following service properties:</p>
<ul>
-<li><strong>Name:</strong> Defined by the value of the property "stanbol.enhancer.engine.name" it will be used to access Engines on the Stanbol RESTful interface</li>
+<li><strong>Name:</strong> Defined by the value of the property "stanbol.enhancer.engine.name" it will be used to access engines on the Stanbol RESTful interface</li>
<li><strong>Service Ranking:</strong> The service ranking property defined by OSGI will be used to decide which engine to use in case several active enhancement engines do use the same name. In such cases only the Engine with the highest ranking will be used to enhance ContentItems.</li>
</ul>
<!-- TODO: The Configuration is not yet defined
-* __Configuration:__ Each EnhacementEngien MAY provide an RDF graph with its configuration. This graph will be returned on GET request on the URL of the enhancement engine. If no configuration is known for the engine this MUST at least return a single triple with the name for the engine.
+* __Configuration:__ Each EnhancementEngine MAY provide an RDF graph with its configuration. This graph will be returned on GET request on the URL of the enhancement engine. If no configuration is known for the engine this MUST at least return a single triple with the name for the engine.
_TODO:_ To correctly construct this graph the Engine needs to know this URL. This could e.g. be provided by some OSGI environment parameter set by the JerseyApplication. As an alternative we could also parse this URI as an parameter to the getEngineConfig method.
-->
<p>Other components such as enhancement chains do refer to engines by their name. The actual enhancement engine instance is only looked up shortly before the execution.</p>
<h3 id="enhancement_engine_name_conflicts">Enhancement Engine Name Conflicts</h3>
-<p>As enhancement engines are identified by the value of the "stanbol.enhancer.engine.name" property - the name - there might be cases where multiple enhancement engine are registered for the same name. In such cases the normal OSGi procedure to select the default service instance of several possible matches is used. This means that</p>
+<p>As enhancement engines are identified by the value of the "stanbol.enhancer.engine.name" property - the name - there might be cases where multiple enhancement engine are registered with the same name. In such cases the normal OSGi procedure to select the default service instance of several possible matches is used. This means that</p>
<ol>
<li>the enhancement engine with the highest "service.ranking" and</li>
<li>the enhancement engine with the lowest "service.id"</li>
</ol>
<p>will be selected on requests for a enhancement engine with a given name. Requests on the RESTful service API will always answer with the enhancement engine selected as default. When using the Java API there are also means to retrieve all enhancement engines for a given name via the <a href="enhancementenginemanager.html">Enhancement Engine Manager</a> interface.</p>
-<p>Out of a user perspective there is one major use case for configuring multiple enhancement engines for the same name. This is to allow the definition of fallback engines if the main one becomes unavailable. e.g. lets assume that a user has a local cache of geonames.org loaded into the <a href="../../entityhub/">Entityhub</a> and configures an <a href="keywordlinkingengine.html">Named Entity Linking</a> engine to perform semantic lifting of extracted locations. However Apache Stanbol also provides the <a href="geonamesengine.html">geonames.org Engine</a> that provides a similar functionality by directly accessing <a href="http://geonames.org">geonames.org</a>. By configuring both engines for the same name, but specifying a higher service ranking for the one using the local cache one can ensure that the local cache is used for the enhancement under normal circumstances. However in case the local cache becomes unavailable the other engine using the remote service will be use
d for enhancement.</p>
+<p>Out of a user perspective there is one major use case for configuring multiple enhancement engines with the same name. This is to allow the definition of fallback engines if the main one becomes unavailable. E.g. lets assume that a user has a local cache of geonames.org loaded into the <a href="../../entityhub/">Entityhub</a> and configures an <a href="keywordlinkingengine.html">Named Entity Linking</a> engine to perform semantic lifting of extracted locations. However Apache Stanbol also provides the <a href="geonamesengine.html">geonames.org Engine</a> that provides a similar functionality by directly accessing <a href="http://geonames.org">geonames.org</a>. By configuring both engines for the same name, but specifying a higher service ranking for the one using the local cache one can ensure that the local cache is used for the enhancement under normal circumstances. However in case the local cache becomes unavailable the other engine using the remote service will be us
ed for enhancement.</p>
<h3 id="enhancement_engine_manager_interface">Enhancement Engine Manager Interface</h3>
<p>The <a href="enhancementenginemanager.html">Enhancement Engine Manager</a> is the management interface for enhancement engines that can be used by components to lookup enhancement engines based on their name. There is also OSGI ServiceTracker like implementation that can be used to track only enhancement engines registered for a specific set of names. </p>
<h2 id="enhancement_engine_implementations">Enhancement Engine Implementations</h2>
-<p>A list of enhancement engine implementations maintained directly by the Apache Stanbol community can be found <a href="engines/list.html">here</a>.
+<p>A list of enhancement engine implementations maintained directly by the Apache Stanbol community can be found <a href="list.html">here</a>.
However the enhancement engine interface is designed in a way that it should be possible for advanced Apache Stanbol users to implement own enhancement engine implementations fulfilling their special needs.</p>
-<p>The Apache Stanbol community would be very happy if users decide to share thoughts about possible enhancement engines or even would like to contribute addition engines to the Apache Stanbol project.</p>
+<p>The Apache Stanbol community would be very happy if users decide to share thoughts about possible enhancement engines or even would like to contribute additional engines to the Apache Stanbol project.</p>
</div>
<div id="footer">