incubator-sling-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r841833 [20/28] - in /websites/staging/sling/trunk/content: ./ site/ site/46-line-blog.data/ site/authentication.data/ site/documentation.data/ site/first-steps.data/ site/getting-and-building-sling.data/ site/how-to-manage-events-in-sling....
Date Wed, 12 Dec 2012 09:17:17 GMT
Added: websites/staging/sling/trunk/content/site/old-documentation.html
==============================================================================
--- websites/staging/sling/trunk/content/site/old-documentation.html (added)
+++ websites/staging/sling/trunk/content/site/old-documentation.html Wed Dec 12 09:16:44 2012
@@ -0,0 +1,57 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Apache Sling - Old Documentation</TITLE>
+    <LINK rel="stylesheet" href="http://incubator.apache.org/sling/site/media.data/site.css" type="text/css" media="all">
+    <LINK rel="icon" href="http://incubator.apache.org/sling/site/media.data/favicon.ico">
+    <META http-equiv="Content-Type" content="text/html;charset=UTF-8">
+  </HEAD>
+  <BODY>
+    <DIV class="title">
+      <DIV class="logo">
+        <A href="http://incubator.apache.org/sling/site/index.html">
+          <IMG border="0" alt="Apache Sling" src="http://incubator.apache.org/sling/site/media.data/logo.png">
+        </A>
+      </DIV>
+      <DIV class="header">
+        <A href="http://incubator.apache.org/">
+          <IMG border="0" alt="Apache Incubator" src="http://incubator.apache.org/images/apache-incubator-logo.png">
+        </A>
+      </DIV>
+    </DIV>
+    <DIV class="menu">
+                                    <P>
+
+<UL>
+	<LI><A href="index.html" title="Index">Home</A></LI>
+	<LI><A href="project-information.html" title="Project Information">Project Information</A></LI>
+	<LI><A href="usecases.html" title="UseCases">Use Cases</A></LI>
+	<LI><A href="guides.html" title="Guides">Guides</A></LI>
+	<LI><A href="documentation.html" title="Documentation">Documentation</A></LI>
+	<LI><A href="plugins.html" title="Plugins">Plugins</A></LI>
+	<LI><A href="../SLING/faq.html" title="FAQ">FAQ</A></LI>
+	<LI><A href="links.html" title="Links">Links</A></LI>
+	<LI><A href="" title="Old Documentation">Old Documentation</A></LI>
+	<LI><SPAN class="nobr"><A href="http://cwiki.apache.org/SLING/" title="Visit page outside Confluence" rel="nofollow">Wiki<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://www.apache.org/foundation/thanks.html" title="Visit page outside Confluence" rel="nofollow">Sponsors<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+	<LI><SPAN class="nobr"><A href="http://www.apache.org/foundation/sponsorship.html" title="Visit page outside Confluence" rel="nofollow">Sponsorship<SUP><IMG class="rendericon" src="http://cwiki.apache.org/confluence/images/icons/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"></SUP></A></SPAN></LI>
+</UL>
+
+
+<P>
+                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            </DIV>
+    <DIV class="main">
+<H1><A name="OldDocumentation-OldDocumentation"></A>Old Documentation</H1>
+
+<P>Below this page you will find a series of old documentation pages, which were accutate mostly at the time Sling entered the Apache Incubator. During the months of October and November 2007 the main API of Sling called the <EM>Component API</EM> underwent a dramatic overhaul and is now the <EM>Sling API</EM>.</P>
+
+<P>For the moment we do not want to just throw away these old pages but remove them from the front, so we put them here. Sometime in the future, the contents in here will probably go for good.</P>
+
+<P>Here is a list of the contents of the old documentation</P>
+
+<UL><LI><A href="component-api.html" title="Component API">Component API</A></LI></UL>
+    </DIV>
+  </BODY>
+</HTML>
+

Added: websites/staging/sling/trunk/content/site/old-stuff.html
==============================================================================
--- websites/staging/sling/trunk/content/site/old-stuff.html (added)
+++ websites/staging/sling/trunk/content/site/old-stuff.html Wed Dec 12 09:16:44 2012
@@ -0,0 +1,71 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Apache Sling - Old Stuff</TITLE>
+    <LINK rel="stylesheet" href="http://sling.apache.org/site/media.data/site.css" type="text/css" media="all">
+    <LINK rel="icon" href="http://sling.apache.org/site/media.data/favicon.ico">
+    <META http-equiv="Content-Type" content="text/html;charset=UTF-8">
+  </HEAD>
+  <BODY>
+    <DIV class="title">
+      <DIV class="logo">
+        <A href="http://sling.apache.org/site/index.html">
+          <IMG border="0" alt="Apache Sling" src="http://sling.apache.org/site/media.data/logo.png">
+        </A>
+      </DIV>
+      <DIV class="header">
+        <A href="http://www.apache.org/">
+          <IMG border="0" alt="Apache" src="http://sling.apache.org/site/media.data/apache.png">
+        </A>
+      </DIV>
+    </DIV>
+    <DIV class="menu">
+<P><B>Documentation</B><BR class="atl-forced-newline">
+<A href="getting-started.html" title="Getting Started">Getting Started</A><BR class="atl-forced-newline">
+<A href="the-sling-engine.html" title="The Sling Engine">The Sling Engine</A><BR class="atl-forced-newline">
+<A href="development.html" title="Development">Development</A><BR class="atl-forced-newline">
+<A href="bundles.html" title="Bundles">Bundles</A><BR class="atl-forced-newline">
+<A href="tutorials-how-tos.html" title="Tutorials & How-Tos">Tutorials &amp; How&#45;Tos</A><BR class="atl-forced-newline">
+<A href="configuration.html" title="Configuration">Configuration</A><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/apidocs/sling6/index.html" class="external-link" rel="nofollow">API docs</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.wiki" class="external-link" rel="nofollow">Wiki</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.faq" class="external-link" rel="nofollow">FAQ</A><BR class="atl-forced-newline"></P>
+
+<P><B>Project info</B><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/site/downloads.cgi" class="external-link" rel="nofollow">Downloads</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</A><BR class="atl-forced-newline">
+<A href="contributing.html" title="Contributing">Contributing</A><BR class="atl-forced-newline">
+<A href="news.html" title="News">News</A><BR class="atl-forced-newline">
+<A href="links.html" title="Links">Links</A><BR class="atl-forced-newline">
+<A href="project-information.html" title="Project Information">Project Information</A><BR class="atl-forced-newline">
+<A href="https://issues.apache.org/jira/browse/SLING" class="external-link" rel="nofollow">Issue Tracker</A><BR class="atl-forced-newline">
+<A href="http://svn.apache.org/viewvc/sling/trunk" class="external-link" rel="nofollow">Browse Source Repository</A><BR class="atl-forced-newline">
+<A href="security.html" title="Security">Security</A><BR class="atl-forced-newline"></P>
+
+<P><B>Sponsorship</B><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/sponsorship.html" class="external-link" rel="nofollow">Become a Sponsor</A><BR>
+<A href="http://www.apache.org/foundation/buy_stuff.html" class="external-link" rel="nofollow">Buy Stuff</A></P>
+
+
+  <IFRAME src="http://www.apache.org/ads/button.html" style="border-width:0; float: left" frameborder="0" scrolling="no" width="135" height="135"></IFRAME>
+  <P style="height: 135px"></P>
+    </DIV>
+    <DIV class="main">
+        <DIV class="breadcrump" style="font-size: 80%;">
+<A href="apache-sling.html" title="Apache Sling Website">Apache Sling Website</A>&nbsp;&gt;&nbsp;<A href="apache-sling.html" title="Apache Sling">Apache Sling</A>&nbsp;&gt;&nbsp;<A href="" title="Old Stuff">Old Stuff</A>
+        </DIV>
+<P>Should either be deleted or reviewed and updated to match the current code:</P>
+
+<UL><LI><A href="assembly.html" title="Assembly">Assembly</A></LI><LI><A href="launch-sling.html" title="Launch Sling">Launch Sling</A></LI><LI><A href="request-processing.html" title="Request Processing">Request Processing</A></LI><LI><A href="run-modes-orgapacheslingrunmode.html" title="Run Modes (org.apache.sling.runmode)">Run Modes (org.apache.sling.runmode)</A></LI><LI><A href="scriptengineintegration.html" title="ScriptEngineIntegration">ScriptEngineIntegration</A><UL><LI><A href="groovy-support.html" title="Groovy Support">Groovy Support</A></LI><LI><A href="xslt-processing-pipeline.html" title="XSLT Processing Pipeline">XSLT Processing Pipeline</A></LI></UL></LI><LI><A href="servlet-resolution.html" title="Servlet Resolution">Servlet Resolution</A></LI><LI><A href="sling-api.html" title="Sling API">Sling API</A></LI></UL>
+        <DIV class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
+Last modified by mykee on 2009-06-01 07:47:50.0
+        </DIV>
+        <DIV class="trademarkFooter">
+Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+        </DIV>
+    </DIV>
+  </BODY>
+</HTML>
+

