Added: websites/staging/sling/trunk/content/web-console-extensions.html ============================================================================== --- websites/staging/sling/trunk/content/web-console-extensions.html (added) +++ websites/staging/sling/trunk/content/web-console-extensions.html Sun Apr 22 16:52:28 2012 @@ -0,0 +1,146 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> +<html> +<!-- + + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + <head> + <title>Apache Sling - Web Console Extensions</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"> + <h1 id="documentation">Documentation</h1> +<ul> +<li><a href="getting-started.html">Getting Started</a></li> +<li><a href="the-sling-engine.html">The Sling Engine</a></li> +<li><a href="development.html">Development</a></li> +<li><a href="bundles.html">Bundles</a></li> +<li><a href="tutorials-&-how-tos.html">Tutorials & How-Tos</a></li> +<li><a href="configuration.html">Configuration</a></li> +<li><a href="http://sling.apache.org/apidocs/sling5/index.html";>API docs</a></li> +<li><a href="http://s.apache.org/sling.wiki";>Wiki</a></li> +<li><a href="http://s.apache.org/sling.faq";>FAQ</a></li> +</ul> +<h1 id="project-info">Project info</h1> +<ul> +<li><a href="http://sling.apache.org/site/downloads.cgi";>Downloads</a></li> +<li><a href="http://www.apache.org/licenses/";>License</a></li> +<li><a href="contributing.html">Contributing</a></li> +<li><a href="news.html">News</a></li> +<li><a href="links.html">Links</a></li> +<li><a href="project-information.html">Project Information</a></li> +<li><a href="https://issues.apache.org/jira/browse/SLING";>Issue Tracker</a></li> +<li><a href="http://svn.apache.org/viewvc/sling/trunk";>Browse Source Repository</a></li> +<li><a href="http://www.apache.org/security/";>Security</a></li> +</ul> +<h1 id="sponsorship">Sponsorship</h1> +<ul> +<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> +<li><a href="http://www.apache.org/foundation/sponsorship.html";>Become a Sponsor</a></li> +<li><a href="http://www.apache.org/foundation/buy_stuff.html";>Buy Stuff</a></li> +</ul> +<iframe + src="http://www.apache.org/ads/button.html"; + style="border-width:0; float: left" frameborder="0" + scrolling="no" + width="135" + height="135"> +</iframe> + </div> + + <div class="main"> + <div class="breadcrump" style="font-size: 80%;"> + (TODO: breadcrumb here) + </div> + <h1 class="title">Web Console Extensions</h1> + <div> + <p><a name="WebConsoleExtensions-WebConsoleExtensions"></a></p> +<h1 id="web-console-extensions">Web Console Extensions</h1> +<p>The Apache Sling project provides two extensions to the <a href="http://felix.apache.org/site/apache-felix-web-console.html";>Apache Felix Web Console</a> + (in addition to a number of plugins, of course):</p> +<p>{toc:minLevel=2|maxLevel=2}</p> +<p><a name="WebConsoleExtensions-Branding(org.apache.sling.extensions.webconsolebranding)"></a></p> +<h2 id="branding-orgapacheslingextensionswebconsolebranding">Branding (org.apache.sling.extensions.webconsolebranding)</h2> +<p>The Apache Sling Web Console Branding provided by Apache Sling is currently +just for the product logo displayed in the upper right corner of the Web +Console and some titles and strings.</p> +<p>This bundle will attach as a fragment bundle to the Apache Felix Web +Console bundle. To enable it after installation into a running system, you +might have to refresh the package imports of the Apache Felix Web Console +bundle. If you install using the Apache Felix Web Console bundle +installation functionality, this will be taken care of by the Web Console.</p> +<p>h2. Security Provider +(org.apache.sling.extensions.webconsolesecurityprovider)</p> +<p>The Apache Sling Web Console Security Provider implements the Apache Felix +Web Console <em>WebConsoleSecurityProvider</em> interface authenticating Web +Console users against the JCR repository. Each username and password +presented is used to login to the JCR repository and to check the +respective session.</p> +<ol> +<li>Ensure the username and password can be used to login to the default +workspace. If not, access is denied</li> +<li>If the username presented is one of the user names configured with the +<em>users</em> configuration property, access is granted.</li> +<li>Otherwise if the user is a (direct or indirect) member of one of the +groups configured with the <em>groups</em> configuration property, access is +granted.</li> +</ol> +<p>Access is denied if the username and password cannot be used to login to +the default workspace or if the user is neither one of the configured +allowed users nor in any of the configured groups.</p> +<p><a name="WebConsoleExtensions-Configuration"></a></p> +<h3 id="configuration">Configuration</h3> +<p>The Security Provider is configured with configuration with PID +<em>org.apache.sling.extensions.webconsolesecurityprovider.internal.SlingWebConsoleSecurityProvider</em> +supporting the following properties:</p> +<table> +<tr><th> Property </th><th> Type </th><th> Default Value </th><th> Description +</tr> +<tr><td> *users* </td><td> *String*, {{String[](.html) +}} or *Vector<String>* </td><td> admin </td><td> The list of users granted access to the +Web Console </td></tr> +<tr><td> *groups*</td><td> *String*, {{String[](.html) +}} or *Vector<String>* </td><td> --- </td><td> The list of groups whose (direct or +indirect) members are granted access to the Web Console </td></tr> +</table> + +<p>Note, that while the default value explicitly grants the <em>admin</em> user to +access the Web Console it is suggested that system administrators define a +special group and assign users with Web Console access to this group.</p> + </div> + </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> + </body> +</html>
Added: websites/staging/sling/trunk/content/wiki.html ============================================================================== --- websites/staging/sling/trunk/content/wiki.html (added) +++ websites/staging/sling/trunk/content/wiki.html Sun Apr 22 16:52:28 2012 @@ -0,0 +1,118 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> +<html> +<!-- + + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + <head> + <title>Apache Sling - wiki</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"> + <h1 id="documentation">Documentation</h1> +<ul> +<li><a href="getting-started.html">Getting Started</a></li> +<li><a href="the-sling-engine.html">The Sling Engine</a></li> +<li><a href="development.html">Development</a></li> +<li><a href="bundles.html">Bundles</a></li> +<li><a href="tutorials-&-how-tos.html">Tutorials & How-Tos</a></li> +<li><a href="configuration.html">Configuration</a></li> +<li><a href="http://sling.apache.org/apidocs/sling5/index.html";>API docs</a></li> +<li><a href="http://s.apache.org/sling.wiki";>Wiki</a></li> +<li><a href="http://s.apache.org/sling.faq";>FAQ</a></li> +</ul> +<h1 id="project-info">Project info</h1> +<ul> +<li><a href="http://sling.apache.org/site/downloads.cgi";>Downloads</a></li> +<li><a href="http://www.apache.org/licenses/";>License</a></li> +<li><a href="contributing.html">Contributing</a></li> +<li><a href="news.html">News</a></li> +<li><a href="links.html">Links</a></li> +<li><a href="project-information.html">Project Information</a></li> +<li><a href="https://issues.apache.org/jira/browse/SLING";>Issue Tracker</a></li> +<li><a href="http://svn.apache.org/viewvc/sling/trunk";>Browse Source Repository</a></li> +<li><a href="http://www.apache.org/security/";>Security</a></li> +</ul> +<h1 id="sponsorship">Sponsorship</h1> +<ul> +<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> +<li><a href="http://www.apache.org/foundation/sponsorship.html";>Become a Sponsor</a></li> +<li><a href="http://www.apache.org/foundation/buy_stuff.html";>Buy Stuff</a></li> +</ul> +<iframe + src="http://www.apache.org/ads/button.html"; + style="border-width:0; float: left" frameborder="0" + scrolling="no" + width="135" + height="135"> +</iframe> + </div> + + <div class="main"> + <div class="breadcrump" style="font-size: 80%;"> + (TODO: breadcrumb here) + </div> + <h1 class="title">wiki</h1> + <div> + <p><a name="wiki-ApacheSlingWebsite"></a></p> +<h1 id="apache-sling-website">Apache Sling Website</h1> +<p>{tip:title=Use Generated Pages} +The Apache Sling project uses a Confluence space for documentation purposes +and to generate the static Sling web site. You are currently looking at the +source wiki. End users should generally use the static, generated pages, at +http://incubator.apache.org/sling since the wiki is typically only +necessary for editing content. Below you'll find an overview of the main +menu, all pages in this wiki as well as a list of recently modified pages. +{tip}</p> +<p>{section} +{column:width=50%} +<a name="wiki-Menu"></a></p> +<h1 id="menu">Menu</h1> +<p>{include:navigation} +<a name="wiki-Recentlyupdatedpages"></a></p> +<h1 id="recently-updated-pages">Recently updated pages</h1> +<p>{recently-updated:spaces=SLINGxSITE} +{column}</p> +<p>{column:width=50%} +<a name="wiki-Sitemap"></a></p> +<h1 id="site-map">Site map</h1> +<p>{children:page=SLINGxSITE:|all=true} +{column} +{section} </p> + </div> + </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> + </body> +</html> Added: websites/staging/sling/trunk/content/wrap-or-decorate-resources.html ============================================================================== --- websites/staging/sling/trunk/content/wrap-or-decorate-resources.html (added) +++ websites/staging/sling/trunk/content/wrap-or-decorate-resources.html Sun Apr 22 16:52:28 2012 @@ -0,0 +1,133 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> +<html> +<!-- + + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + <head> + <title>Apache Sling - Wrap or Decorate Resources</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"> + <h1 id="documentation">Documentation</h1> +<ul> +<li><a href="getting-started.html">Getting Started</a></li> +<li><a href="the-sling-engine.html">The Sling Engine</a></li> +<li><a href="development.html">Development</a></li> +<li><a href="bundles.html">Bundles</a></li> +<li><a href="tutorials-&-how-tos.html">Tutorials & How-Tos</a></li> +<li><a href="configuration.html">Configuration</a></li> +<li><a href="http://sling.apache.org/apidocs/sling5/index.html";>API docs</a></li> +<li><a href="http://s.apache.org/sling.wiki";>Wiki</a></li> +<li><a href="http://s.apache.org/sling.faq";>FAQ</a></li> +</ul> +<h1 id="project-info">Project info</h1> +<ul> +<li><a href="http://sling.apache.org/site/downloads.cgi";>Downloads</a></li> +<li><a href="http://www.apache.org/licenses/";>License</a></li> +<li><a href="contributing.html">Contributing</a></li> +<li><a href="news.html">News</a></li> +<li><a href="links.html">Links</a></li> +<li><a href="project-information.html">Project Information</a></li> +<li><a href="https://issues.apache.org/jira/browse/SLING";>Issue Tracker</a></li> +<li><a href="http://svn.apache.org/viewvc/sling/trunk";>Browse Source Repository</a></li> +<li><a href="http://www.apache.org/security/";>Security</a></li> +</ul> +<h1 id="sponsorship">Sponsorship</h1> +<ul> +<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> +<li><a href="http://www.apache.org/foundation/sponsorship.html";>Become a Sponsor</a></li> +<li><a href="http://www.apache.org/foundation/buy_stuff.html";>Buy Stuff</a></li> +</ul> +<iframe + src="http://www.apache.org/ads/button.html"; + style="border-width:0; float: left" frameborder="0" + scrolling="no" + width="135" + height="135"> +</iframe> + </div> + + <div class="main"> + <div class="breadcrump" style="font-size: 80%;"> + (TODO: breadcrumb here) + </div> + <h1 class="title">Wrap or Decorate Resources</h1> + <div> + <p><a name="WraporDecorateResources-Servicetowrapresources"></a></p> +<h1 id="service-to-wrap-resources">Service to wrap resources</h1> +<p><a name="WraporDecorateResources-Introduction"></a></p> +<h2 id="introduction">Introduction</h2> +<p>The Sling API provides an easy way to wrap or decorate a resource before +returning. Use cases for this could for example be +<em> overwrite resource type/resource super type (for example based on the +resource path) +</em> add metadata</p> +<p><a name="WraporDecorateResources-"></a></p> +<h2></h2> +<p>To add a resource decorator just register one or more services which +implement the interface <em>ResourceDecorator</em></p> +<div class="codehilite"><pre><span class="n">interface</span> <span class="n">ResourceDecorator</span> <span class="p">{</span> + <span class="n">Resource</span> <span class="n">decorate</span><span class="p">(</span><span class="n">Resource</span><span class="p">)</span> + + <span class="nv">@Deprecated</span> + <span class="n">Resource</span> <span class="n">decorate</span><span class="p">(</span><span class="n">Resource</span><span class="p">,</span> <span class="n">HttpServletRequest</span><span class="p">)</span> +<span class="p">}</span> +</pre></div> + + +<p>The registered decorators will be called from the resource resolver for +each resource returned. +If the service decorates the resource it should return the new resource. If +the service does not want to decorate the resource, it should return the +original resource or null. </p> +<p>The two-argument <em>{decorate</em>} method will not be invoked, starting with +version 2.1.0 of the JCR Resource bundle. Implementors of this interface +targeting both newer and older versions of this bundle are advised to +implement this method with:</p> +<div class="codehilite"><pre> <span class="n">public</span> <span class="n">Resource</span> <span class="n">decorate</span><span class="p">(</span><span class="n">Resource</span> <span class="n">resource</span><span class="p">,</span> <span class="n">HttpServletRequest</span> <span class="n">request</span><span class="p">)</span> +</pre></div> + + +<p>{ + return this.decorate(resource); + }</p> +<p>And use some other method (e.g. a <em>{ThreadLocal</em>}) to obtain the current +request if necessary.</p> + </div> + </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> + </body> +</html> Added: websites/staging/sling/trunk/content/xslt-processing-pipeline.html ============================================================================== --- websites/staging/sling/trunk/content/xslt-processing-pipeline.html (added) +++ websites/staging/sling/trunk/content/xslt-processing-pipeline.html Sun Apr 22 16:52:28 2012 @@ -0,0 +1,94 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd";> +<html> +<!-- + + Licensed to the Apache Software Foundation (ASF) under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + The ASF licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE- 2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +--> + <head> + <title>Apache Sling - XSLT Processing Pipeline</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"> + <h1 id="documentation">Documentation</h1> +<ul> +<li><a href="getting-started.html">Getting Started</a></li> +<li><a href="the-sling-engine.html">The Sling Engine</a></li> +<li><a href="development.html">Development</a></li> +<li><a href="bundles.html">Bundles</a></li> +<li><a href="tutorials-&-how-tos.html">Tutorials & How-Tos</a></li> +<li><a href="configuration.html">Configuration</a></li> +<li><a href="http://sling.apache.org/apidocs/sling5/index.html";>API docs</a></li> +<li><a href="http://s.apache.org/sling.wiki";>Wiki</a></li> +<li><a href="http://s.apache.org/sling.faq";>FAQ</a></li> +</ul> +<h1 id="project-info">Project info</h1> +<ul> +<li><a href="http://sling.apache.org/site/downloads.cgi";>Downloads</a></li> +<li><a href="http://www.apache.org/licenses/";>License</a></li> +<li><a href="contributing.html">Contributing</a></li> +<li><a href="news.html">News</a></li> +<li><a href="links.html">Links</a></li> +<li><a href="project-information.html">Project Information</a></li> +<li><a href="https://issues.apache.org/jira/browse/SLING";>Issue Tracker</a></li> +<li><a href="http://svn.apache.org/viewvc/sling/trunk";>Browse Source Repository</a></li> +<li><a href="http://www.apache.org/security/";>Security</a></li> +</ul> +<h1 id="sponsorship">Sponsorship</h1> +<ul> +<li><a href="http://www.apache.org/foundation/thanks.html";>Thanks</a></li> +<li><a href="http://www.apache.org/foundation/sponsorship.html";>Become a Sponsor</a></li> +<li><a href="http://www.apache.org/foundation/buy_stuff.html";>Buy Stuff</a></li> +</ul> +<iframe + src="http://www.apache.org/ads/button.html"; + style="border-width:0; float: left" frameborder="0" + scrolling="no" + width="135" + height="135"> +</iframe> + </div> + + <div class="main"> + <div class="breadcrump" style="font-size: 80%;"> + (TODO: breadcrumb here) + </div> + <h1 class="title">XSLT Processing Pipeline</h1> + <div> + + </div> + </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> + </body> +</html>
![http://sling.apache.org/site/media.data/logo.png"](http://sling.apache.org/site/media.data/logo.png"){kind=link}
![http://sling.apache.org/site/media.data/apache.png"](http://sling.apache.org/site/media.data/apache.png"){kind=link}