You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by bd...@apache.org on 2017/06/27 17:30:08 UTC
[3/6] sling-site git commit: Publish latest fixes
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/development/slingstart.html
----------------------------------------------------------------------
diff --git a/documentation/development/slingstart.html b/documentation/development/slingstart.html
index 2528b40..3d095b7 100644
--- a/documentation/development/slingstart.html
+++ b/documentation/development/slingstart.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: The Apache Sling Provisioning Model and Apache SlingStart</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,10 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>The Apache Sling Provisioning Model and Apache SlingStart</h1></header><p>[TOC]</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » <a href="/ng/documentation/development/sling.html">Maven Sling Plugin</a> » </div> <h1>
+ The Apache Sling Provisioning Model and Apache SlingStart
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<p>The Apache Sling provisioning model is a model to describe OSGi based application. It can also be used to define a partial application aka feature (or subsystem in OSGi terms).</p>
<p>The model is describing an instance, it is not directly related to any particular tooling or packaging/provisioning vehicle.</p>
<p>For Apache Maven users, the <code>slingstart-maven-plugin</code> uses the model to create an executable application and/or a web application based on the model. Sling's Launchpad is defined using the model and built by this Maven plugin. See <a href="http://sling.apache.org/components/slingstart-maven-plugin/">SlingStart Maven Plugin</a> for a documentation of the supported goals and parameters.</p>
@@ -402,7 +405,7 @@ stringsimple ::= <quoted string representation of the value> (see below)
</dependency>
</dependencies>
</plugin>
-</code></pre></section></div></div>
+</code></pre></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/development/version-policy.html
----------------------------------------------------------------------
diff --git a/documentation/development/version-policy.html b/documentation/development/version-policy.html
index 5b71c06..9db3901 100644
--- a/documentation/development/version-policy.html
+++ b/documentation/development/version-policy.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Version Policy</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,12 +66,14 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Version Policy</h1></header><p>Excerpt: This page is about how we assign versions to exported packages and bundles and defines when to increase which part of the version number.</p>
-<p>This page is about how we assign versions to exported packages and bundles and defines when to increase which part of the version number.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/development.html">Development</a> » </div> <h1>
+ Version Policy
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>This page is about how we assign versions to exported packages and bundles and defines when to increase which part of the version number.</p>
<div class="info">
Please note that this page is currently in draft stage and still being discussed.
</div>
-<p>[TOC]</p>
+<p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<h2>Introduction</h2>
<p>In comments to <a href="https://issues.apache.org/jira/browse/SLING-2944">SLING-1176</a> Ian Boston wrote:</p>
<blockquote>
@@ -273,7 +275,7 @@ import aQute.bnd.annotation.Export;
<li><a href="http://wiki.eclipse.org/index.php/Version_Numbering">Version Numbering</a> -- An Eclipse paper on assigning version numbers. Very good read.</li>
<li><a href="http://www.osgi.org/wiki/uploads/Links/SemanticVersioning.pdf">Semantic Versioning</a> -- An OSGi Alliance paper on semantic versioning.</li>
<li><a href="http://bnd.bndtools.org/chapters/170-versioning.html">bnd Versioning</a> -- Describes how the bnd library used by the Maven Bundle plugin supports package versioning</li>
-</ul></section></div></div>
+</ul></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/getting-started.html
----------------------------------------------------------------------
diff --git a/documentation/getting-started.html b/documentation/getting-started.html
index 1f2e372..71c2049 100644
--- a/documentation/getting-started.html
+++ b/documentation/getting-started.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Getting Started</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Getting Started</h1></header><p>We're on the way to update the documentation to make it more easy to get in touch with Sling. At the moment we can give you the following starting points:</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » </div> <h1>
+ Getting Started
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>We're on the way to update the documentation to make it more easy to get in touch with Sling. At the moment we can give you the following starting points:</p>
<ul>
<li><a href="getting-started/discover-sling-in-15-minutes.html">Discover Sling in 15 minutes</a></li>
</ul>
@@ -82,7 +84,7 @@
<li><a href="/documentation/the-sling-engine/request-parameters.html">Request Parameters</a></li>
<li><a href="/documentation/the-sling-engine/authentication.html">Authentication</a></li>
<li><a href="/documentation/bundles/apache-sling-eventing-and-job-handling.html">Eventing and Jobs</a></li>
-</ul></section></div></div>
+</ul></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/getting-started/discover-sling-in-15-minutes.html
----------------------------------------------------------------------
diff --git a/documentation/getting-started/discover-sling-in-15-minutes.html b/documentation/getting-started/discover-sling-in-15-minutes.html
index 3af1ed4..619c559 100644
--- a/documentation/getting-started/discover-sling-in-15-minutes.html
+++ b/documentation/getting-started/discover-sling-in-15-minutes.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Discover Sling in 15 minutes</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,10 +66,13 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Discover Sling in 15 minutes</h1></header><p>The Sling Launchpad is a ready-to-run Sling configuration, providing an embedded JCR content repository and web server, a selection of Sling components, documentation and examples. The Launchpad makes it easy to get started with Sling and to develop script-based applications.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/getting-started.html">Getting Started</a> » </div> <h1>
+ Discover Sling in 15 minutes
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The Sling Launchpad is a ready-to-run Sling configuration, providing an embedded JCR content repository and web server, a selection of Sling components, documentation and examples. The Launchpad makes it easy to get started with Sling and to develop script-based applications.</p>
<p>This page will help you get started with the Launchpad. Fifteen minutes should be enough to get an overview of what Sling does.</p>
<p>While simple to run and understand, the Launchpad is a full-featured instance of Sling, an example configuration that we have created with the most common modules and configurations. The full functionality of Sling is available by loading additional Sling (or custom) OSGi bundles as needed, using the Launchpad's web-based OSGi management console.</p>
-<p>[TOC]</p>
+<p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<h2>See Also</h2>
<p>More Sling samples can be found under <a href="http://svn.apache.org/repos/asf/sling/trunk/samples/">http://svn.apache.org/repos/asf/sling/trunk/samples/</a></p>
<p>Once you grok the basic examples of this page, we recommend studying the <em>slingbucks</em> and <em>espblog</em> samples. Both have README files with more info.</p>
@@ -181,7 +184,7 @@ curl -u admin:admin -T sling.jpg http://localhost:8080/images/sling.jpg
<p>And upload it again to replace the previous version:</p>
<pre><code>curl -u admin:admin -T html.esp http://localhost:8080/apps/foo/bar/html.esp
</code></pre>
-<p>The <a href="http://localhost:8080/content/mynode.html">http://localhost:8080/content/mynode.html</a>, once refreshed, now shows the blue headline and logo, and this layout also applies to any node created with <em>sling:resourceType=foo/bar</em>.</p></section></div></div>
+<p>The <a href="http://localhost:8080/content/mynode.html">http://localhost:8080/content/mynode.html</a>, once refreshed, now shows the blue headline and logo, and this layout also applies to any node created with <em>sling:resourceType=foo/bar</em>.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/legacy/logging.html
----------------------------------------------------------------------
diff --git a/documentation/legacy/logging.html b/documentation/legacy/logging.html
index b6013d5..8b2f563 100644
--- a/documentation/legacy/logging.html
+++ b/documentation/legacy/logging.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Logging</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Logging</h1></header><div class="note">
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » </div> <h1>
+ Logging
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><div class="note">
This document is for 3.x release of Sling Commons Log components. Refer to
<a href="http://sling.apache.org/documentation/development/logging.html">Logging</a> for documentation related
to newer version.
@@ -247,7 +249,7 @@ to newer version.
<p>Note that Scheduled Rotation ignores the <code>org.apache.sling.commons.log.file.number</code> property since the old log files are not numbered but "dated".</p>
<h3>Size Rotation</h3>
<p>Log file rotation by size is specified by setting the <code>org.apache.sling.commons.log.file.size</code> property to a plain number or a number plus a size multiplier. The size multiplier may be any of <code>K</code>, <code>KB</code>, <code>M</code>, <code>MB</code>, <code>G</code>, or <code>GB</code> where the case is ignored and the meaning is probably obvious.</p>
-<p>When using Size Rotation, the <code>org.apache.sling.commons.log.file.number</code> defines the number of old log file generations to keep. For example to keep 5 old log files indexed by 0 through 4, set the <code>org.apache.sling.commons.log.file.number</code> to <code>5</code> (which happens to be the default).</p></section></div></div>
+<p>When using Size Rotation, the <code>org.apache.sling.commons.log.file.number</code> defines the number of old log file generations to keep. For example to keep 5 old log files indexed by 0 through 4, set the <code>org.apache.sling.commons.log.file.number</code> to <code>5</code> (which happens to be the default).</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/pax-exam-utils.html
----------------------------------------------------------------------
diff --git a/documentation/pax-exam-utils.html b/documentation/pax-exam-utils.html
index 0031933..aad8cb2 100644
--- a/documentation/pax-exam-utils.html
+++ b/documentation/pax-exam-utils.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Sling Pax Exam Utilities</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,9 +66,11 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Sling Pax Exam Utilities</h1></header><p>Utilities to help testing Sling components with Pax Exam are available at <a href="https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util">https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util</a></p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » </div> <h1>
+ Sling Pax Exam Utilities
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Utilities to help testing Sling components with Pax Exam are available at <a href="https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util">https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util</a></p>
<p>The focus is on making it easier to test Sling components against a full Sling launchpad, with minimal boilerplate code.</p>
-<p>See the <a href="https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util/src/test/java/org/apache/sling/paxexam/util/SlingRepositoryTest.java">SlingRepositoryTest</a> class for an example test.</p></section></div></div>
+<p>See the <a href="https://svn.apache.org/repos/asf/sling/trunk/testing/sling-pax-util/src/test/java/org/apache/sling/paxexam/util/SlingRepositoryTest.java">SlingRepositoryTest</a> class for an example test.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine.html b/documentation/the-sling-engine.html
index 0c5f504..6accd85 100644
--- a/documentation/the-sling-engine.html
+++ b/documentation/the-sling-engine.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: The Sling Engine</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>The Sling Engine</h1></header><h2>General</h2>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » </div> <h1>
+ The Sling Engine
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><h2>General</h2>
<ul>
<li><a href="/documentation/the-sling-engine/architecture.html">Architecture</a></li>
<li><a href="/documentation/the-sling-engine/authentication.html">Authentication</a></li>
@@ -94,7 +96,7 @@
<ul>
<li><a href="/documentation/the-sling-engine/adapters.html">Adapters</a></li>
<li><a href="/documentation/the-sling-engine/featureflags.html">Feature Flags</a></li>
-</ul></section></div></div>
+</ul></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/adapters.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/adapters.html b/documentation/the-sling-engine/adapters.html
index 080858f..3fb12ea 100644
--- a/documentation/the-sling-engine/adapters.html
+++ b/documentation/the-sling-engine/adapters.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Adapters</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,10 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Adapters</h1></header><p>[TOC]</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Adapters
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<p>The <code>Resource</code> and <code>ResourceResolver</code> interfaces are defined with a method <code>adaptTo</code>, which adapts the object to other classes. Using this mechanism the JCR session of the resource resolver calling the <code>adaptTo</code> method with the <code>javax.jcr.Session</code> class object. Likewise the JCR node on which a resource is based can be retrieved by calling the <code>Resource.adaptTo</code> method with the <code>javax.jcr.Node</code> class object.</p>
<p>To use resources as scripts, the <code>Resource.adaptTo</code> method must support being called with the <code>org.apache.sling.api.script.SlingScript</code> class object. But of course, we do not want to integrate the script manager with the resource resolver. To enable adapting objects to classes which are not foreseen by the original implementation, a factory mechanism is used. This way, the script manager can provide an adapter factory to adapt <code>Resource</code> to <code>SlingScript</code> objects.</p>
<h1>Adaptable</h1>
@@ -179,7 +182,7 @@
<p>Any object can theoretically be adapted to any class even if it does not implement the <code>Adaptable</code> interface, if an <code>AdapterFactory</code> service delivers a <code>getAdapter()</code> method which adapts an object to another one. To check if there's any existing <code>AdapterFactory</code> which can adapt a given object to another one the <code>AdapterManager</code> service with its <code>getAdapter()</code> method does the job. So the <code>Adaptable</code> interface merely is an indicator that the object provides built-in support for being adapted.</p>
<h2>SlingAdaptable</h2>
<p>The <code>SlingAdaptable</code> class is an implementation of the <code>Adaptable</code> interface which provides built-in support to call the <code>AdapterManager</code> to provide an adapter from the <code>Adaptable</code> object to the requested class.</p>
-<p>An example of extending the <code>SlingAdaptable</code> class will be the Sling JCR based <code>Resource</code> implementation. This way, such a resource may be adapted to a <code>SlingScript</code> by means of an appropriately programmed <code>AdapterFactory</code> (see below).</p></section></div></div>
+<p>An example of extending the <code>SlingAdaptable</code> class will be the Sling JCR based <code>Resource</code> implementation. This way, such a resource may be adapted to a <code>SlingScript</code> by means of an appropriately programmed <code>AdapterFactory</code> (see below).</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/architecture.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/architecture.html b/documentation/the-sling-engine/architecture.html
index c83d758..09b580f 100644
--- a/documentation/the-sling-engine/architecture.html
+++ b/documentation/the-sling-engine/architecture.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Architecture</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Architecture</h1></header><p>The following is a short list of high-lights of Sling:</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Architecture
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The following is a short list of high-lights of Sling:</p>
<ul>
<li><strong><a href="#osgi">OSGi</a></strong> — The Sling application is built as a series of OSGi bundles and makes heavy use of a number of OSGi core and compendium services.</li>
<li><strong><a href="#sling-api">Sling API</a></strong> — To implement content based Web applications with Sling, an API has been defined, this extends the Servlet API and provides more functionality to work on the content.</li>
@@ -118,7 +120,7 @@
<p>The Sling Servlet is equally small as the Sling Application. It uses the Felix <code>HttpService</code> bridge as the glue between the servlet container and the OSGi framework.</p>
<p>As we have seen, Sling may be launched as a standalone Java Application or as a Web Application inside any compliant Servlet Container. To hide the differences of the launching mechanism, Sling internally registers a Servlet with an OSGi <code>HttpService</code>. Regardless of how Sling is launched, the Felix implementation of the OSGi <code>HttpService</code> specification is used. When Sling is launched as a standalone Java Application, Felix HttpService uses an embedded version of the Jetty servlet container. When Sling is launched as a Web Application, the Felix HttpService Bridge is used.</p>
<p>Optionally, PAX Web's implementation of HttpService can be used when Sling is launched as a standalone Java Application. See the <a href="/documentation/development/maven-launchpad-plugin.html">Maven Launchpad Plugin</a> page for information on how to do this.</p>
-<p>See <a href="/documentation/the-sling-engine/the-sling-launchpad.html">The Sling Launchpad</a> for more information.</p></section></div></div>
+<p>See <a href="/documentation/the-sling-engine/the-sling-launchpad.html">The Sling Launchpad</a> for more information.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/authentication.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/authentication.html b/documentation/the-sling-engine/authentication.html
index eac82a4..14ba550 100644
--- a/documentation/the-sling-engine/authentication.html
+++ b/documentation/the-sling-engine/authentication.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Authentication</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,8 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Authentication</h1></header><p>Excerpt: How requests are authenticated.</p>
-<p>This section describes the framework provided by Sling to authenticate HTTP requests.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Authentication
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>This section describes the framework provided by Sling to authenticate HTTP requests.</p>
<p>Let's look at generic request processing of Sling: Sling is linked into the outside world by registering the Sling Main Servlet – implemented by the <code>SlingMainServlet</code> class in the Sling Engine bundle – with an OSGi <code>HttpService</code>. This registration is accompanyied with an implementation instance of the OSGi <code>HttpContext</code> interface, which defines a method to authenticate requests: <code>handleSecurity</code>.</p>
<p>This method is called by the OSGi HTTP Service implementation after the servlet has been selected to handle the request but before actually calling the servlet's <code>service</code> method.</p>
<a href="authentication.png" style="float:left;padding-right:5%">
@@ -85,7 +86,7 @@
<li><a href="/documentation/the-sling-engine/authentication/authentication-actors.html">Actors</a>: Authentication actors and process</li>
<li><a href="/documentation/the-sling-engine/authentication/authentication-framework.html">Framework</a>: Authentication Framework, Auth Core bundle etc.</li>
<li><a href="/documentation/the-sling-engine/authentication/authentication-authenticationhandler.html">AuthenticationHandler</a>: Authentication Handler service API.</li>
-</ul></section></div></div>
+</ul></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/authentication/authentication-actors.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/authentication/authentication-actors.html b/documentation/the-sling-engine/authentication/authentication-actors.html
index ce9977b..63bc2e4 100644
--- a/documentation/the-sling-engine/authentication/authentication-actors.html
+++ b/documentation/the-sling-engine/authentication/authentication-actors.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Authentication - Actors</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,8 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Authentication - Actors</h1></header><p>Excerpt: The authentication process involves a number of actors contributing to the concepts, the API and the particular implementations.</p>
-<p>The authentication process involves a number of actors contributing to the concepts, the API and the particular implementations.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » <a href="/ng/documentation/the-sling-engine/authentication.html">Authentication</a> » </div> <h1>
+ Authentication - Actors
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The authentication process involves a number of actors contributing to the concepts, the API and the particular implementations.</p>
<h2>OSGi Http Service Specification</h2>
<p>The main support for authentication is defined by the OSGi Http Service specification. This specification defines how an OSGi application can register servlets and resources to build web applications. As part of the servlet and/or resource registration a <code>HttpContext</code> may be provided, which allows for additional support.</p>
<p>The main method of interest to the authentication process is the <code>handleSecurity</code> method. This is called by the OSGi Http Service implementation before the registered servlet is called. Its intent is to authenticate the request and to provide authentication information for the request object: the authentication type and the remote user name.</p>
@@ -106,7 +107,7 @@
<p>Sling Applications should never directly use any knowledge of any authentication handler or directly call into an authentication handler. This will certainly break the application and cause unexpected behaviour.</p>
<div class="info">
If you want to know whether a request is authenticated or not, you can inspect the result of the <code>HttpServletRequest.getAuthType</code> method: If this method returns <code>null</code> the request is not authenticated.
-</div></section></div></div>
+</div></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/authentication/authentication-authenticationhandler.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/authentication/authentication-authenticationhandler.html b/documentation/the-sling-engine/authentication/authentication-authenticationhandler.html
index 3e869a7..14eb620 100644
--- a/documentation/the-sling-engine/authentication/authentication-authenticationhandler.html
+++ b/documentation/the-sling-engine/authentication/authentication-authenticationhandler.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Authentication - AuthenticationHandler</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,8 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Authentication - AuthenticationHandler</h1></header><p>Excerpt: The <code>AuthenticationHandler</code> interface defines the service API which may be implemented by authentication handlers registered as OSGi services.</p>
-<p>The <code>AuthenticationHandler</code> interface defines the service API which may be implemented by authentication handlers registered as OSGi services.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » <a href="/ng/documentation/the-sling-engine/authentication.html">Authentication</a> » </div> <h1>
+ Authentication - AuthenticationHandler
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The <code>AuthenticationHandler</code> interface defines the service API which may be implemented by authentication handlers registered as OSGi services.</p>
<p><code>AuthenticationHandler</code> services have a single required service registration property which is used to identify requests to which the <code>AuthenticationHandler</code> service is applicable:</p>
<table>
<thead>
@@ -140,7 +141,7 @@
<li><code>requestCredentials</code> -- Send the login form for the user to provide the login parameters.</li>
<li><code>dropCredentials</code> -- Clear the authentication cookie and internal store.</li>
</ul>
-<p>///Footnotes Go Here///</p></section></div></div>
+<p>///Footnotes Go Here///</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/authentication/authentication-authenticationhandler/form-based-authenticationhandler.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/authentication/authentication-authenticationhandler/form-based-authenticationhandler.html b/documentation/the-sling-engine/authentication/authentication-authenticationhandler/form-based-authenticationhandler.html
index 820b6a3..4fe2d97 100644
--- a/documentation/the-sling-engine/authentication/authentication-authenticationhandler/form-based-authenticationhandler.html
+++ b/documentation/the-sling-engine/authentication/authentication-authenticationhandler/form-based-authenticationhandler.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Form Based AuthenticationHandler</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,10 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Form Based AuthenticationHandler</h1></header><p>[TOC]</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » <a href="/ng/documentation/the-sling-engine/authentication.html">Authentication</a> » <a href="/ng/documentation/the-sling-engine/authentication/authentication-authenticationhandler.html">Authentication - AuthenticationHandler</a> » </div> <h1>
+ Form Based AuthenticationHandler
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<p>The Form Based AuthenticationHandler has two authentication phases: The first phase is presenting a login form to the user and passing the entered user name and password to the server. The second phase is storing successful authentication in a Cookie or an HTTP Session.</p>
<p>The implementation of the Form Based Authentication Handler follows the guidelines of the Servlet API 2.4 specification for <em>Form Based Authentication</em> in section SRV.12.5.3. Specifically the following requirements are implemented:</p>
<ul>
@@ -214,7 +217,7 @@
<li>User name and password are transmitted in plain text in the initial form submission.</li>
<li>The Cookie used to provide the authentication state or the HTTP Session ID may be stolen.</li>
</ol>
-<p>To prevent eavesdroppers from sniffing the credentials or stealing the Cookie a secure transport layer should be used such as TLS/SSL, VPN or IPSec.</p></section></div></div>
+<p>To prevent eavesdroppers from sniffing the credentials or stealing the Cookie a secure transport layer should be used such as TLS/SSL, VPN or IPSec.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/authentication/authentication-authenticationhandler/openid-authenticationhandler.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/authentication/authentication-authenticationhandler/openid-authenticationhandler.html b/documentation/the-sling-engine/authentication/authentication-authenticationhandler/openid-authenticationhandler.html
index 390e63b..65449c3 100644
--- a/documentation/the-sling-engine/authentication/authentication-authenticationhandler/openid-authenticationhandler.html
+++ b/documentation/the-sling-engine/authentication/authentication-authenticationhandler/openid-authenticationhandler.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: OpenID AuthenticationHandler</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,10 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>OpenID AuthenticationHandler</h1></header><p>[TOC]</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » <a href="/ng/documentation/the-sling-engine/authentication.html">Authentication</a> » <a href="/ng/documentation/the-sling-engine/authentication/authentication-authenticationhandler.html">Authentication - AuthenticationHandler</a> » </div> <h1>
+ OpenID AuthenticationHandler
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<p>The OpenID Authentication Handler supports authentication of request users using the <a href="http://www.openid.net">OpenID</a> authentication protocol. If the user has successfully authenticated with his OpenID provider a signed OpenID identity is further used to identify the user.</p>
<p>Since generally an OpenID identity is an URL and URLs may not be used as JCR user names, an association mechanism is used by the OpenID authentication handler to associate an OpenID identity with an existing JCR user: The OpenID identity URL is set as the value of a JCR user property. When a user authenticates with his OpenID identity the matching user searched for by looking for a match in this property.</p>
<p><em>NOTE:</em> This association currently only works with Jackrabbit (or Jackrabbit based repositories) because user management is not part of the JCR 2 specification and the OpenID authentication handler uses the Jackrabbit <code>UserManager</code> to find users by a user property value.</p>
@@ -174,7 +177,7 @@
<li>The Cookie used to provide the authentication state or the HTTP Session ID may be stolen.</li>
<li>When using the <code>trusted_credentials_attribute</code> mechanism, any intruder knowing the attribute name may log into the repository as any existing JCR user. The better option is to be based on the <code>LoginModulePlugin</code> mechanism.</li>
</ol>
-<p>To prevent eavesdroppers from sniffing the credentials or stealing the Cookie a secure transport layer should be used such as TLS/SSL, VPN or IPSec.</p></section></div></div>
+<p>To prevent eavesdroppers from sniffing the credentials or stealing the Cookie a secure transport layer should be used such as TLS/SSL, VPN or IPSec.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/authentication/authentication-framework.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/authentication/authentication-framework.html b/documentation/the-sling-engine/authentication/authentication-framework.html
index ee7d9e7..d38de48 100644
--- a/documentation/the-sling-engine/authentication/authentication-framework.html
+++ b/documentation/the-sling-engine/authentication/authentication-framework.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Authentication - Framework</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,8 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Authentication - Framework</h1></header><p>Excerpt: The core piece of functionality with respect to authentication in Sling is contained in the Sling Auth Core bundle. This bundle provides the API for Sling and Sling applications to make use of authentication.</p>
-<p>The core piece of functionality with respect to authentication in Sling is contained in the Sling Auth Core bundle. This bundle provides the API for Sling and Sling applications to make use of authentication.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » <a href="/ng/documentation/the-sling-engine/authentication.html">Authentication</a> » </div> <h1>
+ Authentication - Framework
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The core piece of functionality with respect to authentication in Sling is contained in the Sling Auth Core bundle. This bundle provides the API for Sling and Sling applications to make use of authentication.</p>
<p>This support encompasses three parts:</p>
<ul>
<li>The <code>AuthenticationSupport</code> service provided by the <code>SlingAuthenticator</code> class. This service can be used by implementations of the OSGi <code>HttpContext</code> interface to delegate authentication.</li>
@@ -220,7 +221,7 @@
<li>Select one or more <code>AuthenticationHandler</code> for the request according to the request URL's scheme and authorization part.</li>
<li>Call the <code>dropCredentials</code> method of each authentication handler, where the order of handler call is defined by the length of the registered path: handlers registered with longer paths are called before handlers with shorter paths. The goal is to call the handlers in order from longest request path match to shortest match. Handlers not matching the request path at all are not called.</li>
</ol>
-<p>Unlike for the <code>login</code> method in the <code>logout</code> method case all <code>AuthenticationHandler</code> services selected in the first step are called. If none can be selected or none can actually handle the <code>dropCredentials</code> request, the <code>logout</code> silently returns.</p></section></div></div>
+<p>Unlike for the <code>login</code> method in the <code>logout</code> method case all <code>AuthenticationHandler</code> services selected in the first step are called. If none can be selected or none can actually handle the <code>dropCredentials</code> request, the <code>logout</code> silently returns.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/authentication/authentication-tasks.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/authentication/authentication-tasks.html b/documentation/the-sling-engine/authentication/authentication-tasks.html
index cae077e..a6a85af 100644
--- a/documentation/the-sling-engine/authentication/authentication-tasks.html
+++ b/documentation/the-sling-engine/authentication/authentication-tasks.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Authentication - Tasks</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,8 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Authentication - Tasks</h1></header><p>Excerpt: Authentication of HTTP Requests is generally a two-step process: First the credentials must be extracted from the request and second the credentials must be validated. In the case of Sling this means acquiring a JCR Session.</p>
-<p>Authentication of HTTP Requests is generally a two-step process: First the credentials must be extracted from the request and second the credentials must be validated. In the case of Sling this means acquiring a JCR Session.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » <a href="/ng/documentation/the-sling-engine/authentication.html">Authentication</a> » </div> <h1>
+ Authentication - Tasks
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Authentication of HTTP Requests is generally a two-step process: First the credentials must be extracted from the request and second the credentials must be validated. In the case of Sling this means acquiring a JCR Session.</p>
<h2>Extract Credentials from the Request</h2>
<ul>
<li>Implemented and controlled by the Sling Auth Core bundle</li>
@@ -82,7 +83,7 @@
<li>Provides a JCR <code>Session</code></li>
<li>Implementation dependent process. Jackrabbit provides extensibility based on <code>LoginModules</code>; Sling's Embedded Jackrabbit Repository bundle provides extensibility with <code>LoginModulePlugin</code> services.</li>
</ul>
-<p>Currently the credentials are always verified by trying to login to the JCR repository. Once an <a href="http://cwiki.apache.org/SLING/add-resourceresolverfactory-service-interface.html">ResourceResolverFactory</a> API has been added, the process of validating the credentials and logging in is actualy replaced by a process of requesting a <code>ResourceResolver</code> from the <code>ResourceResolverFactory</code>. Of course, the JCR Repository will still be the main underlying repository and as such be used to validate the credentials and get a JCR Session.</p></section></div></div>
+<p>Currently the credentials are always verified by trying to login to the JCR repository. Once an <a href="http://cwiki.apache.org/SLING/add-resourceresolverfactory-service-interface.html">ResourceResolverFactory</a> API has been added, the process of validating the credentials and logging in is actualy replaced by a process of requesting a <code>ResourceResolver</code> from the <code>ResourceResolverFactory</code>. Of course, the JCR Repository will still be the main underlying repository and as such be used to validate the credentials and get a JCR Session.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/default-mapping-and-rendering.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/default-mapping-and-rendering.html b/documentation/the-sling-engine/default-mapping-and-rendering.html
index 691d777..fa3bade 100644
--- a/documentation/the-sling-engine/default-mapping-and-rendering.html
+++ b/documentation/the-sling-engine/default-mapping-and-rendering.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Default Mapping and Rendering</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,8 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Default Mapping and Rendering</h1></header><p>translation_pending: true</p>
-<p>This page contained obsolete content, moved it to http://cwiki.apache.org/confluence/display/SLING/Default+Mapping+and+Rendering+%28OBSOLETE%29 in case it is useful to someone.</p></section></div></div>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Default Mapping and Rendering
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>This page contained obsolete content, moved it to http://cwiki.apache.org/confluence/display/SLING/Default+Mapping+and+Rendering+%28OBSOLETE%29 in case it is useful to someone.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/dispatching-requests.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/dispatching-requests.html b/documentation/the-sling-engine/dispatching-requests.html
index 926970d..c37901e 100644
--- a/documentation/the-sling-engine/dispatching-requests.html
+++ b/documentation/the-sling-engine/dispatching-requests.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Dispatching Requests</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Dispatching Requests</h1></header><h2>Main process</h2>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Dispatching Requests
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><h2>Main process</h2>
<p>The following steps should give you an overview how a request is processed in Sling. Details can be found under provided links.</p>
<ol>
<li>
@@ -165,7 +167,7 @@
</tbody>
</table>
<p>Constants are defined in the <code>org.apache.sling.api.SlingConstants</code> class for these request attributes.</p>
-<p><strong>Note:</strong> These request attributes are not set if the servlet or script is called to handle the request or as a result of <code>RequestDispatcher.forward</code>.</p></section></div></div>
+<p><strong>Note:</strong> These request attributes are not set if the servlet or script is called to handle the request or as a result of <code>RequestDispatcher.forward</code>.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/errorhandling.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/errorhandling.html b/documentation/the-sling-engine/errorhandling.html
index aa209ac..78db68e 100644
--- a/documentation/the-sling-engine/errorhandling.html
+++ b/documentation/the-sling-engine/errorhandling.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Errorhandling</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,11 +66,14 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Errorhandling</h1></header><p>The Sling Engine includes support for handling uncaught <code>Throwable</code> as well as rendering custom HTTP status code pages. This is implemented by expecting a (single) <code>org.apache.sling.engine.servlets.ErrorHandler</code> service to which handling of uncaught <code>Throwable</code> and HTTP status responses are delegated.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Errorhandling
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>The Sling Engine includes support for handling uncaught <code>Throwable</code> as well as rendering custom HTTP status code pages. This is implemented by expecting a (single) <code>org.apache.sling.engine.servlets.ErrorHandler</code> service to which handling of uncaught <code>Throwable</code> and HTTP status responses are delegated.</p>
<p>The Sling Servlet Resolver bundle implements this interface by providing an elaborate mechanism to find the correct error handling script or servlet using the same algorithms as are used to select the scripts or servlets to handle regular requests.</p>
<p>This page provides more information on how error handler scripts are selected and what is provided out of the box.</p>
<p>The <a href="https://svn.apache.org/repos/asf/sling/trunk/launchpad/integration-tests/src/main/java/org/apache/sling/launchpad/webapp/integrationtest/servlets/resolver/errorhandler/ErrorHandlingTest.java">ErrorHandlingTest</a> in our integration tests suite provides working examples of various error handling scenarios.</p>
-<p>[TOC]</p>
+<p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<h2>Resetting the Response</h2>
<p>Errorhandler scripts and servlets are script with the current response. Before setting the status and writing to the response such handlers should do the following:</p>
<ul>
@@ -113,7 +116,7 @@
<li>Dump the request progress tracker</li>
</ul>
<p>Starting with Sling Servlet Resolver version 2.0.10 the default error handler servlet is looked up using the string <code>default</code> as the request extension and the provided default servlet is registered as <code><prefix>/sling/servlet/errorhandler/default.servlet</code> where <prefix> is the last entry in the resource resolver search path, <code>/libs</code> by default.</p>
-<p>Thus to overwrite the default error handler servlet provide a servlet or script for the <code>default</code> extension, for example <code>/apps/sling/servlet/errorhandler/default.groovy</code>.</p></section></div></div>
+<p>Thus to overwrite the default error handler servlet provide a servlet or script for the <code>default</code> extension, for example <code>/apps/sling/servlet/errorhandler/default.groovy</code>.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/featureflags.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/featureflags.html b/documentation/the-sling-engine/featureflags.html
index adfbfea..b3092b7 100644
--- a/documentation/the-sling-engine/featureflags.html
+++ b/documentation/the-sling-engine/featureflags.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Feature Flags</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Feature Flags</h1></header><p>Feature Flags are used to select whether a particular feature is enabled or not. This allows to continuosly deploy new features of an application without making them globally available yet.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Feature Flags
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Feature Flags are used to select whether a particular feature is enabled or not. This allows to continuosly deploy new features of an application without making them globally available yet.</p>
<p>Features may be enabled based on various contextual data:</p>
<ul>
<li>Time of Day</li>
@@ -98,7 +100,7 @@
<td>Boolean flag indicating whether the feature is enabled or not by this configuration</td>
</tr>
</tbody>
-</table></section></div></div>
+</table></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/filters.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/filters.html b/documentation/the-sling-engine/filters.html
index ac4a3c3..6bd4018 100644
--- a/documentation/the-sling-engine/filters.html
+++ b/documentation/the-sling-engine/filters.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Servlet Filter Support</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Servlet Filter Support</h1></header><p>Sling supports filter processing by applying filter chains to the requests before actually dispatching to the servlet or script for processing. Filters to be used in such filter processing are plain OSGi services of type <code>javax.servlet.Filter</code> which of course means that the services implement this interface.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Servlet Filter Support
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling supports filter processing by applying filter chains to the requests before actually dispatching to the servlet or script for processing. Filters to be used in such filter processing are plain OSGi services of type <code>javax.servlet.Filter</code> which of course means that the services implement this interface.</p>
<div class="note">
See <a href="https://issues.apache.org/jira/browse/SLING-1213">SLING-1213</a>,
<a href="https://issues.apache.org/jira/browse/SLING-1734">SLING-1734</a>, and
@@ -230,7 +232,7 @@ Component Filters:
<li>Any <code>javax.servlet.Filter</code> service is accepted as a filter for Sling unless the <code>pattern</code> property used by the <a href="http://felix.apache.org/site/apache-felix-http-service.html#ApacheFelixHTTPService-UsingtheWhiteboard">Apache Felix HttpService whiteboard support</a> is set in the service registration properties.</li>
<li>The <code>filter.scope</code> property is optional and supports the case-sensitive values <code>request</code> and <code>component</code>.</li>
<li>Filter ordering is defined by the <code>filter.order</code> property whose default value is <code>Integer.MAX_VALUE</code> where smaller values have higher priority over higher values.</li>
-</ul></section></div></div>
+</ul></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/mappings-for-resource-resolution.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/mappings-for-resource-resolution.html b/documentation/the-sling-engine/mappings-for-resource-resolution.html
index 9101026..6f230d7 100644
--- a/documentation/the-sling-engine/mappings-for-resource-resolution.html
+++ b/documentation/the-sling-engine/mappings-for-resource-resolution.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Mappings for Resource Resolution</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,10 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Mappings for Resource Resolution</h1></header><p>[TOC]</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Mappings for Resource Resolution
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<h2>Configuration</h2>
<h3>Properties</h3>
<p>The mapping of request URLs to resources is mainly configured in a configuration tree which is (by default) located below <code>/etc/map</code>. The actual location can be configured with the <code>resource.resolver.map.location</code> property of the <code>org.apache.sling.jcr.resource.internal.JcrResourceResolverFactoryImpl</code> configuration. That way you can even make it run mode specific, by taking advantage of the Sling OSGi Installer's run mode awareness.</p>
@@ -287,7 +290,7 @@ for (String segment: segments) {
<li>start Apache Sling (this might take few minutes, depending on how many vanity path entries are present)</li>
</ul>
<h2>Debugging Issues</h2>
-<p>Use the Felix Web Console Plugin provided at <code>/system/console/jcrresolver</code> to inspect both the mapping and the resolver map entries. Also you can check what either <code>ResourceResolver.map(...)</code> or <code>ResourceResolver.resolve(...)</code> would return for a given URL/path.</p></section></div></div>
+<p>Use the Felix Web Console Plugin provided at <code>/system/console/jcrresolver</code> to inspect both the mapping and the resolver map entries. Also you can check what either <code>ResourceResolver.map(...)</code> or <code>ResourceResolver.resolve(...)</code> would return for a given URL/path.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/request-listeners.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/request-listeners.html b/documentation/the-sling-engine/request-listeners.html
index 1f1381b..5c239e8 100644
--- a/documentation/the-sling-engine/request-listeners.html
+++ b/documentation/the-sling-engine/request-listeners.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Request Listeners</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Request Listeners</h1></header><p>Sling provides the possibility to "listen" to a request processed by the Sling Engine (<code>SlingMainServlet</code>). To get notified you implement the service interface <code>org.apache.sling.api.request.SlingRequestListener</code>.</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Request Listeners
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p>Sling provides the possibility to "listen" to a request processed by the Sling Engine (<code>SlingMainServlet</code>). To get notified you implement the service interface <code>org.apache.sling.api.request.SlingRequestListener</code>.</p>
<pre><code>#!java
public interface SlingRequestListener {
@@ -104,7 +106,7 @@ public interface SlingRequestListener {
<td>at the end of the <code>service</code> method in <code>SlingMainServlet</code> </td>
</tr>
</tbody>
-</table></section></div></div>
+</table></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/request-parameters.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/request-parameters.html b/documentation/the-sling-engine/request-parameters.html
index 3cb5577..f9f5ac7 100644
--- a/documentation/the-sling-engine/request-parameters.html
+++ b/documentation/the-sling-engine/request-parameters.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Request Parameter Handling in Sling</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,8 +66,9 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Request Parameter Handling in Sling</h1></header><p>Excerpt: Explains how Sling provides request parameters to the <code>Component</code>.</p>
-<h2>Servlet API</h2>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Request Parameter Handling in Sling
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><h2>Servlet API</h2>
<p>The Servlet API specification provides the following methods to access the parameters of a request</p>
<table>
<thead>
@@ -190,7 +191,7 @@
<div class="info">
Up to and including Sling Engine 2.2.2 request parameters are always decoded with ISO-8859-1 encoding if the <code>_charset_</code> request parameter is missing. As of Sling Engine 2.2.4 the <code>_charset_</code> request parameter is optional. As of this version the Sling Main Servlet supports a configuration setting which allows to change the default character encoding used if the <code>_charset_</code> request parameter is missing.
To enable this functionality set the <code>sling.default.parameter.encoding</code> parameter of the Sling Main Servlet (PID <code>org.apache.sling.engine.impl.SlingMainServlet</code>) configuration (for Sling Engine < 2.3.0) or the same parameter of the Sling Request Parameter Handling (PID <code>org.apache.sling.engine.parameters</code>) configuration (for Sling Engine >= 2.3.0 ) to the desired encoding, which of course must be supported by the actual Java Platform.
-</div></section></div></div>
+</div></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/resources.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/resources.html b/documentation/the-sling-engine/resources.html
index 82a6882..ba8ac75 100644
--- a/documentation/the-sling-engine/resources.html
+++ b/documentation/the-sling-engine/resources.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Resources</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,10 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Resources</h1></header><p>[TOC]</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Resources
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<h2>What is a Resource</h2>
<p>The Resource is one of the central parts of Sling. Extending from JCR's <em>Everything is Content</em>, Sling assumes <em>Everthing is a Resource</em>. Thus Sling is maintaining a virtual tree of resources, which is a merger of the actual contents in the JCR Repository and resources provided by so called resource providers. By doing this Sling fits very well in the paradigma of the REST architecture.</p>
<h3>Resource Properties</h3>
@@ -216,7 +219,7 @@
<h3>OSGi Event Admin</h3>
<p>Resource events are sent out via the OSGi Event Admin. You can subscribe to those event by registering an OSGi service for <a href="https://osgi.org/javadoc/r6/cmpn/org/osgi/service/event/EventHandler.html"><code>org.osgi.service.event.EventHandler</code></a>. Several properties should be used to restrict the subscription to only the relevant event. The event topics which are used for resources are listed as constants in <a href="http://sling.apache.org/apidocs/sling8/org/apache/sling/api/SlingConstants.html"><code>org.apache.sling.api.SlingConstants</code></a> starting with the prefix <code>TOPIC_</code>.</p>
<h2>Wrap/Decorate Resources</h2>
-<p>The Sling API provides an easy way to wrap or decorate a resource before returning. Details see <a href="/documentation/the-sling-engine/wrap-or-decorate-resources.html">Wrap or Decorate Resources</a>.</p></section></div></div>
+<p>The Sling API provides an easy way to wrap or decorate a resource before returning. Details see <a href="/documentation/the-sling-engine/wrap-or-decorate-resources.html">Wrap or Decorate Resources</a>.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/service-authentication.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/service-authentication.html b/documentation/the-sling-engine/service-authentication.html
index 12307bd..d1c63ee 100644
--- a/documentation/the-sling-engine/service-authentication.html
+++ b/documentation/the-sling-engine/service-authentication.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Service Authentication</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,8 +66,10 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Service Authentication</h1></header><p>Excerpt: Introduce new service level authentication to replace <code>loginAdministrative</code></p>
-<p>[TOC]</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Service Authentication
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<h2>Problem</h2>
<p>To access the data storage in the Resource Tree and/or the JCR Repository authentication is required to properly setup access control and guard sensitive data from unauthorized access. For regular request processing this authentication step is handled by the Sling <a href="/documentation/the-sling-engine/authentication.html">Authentication</a> subsystem.</p>
<p>On the other hand there are also some background tasks to be executed with access to the resources. Such tasks cannot in general be configured with user names and passwords: Neither hard coding the passwords in the code nor having the passwords in – more or less – plain text in some configuration is considered good practice.</p>
@@ -225,7 +227,7 @@ whitelist.bundles.regexp="^PAXEXAM.*$"
<td>A regular expression that whitelists all matching bundle symbolic names. This is <strong>NOT</strong> recommended for production and warnings will be logged. </td>
</tr>
</tbody>
-</table></section></div></div>
+</table></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/servlets.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/servlets.html b/documentation/the-sling-engine/servlets.html
index e784481..716af6a 100644
--- a/documentation/the-sling-engine/servlets.html
+++ b/documentation/the-sling-engine/servlets.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Servlets and Scripts</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,10 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Servlets and Scripts</h1></header><p>[TOC]</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Servlets and Scripts
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<p>See also <a href="/documentation/the-sling-engine/url-to-script-resolution.html">URL to Script Resolution</a> which explains how Sling maps URLs to a script or and servlet.</p>
<h2>Servlet Registration</h2>
<p>Servlets can be registered as OSGi services. The following service reference properties are evaluated for Servlets defined as OSGi services of type <code>javax.servlet.Servlet</code> (all those property names are defined in <code>org.apache.sling.api.servlets.ServletResolverConstants</code> (since API 2.15.2) or <code>org.apache.sling.servlets.resolver.internal.ServletResolverConstants</code> (before API 2.15.2)):</p>
@@ -225,7 +228,7 @@ sling.servlet.extensions = [ "html", "txt", "json"
<p>In this case, the servlet is only selected for processing the current request if its <code>accept</code> method returns true.</p>
<p>While an opting servlet seems to be a nice way of picking the right servlet to process the request, the use of an opting servlet is not recommended: the main reason is that it complicates the request processing, makes it less transparent what is going on during a request and prevents optimizations like caching the script resolution in an optimal manner. The other static options are usually sufficient for all use cases.</p>
<h2>Error Handler Servlet(s) or Scripts</h2>
-<p>Error handling support is described on the <a href="/documentation/the-sling-engine/errorhandling.html">Errorhandling</a> page.</p></section></div></div>
+<p>Error handling support is described on the <a href="/documentation/the-sling-engine/errorhandling.html">Errorhandling</a> page.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here
http://git-wip-us.apache.org/repos/asf/sling-site/blob/6120b7bb/documentation/the-sling-engine/sling-api-crud-support.html
----------------------------------------------------------------------
diff --git a/documentation/the-sling-engine/sling-api-crud-support.html b/documentation/the-sling-engine/sling-api-crud-support.html
index fc27a98..3342d59 100644
--- a/documentation/the-sling-engine/sling-api-crud-support.html
+++ b/documentation/the-sling-engine/sling-api-crud-support.html
@@ -1,7 +1,7 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
- <title>Apache Sling on JBake</title>
+ <title>Apache Sling :: Sling API CRUD Support</title>
<link rel="icon" href="/ng/res/favicon.ico"/>
<link rel="stylesheet" href="/ng/res/css/site.css"/>
@@ -66,7 +66,10 @@
<strong><a href="/ng/sitemap.html">Site Map</a></strong>
</p>
</div> <div class="main">
-<div class="row"><div class="small-12 columns"><section class="wrap"><header><h1>Sling API CRUD Support</h1></header><p>[TOC]</p>
+<div class="breadcrumbs"><a href="/ng/">Home</a> » <a href="/ng/documentation.html">Documentation</a> » <a href="/ng/documentation/the-sling-engine.html">The Sling Engine</a> » </div> <h1>
+ Sling API CRUD Support
+ </h1><div class="row"><div class="small-12 columns"><section class="wrap"><p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
+</p>
<h2>Apache Sling API Support</h2>
<p>As of version 2.3.0, the Sling API provides full Create Read Update Delete (CRUD) features. CRUD support is provided by the addition of the following methods to the ResourceResolver:</p>
<ul>
@@ -196,7 +199,7 @@ resourceResolver.commit();
<li><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Boolean.html">Boolean</a></li>
<li><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html">String</a></li>
</ul>
-<p>As well as the corresponding primitive types. Any object which implements the Serializable interface will be serialized and the result of the serialization will be saved as a binary value for the property.</p></section></div></div>
+<p>As well as the corresponding primitive types. Any object which implements the Serializable interface will be serialized and the result of the serialization will be saved as a binary value for the property.</p></section></div></div>
<div class="footer">
<div class="timestamp">
TODO display revision number here