Added: websites/staging/sling/trunk/content/site/openid-authenticationhandler.html
==============================================================================
--- websites/staging/sling/trunk/content/site/openid-authenticationhandler.html (added)
+++ websites/staging/sling/trunk/content/site/openid-authenticationhandler.html Wed Dec 12 09:16:44 2012
@@ -0,0 +1,288 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Apache Sling - OpenID AuthenticationHandler</TITLE>
+    <LINK rel="stylesheet" href="http://sling.apache.org/site/media.data/site.css" type="text/css" media="all">
+    <LINK rel="icon" href="http://sling.apache.org/site/media.data/favicon.ico">
+    <META http-equiv="Content-Type" content="text/html;charset=UTF-8">
+  </HEAD>
+  <BODY>
+    <DIV class="title">
+      <DIV class="logo">
+        <A href="http://sling.apache.org/site/index.html">
+          <IMG border="0" alt="Apache Sling" src="http://sling.apache.org/site/media.data/logo.png">
+        </A>
+      </DIV>
+      <DIV class="header">
+        <A href="http://www.apache.org/">
+          <IMG border="0" alt="Apache" src="http://sling.apache.org/site/media.data/apache.png">
+        </A>
+      </DIV>
+    </DIV>
+    <DIV class="menu">
+<P><B>Documentation</B><BR class="atl-forced-newline">
+<A href="getting-started.html" title="Getting Started">Getting Started</A><BR class="atl-forced-newline">
+<A href="the-sling-engine.html" title="The Sling Engine">The Sling Engine</A><BR class="atl-forced-newline">
+<A href="development.html" title="Development">Development</A><BR class="atl-forced-newline">
+<A href="bundles.html" title="Bundles">Bundles</A><BR class="atl-forced-newline">
+<A href="tutorials-how-tos.html" title="Tutorials & How-Tos">Tutorials &amp; How&#45;Tos</A><BR class="atl-forced-newline">
+<A href="configuration.html" title="Configuration">Configuration</A><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/apidocs/sling6/index.html" class="external-link" rel="nofollow">API docs</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.wiki" class="external-link" rel="nofollow">Wiki</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.faq" class="external-link" rel="nofollow">FAQ</A><BR class="atl-forced-newline"></P>
+
+<P><B>Project info</B><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/site/downloads.cgi" class="external-link" rel="nofollow">Downloads</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</A><BR class="atl-forced-newline">
+<A href="contributing.html" title="Contributing">Contributing</A><BR class="atl-forced-newline">
+<A href="news.html" title="News">News</A><BR class="atl-forced-newline">
+<A href="links.html" title="Links">Links</A><BR class="atl-forced-newline">
+<A href="project-information.html" title="Project Information">Project Information</A><BR class="atl-forced-newline">
+<A href="https://issues.apache.org/jira/browse/SLING" class="external-link" rel="nofollow">Issue Tracker</A><BR class="atl-forced-newline">
+<A href="http://svn.apache.org/viewvc/sling/trunk" class="external-link" rel="nofollow">Browse Source Repository</A><BR class="atl-forced-newline">
+<A href="security.html" title="Security">Security</A><BR class="atl-forced-newline"></P>
+
+<P><B>Sponsorship</B><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/sponsorship.html" class="external-link" rel="nofollow">Become a Sponsor</A><BR>
+<A href="http://www.apache.org/foundation/buy_stuff.html" class="external-link" rel="nofollow">Buy Stuff</A></P>
+
+
+  <IFRAME src="http://www.apache.org/ads/button.html" style="border-width:0; float: left" frameborder="0" scrolling="no" width="135" height="135"></IFRAME>
+  <P style="height: 135px"></P>
+    </DIV>
+    <DIV class="main">
+        <DIV class="breadcrump" style="font-size: 80%;">
+<A href="apache-sling.html" title="Apache Sling Website">Apache Sling Website</A>&nbsp;&gt;&nbsp;<A href="apache-sling.html" title="Apache Sling">Apache Sling</A>&nbsp;&gt;&nbsp;<A href="documentation.html" title="Documentation">Documentation</A>&nbsp;&gt;&nbsp;<A href="the-sling-engine.html" title="The Sling Engine">The Sling Engine</A>&nbsp;&gt;&nbsp;<A href="authentication.html" title="Authentication">Authentication</A>&nbsp;&gt;&nbsp;<A href="authentication-authenticationhandler.html" title="Authentication - AuthenticationHandler">Authentication - AuthenticationHandler</A>&nbsp;&gt;&nbsp;<A href="" title="OpenID AuthenticationHandler">OpenID AuthenticationHandler</A>
+        </DIV>
+<H1><A name="OpenIDAuthenticationHandler-OpenIDAuthenticationHandler"></A>OpenID AuthenticationHandler</H1>
+
+<DIV><A href="#OpenIDAuthenticationHandler-CredentialsExtraction">Credentials Extraction</A> | <A href="#OpenIDAuthenticationHandler-Phase1%253AFormSubmission">Phase 1: Form Submission</A> | <A href="#OpenIDAuthenticationHandler-Configuration">Configuration</A> | <A href="#OpenIDAuthenticationHandler-AuthenticationHandlerimplementation">AuthenticationHandler implementation</A> | <A href="#OpenIDAuthenticationHandler-AuthenticationFeedbackHandlerimplementation">AuthenticationFeedbackHandler implementation</A> | <A href="#OpenIDAuthenticationHandler-IntegrationwithJackrabbit">Integration with Jackrabbit</A> | <A href="#OpenIDAuthenticationHandler-SecurityConsiderations">Security Considerations</A></DIV>
+
+<P>The OpenID Authentication Handler supports authentication of request users using the <A href="http://www.openid.net/" class="external-link" rel="nofollow">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 <TT>UserManager</TT> to find users by a user property value.</P>
+
+<P>The OpenID Authentication Handler is maintained in the <A href="http://svn.apache.org/repos/asf/sling/trunk/bundles/auth/openid/" class="external-link" rel="nofollow">Sling SVN</A></P>
+
+
+<H3><A name="OpenIDAuthenticationHandler-CredentialsExtraction"></A>Credentials Extraction</H3>
+
+<P>Theoretically each request with the <TT>openid_identifier</TT> request parameter set may initiate an OpenID authentication process which involves resolving the OpenID provider for the identifier and subsequently authentication with the provider authorizing the Sling instance to use the OpenID identity.</P>
+
+<P>This initiation, though, is not possible if the request already contains a valid and validated OpenID identifier either set as a request attribute or set in the HTTP Session or the OpenID cookie. In these situations, the current association of a client with an OpenID identity must first be removed by logging out, e.g. by requesting <TT>/system/sling/logout.html</TT> which causes the current OpenID user data to be removed by either removing it from the HTTP Session or by clearing the OpenID cookie.</P>
+
+
+<H3><A name="OpenIDAuthenticationHandler-Phase1%3AFormSubmission"></A>Phase 1: Form Submission</H3>
+
+<P>Requesting an OpenID identifier is initiated by the Sling Authenticator deciding, that authentication is actually required to process a request and the OpenID Authentication Handler being selected to request credentials with.</P>
+
+<P>In this case the OpenID authenticator causes a form to be rendered by redirecting the client to the URL indicated by the <TT>form.login.form</TT> configuration parameter. This redirection request may accompanied by the following parameters:</P>
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Request Parameter </TH>
+<TH class="confluenceTh"> Description </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>resource</TT> </TD>
+<TD class="confluenceTd"> The location to which the user initially requested access and that caused the <TT>requestCredentials</TT> method to be called. This may not be set (or be set to an empty string). </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>j_reason</TT> </TD>
+<TD class="confluenceTd"> The reason why an earlier attempt at authentication with the OpenID authentication handler failed. This request parameter is only set if the same named request attribute has been set by the <TT>extractCredentials</TT> or the <TT>authenticationFailed</TT> method. The value of the parameter is the name of one of the <TT>OpenIDFailure</TT> constants. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>j_openid_identity</TT> </TD>
+<TD class="confluenceTd"> The OpenID identity which could not successfully be associated with an existing JCR user. This request parameter is only set if the <TT>authenticationFailed</TT> method has been called due to inability to associate an existing and validated OpenID identity with an existing JCR user. </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+
+<P>The OpenID Authentication handlers supports the following request parameters submitted by the HTML form:</P>
+
+<UL>
+	<LI><TT>openid_identifier</TT> &ndash; OpenID Claimed Identifier. This may be any actual OpenID identity URL or the URL of OpenID Provider such as <A href="https://www.google.com/accounts/o8/id" class="external-link" rel="nofollow">https://www.google.com/accounts/o8/id</A>, <A href="https://me.yahoo.com/" class="external-link" rel="nofollow">https://me.yahoo.com</A>, or <A href="https://www.myopenid.com/" class="external-link" rel="nofollow">https://www.myopenid.com</A>.</LI>
+	<LI><TT>sling:authRequestLogin</TT> &ndash; This request parameter is recommended to be set with a hidden field to the value <EM>OpenID</EM> to ensure the request is handled by the OpenID Authentication Handler.</LI>
+	<LI><TT>resource</TT> &ndash; The <TT>resource</TT> request parameter should be sent back to ensure the user is finally redirected to requested target resource after successful authentication. If this request parameter is not set, or is set to an empty string, it is assumed to be the request context root path.</LI>
+</UL>
+
+
+<P>The OpenID Authentication Handler provides a default login form registered at <TT>/system/sling/openid/login</TT>.</P>
+
+
+<H3><A name="OpenIDAuthenticationHandler-Configuration"></A>Configuration</H3>
+
+<P>The OpenID AuthenticationHandler is configured with configuration provided by the OSGi Configuration Admin Service using the <TT>org.apache.sling.openidauth.OpenIdAuthenticationHandler</TT> service PID.</P>
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Parameter </TH>
+<TH class="confluenceTh"> Default </TH>
+<TH class="confluenceTh"> Description </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>path</TT> </TD>
+<TD class="confluenceTd"> &ndash; </TD>
+<TD class="confluenceTd"> Repository path for which this authentication handler should be used by Sling. If this is empty, the authentication handler will be disabled. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>openid.login.form</TT> </TD>
+<TD class="confluenceTd"> <TT>/system/sling/openid/login</TT> </TD>
+<TD class="confluenceTd"> This should provide a way to capture the user's OpenID identifier.  This is not the OpenID Provider's login page, however, it does not have to be a local URL. If it is a local Sling URL, it must be accessible by the anonymous user. The user is HTTP Redirect'ed to this URL.  This page should POST back the user's OpenID identifier (as named by the &quot;OpenID identifier form field&quot; property) to the originally requested URL set in the &quot;resource&quot; request parameter. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>openid.login.identifier</TT> </TD>
+<TD class="confluenceTd"> <TT>openid_identifier</TT> </TD>
+<TD class="confluenceTd"> The name of the form parameter that provides the user's OpenID identifier. By convention this is <TT>openid_identifier</TT>. Only change this if you have a very good reason to do so. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>openid.external.url.prefix</TT> </TD>
+<TD class="confluenceTd"> &ndash; </TD>
+<TD class="confluenceTd"> The prefix of URLs generated for the <TT>ReturnTo</TT> and <TT>TrustRoot</TT> properties of the OpenID request to the OpenID provider. Thus this URL prefix should bring back the authenticated user to this Sling instance. Configuring this property is usually necessary when running Sling behind a proxy (like Apache) since proxy mapping is not performed on the OpenID ReturnTo and TrustRoot URLs as they are sent to the OpenID Provider as form parameters.  If this property is empty, the URLs are generated using the hostname found in the original request.</TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>openid.use.cookie</TT> </TD>
+<TD class="confluenceTd"> <TT>true</TT> </TD>
+<TD class="confluenceTd">  Whether to use a regular Cookie or an HTTP Session to cache the OpenID authentication details. By default a regular cookie is used to prevent use of HTTP Sessions. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>openid.cookie.domain</TT> </TD>
+<TD class="confluenceTd"> &ndash; </TD>
+<TD class="confluenceTd"> Domain of cookie used to persist authentication. This defaults to the host name of the Sling server but may be set to a different value to share the cookie amongst a server farm or if the server is running behind a proxy. Only used if 'Use Cookie' is checked. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>openid.cookie.name</TT> </TD>
+<TD class="confluenceTd"> <TT>sling.openid</TT> </TD>
+<TD class="confluenceTd"> Name of cookie used to persist authentication. Only used if 'Use Cookie' is checked. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>openid.cookie.secret.key</TT> </TD>
+<TD class="confluenceTd"> <TT>secret</TT> </TD>
+<TD class="confluenceTd"> Secret key used to create a signature of the cookie value to prevent tampering. Only used if 'Use Cookie' is true. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>openid.user.attr</TT> </TD>
+<TD class="confluenceTd"> <TT>openid.user</TT> </TD>
+<TD class="confluenceTd"> Name of the JCR SimpleCredentials attribute to to set with the OpenID User data. This attribute is used by the OpenID LoginModule to validate the OpenID user authentication data. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>openid.property.identity</TT> </TD>
+<TD class="confluenceTd"> <TT>openid.identity</TT> </TD>
+<TD class="confluenceTd">  The name of the JCR User attribute listing one or more OpenID Identity URLs with which a user is associated. The property may be a multi- or single-valued. To resolve a JCR user ID from an OpenID identity a user is searched who lists the identity in this property. </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+
+
+
+<H3><A name="OpenIDAuthenticationHandler-AuthenticationHandlerimplementation"></A>AuthenticationHandler implementation</H3>
+
+
+<H4><A name="OpenIDAuthenticationHandler-extractCredentials"></A>extractCredentials</H4>
+
+<P>To extract authentication information from the request, the Sling OpenID Authentication handler considers the following information in order:</P>
+
+<OL>
+	<LI>The OpenID credentials cookie or OpenID User data in the HTTP Session (depending on the <TT>openid.use.cookie</TT> configuration)</LI>
+	<LI>Otherwise the <TT>openid_identifier</TT> request parameter (or a different request parameter depending on the <TT>openid.login.identifier</TT> configuration)</LI>
+</OL>
+
+
+<P>If the OpenID credentials already exist in the request, they are validated and returned if valid</P>
+
+<P>If the existing credentials fail to validate, authentication failure is assumed and the credentials are removed from the request, either by clearing the OpenID cookie or by removing the OpenID User data from the HTTP Session.</P>
+
+<P>If no OpenID credentials are found in the request, the request parameter is considered and if set is used to resolve the actual OpenID identity of the user. This involves redirecting the client to the OpenID provider resolved from the OpenID identifier supplied.</P>
+
+<P>If the supplied OpenID identifier fails to resolve to an OpenID provider or if the identifier fails to be resolved to a validated OpenID identity, authentication fails.</P>
+
+
+<H4><A name="OpenIDAuthenticationHandler-requestCredentials"></A>requestCredentials</H4>
+
+<P>If the <TT>sling:authRequestLogin</TT> parameter is set to a value other than <TT>OpenID</TT> this method immediately returns <TT>false</TT>.</P>
+
+<P>If the parameter is not set or is set to <TT>OpenID</TT> this method continues with first invalidating any cached OpenID credentials (same as <TT>dropCredentials</TT> does) and then redirecting the client to the login form configured with the <TT>openid.login.form</TT> configuration property. The redirect is provided with up to three request parameters:</P>
+
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Request Parameter </TH>
+<TH class="confluenceTh"> Description </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>resource</TT> </TD>
+<TD class="confluenceTd"> The location to which the user initially requested access and that caused the <TT>requestCredentials</TT> method to be called. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>j_reason</TT> </TD>
+<TD class="confluenceTd"> The reason why an earlier attempt at authentication with the OpenID authentication handler failed. This request parameter is only set if the same named request attribute has been set by the <TT>extractCredentials</TT> or the <TT>authenticationFailed</TT> method. The value of the parameter is the name of one of the <TT>OpenIDFailure</TT> constants. </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> <TT>j_openid_identity</TT> </TD>
+<TD class="confluenceTd"> The OpenID identity which could not successfully be associated with an existing JCR user. This request parameter is only set if the <TT>authenticationFailed</TT> method has been called due to inability to associate an existing and validated OpenID identity with an existing JCR user. </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+
+
+
+<H4><A name="OpenIDAuthenticationHandler-dropCredentials"></A>dropCredentials</H4>
+
+<P>Invalidates the OpenID identity currently stored with the request. This means to either remove the OpenID cookie or to remove the OpenID information from the HTTP Session. This method does not write to the response (except setting the <TT>Set-Cookie</TT> header to remove the OpenID cookie if required) and does not commit the response.</P>
+
+
+<H3><A name="OpenIDAuthenticationHandler-AuthenticationFeedbackHandlerimplementation"></A>AuthenticationFeedbackHandler implementation</H3>
+
+<H4><A name="OpenIDAuthenticationHandler-authenticationFailed"></A>authenticationFailed</H4>
+
+<P>This method is called, if the Credentials provided by the Authentication Handler could not be validated by the Jackrabbit authentication infrastructure. One cause may be that the integration with Jackrabbit has not been completed (see <EM>Integration with Jackrabbit</EM> below). Another, more probably cause, is that the validated OpenID identifier cannot be associated with an existing JCR user.</P>
+
+<P>The OpenID Authentication Handler implementation of the <TT>authenticationFailed</TT> method sets the <TT>j_reason</TT> request attribute to <TT>OpenIDFailure.REPOSITORY</TT> and sets the <TT>j_openid_identity</TT> request attribute to the OpenID identity of the authenticated user.</P>
+
+<P>A login form provider may wish to act upon this situation and provide a login form to the user to allow to his OpenID identity with an existing JCR user.</P>
+
+<P>In addition, the current OpenID identity is invalidated thus the cached OpenID information is removed from the HTTP Session or the OpenID cookie is cleaned. This will allow the user to present a different OpenID identifier to retry or it will require the OpenID identity to be revalidated with the OpenID provider if the identity is associated with a JCR user.</P>
+
+<H4><A name="OpenIDAuthenticationHandler-authenticationSucceeded"></A>authenticationSucceeded</H4>
+
+<P>The OpenID Authentication Handler implementation of the <TT>authenticationSucceeded</TT> method just calls the <TT>DefaultAuthenticationFeedbackHandler.handleRedirect</TT> method to redirect the user to the initially requested location.</P>
+
+
+<H3><A name="OpenIDAuthenticationHandler-IntegrationwithJackrabbit"></A>Integration with Jackrabbit</H3>
+
+<P>The OpenID authentication handler can be integrated in two ways into the Jackrabbit authentication mechanism which is based on JAAS <TT>LoginModule</TT>. One integration is by means of a <TT>LoginModulePlugin</TT> which plugs into the extensible <TT>LoginModule</TT> architecture supported by the Sling Jackrabbit Embedded Repository bundle.</P>
+
+<P>The other integration option is the <TT>trusted_credentials_attribute</TT> mechanism supported by the Jackrabbit <TT>DefaultLoginModule</TT>. By setting the <TT>trusted_credentials_attribute</TT> parameter of the Jackrabbit <TT>DefaultLoginModule</TT> and the <TT>openid.user.attr</TT> configuration property of the OpenID Authentication Handler to the same value, the existence of an attribute of that name in the <TT>SimpleCredentials</TT> instance provided to the <TT>Repository.login</TT> method signals pre-authenticated credentials, which need not be further checked by the <TT>DefaultLoginModule</TT>.</P>
+
+
+<H3><A name="OpenIDAuthenticationHandler-SecurityConsiderations"></A>Security Considerations</H3>
+
+<P>OpenIDAuthentication has some limitations in terms of security:</P>
+
+<OL>
+	<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>
+	<LI>When using the <TT>trusted_credentials_attribute</TT> 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 <TT>LoginModulePlugin</TT> 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>
+        <DIV class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
+Last modified by fmeschbe on 2011-05-25 10:06:09.0
+        </DIV>
+        <DIV class="trademarkFooter">
+Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+        </DIV>
+    </DIV>
+  </BODY>
+</HTML>
+

Added: websites/staging/sling/trunk/content/site/osgi-installer.data/Slide14.jpg
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/sling/trunk/content/site/osgi-installer.data/Slide14.jpg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Added: websites/staging/sling/trunk/content/site/osgi-installer.data/Slide14.jpg.jpeg
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/sling/trunk/content/site/osgi-installer.data/Slide14.jpg.jpeg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Added: websites/staging/sling/trunk/content/site/osgi-installer.data/Slide14.png
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/sling/trunk/content/site/osgi-installer.data/Slide14.png
------------------------------------------------------------------------------
    svn:mime-type = image/png

Added: websites/staging/sling/trunk/content/site/osgi-installer.data/Slide14.png.jpeg
==============================================================================
Binary file - no diff available.

Propchange: websites/staging/sling/trunk/content/site/osgi-installer.data/Slide14.png.jpeg
------------------------------------------------------------------------------
    svn:mime-type = image/jpeg

Added: websites/staging/sling/trunk/content/site/osgi-installer.html
==============================================================================
--- websites/staging/sling/trunk/content/site/osgi-installer.html (added)
+++ websites/staging/sling/trunk/content/site/osgi-installer.html Wed Dec 12 09:16:44 2012
@@ -0,0 +1,111 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Apache Sling - OSGi Installer</TITLE>
+    <LINK rel="stylesheet" href="http://sling.apache.org/site/media.data/site.css" type="text/css" media="all">
+    <LINK rel="icon" href="http://sling.apache.org/site/media.data/favicon.ico">
+    <META http-equiv="Content-Type" content="text/html;charset=UTF-8">
+  </HEAD>
+  <BODY>
+    <DIV class="title">
+      <DIV class="logo">
+        <A href="http://sling.apache.org/site/index.html">
+          <IMG border="0" alt="Apache Sling" src="http://sling.apache.org/site/media.data/logo.png">
+        </A>
+      </DIV>
+      <DIV class="header">
+        <A href="http://www.apache.org/">
+          <IMG border="0" alt="Apache" src="http://sling.apache.org/site/media.data/apache.png">
+        </A>
+      </DIV>
+    </DIV>
+    <DIV class="menu">
+<P><B>Documentation</B><BR class="atl-forced-newline">
+<A href="getting-started.html" title="Getting Started">Getting Started</A><BR class="atl-forced-newline">
+<A href="the-sling-engine.html" title="The Sling Engine">The Sling Engine</A><BR class="atl-forced-newline">
+<A href="development.html" title="Development">Development</A><BR class="atl-forced-newline">
+<A href="bundles.html" title="Bundles">Bundles</A><BR class="atl-forced-newline">
+<A href="tutorials-how-tos.html" title="Tutorials & How-Tos">Tutorials &amp; How&#45;Tos</A><BR class="atl-forced-newline">
+<A href="configuration.html" title="Configuration">Configuration</A><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/apidocs/sling6/index.html" class="external-link" rel="nofollow">API docs</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.wiki" class="external-link" rel="nofollow">Wiki</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.faq" class="external-link" rel="nofollow">FAQ</A><BR class="atl-forced-newline"></P>
+
+<P><B>Project info</B><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/site/downloads.cgi" class="external-link" rel="nofollow">Downloads</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</A><BR class="atl-forced-newline">
+<A href="contributing.html" title="Contributing">Contributing</A><BR class="atl-forced-newline">
+<A href="news.html" title="News">News</A><BR class="atl-forced-newline">
+<A href="links.html" title="Links">Links</A><BR class="atl-forced-newline">
+<A href="project-information.html" title="Project Information">Project Information</A><BR class="atl-forced-newline">
+<A href="https://issues.apache.org/jira/browse/SLING" class="external-link" rel="nofollow">Issue Tracker</A><BR class="atl-forced-newline">
+<A href="http://svn.apache.org/viewvc/sling/trunk" class="external-link" rel="nofollow">Browse Source Repository</A><BR class="atl-forced-newline">
+<A href="security.html" title="Security">Security</A><BR class="atl-forced-newline"></P>
+
+<P><B>Sponsorship</B><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/sponsorship.html" class="external-link" rel="nofollow">Become a Sponsor</A><BR>
+<A href="http://www.apache.org/foundation/buy_stuff.html" class="external-link" rel="nofollow">Buy Stuff</A></P>
+
+
+  <IFRAME src="http://www.apache.org/ads/button.html" style="border-width:0; float: left" frameborder="0" scrolling="no" width="135" height="135"></IFRAME>
+  <P style="height: 135px"></P>
+    </DIV>
+    <DIV class="main">
+        <DIV class="breadcrump" style="font-size: 80%;">
+<A href="apache-sling.html" title="Apache Sling Website">Apache Sling Website</A>&nbsp;&gt;&nbsp;<A href="apache-sling.html" title="Apache Sling">Apache Sling</A>&nbsp;&gt;&nbsp;<A href="documentation.html" title="Documentation">Documentation</A>&nbsp;&gt;&nbsp;<A href="bundles.html" title="Bundles">Bundles</A>&nbsp;&gt;&nbsp;<A href="" title="OSGi Installer">OSGi Installer</A>
+        </DIV>
+<H1><A name="OSGiInstaller-Overview"></A>Overview</H1>
+
+<P>The OSGi installer is a central service for handling installs, updates and uninstall of &quot;artifacts&quot;. By default, the installer supports bundles and has an extension for handling configurations for the OSGi configuration admin.</P>
+
+<P><SPAN class="image-wrap" style=""><IMG src="osgi-installer.data/Slide14.jpg" style="border: 1px solid black"></SPAN></P>
+
+<P>The OSGi installer itself is &quot;just&quot; the central service managing the tasks and states of the artifacts. The artifacts can be provided through various providers, e.g. through a file system provider reading artifacts from configured directories or the jcr provider reading artifacts from a JCR repository.</P>
+
+<P>A provider is just scanning for artifacts and their removal. It informs the OSGi installer about new artifacts and removed artifacts. The provider itself has usually no knowledge about the contents of an artifact. It does not know about bundles, configurations etc.</P>
+
+<P>As the OSGi installer itself is not performing the actual install, update or removal of an artifact, its possible to install transformers and installer factories. A transformer inspects the artifacts and tries to detect its type. By default, detecting of bundles and configurations is supported. The final service is an installer factory creating the actual task, like install this bundle, update that bundle etc.</P>
+
+<P>It's possible to add own providers, transformers and installer factories to support custom scenarios.</P>
+
+<H2><A name="OSGiInstaller-ArtifactHandling"></A>Artifact Handling</H2>
+
+<P>Once an artifact is detected by a transformer, it gets a unique id. By default a bundle gets the symbolic name as the unique identifier and a configuration the PID.<BR>
+In addition to this id, an artifact gets a priority information from the provider. The priority is used if an artifact with the same id is provided several times from different locations. For example if a file system provider is scanning two directories and an artifact with the same id (like a configuration) is added to both directories, one should have precedence over the other. This is handled by the priority.</P>
+
+<P>Artifacts with the same unique id are grouped and then sorted by priority and maybe other artifact dependent metadata like the bundle version. Only the first artifact in this sorted group is tried to be applied!</P>
+
+<H2><A name="OSGiInstaller-BundleHandling"></A>Bundle Handling</H2>
+
+<P>In general, the OSGi installer always tries to install the highest version of a bundle if several bundles with the same symbolic name are provided. In this case higher version wins over priority.<BR>
+If an installed bundle is removed by a provider, for example deleted in the repository, the OSGi installer uninstall the bundle.<BR>
+If a bundle is removed from a provider which is currently not installed, this has no effect at all.<BR>
+If an installed bundle is removed and another version of this bundle is provided (a lower version), than this one is installed instead. This is basically a downgrade of the bundle.<BR>
+If a bundle is installed and a higher version is provided, an upgrade is performed.<BR>
+If an installed bundle is managed via any other OSGi tooling, like uninstalling it through the web console, the OSGi installer does no action at all!</P>
+
+<P>If a failure occurs during bundle installation or update, the OSGi installer will retry this as soon as another bundle has been installed. The common use case is an application installation with several bundles where one bundle depends on another. As they are installed in arbitrary order, this mechanism ensures that in the end all bundles are properly wired and installed.</P>
+
+<P>When all artifacts have been processed (either install, update or delete), a package refresh is automatically called.</P>
+
+<H3><A name="OSGiInstaller-VersionsandSnapshots"></A>Versions and Snapshots</H3>
+
+<P>The OSGi installer asumes that a symbolic name and version (not a snapshot version) uniquely identifies a bundle. Obviously this is a common development requirement that a released version of an artifact never changes over time. Therefore, once a bundle with a specific version is installed, it will not be reinstalled if the corresponding artifact changes. For example, if  bundle A with version 1.0 is put into the JCR repository, it gets installed. If now this jar in the repository is overwritten either with the same contents or with a different one, and this new artifact has again A as the symbolic name and version set to 1.0, nothing will happen as this exact bundle is already installed.</P>
+
+<P>During development, SNAPSHOT versions should be used, like 1.0.0-SNAPSHOT (using the Maven convention). If a bundle with a snapshot version is changed, it gets updated by the OSGI installer.</P>
+
+<H2><A name="OSGiInstaller-ConfigurationHandling"></A>Configuration Handling</H2>
+
+<P>In general the OSGi installer installs the configuration with the highes priority. For example in combination with the JCR installer provider, a configuration from <EM>/apps</EM> is preferred over a configuration for the same service from <EM>/libs</EM>.</P>
+        <DIV class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
+Last modified by cziegeler@apache.org on 2011-10-11 07:59:17.0
+        </DIV>
+        <DIV class="trademarkFooter">
+Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+        </DIV>
+    </DIV>
+  </BODY>
+</HTML>
+

Added: websites/staging/sling/trunk/content/site/output-rewriting-pipelines-orgapacheslingrewriter.html
==============================================================================
--- websites/staging/sling/trunk/content/site/output-rewriting-pipelines-orgapacheslingrewriter.html (added)
+++ websites/staging/sling/trunk/content/site/output-rewriting-pipelines-orgapacheslingrewriter.html Wed Dec 12 09:16:44 2012
@@ -0,0 +1,166 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Apache Sling - Output Rewriting Pipelines (org.apache.sling.rewriter)</TITLE>
+    <LINK rel="stylesheet" href="http://sling.apache.org/site/media.data/site.css" type="text/css" media="all">
+    <LINK rel="icon" href="http://sling.apache.org/site/media.data/favicon.ico">
+    <META http-equiv="Content-Type" content="text/html;charset=UTF-8">
+  </HEAD>
+  <BODY>
+    <DIV class="title">
+      <DIV class="logo">
+        <A href="http://sling.apache.org/site/index.html">
+          <IMG border="0" alt="Apache Sling" src="http://sling.apache.org/site/media.data/logo.png">
+        </A>
+      </DIV>
+      <DIV class="header">
+        <A href="http://www.apache.org/">
+          <IMG border="0" alt="Apache" src="http://sling.apache.org/site/media.data/apache.png">
+        </A>
+      </DIV>
+    </DIV>
+    <DIV class="menu">
+<P><B>Documentation</B><BR class="atl-forced-newline">
+<A href="getting-started.html" title="Getting Started">Getting Started</A><BR class="atl-forced-newline">
+<A href="the-sling-engine.html" title="The Sling Engine">The Sling Engine</A><BR class="atl-forced-newline">
+<A href="development.html" title="Development">Development</A><BR class="atl-forced-newline">
+<A href="bundles.html" title="Bundles">Bundles</A><BR class="atl-forced-newline">
+<A href="tutorials-how-tos.html" title="Tutorials & How-Tos">Tutorials &amp; How&#45;Tos</A><BR class="atl-forced-newline">
+<A href="configuration.html" title="Configuration">Configuration</A><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/apidocs/sling6/index.html" class="external-link" rel="nofollow">API docs</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.wiki" class="external-link" rel="nofollow">Wiki</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.faq" class="external-link" rel="nofollow">FAQ</A><BR class="atl-forced-newline"></P>
+
+<P><B>Project info</B><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/site/downloads.cgi" class="external-link" rel="nofollow">Downloads</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</A><BR class="atl-forced-newline">
+<A href="contributing.html" title="Contributing">Contributing</A><BR class="atl-forced-newline">
+<A href="news.html" title="News">News</A><BR class="atl-forced-newline">
+<A href="links.html" title="Links">Links</A><BR class="atl-forced-newline">
+<A href="project-information.html" title="Project Information">Project Information</A><BR class="atl-forced-newline">
+<A href="https://issues.apache.org/jira/browse/SLING" class="external-link" rel="nofollow">Issue Tracker</A><BR class="atl-forced-newline">
+<A href="http://svn.apache.org/viewvc/sling/trunk" class="external-link" rel="nofollow">Browse Source Repository</A><BR class="atl-forced-newline">
+<A href="security.html" title="Security">Security</A><BR class="atl-forced-newline"></P>
+
+<P><B>Sponsorship</B><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/sponsorship.html" class="external-link" rel="nofollow">Become a Sponsor</A><BR>
+<A href="http://www.apache.org/foundation/buy_stuff.html" class="external-link" rel="nofollow">Buy Stuff</A></P>
+
+
+  <IFRAME src="http://www.apache.org/ads/button.html" style="border-width:0; float: left" frameborder="0" scrolling="no" width="135" height="135"></IFRAME>
+  <P style="height: 135px"></P>
+    </DIV>
+    <DIV class="main">
+        <DIV class="breadcrump" style="font-size: 80%;">
+<A href="apache-sling.html" title="Apache Sling Website">Apache Sling Website</A>&nbsp;&gt;&nbsp;<A href="apache-sling.html" title="Apache Sling">Apache Sling</A>&nbsp;&gt;&nbsp;<A href="documentation.html" title="Documentation">Documentation</A>&nbsp;&gt;&nbsp;<A href="bundles.html" title="Bundles">Bundles</A>&nbsp;&gt;&nbsp;<A href="" title="Output Rewriting Pipelines (org.apache.sling.rewriter)">Output Rewriting Pipelines (org.apache.sling.rewriter)</A>
+        </DIV>
+<H1><A name="OutputRewritingPipelines%28org.apache.sling.rewriter%29-ApacheSlingRewriter"></A>Apache Sling Rewriter</H1>
+
+<P>The Apache Sling Rewriter is a module for rewriting the output generated by a usual Sling rendering process. Some possible use cases include rewriting or checking all links in an html page, manipulating the html page, or using the generated output as the base for further transformation. An example of futher transformation is to use XSLT to transform rendered XML to some output format like HTML or XSL:FO for generating PDF.</P>
+
+<P>For supporting these use cases, the rewriter uses the concept for a processor. The processor is a component that is injected through a servlet filter into the response. By implementing the <EM>Processor</EM> interface one is able to rewrite the whole response in one go. A more convenient way of processing the output is by using a so called pipeline; the Apache Sling rewriter basically uses the same concept as the famous Apache Cocoon: an XML based pipeline for further post processing of the output. The pipeline is based on SAX events.</P>
+
+<H2><A name="OutputRewritingPipelines%28org.apache.sling.rewriter%29-SAXPipelines"></A>SAX Pipelines</H2>
+<P>The rewriter allows to configure a pipeline for post processing of the generated response. Depending on how the pipeline is assembled the rewriting process might buffer the whole output in order to do proper post processing - for example this is required if an HTML response is &quot;transformed&quot; to XHTML or if XSLT is used to process the response.</P>
+
+<P>As the pipeline is based on SAX events, there needs to be a component that generates these events and sends them through the pipeline. By default the Sling rendering scripts write to an output stream, so there is a need to parse this output and generate the SAX events.</P>
+
+<P>The first component in the pipeline generating the initial SAX events is called a generator. The generator gets the output from Sling, generates SAX events (XML), and streams these events into the pipeline. The counterpart of the generator is the serializer which builds the end of the pipeline. The serializer collects all incomming SAX events, transforms them into the required response by writing into output stream of the response.</P>
+
+<P>Between the generator and the serializer so called transformers can be placed in a chain. A transformer receives SAX events from the previous component in the pipeline and sends SAX events to the next component in the pipeline. A transformer can remove events, change events, add events or just pass on the events.</P>
+
+<P>Sling contains a default pipeline which is executed for all html responses: it starts with an html generator, parsing the html output and sending events into the pipeline. A html serializer collects all events and serializes the output. </P>
+
+<P>The pipelines can be configured in the repository as a child node of <EM>/apps/APPNAME/config/rewriter</EM> (or <EM>/libs/APPNAME/config/rewriter</EM>). (In fact the configured search paths of the resource resolver are observed.) Each node can have the following properties:</P>
+<UL>
+	<LI>generatorType - the type of the generator (required)</LI>
+	<LI>transformerTypes (multi value string) - the types of the transformers (optional)</LI>
+	<LI>serializerType - the type of the serializer (required)</LI>
+	<LI>paths (multi value string) - the paths this pipeline should run on (content paths)</LI>
+	<LI>contentTypes (multi value string) - the content types this pipeline should be used for (optional)</LI>
+	<LI>extensions (multi value string) - the extensions this pipeline should be used for (optional)</LI>
+	<LI>resourceTypes (multi value string) - the resource types this pipeline should be used for (optional)</LI>
+	<LI>order (long) - the configurations are sorted by this order, order must be higher or equal to 0. The configuration with the highest order is tried first.</LI>
+	<LI>enabled (boolean) - Is this configuration active? (default yes)</LI>
+</UL>
+
+
+<P>As you can see from the configuration there are several possibilities to define when a pipeline should be used for a response, like paths, extensions, content types, or resource types. It is possible to specify several of them at once. In this case all conditions must be met.</P>
+
+<P>If a component needs a configuration, the configuration is stored in a child node which name is <EM>{componentType}&#45;{name}</EM>, e.g. to configure the html generator (named <EM>html&#45;generator</EM>), the node should have the name <EM>generator-html-generator</EM>. In the case that the pipeline contains the same transformer several times, the configuration child node should have the formant <EM>{componentType}-{index}</EM> where index is the index of the transformer starting with 1. For example if you have a pipeline with the following transformers, xslt, html-cleaner, xslt, link-checker, then the configuration nodes should be named <EM>transformer-1</EM> (for the first xslt), <EM>transformer-html-cleaner</EM>, <EM>transformer-3</EM> (for the second xslt), and <EM>transformer-link-checker</EM>.</P>
+
+
+<H3><A name="OutputRewritingPipelines%28org.apache.sling.rewriter%29-DefaultPipeline"></A>Default Pipeline</H3>
+
+<P>The default pipeline is configured for the <EM>text/html</EM> mime type and the <EM>html</EM> extensions and consists of the <EM>html-generator</EM> as the generator, and the <EM>html-serializer</EM> for generating the final response.<BR>
+As the html generated by Sling is not required to be valid XHTML, the html parser is using an HTML parser to create valid SAX events. In order to perform this, the generator needs to buffer the whole response first.</P>
+
+<H2><A name="OutputRewritingPipelines%28org.apache.sling.rewriter%29-ImplementingPipelineComponents"></A>Implementing Pipeline Components</H2>
+
+<P>Each pipeline component type has a corresponding Java interface (Generator, Transformer, and Serializer) together with a factory interface (GeneratorFactory, TransformerFactory, and SerializerFactory). When implementing such a component, both interfaces need to be implemented. The factory has only one method which creates a new instance of that type for the current request. The factory has to be registered as a service. For example if you're using the Maven SCR plugin, it looks like this:</P>
+
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+@scr.component metatype=<SPAN class="code-quote">&quot;no&quot;</SPAN> 
+@scr.service <SPAN class="code-keyword">interface</SPAN>=<SPAN class="code-quote">&quot;TransformerFactory&quot;</SPAN>
+@scr.property value=<SPAN class="code-quote">&quot;pipeline.type&quot;</SPAN> value=<SPAN class="code-quote">&quot;validator&quot;</SPAN>
+</PRE>
+</DIV></DIV>
+
+<P>The factory needs to implement the according interface and should be registered as a service for this factory interface (this is a plain service and not a factory service in the OSGi sense). Each factory gets a unique name through the <EM>pipeline.type</EM> property. The pipeline configuration in the repository just references this unique name (like validator).</P>
+
+<H2><A name="OutputRewritingPipelines%28org.apache.sling.rewriter%29-ExtendingthePipeline"></A>Extending the Pipeline</H2>
+<P>With the possibilities from above, it is possible to define new pipelines and add custom components to the pipeline. However, in some cases it is required to just add a custom transformer to the existing pipeline. Therefore the rewriting can be configured with pre and post transformers that are simply added to each configured pipeline. This allows a more flexible way of customizing the pipeline without changing/adding a configuration in the repository.</P>
+
+<P>The approach here is nearly the same. A transformer factory needs to be implemented, but instead of giving this factory a unique name, this factory is marked as a global factory:</P>
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+@scr.component metatype=<SPAN class="code-quote">&quot;no&quot;</SPAN>
+@scr.service <SPAN class="code-keyword">interface</SPAN>=<SPAN class="code-quote">&quot;TransformerFactory&quot;</SPAN>
+@scr.property name=<SPAN class="code-quote">&quot;pipeline.mode&quot;</SPAN> value=<SPAN class="code-quote">&quot;global&quot;</SPAN>
+@scr.property name=<SPAN class="code-quote">&quot;service.ranking&quot;</SPAN> value=<SPAN class="code-quote">&quot;RANKING&quot;</SPAN> type=<SPAN class="code-quote">&quot;<SPAN class="code-object">Integer</SPAN>&quot;</SPAN>
+</PRE>
+</DIV></DIV>
+<P><EM>RANKING</EM> is an integer value (don't forget the type attribute otherwise the ranking is interpreted as zero!) specifying where to add the transformer in the pipeline. If the value is less than zero the transformer is added at the beginning of the pipeline right after the generator. If the ranking is equal or higher as zero, the transformer is added at the end of the pipeline before the serializer.</P>
+
+<P>The <EM>TransformerFactory</EM> interface has just one method which returns a new transformer instance. If you plan to use other services in your transformer you might declare the references on the factory and pass in the instances into the newly created transformer.</P>
+
+
+<H2><A name="OutputRewritingPipelines%28org.apache.sling.rewriter%29-ImplementingaProcessor"></A>Implementing a Processor</H2>
+<P>A processor must conform to the Java interface <EM>org.apache.sling.rewriter.Processor</EM>. It gets initializd (method <EM>init</EM>) with the <EM>ProcessingContext</EM>. This context contains all necessary information for the current request (especially the output writer to write the rewritten content to).<BR>
+The <EM>getWriter</EM> method should return a writer where the output is written to. When the output is written or an error occured <EM>finished</EM> is called.</P>
+
+<P>Like the pipeline components a processor is generated by a factory which has to be registered as a service factory, like this:</P>
+<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
+<PRE class="code-java">
+@scr.component metatype=<SPAN class="code-quote">&quot;no&quot;</SPAN> 
+@scr.service <SPAN class="code-keyword">interface</SPAN>=<SPAN class="code-quote">&quot;ProcessorFactory&quot;</SPAN>
+@scr.property value=<SPAN class="code-quote">&quot;pipeline.type&quot;</SPAN> value=<SPAN class="code-quote">&quot;uniqueName&quot;</SPAN>
+</PRE>
+</DIV></DIV>
+
+<H2><A name="OutputRewritingPipelines%28org.apache.sling.rewriter%29-ConfiguringaProcessor"></A>Configuring a Processor</H2>
+<P>The processors can be configured in the repository as a child node of <EM>/apps/APPNAME/config/rewriter</EM> (or libs or any configured search path). Each node can have the following properties:</P>
+<UL>
+	<LI>processorType - the type of the processor (required) - this is the part from the scr factory information after the slash (in the example above this is <EM>uniqueName</EM>)</LI>
+	<LI>paths (multi value string) - the paths this processor should run on (content paths)</LI>
+	<LI>contentTypes (multi value string) - the content types this processor should be used for (optional)</LI>
+	<LI>extensions (multi value string) - the extensions this pipeline should be used for (optional)</LI>
+	<LI>resourceTypes (multi value string) - the resource types this pipeline should be used for (optional)</LI>
+	<LI>order (long) - the configurations are sorted by this order, order must be higher or equal to 0. The configuration with the highest order is tried first.</LI>
+	<LI>enabled (boolean) - Is this configuration active? (default yes)</LI>
+</UL>
+
+
+        <DIV class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
+Last modified by cziegeler@apache.org on 2009-09-15 23:06:52.0
+        </DIV>
+        <DIV class="trademarkFooter">
+Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+        </DIV>
+    </DIV>
+  </BODY>
+</HTML>
+

Added: websites/staging/sling/trunk/content/site/plugins.html
==============================================================================
--- websites/staging/sling/trunk/content/site/plugins.html (added)
+++ websites/staging/sling/trunk/content/site/plugins.html Wed Dec 12 09:16:44 2012
@@ -0,0 +1,71 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Apache Sling - Plugins</TITLE>
+    <LINK rel="stylesheet" href="http://sling.apache.org/site/media.data/site.css" type="text/css" media="all">
+    <LINK rel="icon" href="http://sling.apache.org/site/media.data/favicon.ico">
+    <META http-equiv="Content-Type" content="text/html;charset=UTF-8">
+  </HEAD>
+  <BODY>
+    <DIV class="title">
+      <DIV class="logo">
+        <A href="http://sling.apache.org/site/index.html">
+          <IMG border="0" alt="Apache Sling" src="http://sling.apache.org/site/media.data/logo.png">
+        </A>
+      </DIV>
+      <DIV class="header">
+        <A href="http://www.apache.org/">
+          <IMG border="0" alt="Apache" src="http://sling.apache.org/site/media.data/apache.png">
+        </A>
+      </DIV>
+    </DIV>
+    <DIV class="menu">
+<P><B>Documentation</B><BR class="atl-forced-newline">
+<A href="getting-started.html" title="Getting Started">Getting Started</A><BR class="atl-forced-newline">
+<A href="the-sling-engine.html" title="The Sling Engine">The Sling Engine</A><BR class="atl-forced-newline">
+<A href="development.html" title="Development">Development</A><BR class="atl-forced-newline">
+<A href="bundles.html" title="Bundles">Bundles</A><BR class="atl-forced-newline">
+<A href="tutorials-how-tos.html" title="Tutorials & How-Tos">Tutorials &amp; How&#45;Tos</A><BR class="atl-forced-newline">
+<A href="configuration.html" title="Configuration">Configuration</A><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/apidocs/sling6/index.html" class="external-link" rel="nofollow">API docs</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.wiki" class="external-link" rel="nofollow">Wiki</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.faq" class="external-link" rel="nofollow">FAQ</A><BR class="atl-forced-newline"></P>
+
+<P><B>Project info</B><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/site/downloads.cgi" class="external-link" rel="nofollow">Downloads</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</A><BR class="atl-forced-newline">
+<A href="contributing.html" title="Contributing">Contributing</A><BR class="atl-forced-newline">
+<A href="news.html" title="News">News</A><BR class="atl-forced-newline">
+<A href="links.html" title="Links">Links</A><BR class="atl-forced-newline">
+<A href="project-information.html" title="Project Information">Project Information</A><BR class="atl-forced-newline">
+<A href="https://issues.apache.org/jira/browse/SLING" class="external-link" rel="nofollow">Issue Tracker</A><BR class="atl-forced-newline">
+<A href="http://svn.apache.org/viewvc/sling/trunk" class="external-link" rel="nofollow">Browse Source Repository</A><BR class="atl-forced-newline">
+<A href="security.html" title="Security">Security</A><BR class="atl-forced-newline"></P>
+
+<P><B>Sponsorship</B><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/sponsorship.html" class="external-link" rel="nofollow">Become a Sponsor</A><BR>
+<A href="http://www.apache.org/foundation/buy_stuff.html" class="external-link" rel="nofollow">Buy Stuff</A></P>
+
+
+  <IFRAME src="http://www.apache.org/ads/button.html" style="border-width:0; float: left" frameborder="0" scrolling="no" width="135" height="135"></IFRAME>
+  <P style="height: 135px"></P>
+    </DIV>
+    <DIV class="main">
+        <DIV class="breadcrump" style="font-size: 80%;">
+<A href="apache-sling.html" title="Apache Sling Website">Apache Sling Website</A>&nbsp;&gt;&nbsp;<A href="apache-sling.html" title="Apache Sling">Apache Sling</A>&nbsp;&gt;&nbsp;<A href="" title="Plugins">Plugins</A>
+        </DIV>
+<P>These pages present the various Maven Plugins of Sling:</P>
+
+
+        <DIV class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
+Last modified by fmeschbe on 2008-02-11 05:47:17.0
+        </DIV>
+        <DIV class="trademarkFooter">
+Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+        </DIV>
+    </DIV>
+  </BODY>
+</HTML>
+

Added: websites/staging/sling/trunk/content/site/project-information.html
==============================================================================
--- websites/staging/sling/trunk/content/site/project-information.html (added)
+++ websites/staging/sling/trunk/content/site/project-information.html Wed Dec 12 09:16:44 2012
@@ -0,0 +1,202 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<HTML>
+  <HEAD>
+    <TITLE>Apache Sling - Project Information</TITLE>
+    <LINK rel="stylesheet" href="http://sling.apache.org/site/media.data/site.css" type="text/css" media="all">
+    <LINK rel="icon" href="http://sling.apache.org/site/media.data/favicon.ico">
+    <META http-equiv="Content-Type" content="text/html;charset=UTF-8">
+  </HEAD>
+  <BODY>
+    <DIV class="title">
+      <DIV class="logo">
+        <A href="http://sling.apache.org/site/index.html">
+          <IMG border="0" alt="Apache Sling" src="http://sling.apache.org/site/media.data/logo.png">
+        </A>
+      </DIV>
+      <DIV class="header">
+        <A href="http://www.apache.org/">
+          <IMG border="0" alt="Apache" src="http://sling.apache.org/site/media.data/apache.png">
+        </A>
+      </DIV>
+    </DIV>
+    <DIV class="menu">
+<P><B>Documentation</B><BR class="atl-forced-newline">
+<A href="getting-started.html" title="Getting Started">Getting Started</A><BR class="atl-forced-newline">
+<A href="the-sling-engine.html" title="The Sling Engine">The Sling Engine</A><BR class="atl-forced-newline">
+<A href="development.html" title="Development">Development</A><BR class="atl-forced-newline">
+<A href="bundles.html" title="Bundles">Bundles</A><BR class="atl-forced-newline">
+<A href="tutorials-how-tos.html" title="Tutorials & How-Tos">Tutorials &amp; How&#45;Tos</A><BR class="atl-forced-newline">
+<A href="configuration.html" title="Configuration">Configuration</A><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/apidocs/sling6/index.html" class="external-link" rel="nofollow">API docs</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.wiki" class="external-link" rel="nofollow">Wiki</A><BR class="atl-forced-newline">
+<A href="http://s.apache.org/sling.faq" class="external-link" rel="nofollow">FAQ</A><BR class="atl-forced-newline"></P>
+
+<P><B>Project info</B><BR class="atl-forced-newline">
+<A href="http://sling.apache.org/site/downloads.cgi" class="external-link" rel="nofollow">Downloads</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/licenses/" class="external-link" rel="nofollow">License</A><BR class="atl-forced-newline">
+<A href="contributing.html" title="Contributing">Contributing</A><BR class="atl-forced-newline">
+<A href="news.html" title="News">News</A><BR class="atl-forced-newline">
+<A href="links.html" title="Links">Links</A><BR class="atl-forced-newline">
+<A href="" title="Project Information">Project Information</A><BR class="atl-forced-newline">
+<A href="https://issues.apache.org/jira/browse/SLING" class="external-link" rel="nofollow">Issue Tracker</A><BR class="atl-forced-newline">
+<A href="http://svn.apache.org/viewvc/sling/trunk" class="external-link" rel="nofollow">Browse Source Repository</A><BR class="atl-forced-newline">
+<A href="security.html" title="Security">Security</A><BR class="atl-forced-newline"></P>
+
+<P><B>Sponsorship</B><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/thanks.html" class="external-link" rel="nofollow">Thanks</A><BR class="atl-forced-newline">
+<A href="http://www.apache.org/foundation/sponsorship.html" class="external-link" rel="nofollow">Become a Sponsor</A><BR>
+<A href="http://www.apache.org/foundation/buy_stuff.html" class="external-link" rel="nofollow">Buy Stuff</A></P>
+
+
+  <IFRAME src="http://www.apache.org/ads/button.html" style="border-width:0; float: left" frameborder="0" scrolling="no" width="135" height="135"></IFRAME>
+  <P style="height: 135px"></P>
+    </DIV>
+    <DIV class="main">
+        <DIV class="breadcrump" style="font-size: 80%;">
+<A href="apache-sling.html" title="Apache Sling Website">Apache Sling Website</A>&nbsp;&gt;&nbsp;<A href="apache-sling.html" title="Apache Sling">Apache Sling</A>&nbsp;&gt;&nbsp;<A href="" title="Project Information">Project Information</A>
+        </DIV>
+<H1><A name="ProjectInformation-Slingprojectinformation"></A>Sling project information</H1>
+
+<P>This document provides an overview of the various documents and links that are part of this project's general information:</P>
+
+<UL>
+	<LI><A href="apache-sling-community-roles-and-processes.html" title="Apache Sling Community Roles and Processes">Community Roles and Processes</A></LI>
+	<LI><A href="project-team.html" title="Project Team">Project Team</A></LI>
+	<LI><A href="#ProjectInformation-lists">Mailing Lists</A></LI>
+	<LI><A href="#ProjectInformation-issues">Issue Tracking</A></LI>
+	<LI><A href="#ProjectInformation-source">Source Repository</A></LI>
+	<LI><A href="#ProjectInformation-ci">Continuous Integration</A></LI>
+	<LI><A href="project-license.html" title="Project License">Project License</A></LI>
+</UL>
+
+
+
+<P><A name="ProjectInformation-lists"></A></P>
+<H2><A name="ProjectInformation-MailingLists"></A>Mailing Lists</H2>
+
+<P>These are the mailing lists that have been established for this project. For each list, there is a subscribe, unsubscribe, and an archive link.</P>
+<DIV class="table-wrap">
+<TABLE class="confluenceTable"><TBODY>
+<TR>
+<TH class="confluenceTh"> Name </TH>
+<TH class="confluenceTh"> Subscribe </TH>
+<TH class="confluenceTh"> Unsubscribe </TH>
+<TH class="confluenceTh"> Post </TH>
+<TH class="confluenceTh"> Archive </TH>
+<TH class="confluenceTh"> Other Archives </TH>
+</TR>
+<TR>
+<TD class="confluenceTd"> Sling Users List </TD>
+<TD class="confluenceTd"> <A href="mailto:users-subscribe@sling.apache.org" class="external-link" rel="nofollow">Subscribe</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:users-unsubscribe@sling.apache.org" class="external-link" rel="nofollow">Unsubscribe</A> </TD>
+<TD class="confluenceTd"> users at sling.apache.org </TD>
+<TD class="confluenceTd"> <A href="http://mail-archives.apache.org/mod_mbox/sling-users/" class="external-link" rel="nofollow">mail-archives.apache.org</A> </TD>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/users@sling.apache.org/" class="external-link" rel="nofollow">www.mail-archive.com</A> <A href="http://sling.markmail.org/" class="external-link" rel="nofollow">MarkMail</A> <A href="http://n3.nabble.com/Sling-Users-f73968.html" class="external-link" rel="nofollow">Nabble</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Sling Developers List </TD>
+<TD class="confluenceTd"> <A href="mailto:dev-subscribe@sling.apache.org" class="external-link" rel="nofollow">Subscribe</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:dev-unsubscribe@sling.apache.org" class="external-link" rel="nofollow">Unsubscribe</A> </TD>
+<TD class="confluenceTd"> dev at sling.apache.org </TD>
+<TD class="confluenceTd"> <A href="http://mail-archives.apache.org/mod_mbox/sling-dev/" class="external-link" rel="nofollow">mail-archives.apache.org</A> </TD>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/dev@sling.apache.org/" class="external-link" rel="nofollow">www.mail-archive.com</A> <A href="http://sling.markmail.org/" class="external-link" rel="nofollow">MarkMail</A> <A href="http://n3.nabble.com/Sling-Dev-f73966.html" class="external-link" rel="nofollow">Nabble</A> </TD>
+</TR>
+<TR>
+<TD class="confluenceTd"> Sling Source Control List </TD>
+<TD class="confluenceTd"> <A href="mailto:commits-subscribe@sling.apache.org" class="external-link" rel="nofollow">Subscribe</A> </TD>
+<TD class="confluenceTd"> <A href="mailto:commits-unsubscribe@sling.apache.org" class="external-link" rel="nofollow">Unsubscribe</A> </TD>
+<TD class="confluenceTd">&nbsp;</TD>
+<TD class="confluenceTd"> <A href="http://mail-archives.apache.org/mod_mbox/incubator-sling-commits/" class="external-link" rel="nofollow">mail-archives.apache.org</A> </TD>
+<TD class="confluenceTd"> <A href="http://www.mail-archive.com/commits@sling.apache.org/" class="external-link" rel="nofollow">www.mail-archive.com</A> <A href="http://sling.markmail.org/" class="external-link" rel="nofollow">MarkMail</A> </TD>
+</TR>
+</TBODY></TABLE>
+</DIV>
+
+
+
+<P><A name="ProjectInformation-issues"></A></P>
+<H2><A name="ProjectInformation-IssueTracking"></A>Issue Tracking</H2>
+
+<P>This project uses JIRA a J2EE-based, issue tracking and project management application. Issues, bugs, and feature requests should be submitted to the following issue tracking system for this project.</P>
+
+<P>The issue tracker can be found at <A href="http://issues.apache.org/jira/browse/SLING" class="external-link" rel="nofollow">http://issues.apache.org/jira/browse/SLING</A></P>
+
+<P><A name="ProjectInformation-source"></A></P>
+<H2><A name="ProjectInformation-SourceRepository"></A>Source Repository</H2>
+
+<P>This project uses Subversion to manage its source code. Instructions on Subversion use can be found at <A href="http://svnbook.red-bean.com/" class="external-link" rel="nofollow">http://svnbook.red-bean.com/</A>.</P>
+
+<H3><A name="ProjectInformation-WebAccess"></A>Web Access</H3>
+
+<P>The following is a link to the online source repository.</P>
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>http://svn.apache.org/viewvc/sling/trunk
+</PRE>
+</DIV></DIV>
+
+<H3><A name="ProjectInformation-Anonymousaccess"></A>Anonymous access</H3>
+
+<P>The source can be checked out anonymously from SVN with this command:</P>
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ svn checkout http://svn.apache.org/repos/asf/sling/trunk sling
+</PRE>
+</DIV></DIV>
+
+<H3><A name="ProjectInformation-Developeraccess"></A>Developer access</H3>
+
+<P>Everyone can access the Subversion repository via HTTPS, but Committers must checkout the Subversion repository via HTTPS.</P>
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ svn checkout https://svn.apache.org/repos/asf/sling/trunk sling
+</PRE>
+</DIV></DIV>
+
+<P>To commit changes to the repository, execute the following command to commit your changes (svn will prompt you for your password)</P>
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ svn commit --username your-username -m &quot;A message&quot;
+</PRE>
+</DIV></DIV>
+
+<H3><A name="ProjectInformation-Accessfrombehindafirewall"></A>Access from behind a firewall</H3>
+
+<P>For those users who are stuck behind a corporate firewall which is blocking http access to the Subversion repository, you can try to access it via the developer connection:</P>
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>$ svn checkout https://svn.apache.org/repos/asf/sling/trunk sling
+</PRE>
+</DIV></DIV>
+
+<H3><A name="ProjectInformation-Accessthroughaproxy"></A>Access through a proxy</H3>
+
+<P>The Subversion client can go through a proxy, if you configure it to do so. First, edit your &quot;servers&quot; configuration file to indicate which proxy to use. The files location depends on your operating system. On Linux or Unix it is located in the directory &quot;~/.subversion&quot;. On Windows it is in &quot;%APPDATA%\Subversion&quot;. (Try &quot;echo %APPDATA%&quot;, note this is a hidden directory.)</P>
+
+<P>There are comments in the file explaining what to do. If you don't have that file, get the latest Subversion client and run any command; this will cause the configuration directory and template files to be created.</P>
+
+<P>Example : Edit the 'servers' file and add something like :</P>
+
+<DIV class="preformatted panel" style="border-width: 1px;"><DIV class="preformattedContent panelContent">
+<PRE>[global]
+http-proxy-host = your.proxy.name
+http-proxy-port = 3128
+</PRE>
+</DIV></DIV>
+
+<P><A name="ProjectInformation-ci"></A></P>
+<H2><A name="ProjectInformation-ContinuousIntegration"></A>Continuous Integration</H2>
+<P>Sling builds run automatically on the ASF's <A href="https://builds.apache.org/view/S-Z/view/Sling/" class="external-link" rel="nofollow">Jenkins build server</A>, triggered by SVN changes and daily.</P>
+
+<P>See <A href="https://issues.apache.org/jira/browse/SLING-920" class="external-link" rel="nofollow">SLING-920</A> for Hudson configuration information.</P>
+        <DIV class="timestamp" style="margin-top: 30px; font-size: 80%; text-align: right;">
+Last modified by justinedelson on 2011-07-29 10:44:01.0
+        </DIV>
+        <DIV class="trademarkFooter">
+Apache Sling, Sling, Apache, the Apache feather logo, and the Apache Sling project logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners.
+        </DIV>
+    </DIV>
+  </BODY>
+</HTML>
+



Mime
View raw message