You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by th...@apache.org on 2006/08/05 23:21:51 UTC

svn commit: r429057 - in /forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher: ./ how/ int/ themes/

Author: thorsten
Date: Sat Aug  5 14:21:49 2006
New Revision: 429057

URL: http://svn.apache.org/viewvc?rev=429057&view=rev
Log:
Deployment of docs for org.apache.forrest.plugin.internal.dispatcher plugin (deployed by 'deploy-docs' target of plugin build script)

Added:
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.dispatcher.css   (with props)
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.html   (with props)
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.pdf   (with props)
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.dispatcher.css   (with props)
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.html   (with props)
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.pdf   (with props)
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.dispatcher.css   (with props)
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.html   (with props)
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.pdf   (with props)
Modified:
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/changes.html
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/dispatcher-glossary.html
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-contracts.html
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-quickstart.html
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-quickstart.pdf
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-structurer.html
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-contracts.html
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-dsl.html
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-dsl.pdf
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.html
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/linkmap.html
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/linkmap.pdf
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/themes/pelt.screen.css
    forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/todo.html

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/changes.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/changes.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/changes.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/changes.html Sat Aug  5 14:21:49 2006
@@ -16,7 +16,7 @@
 }</style>
       <meta content="Apache Forrest" name="Generator" />
 <meta content="0.8" name="Forrest-version" />
-<meta content="pelt" name="Forrest-theme-name" />
+<meta content="${project.theme}" name="Forrest-theme-name" />
 <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
 <!--+ |start navigation links +-->
 <link href="index.html" rel="Index" title="Index..." />
@@ -107,6 +107,9 @@
 <li>
 <a class="base-not-selected" href="how/howto-dispatcher-quickstart.html">HowTo</a>
 </li>
+<li>
+<a class="base-not-selected" href="int/index.html">internals</a>
+</li>
 </ul>
 <!--+ |end Tabs +-->
 <div id="publishedStrip"> <!--+
@@ -152,6 +155,14 @@
 </li>
 <li class="menuitem">
 <a href="how/howto-dispatcher-contracts.html" title="">Contracts</a>
+</li>
+</ul>
+</li>
+<li class="pagegroup" id="menu_1.3Title">
+<span onclick="SwitchMenu('menu_1.3')">Internals</span>
+<ul class="menuitemgroup" id="menu_1.3">
+<li class="menuitem">
+<a href="int/index.html" title="">Overview</a>
 </li>
 </ul>
 </li>

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/dispatcher-glossary.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/dispatcher-glossary.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/dispatcher-glossary.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/dispatcher-glossary.html Sat Aug  5 14:21:49 2006
@@ -16,7 +16,7 @@
 }</style>
       <meta content="Apache Forrest" name="Generator" />
 <meta content="0.8" name="Forrest-version" />
-<meta content="pelt" name="Forrest-theme-name" />
+<meta content="${project.theme}" name="Forrest-theme-name" />
 <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
 <!--+ |start navigation links +-->
 <link href="index.html" rel="Index" title="Index..." />
@@ -107,6 +107,9 @@
 <li>
 <a class="base-not-selected" href="how/howto-dispatcher-quickstart.html">HowTo</a>
 </li>
+<li>
+<a class="base-not-selected" href="int/index.html">internals</a>
+</li>
 </ul>
 <!--+ |end Tabs +-->
 <div id="publishedStrip"> <!--+
@@ -152,6 +155,14 @@
 </li>
 <li class="menuitem">
 <a href="how/howto-dispatcher-contracts.html" title="">Contracts</a>
+</li>
+</ul>
+</li>
+<li class="pagegroup" id="menu_1.3Title">
+<span onclick="SwitchMenu('menu_1.3')">Internals</span>
+<ul class="menuitemgroup" id="menu_1.3">
+<li class="menuitem">
+<a href="int/index.html" title="">Overview</a>
 </li>
 </ul>
 </li>

Added: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.dispatcher.css
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.dispatcher.css?rev=429057&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.dispatcher.css (added)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.dispatcher.css Sat Aug  5 14:21:49 2006
@@ -0,0 +1,45 @@
+
+/* branding-theme-profiler-theme: Pelt */ 
+#header .round-top-left-small {
+    background-image: url(../themes/images/roundcorner-t-l-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top left;
+}
+#header .round-top-right-small {
+    background-image: url(../themes/images/roundcorner-t-r-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top right;
+}
+#nav-main li {
+    background-image: url(../themes/images/roundcorner-t-r-5-bg294563-strokeCEDFEF-fgCEDFEF.png);
+    background-repeat: no-repeat;
+    background-position: top right;
+}
+#nav-main li a {
+    background-image: url(../themes/images/roundcorner-t-l-5-bg294563-strokeCEDFEF-fgCEDFEF.png);
+    background-repeat: no-repeat;
+    background-position: top left;
+}
+#nav-main .current {
+    background-image: url(../themes/images/roundcorner-t-r-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top right;
+}
+#nav-main .current a {
+    background-image: url(../themes/images/roundcorner-t-l-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top left;
+}
+#roundbottom {
+    background-image: url(../themes/images/roundcorner-b-r-15-bgffffff-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: bottom right;
+}
+#roundbottomLeft {
+    background-image: url(../themes/images/roundcorner-b-l-15-bgffffff-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: bottom left;
+}
+            
+  
+  

Propchange: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.dispatcher.css
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.html?rev=429057&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.html (added)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.html Sat Aug  5 14:21:49 2006
@@ -0,0 +1,370 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+        <link href="../themes/common.css" media="screen" rel="alternate stylesheet" title="common" type="text/css" />
+        <link href="../themes/leather-dev.css" media="screen" rel="alternate stylesheet" title="common" type="text/css" />
+        <link href="../themes/pelt.screen.css" media="screen" rel="stylesheet" title="Pelt" type="text/css" />
+        
+        <link href="../how/howItWork.dispatcher.css" media="screen" rel="stylesheet" title="Pelt" type="text/css" />
+        <link href="../themes/pelt.print.css" media="print" rel="stylesheet" title="pelt.print.css" type="text/css" />
+        <style type="text/css">/* Extra css */ 
+p.quote {
+ margin-left: 2em; 
+ padding: .5em; 
+ background-color: #f0f0f0; 
+ font-family: monospace; 
+}</style>
+      <meta content="Apache Forrest" name="Generator" />
+<meta content="0.8-dev" name="Forrest-version" />
+<meta content="pelt" name="Forrest-theme-name" />
+<meta content="text/html; charset=UTF-8" http-equiv="content-type" />
+<!--+ |start navigation links +-->
+<link href="../index.html" rel="Index" title="Index..." />
+<link href="../linkmap.html" rel="CONTENTS" title="Site map..." />
+<link href="../changes.html" rel="NEXT" title="Changes" />
+<link href="../index.old.html" rel="PREVIOUS" title="(FIXME: old) Index" />
+<link href="../todo.html" rel="LAST" title="Todo" />
+<link href="../index.html" rel="FIRST" title="Dispatcher development" />
+<!--+ |end navigation links +-->
+<!--+|start favicon +-->
+<link href="../favicon.ico" rel="shortcut icon" />
+<!--+|start favicon +-->
+<script src="../themes/getBlank.js" type="text/javascript"> </script>
+<script src="../themes/menu.js" type="text/javascript"> </script>
+<!--+ |start content-title +-->
+<title>forrest:views - x formats, one config</title>
+<!--+ |end content-title +-->
+</head>
+<body>
+<div id="container">
+<!--+
+    | start breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">MyGroup</a>
+                   &gt; <a href="http://forrest.apache.org/">MyProject</a>
+<script src="../themes/breadcrumbs.js" type="text/javascript"> </script>
+</div>
+<!--+
+    | end breadtrail
+    +-->
+<div id="header">
+<div id="branding-tagline-name">new 
+            seed</div>
+<div id="branding-tagline-tagline">powered by the 
+            dispatcher</div>
+<div class="logo">
+<!--+
+    |start Logo
+    +-->
+<a href="http://mygroup.org/">
+<img alt="MyGroup" class="logoImage" src="../images/group.png" title="MyGroup Description" />
+</a>
+<!--+
+    |end group Logo
+    +-->
+</div>
+<div class="logo">
+<!--+
+    |start Logo
+    +-->
+<a href="http://myproj.mygroup.org/">
+<img alt="MyProject" class="logoImage" src="../images/project.png" title="MyProject Description" />
+</a>
+<!--+
+    |end group Logo
+    +-->
+</div>
+<!--+
+  |start Search
+  +-->
+<div class="searchbox">
+<div class="round-top-left-small">
+<div class="round-top-right-small">
+<div class="search-input">
+<form action="http://www.google.com/search" method="get">
+<div class="search-hidden">
+<input name="sitesearch" type="hidden" value="mydomain" />
+</div>
+<div class="search-field">
+<input name="q" size="25" type="text" value="Search the site with google" />
+</div>
+<div class="search-submit">
+<input name="Search" type="submit" value="Search" />
+</div>
+</form>
+</div>
+</div>
+</div>
+</div>
+<!--+ |end search +-->
+<div id="nav-main-hook">
+<!--+ |start Tabs new +-->
+<ul id="nav-main">
+<li class="current">
+<a class="base-selected" href="../index.html">Home</a>
+</li>
+</ul>
+<!--+ |end Tabs +-->
+<div id="publishedStrip"> <!--+
+    |start nav-main-sub
+    +--><!--+
+    |end Endtabs
+    +--><script type="text/javascript">document.write("Last Published: " + document.lastModified);</script>
+</div>
+</div>
+</div>
+<div id="page">
+<div class="breadtrail"> </div>
+<div id="leftbar">
+<!--+ |start 0 menu +-->
+<!--+ |start Menu +-->
+<div id="nav-section">
+<ul>
+<li class="pagegroupselected" id="menu_selected_1.1Title">
+<span onclick="SwitchMenu('menu_selected_1.1')">About</span>
+<ul class="&#10;               selectedmenuitemgroup" id="menu_selected_1.1">
+<li class="menuitem">
+<a href="../index.html" title="">Dispatcher development</a>
+</li>
+<li class="pagegroup" id="menu_1.1.2Title">
+<span onclick="SwitchMenu('menu_1.1.2')">How to</span>
+<ul class="menuitemgroup" id="menu_1.1.2">
+<li class="menuitem">
+<a href="../how/howto-dispatcher-quickstart.html" title="">Quickstart</a>
+</li>
+<li class="menuitem">
+<a href="../how/howto-structurer-dsl.html" title="">Structurer</a>
+</li>
+<li class="menuitem">
+<a href="../how/howto-structurer-contracts.html" title="">Contracts</a>
+</li>
+</ul>
+</li>
+<li class="menuitem">
+<a href="../dispatcher-glossary.html" title="Dispactcher related terms and meanings">(FIXME: add content) Glossary</a>
+</li>
+<li class="menuitem">
+<a href="../index.old.html" title="(FIXME: old) index">(FIXME: old) Index</a>
+</li>
+<li class="menupage">
+<div class="menupagetitle">(FIXME: old) howItWorks</div>
+</li>
+<li class="menuitem">
+<a href="../changes.html" title="History of Changes">Changes</a>
+</li>
+<li class="menuitem">
+<a href="../todo.html" title="Todo List">Todo</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<!--+ |end menu +-->
+<!--+ |start content-motd-page +-->
+<!--+ |end content-motd-page +-->
+<div id="roundbottom">
+<div id="roundbottomLeft">
+<img alt="spacer" src="../themes/images/spacer.gif" />
+</div>
+</div>
+</div>
+<div id="export-link">
+<a class="format" href="howItWork.pdf">
+<img alt="PDF - icon" class="skin" src="../themes/images/pdfdoc.gif" />
+<span class="caption">PDF</span>
+</a>
+</div>
+<div id="content">
+<!--+ |start content-title +-->
+<h1 class="content-title">forrest:views - x formats, one config</h1>
+<!--+ |end content-title +-->
+<!--+ |start content-abstract +-->This plugin depends on a ViewHelper and a BusinessHelper implementation.<!--+ |end content-abstract +--><!--+ |start content-minitoc +--><div id="content-minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#How+it+works">How it works </a>
+</li>
+<li>
+<a href="#Resume">Resume</a>
+</li>
+</ul>
+</div>
+<!--+ |end minitoc +-->
+<!--+ |start content-main +-->
+<a name="How+it+works" title="How it works "> </a>
+<h2 class="underlined_10">How it works </h2>
+<div class="section">
+<pre class="code">
+This plugin has three components:
+  1. viewHelper - delivers contracts in form of xsl:templates
+  2. businessHelper - delivers content that is used in the contracts
+  3. views - prepares and transforms the requested contracts (viewHelper) 
+     and populate them with the content (businessHelper)
+
+1. viewHelper
+  This is the template producing factory.
+
+a. &lt;map:match pattern="resolve.contract.*.*"&gt; -&gt; Resolving factory
+Project implementation of templates have priority before default ones.
+If no implementation can be found we use the noFt (~ - no
+forrest:template) implementation.-&gt; this match is implemented in the viewHelper plugin
+
+b. &lt;map:match pattern="get.contract.*.*"&gt;-&gt; this match is implemented in the viewHelper plugin
+Get the xsl:templates of the requested contract and specific format.
+
+c. &lt;map:match pattern="get.contract-property.*"&gt;-&gt; this match is implemented in the viewHelper plugin
+Get the forrest:properties of the requested contract. 
+This will determine which templates (css, head, body) we have to call
+later on
+
+GENERAL:
+Contracts are stored in forrest:templates ({contract-name}.ft) please
+have a look on the templates/*.ft that the viewHelper implementation contain to get
+an idea how your own implementation have to look like.
+
+
+2. businessHelper
+  This is the content producing factory.
+
+NOTE: &lt;map:match pattern="*.page"&gt;
+  The current factory uses the models the skin (e.g. document2xhtml.xsl from pelt [default skin]).
+  It is only exchanging the last model of the models the skin is producing (site2xhtml.xsl) till now.
+  This will have to be changed in the future.
+
+3. views
+  prepares the requested contracts viewHelper and dispatches
+the corresponding businessHelper.
+
+a.  &lt;map:match pattern="prepare.view.*"&gt; -&gt; View config resolver
+File specific views have priority before default ones.
+If no view can be found in the project we use the default one of the
+views plugin.
+
+b.  &lt;map:match pattern="prepare.include.*.**"&gt; 
+Aggregate the contract-templates requested by the view with xinclude.
+The result is a stylesheet with all needed xsl:templates.
+
+c. &lt;map:match pattern="prepare.properties.*.*"&gt;
+Aggregate the forrest:properties requested by the *.fv.
+The result is an aggregation of properties which defines the templates
+to be call.
+
+d. &lt;map:match pattern="prepare.xhtml.*"&gt;
+Aggregate all contracts-templates requested by the view.
+Create a xsl that can be used for the last step of the transformation of
+the view.
+
+e. &lt;map:match pattern="*.html"&gt; -&gt; Last processing step. 
+Here we are overriding the default skin generation. 
+-&gt; this match is implemented in the viewHelper plugin
+
+GENERAL:
+Views are stored in forrest:view ({file-name}.fv) please have look on
+plugins/org.apache.forrest.plugin.internal.structurer/src/documentation/common.fv do
+get an idea how your own implementation have to look like.
+
+      </pre>
+</div>
+<a name="Resume" title="Resume"> </a>
+<h2 class="underlined_10">Resume</h2>
+<div class="section">
+<pre class="code">
+The views plugin can be seen as prototype for the next generation
+skinning of forrest. It is still in early stage but with extracting the businessHelper we
+hope to make it easier for all devs (not only committer) to get the idea
+and enable them to enhance the design of this plugin and their implementation.
+
+Some basic and simple hints:
+a) If you want another implementation of a contract then create a folder
+"templates" in ${project.resources-dir} and it will be matched before
+the standard implementation. 
+
+e.g. feedback contract:
+
+&lt;forrest:contract name="feedback" type="nugget"
+  xmlns:forrest="http://apache.org/forrest/templates/1.0"&gt;
+&lt;description&gt;
+This function will output the html feedback information.
+&lt;/description&gt;
+
+&lt;forrest:template
+xmlns:forrest="http://apache.org/forrest/templates/1.0"
+format="xhtml" name="feedback" inputFormat="xsl" body="true"
+head="false" css="true"&gt;
+
+&lt;xsl:stylesheet version="1.1" 
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:jx="http://apache.org/cocoon/templates/jx/1.0"&gt;
+
+&lt;xsl:template name="feedback-css"&gt;
+#feedback {
+    color: black;
+    background: #CFDCED;
+    text-align:center;
+    margin-top: 5px;
+}
+#feedback #feedbackto {
+    font-size: 90%;
+    color: black;
+}&lt;/xsl:template&gt;
+
+&lt;xsl:template name="feedback-body"&gt;
+&lt;div id="feedback"&gt; Modified project implementation
+&lt;xsl:value-of select="$config/feedback"/&gt;
+&lt;xsl:choose&gt;
+&lt;xsl:when test="$config/feedback/@href and
+not($config/feedback/@href='')"&gt;
+  &lt;a id="feedbackto"&gt;
+    &lt;xsl:attribute name="href"&gt;
+      &lt;xsl:value-of select="$config/feedback/@href"/&gt;
+      &lt;xsl:value-of select="$path"/&gt;
+    &lt;/xsl:attribute&gt;
+    &lt;xsl:value-of select="$config/feedback/@to"/&gt;
+  &lt;/a&gt;
+&lt;/xsl:when&gt;
+&lt;xsl:otherwise&gt;
+  &lt;xsl:value-of select="$config/feedback/@to"/&gt;
+&lt;/xsl:otherwise&gt;
+&lt;/xsl:choose&gt;
+&lt;/div&gt;
+&lt;/xsl:template&gt;
+&lt;/xsl:stylesheet&gt;
+&lt;/forrest:template&gt;
+&lt;/forrest:contract&gt;
+
+The @attributes (body="true" head="false" css="true") of the 
+forrest:template defining which parts of the html page (head, head-css
+and body) we have to render. The xsl:templates are following the simple
+naming convention {@name}-(css|head|body).
+
+
+b. If you want a default view for your project then copy the common.fv
+from the viewHelper implementation to your ${project.conf-dir} and modify this file. When
+you want another view for a specific file (e.g. ${project.xdocs-dir}/index.html) then copy
+the common.fv to your ${project.xdocs-dir} and renamed it to 
+${project.xdocs-dir}/index.fv.</pre>
+</div>
+<!--+ |end content-main +-->
+</div>
+</div>
+<div id="footer">
+<div class="lastmodified">
+<script type="text/javascript">document.write("Last Published: " + document.lastModified);</script>
+</div>
+<div class="copyright">
+            Copyright ©
+             2002-2006 <a href="http://www.acme.org/licenses/">The Acme Software Organisation.</a> </div>
+<!--+ |start compliance links +-->
+<div id="siteinfo-compliance-links">
+<a href="http://validator.w3.org/check?uri=referer">
+<img alt="Valid XHTML 1.0!" height="31" src="http://www.w3.org/Icons/valid-xhtml10" width="88" />
+</a>
+<a href="http://jigsaw.w3.org/css-validator/check/referer">
+<img alt="Valid CSS!" src="http://jigsaw.w3.org/css-validator/images/vcss" style="border:0;width:88px;height:31px" />
+</a>
+</div>
+<!--+ |end compliance links +-->
+</div>
+</div>
+</body>
+</html>

Propchange: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.pdf?rev=429057&view=auto
==============================================================================
Binary file - no diff available.

Propchange: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howItWork.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-contracts.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-contracts.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-contracts.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-contracts.html Sat Aug  5 14:21:49 2006
@@ -16,7 +16,7 @@
 }</style>
       <meta content="Apache Forrest" name="Generator" />
 <meta content="0.8" name="Forrest-version" />
-<meta content="pelt" name="Forrest-theme-name" />
+<meta content="${project.theme}" name="Forrest-theme-name" />
 <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
 <!--+ |start navigation links +-->
 <link href="../index.html" rel="Index" title="Index..." />
@@ -104,6 +104,9 @@
 </li>
 <li class="current">
 <a class="base-selected" href="../how/howto-dispatcher-quickstart.html">HowTo</a>
+</li>
+<li>
+<a class="base-not-selected" href="../int/index.html">internals</a>
 </li>
 </ul>
 <!--+ |end Tabs +-->

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-quickstart.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-quickstart.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-quickstart.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-quickstart.html Sat Aug  5 14:21:49 2006
@@ -16,7 +16,7 @@
 }</style>
       <meta content="Apache Forrest" name="Generator" />
 <meta content="0.8" name="Forrest-version" />
-<meta content="pelt" name="Forrest-theme-name" />
+<meta content="${project.theme}" name="Forrest-theme-name" />
 <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
 <!--+ |start navigation links +-->
 <link href="../index.html" rel="Index" title="Index..." />
@@ -105,6 +105,9 @@
 <li class="current">
 <a class="base-selected" href="../how/howto-dispatcher-quickstart.html">HowTo</a>
 </li>
+<li>
+<a class="base-not-selected" href="../int/index.html">internals</a>
+</li>
 </ul>
 <!--+ |end Tabs +-->
 <div id="publishedStrip"> <!--+
@@ -275,12 +278,13 @@
         <li>Add the new plugins to forrest.properties ...
         ,org.apache.forrest.plugin.internal.dispatcher,org.apache.forrest.themes.core
         </li>
-        <li>localhost:8888/index.html ... fantastic. See the default view.</li>
+        <li>localhost:8888/index.html ... fantastic. See the pelt view.</li>
       </ul>
 <a name="another-theme" title="Use another theme"> </a>
 <h3 class="underlined_5">Use another theme</h3>
 <ul>
-        <li>Add project.theme=pelt to forrest.properties</li>
+        <li>Add &lt;property name="dispatcher.theme" value="common"/&gt; 
+          to your forrest.properties.xml</li>
         <li>Re-start 'forrest run'</li>
         <li>localhost:8888/index.html ... See the new view.</li>
       </ul>

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-quickstart.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-quickstart.pdf?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
Binary files - no diff available.

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-structurer.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-structurer.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-structurer.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-dispatcher-structurer.html Sat Aug  5 14:21:49 2006
@@ -16,7 +16,7 @@
 }</style>
       <meta content="Apache Forrest" name="Generator" />
 <meta content="0.8" name="Forrest-version" />
-<meta content="pelt" name="Forrest-theme-name" />
+<meta content="${project.theme}" name="Forrest-theme-name" />
 <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
 <!--+ |start navigation links +-->
 <link href="../index.html" rel="Index" title="Index..." />
@@ -106,6 +106,9 @@
 </li>
 <li class="current">
 <a class="base-selected" href="../how/howto-dispatcher-quickstart.html">HowTo</a>
+</li>
+<li>
+<a class="base-not-selected" href="../int/index.html">internals</a>
 </li>
 </ul>
 <!--+ |end Tabs +-->

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-contracts.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-contracts.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-contracts.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-contracts.html Sat Aug  5 14:21:49 2006
@@ -21,6 +21,7 @@
 <!--+ |start navigation links +-->
 <link href="../index.html" rel="Index" title="Index..." />
 <link href="../linkmap.html" rel="CONTENTS" title="Site map..." />
+<link href="../dispatcher-glossary.html" rel="NEXT" title="(FIXME: add content) Glossary" />
 <link href="../how/howto-structurer-dsl.html" rel="PREVIOUS" title="Structurer" />
 <link href="../how/howto-dispatcher-quickstart.html" rel="FIRST" title="Quickstart" />
 <!--+ |end navigation links +-->
@@ -99,11 +100,8 @@
 <div id="nav-main-hook">
 <!--+ |start Tabs new +-->
 <ul id="nav-main">
-<li>
-<a class="base-not-selected" href="../index.html">Home</a>
-</li>
 <li class="current">
-<a class="base-selected" href="../how/howto-dispatcher-quickstart.html">HowTo</a>
+<a class="base-selected" href="../index.html">Home</a>
 </li>
 </ul>
 <!--+ |end Tabs +-->
@@ -123,9 +121,15 @@
 <div id="nav-section">
 <ul>
 <li class="pagegroupselected" id="menu_selected_1.1Title">
-<span onclick="SwitchMenu('menu_selected_1.1')">How to</span>
+<span onclick="SwitchMenu('menu_selected_1.1')">About</span>
 <ul class="&#10;               selectedmenuitemgroup" id="menu_selected_1.1">
 <li class="menuitem">
+<a href="../index.html" title="">Dispatcher development</a>
+</li>
+<li class="pagegroupselected" id="menu_selected_1.1.2Title">
+<span onclick="SwitchMenu('menu_selected_1.1.2')">How to</span>
+<ul class="&#10;               selectedmenuitemgroup" id="menu_selected_1.1.2">
+<li class="menuitem">
 <a href="../how/howto-dispatcher-quickstart.html" title="">Quickstart</a>
 </li>
 <li class="menuitem">
@@ -133,6 +137,23 @@
 </li>
 <li class="menupage">
 <div class="menupagetitle">Contracts</div>
+</li>
+</ul>
+</li>
+<li class="menuitem">
+<a href="../dispatcher-glossary.html" title="Dispactcher related terms and meanings">(FIXME: add content) Glossary</a>
+</li>
+<li class="menuitem">
+<a href="../index.old.html" title="(FIXME: old) index">(FIXME: old) Index</a>
+</li>
+<li class="menuitem">
+<a href="../how/howItWork.html" title="(FIXME: old) howItWorks">(FIXME: old) howItWorks</a>
+</li>
+<li class="menuitem">
+<a href="../changes.html" title="History of Changes">Changes</a>
+</li>
+<li class="menuitem">
+<a href="../todo.html" title="Todo List">Todo</a>
 </li>
 </ul>
 </li>

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-dsl.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-dsl.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-dsl.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-dsl.html Sat Aug  5 14:21:49 2006
@@ -101,11 +101,8 @@
 <div id="nav-main-hook">
 <!--+ |start Tabs new +-->
 <ul id="nav-main">
-<li>
-<a class="base-not-selected" href="../index.html">Home</a>
-</li>
 <li class="current">
-<a class="base-selected" href="../how/howto-dispatcher-quickstart.html">HowTo</a>
+<a class="base-selected" href="../index.html">Home</a>
 </li>
 </ul>
 <!--+ |end Tabs +-->
@@ -125,9 +122,15 @@
 <div id="nav-section">
 <ul>
 <li class="pagegroupselected" id="menu_selected_1.1Title">
-<span onclick="SwitchMenu('menu_selected_1.1')">How to</span>
+<span onclick="SwitchMenu('menu_selected_1.1')">About</span>
 <ul class="&#10;               selectedmenuitemgroup" id="menu_selected_1.1">
 <li class="menuitem">
+<a href="../index.html" title="">Dispatcher development</a>
+</li>
+<li class="pagegroupselected" id="menu_selected_1.1.2Title">
+<span onclick="SwitchMenu('menu_selected_1.1.2')">How to</span>
+<ul class="&#10;               selectedmenuitemgroup" id="menu_selected_1.1.2">
+<li class="menuitem">
 <a href="../how/howto-dispatcher-quickstart.html" title="">Quickstart</a>
 </li>
 <li class="menupage">
@@ -138,6 +141,23 @@
 </li>
 </ul>
 </li>
+<li class="menuitem">
+<a href="../dispatcher-glossary.html" title="Dispactcher related terms and meanings">(FIXME: add content) Glossary</a>
+</li>
+<li class="menuitem">
+<a href="../index.old.html" title="(FIXME: old) index">(FIXME: old) Index</a>
+</li>
+<li class="menuitem">
+<a href="../how/howItWork.html" title="(FIXME: old) howItWorks">(FIXME: old) howItWorks</a>
+</li>
+<li class="menuitem">
+<a href="../changes.html" title="History of Changes">Changes</a>
+</li>
+<li class="menuitem">
+<a href="../todo.html" title="Todo List">Todo</a>
+</li>
+</ul>
+</li>
 </ul>
 </div>
 <!--+ |end menu +-->
@@ -243,6 +263,45 @@
       developing. Many instructions assumes that you have the forrestbar 
       installed. </div>
 </div>
+<p> We developed<strong> the structurer</strong> to let the user decide 
+      where to place elements in e.g. html pages. We started this work with the 
+      <span class="codefrag">skinconf.xml</span> where you could configure certain elements and 
+      their positions. These elements were known under certain names. It was up 
+      to the skin designer to support this configuration and the elements. </p>
+<p> The work started with grouping elements (the ones from skinconf). We 
+      used css-contracts that we added as @attributes e.g. <span class="codefrag">&lt;div id="content-main"/&gt;
+       </span>. That made it possible to use the same elements in different 
+      skins. For the full list refer to the <a href="http://svn.apache.org/repos/asf/forrest/trunk/main/webapp/skins/leather-dev/contracts.initial.txt"> 
+      initial contract list </a> </p>
+<p> Around this contracts we developed a configuration Domain Specific 
+      Language - called <strong>the structurer</strong>. The 
+      <strong>structurer</strong> allows us to define the order in which 
+      <strong>forrest:contract</strong>s appear, and also to group them using 
+      <strong>forrest:hook</strong>s. </p>
+<p> <strong>forrest:hook</strong>s are containers that are only used for 
+      layout reasons. They <strong>do not</strong> add any content nor 
+      functionality to the output. They add <strong>only</strong> layout 
+      information to the output. Actually e.g. a <span class="codefrag">&lt;forrest:hook name="layoutId"/&gt;
+      </span> will be transformed to <span class="codefrag">&lt;div id="layoutId"/&gt; 
+      </span> </p>
+<p> <strong>forrest:contract</strong>s are functionality or extra content 
+      that a theme can use to display the request. Sometimes a contract 
+      delivers <strong>format-specific markup</strong>, other times it delivers 
+      a <strong>format-independent string</strong>. We decide different kind of 
+      contracts, static one (like described in the contract howto), semi static 
+      (which offer configuration parameter in the structurer) and dynamic 
+      contracts (which offer semi-static configuration and/or requesting the 
+      content).  </p>
+<div class="note">
+<div class="label">Note</div>
+<div class="content"> The structurer is as well a configuration file for the dispatcher. 
+        The new think on the dispatcher is that one can include any content 
+        from any given business service by dispatching a request against it. In 
+        "old fashion" skins and in v1 contracts we assumed a given data model. 
+        In the dispatcher there is <strong>no</strong> given data model any 
+        more. All data has to be defined in the structurer that they can be 
+        dispatched. </div>
+</div>
 <a name="emptystructurer" title="Empty structurer file"> </a>
 <h3 class="underlined_5">Empty structurer file</h3>
 <pre class="code">&lt;forrest:views 
@@ -262,17 +321,19 @@
 <div class="label">Warning</div>
 <div class="content"> The structurer is based on jx templates to allow simple 
         presentation logic (all code starting with "jx:"). Please refer to the 
-        cocoon documentation about jx. </div>
+        cocoon documentation about jx. For now we are using jx to 
+        include the raw data into the presentation model and generating an 
+        alias-xsl stylesheet. That is heavy on performance and we will change 
+        this ASAP. Mind the warning at the start of the howto. </div>
 </div>
 <p> In this section we will create a new structurer. We will override the 
-        default structurer of the core themes for the index page of a new seed. 
-        For that we will create a file called <span class="codefrag">index.fv</span> and save it 
-        in the directory <span class="codefrag">{project:resources}/structurer/url</span> 
-        (create it if needed). This will make <strong>only</strong> the 
-        index.html page look different from the rest of the project. </p>
+        default structurer of the themer-plugin for the index page of the new seed. For that we will create a 
+        file called <span class="codefrag">index.fv</span> and save it in our xdocs directory. 
+        This will make <strong>only</strong> the index.html page look different 
+        from the rest of the project. </p>
 <div class="note">
-<div class="label">RecursiveDirectoryTraversalAction</div>
-<div class="content"> You can set a view for an individual file, a directory, or the whole site. To address multiple files in a directory call your  <span class="codefrag">.fv</span> file <span class="codefrag">common.fv</span>. If Forrest doesn't find a <span class="codefrag">.fv</span> file with the same name as the current file it will use the common.fv file in that directory, or the first one it finds going upwards through the directory structure. 
+<div class="label">Note</div>
+<div class="content">You can set a view for an individual file, a directory, or the whole site. To address multiple files in a directory call your  <span class="codefrag">.fv</span> file <span class="codefrag">common.fv</span>. If Forrest doesn't find a <span class="codefrag">.fv</span> file with the same name as the current file it will use the common.fv file in that directory, or the first one it finds going upwards through the directory structure. 
 	<span class="codefrag">common.fv</span> files affect all subdirectories unless they are overidden by another <span class="codefrag">common.fv</span> or a file-specific <span class="codefrag">foo.fv</span> file. 
 	</div>
 </div>

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-dsl.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/how/howto-structurer-dsl.pdf?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
Binary files - no diff available.

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.html Sat Aug  5 14:21:49 2006
@@ -16,7 +16,7 @@
 }</style>
       <meta content="Apache Forrest" name="Generator" />
 <meta content="0.8" name="Forrest-version" />
-<meta content="pelt" name="Forrest-theme-name" />
+<meta content="${project.theme}" name="Forrest-theme-name" />
 <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
 <!--+ |start navigation links +-->
 <link href="index.html" rel="Index" title="Index..." />
@@ -105,6 +105,9 @@
 <li>
 <a class="base-not-selected" href="how/howto-dispatcher-quickstart.html">HowTo</a>
 </li>
+<li>
+<a class="base-not-selected" href="int/index.html">internals</a>
+</li>
 </ul>
 <!--+ |end Tabs +-->
 <div id="publishedStrip"> <!--+
@@ -150,6 +153,14 @@
 </li>
 <li class="menuitem">
 <a href="how/howto-dispatcher-contracts.html" title="">Contracts</a>
+</li>
+</ul>
+</li>
+<li class="pagegroup" id="menu_1.3Title">
+<span onclick="SwitchMenu('menu_1.3')">Internals</span>
+<ul class="menuitemgroup" id="menu_1.3">
+<li class="menuitem">
+<a href="int/index.html" title="">Overview</a>
 </li>
 </ul>
 </li>

Added: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.dispatcher.css
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.dispatcher.css?rev=429057&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.dispatcher.css (added)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.dispatcher.css Sat Aug  5 14:21:49 2006
@@ -0,0 +1,45 @@
+
+/* branding-theme-profiler-theme: Pelt */ 
+#header .round-top-left-small {
+    background-image: url(themes/images/roundcorner-t-l-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top left;
+}
+#header .round-top-right-small {
+    background-image: url(themes/images/roundcorner-t-r-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top right;
+}
+#nav-main li {
+    background-image: url(themes/images/roundcorner-t-r-5-bg294563-strokeCEDFEF-fgCEDFEF.png);
+    background-repeat: no-repeat;
+    background-position: top right;
+}
+#nav-main li a {
+    background-image: url(themes/images/roundcorner-t-l-5-bg294563-strokeCEDFEF-fgCEDFEF.png);
+    background-repeat: no-repeat;
+    background-position: top left;
+}
+#nav-main .current {
+    background-image: url(themes/images/roundcorner-t-r-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top right;
+}
+#nav-main .current a {
+    background-image: url(themes/images/roundcorner-t-l-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top left;
+}
+#roundbottom {
+    background-image: url(themes/images/roundcorner-b-r-15-bgffffff-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: bottom right;
+}
+#roundbottomLeft {
+    background-image: url(themes/images/roundcorner-b-l-15-bgffffff-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: bottom left;
+}
+            
+  
+  

Propchange: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.dispatcher.css
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.html?rev=429057&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.html (added)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.html Sat Aug  5 14:21:49 2006
@@ -0,0 +1,350 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+        <link href="themes/common.css" media="screen" rel="alternate stylesheet" title="common" type="text/css" />
+        <link href="themes/leather-dev.css" media="screen" rel="alternate stylesheet" title="common" type="text/css" />
+        <link href="themes/pelt.screen.css" media="screen" rel="stylesheet" title="Pelt" type="text/css" />
+        
+        <link href="index.old.dispatcher.css" media="screen" rel="stylesheet" title="Pelt" type="text/css" />
+        <link href="themes/pelt.print.css" media="print" rel="stylesheet" title="pelt.print.css" type="text/css" />
+        <style type="text/css">/* Extra css */ 
+p.quote {
+ margin-left: 2em; 
+ padding: .5em; 
+ background-color: #f0f0f0; 
+ font-family: monospace; 
+}</style>
+      <meta content="Apache Forrest" name="Generator" />
+<meta content="0.8-dev" name="Forrest-version" />
+<meta content="pelt" name="Forrest-theme-name" />
+<meta content="text/html; charset=UTF-8" http-equiv="content-type" />
+<!--+ |start navigation links +-->
+<link href="index.html" rel="Index" title="Index..." />
+<link href="linkmap.html" rel="CONTENTS" title="Site map..." />
+<link href="how/howItWork.html" rel="NEXT" title="(FIXME: old) howItWorks" />
+<link href="dispatcher-glossary.html" rel="PREVIOUS" title="(FIXME: add content) Glossary" />
+<link href="todo.html" rel="LAST" title="Todo" />
+<link href="index.html" rel="FIRST" title="Dispatcher development" />
+<!--+ |end navigation links +-->
+<!--+|start favicon +-->
+<link href="favicon.ico" rel="shortcut icon" />
+<!--+|start favicon +-->
+<script src="themes/getBlank.js" type="text/javascript"> </script>
+<script src="themes/menu.js" type="text/javascript"> </script>
+<!--+ |start content-title +-->
+<title>forrest:views - x output formats, one config</title>
+<!--+ |end content-title +-->
+</head>
+<body>
+<div id="container">
+<!--+
+    | start breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">MyGroup</a>
+                   &gt; <a href="http://forrest.apache.org/">MyProject</a>
+<script src="themes/breadcrumbs.js" type="text/javascript"> </script>
+</div>
+<!--+
+    | end breadtrail
+    +-->
+<div id="header">
+<div id="branding-tagline-name">new 
+            seed</div>
+<div id="branding-tagline-tagline">powered by the 
+            dispatcher</div>
+<div class="logo">
+<!--+
+    |start Logo
+    +-->
+<a href="http://mygroup.org/">
+<img alt="MyGroup" class="logoImage" src="images/group.png" title="MyGroup Description" />
+</a>
+<!--+
+    |end group Logo
+    +-->
+</div>
+<div class="logo">
+<!--+
+    |start Logo
+    +-->
+<a href="http://myproj.mygroup.org/">
+<img alt="MyProject" class="logoImage" src="images/project.png" title="MyProject Description" />
+</a>
+<!--+
+    |end group Logo
+    +-->
+</div>
+<!--+
+  |start Search
+  +-->
+<div class="searchbox">
+<div class="round-top-left-small">
+<div class="round-top-right-small">
+<div class="search-input">
+<form action="http://www.google.com/search" method="get">
+<div class="search-hidden">
+<input name="sitesearch" type="hidden" value="mydomain" />
+</div>
+<div class="search-field">
+<input name="q" size="25" type="text" value="Search the site with google" />
+</div>
+<div class="search-submit">
+<input name="Search" type="submit" value="Search" />
+</div>
+</form>
+</div>
+</div>
+</div>
+</div>
+<!--+ |end search +-->
+<div id="nav-main-hook">
+<!--+ |start Tabs new +-->
+<ul id="nav-main">
+<li class="current">
+<a class="base-selected" href="index.html">Home</a>
+</li>
+</ul>
+<!--+ |end Tabs +-->
+<div id="publishedStrip"> <!--+
+    |start nav-main-sub
+    +--><!--+
+    |end Endtabs
+    +--><script type="text/javascript">document.write("Last Published: " + document.lastModified);</script>
+</div>
+</div>
+</div>
+<div id="page">
+<div class="breadtrail"> </div>
+<div id="leftbar">
+<!--+ |start 0 menu +-->
+<!--+ |start Menu +-->
+<div id="nav-section">
+<ul>
+<li class="pagegroupselected" id="menu_selected_1.1Title">
+<span onclick="SwitchMenu('menu_selected_1.1')">About</span>
+<ul class="&#10;               selectedmenuitemgroup" id="menu_selected_1.1">
+<li class="menuitem">
+<a href="index.html" title="">Dispatcher development</a>
+</li>
+<li class="pagegroup" id="menu_1.1.2Title">
+<span onclick="SwitchMenu('menu_1.1.2')">How to</span>
+<ul class="menuitemgroup" id="menu_1.1.2">
+<li class="menuitem">
+<a href="how/howto-dispatcher-quickstart.html" title="">Quickstart</a>
+</li>
+<li class="menuitem">
+<a href="how/howto-structurer-dsl.html" title="">Structurer</a>
+</li>
+<li class="menuitem">
+<a href="how/howto-structurer-contracts.html" title="">Contracts</a>
+</li>
+</ul>
+</li>
+<li class="menuitem">
+<a href="dispatcher-glossary.html" title="Dispactcher related terms and meanings">(FIXME: add content) Glossary</a>
+</li>
+<li class="menupage">
+<div class="menupagetitle">(FIXME: old) Index</div>
+</li>
+<li class="menuitem">
+<a href="how/howItWork.html" title="(FIXME: old) howItWorks">(FIXME: old) howItWorks</a>
+</li>
+<li class="menuitem">
+<a href="changes.html" title="History of Changes">Changes</a>
+</li>
+<li class="menuitem">
+<a href="todo.html" title="Todo List">Todo</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<!--+ |end menu +-->
+<!--+ |start content-motd-page +-->
+<!--+ |end content-motd-page +-->
+<div id="roundbottom">
+<div id="roundbottomLeft">
+<img alt="spacer" src="themes/images/spacer.gif" />
+</div>
+</div>
+</div>
+<div id="export-link">
+<a class="format" href="index.old.pdf">
+<img alt="PDF - icon" class="skin" src="themes/images/pdfdoc.gif" />
+<span class="caption">PDF</span>
+</a>
+</div>
+<div id="content">
+<!--+ |start content-title +-->
+<h1 class="content-title">forrest:views - x output formats, one config</h1>
+<!--+ |end content-title +-->
+<!--+ |start content-abstract +-->This plugin depends on a ViewHelper and a BusinessHelper implementation.<!--+ |end content-abstract +--><!--+ |start content-minitoc +--><div id="content-minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#view">view</a>
+</li>
+<li>
+<a href="#viewHelper">viewHelper</a>
+</li>
+<li>
+<a href="#BusinessHelper">BusinessHelper </a>
+</li>
+<li>
+<a href="#links">links</a>
+</li>
+</ul>
+</div>
+<!--+ |end minitoc +-->
+<!--+ |start content-main +-->
+<a name="view" title="view"> </a>
+<h2 class="underlined_10">view</h2>
+<div class="section">
+<p>Together with the ViewHelper and the BusinessHelper (to be implemented) 
+        plugin this plugin is following the <a href="http://java.sun.com/j2ee/patterns/DispatcherView.html">DispatcherView pattern</a> 
+        and building the final view which will be delivered to the client. This implementation follows exactly the pattern shown on 
+          <a href="http://corej2eepatterns.com/Patterns2ndEd/DispatcherView.htm">corej2eepatterns.com</a>
+        </p>
+<p>
+        A view will be configured by a config file 
+        which basically contains the following tags (it is still evolving): </p>
+<pre class="code">&lt;forrest:view type="xhtml"&gt;
+  &lt;forrest:css url="common.css"/&gt;
+  &lt;forrest:contract name="meta"/&gt;
+  &lt;forrest:hook name="container"&gt;
+   &lt;forrest:contract name="feedback"/&gt;
+  &lt;/forrest:hook /&gt;
+&lt;/forrest:view&gt;</pre>
+<p>The view tag's @type determines the final output format. The idea is to
+configure different output formats within a forrest:views. That means a forrest:views 
+can contain n different "forrest:view" configurations for n different formats. <br />
+In short: x formats, one config. :)</p>
+<pre class="code">&lt;forrest:views
+  xmlns:forrest="http://apache.org/forrest/templates/1.0"&gt;
+&lt;forrest:view type="xhtml"&gt;
+  &lt;forrest:css url="common.css"/&gt;
+  &lt;forrest:contract name="meta"/&gt;
+  &lt;forrest:hook name="container"&gt;
+   &lt;forrest:contract name="feedback"/&gt;
+  &lt;/forrest:hook /&gt;
+&lt;/forrest:view&gt;
+&lt;forrest:view type="fo"&gt;
+  &lt;forrest:hook name="container"&gt;
+   &lt;forrest:contract name="feedback"/&gt;
+  &lt;/forrest:hook /&gt;
+&lt;/forrest:view&gt;
+/forrest:views&gt;</pre>
+</div>
+<a name="viewHelper" title="viewHelper"> </a>
+<h2 class="underlined_10">viewHelper</h2>
+<div class="section">
+<p>viewHelper class/implementation - a class/implementation which will
+access the presentation model and transform its models. In other words
+it is a presentation producing factory.
+</p>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">The &lt;forrest:contract name="nav-main"/&gt; expects a certain model
+(now produced by leather-dev - tab2menu.xsl) to transform it. In the
+future this dependency will be on a businessHelper implementation that
+has to be defined in the view. For now it depends on leather-dev. I
+guess leather-dev is still not dead till the businessHelper plugin comes
+(which will implement the businessHelper of leather-dev). ;-)</div>
+</div>
+<p>
+Each forrest:css will be transformed into a &lt;link rel="stylesheet" type="text/css" url="{$root}skin/{url}"&gt; tag (in html
+output [only format that has an implementation]). 
+This tags are designed to help <strong>web-designers</strong> to freely implemend their own css-implementations for a view.
+</p>
+<p>
+Each forrest:hook will be transformed into a &lt;div/&gt; tag (in html
+output [only format that has an implementation]). 
+This tags are designed to help <strong>web-designers</strong> to freely move
+around and group contracts into design container.
+</p>
+<p>Each forrest:contract will dispatch a xml file (ViewHelper) that contains
+xsl:stylesheets (for now, but other implementations to transform the presentation
+ model are/should be possible) for the different output formats of a contract.
+  For html, the only format that we have implemented so far, we
+have three different kind of templates:</p>
+<p>
+&lt;xsl:templates name="{contract/@name}-css/&gt;<br />
+Here the contract specific css will be stored.
+</p>
+<p>
+&lt;xsl:templates name="{contract/@name}-head/&gt;<br />
+Here goes everything that belongs in the html head. e.g. scripts.
+</p>
+<p>
+&lt;xsl:templates name="{contract/@name}-body/&gt;<br />
+Everything that belongs into the body.
+  </p>
+</div>
+<a name="BusinessHelper" title="BusinessHelper "> </a>
+<h2 class="underlined_10">BusinessHelper </h2>
+<div class="section">
+<p>
+<strong>businessHelper class/implementation </strong>- a class/implementation which will
+access businessServices to produce models for the presentation model. In
+other word it is a data producing factory.
+</p>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">Right now we are using the default forrest businessHelper (defined
+by the skin you are using). There are contracts that depend on a
+businessHelper implementation of leather-dev (tab2menu.xsl, site2xhtml.xsl,...). 
+We will create a businessHelper plugin to overcome this problem.</div>
+</div>
+<p>Right now it is implemented for the forrest way of producing the models
+for the view but we will create an independent BusinessHelper to
+access all BusinessServices you may have in your application. </p>
+</div>
+<a name="links" title="links"> </a>
+<h2 class="underlined_10">links</h2>
+<div class="section">
+<div class="note">
+<div class="label">Note</div>
+<div class="content">There are/were lots of mails on the dev-list. Please, search the list</div>
+</div>
+<p>Background mailings around the views concept</p>
+<ul>
+        <li>
+<a href="http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=110019697426791&amp;w=2">[RT] plugin infrastructure</a> </li>
+        <li>
+<a href="http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=109959086204887&amp;w=2">[RT] Forrest templates for second generation skining - towards Corium</a> </li>
+      </ul>
+</div>
+<!--+ |end content-main +-->
+</div>
+</div>
+<div id="footer">
+<div class="lastmodified">
+<script type="text/javascript">document.write("Last Published: " + document.lastModified);</script>
+</div>
+<div class="copyright">
+            Copyright ©
+             2002-2006 <a href="http://www.acme.org/licenses/">The Acme Software Organisation.</a> </div>
+<!--+ |start compliance links +-->
+<div id="siteinfo-compliance-links">
+<a href="http://validator.w3.org/check?uri=referer">
+<img alt="Valid XHTML 1.0!" height="31" src="http://www.w3.org/Icons/valid-xhtml10" width="88" />
+</a>
+<a href="http://jigsaw.w3.org/css-validator/check/referer">
+<img alt="Valid CSS!" src="http://jigsaw.w3.org/css-validator/images/vcss" style="border:0;width:88px;height:31px" />
+</a>
+</div>
+<!--+ |end compliance links +-->
+<!-- |start siteinfo-credits -->
+<div id="credit">
+<a href="http://forrest.apache.org/">
+<img alt="Built with Apache Forrest - logo" src="images/built-with-forrest-button.png" style="width: 88px;height: 31px;" title="Built with Apache Forrest" />
+</a>
+<a href="http://cocoon.apache.org/">
+<img alt="Built with Cocoon - logo" src="&#10;                  http://forrest.apache.org/images/built-with-cocoon.gif" style="" title="Built with Cocoon" />
+</a>
+</div>
+<!--+ |end siteinfo-credits +-->
+</div>
+</div>
+</body>
+</html>

Propchange: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.pdf?rev=429057&view=auto
==============================================================================
Binary file - no diff available.

Propchange: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/index.old.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf

Added: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.dispatcher.css
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.dispatcher.css?rev=429057&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.dispatcher.css (added)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.dispatcher.css Sat Aug  5 14:21:49 2006
@@ -0,0 +1,45 @@
+
+/* branding-theme-profiler-theme: Pelt */ 
+#header .round-top-left-small {
+    background-image: url(../themes/images/roundcorner-t-l-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top left;
+}
+#header .round-top-right-small {
+    background-image: url(../themes/images/roundcorner-t-r-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top right;
+}
+#nav-main li {
+    background-image: url(../themes/images/roundcorner-t-r-5-bg294563-strokeCEDFEF-fgCEDFEF.png);
+    background-repeat: no-repeat;
+    background-position: top right;
+}
+#nav-main li a {
+    background-image: url(../themes/images/roundcorner-t-l-5-bg294563-strokeCEDFEF-fgCEDFEF.png);
+    background-repeat: no-repeat;
+    background-position: top left;
+}
+#nav-main .current {
+    background-image: url(../themes/images/roundcorner-t-r-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top right;
+}
+#nav-main .current a {
+    background-image: url(../themes/images/roundcorner-t-l-5-bg294563-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: top left;
+}
+#roundbottom {
+    background-image: url(../themes/images/roundcorner-b-r-15-bgffffff-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: bottom right;
+}
+#roundbottomLeft {
+    background-image: url(../themes/images/roundcorner-b-l-15-bgffffff-stroke4a6d8c-fg4a6d8c.png);
+    background-repeat: no-repeat;
+    background-position: bottom left;
+}
+            
+  
+  

Propchange: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.dispatcher.css
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.html?rev=429057&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.html (added)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.html Sat Aug  5 14:21:49 2006
@@ -0,0 +1,343 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+        <link href="../themes/common.css" media="screen" rel="alternate stylesheet" title="common" type="text/css" />
+        <link href="../themes/leather-dev.css" media="screen" rel="alternate stylesheet" title="common" type="text/css" />
+        <link href="../themes/pelt.screen.css" media="screen" rel="stylesheet" title="Pelt" type="text/css" />
+        
+        <link href="../int/index.dispatcher.css" media="screen" rel="stylesheet" title="Pelt" type="text/css" />
+        <link href="../themes/pelt.print.css" media="print" rel="stylesheet" title="pelt.print.css" type="text/css" />
+        <style type="text/css">/* Extra css */ 
+p.quote {
+ margin-left: 2em; 
+ padding: .5em; 
+ background-color: #f0f0f0; 
+ font-family: monospace; 
+}</style>
+      <meta content="Apache Forrest" name="Generator" />
+<meta content="0.8" name="Forrest-version" />
+<meta content="${project.theme}" name="Forrest-theme-name" />
+<meta content="text/html; charset=UTF-8" http-equiv="content-type" />
+<!--+ |start navigation links +-->
+<link href="../index.html" rel="Index" title="Index..." />
+<link href="../linkmap.html" rel="CONTENTS" title="Site map..." />
+<!--+ |end navigation links +-->
+<!--+|start favicon +-->
+<link href="../favicon.ico" rel="shortcut icon" />
+<!--+|start favicon +-->
+<script src="../themes/getBlank.js" type="text/javascript"> </script>
+<script src="../themes/menu.js" type="text/javascript"> </script>
+<!--+ |start content-title +-->
+<title>Living on the edge.</title>
+<!--+ |end content-title +-->
+</head>
+<body>
+<div id="container">
+<!--+
+    | start breadtrail
+    +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">MyGroup</a>
+                   &gt; <a href="http://forrest.apache.org/">MyProject</a>
+<script src="../themes/breadcrumbs.js" type="text/javascript"> </script>
+</div>
+<!--+
+    | end breadtrail
+    +-->
+<div id="header">
+<div id="branding-tagline-name">new 
+            seed</div>
+<div id="branding-tagline-tagline">powered by the 
+            dispatcher</div>
+<div class="logo">
+<!--+
+    |start Logo
+    +-->
+<a href="http://mygroup.org/">
+<img alt="MyGroup" class="logoImage" src="../images/group.png" title="MyGroup Description" />
+</a>
+<!--+
+    |end group Logo
+    +-->
+</div>
+<div class="logo">
+<!--+
+    |start Logo
+    +-->
+<a href="http://myproj.mygroup.org/">
+<img alt="MyProject" class="logoImage" src="../images/project.png" title="MyProject Description" />
+</a>
+<!--+
+    |end group Logo
+    +-->
+</div>
+<!--+
+  |start Search
+  +-->
+<div class="searchbox">
+<div class="round-top-left-small">
+<div class="round-top-right-small">
+<div class="search-input">
+<form action="http://www.google.com/search" method="get">
+<div class="search-hidden">
+<input name="sitesearch" type="hidden" value="mydomain" />
+</div>
+<div class="search-field">
+<input name="q" size="25" type="text" value="Search the site with google" />
+</div>
+<div class="search-submit">
+<input name="Search" type="submit" value="Search" />
+</div>
+</form>
+</div>
+</div>
+</div>
+</div>
+<!--+ |end search +-->
+<div id="nav-main-hook">
+<!--+ |start Tabs new +-->
+<ul id="nav-main">
+<li>
+<a class="base-not-selected" href="../index.html">Home</a>
+</li>
+<li>
+<a class="base-not-selected" href="../how/howto-dispatcher-quickstart.html">HowTo</a>
+</li>
+<li class="current">
+<a class="base-selected" href="../int/index.html">internals</a>
+</li>
+</ul>
+<!--+ |end Tabs +-->
+<div id="publishedStrip"> <!--+
+    |start nav-main-sub
+    +--><!--+
+    |end Endtabs
+    +--><script type="text/javascript">document.write("Last Published: " + document.lastModified);</script>
+</div>
+</div>
+</div>
+<div id="page">
+<div class="breadtrail"> </div>
+<div id="leftbar">
+<!--+ |start 0 menu +-->
+<!--+ |start Menu +-->
+<div id="nav-section">
+<ul>
+<li class="pagegroupselected" id="menu_selected_1.1Title">
+<span onclick="SwitchMenu('menu_selected_1.1')">Internals</span>
+<ul class="&#10;               selectedmenuitemgroup" id="menu_selected_1.1">
+<li class="menupage">
+<div class="menupagetitle">Overview</div>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<!--+ |end menu +-->
+<!--+ |start content-motd-page +-->
+<!--+ |end content-motd-page +-->
+<div id="roundbottom">
+<div id="roundbottomLeft">
+<img alt="spacer" src="../themes/images/spacer.gif" />
+</div>
+</div>
+</div>
+<div id="export-link">
+<a class="format" href="index.pdf">
+<img alt="PDF - icon" class="skin" src="../themes/images/pdfdoc.gif" />
+<span class="caption">PDF</span>
+</a>
+</div>
+<div id="content">
+<!--+ |start content-title +-->
+<h1 class="content-title">Living on the edge.</h1>
+<!--+ |end content-title +-->
+<!--+ |start content-abstract +-->
+<!--+ |end content-abstract +-->
+<!--+ |start content-minitoc +-->
+<div id="content-minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#introduction">Introduction</a>
+</li>
+<li>
+<a href="#fpx">forrest.properties.xml</a>
+</li>
+<li>
+<a href="#lm">locationmap.xml</a>
+<ul class="minitoc">
+<li>
+<a href="#handson">Hands on the lm</a>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<!--+ |end minitoc +-->
+<!--+ |start content-main +-->
+<a name="introduction" title="Introduction"> </a>
+<h2 class="underlined_10">Introduction</h2>
+<div class="section">
+<p> Since the dispatcher is in the whiteboard, we can afford to use the 
+        latest features available in forrest. This helps to test these new 
+        features and to be prepared for the future when this feature is 
+        standard.</p>
+</div>
+<a name="fpx" title="forrest.properties.xml"> </a>
+<h2 class="underlined_10">forrest.properties.xml</h2>
+<div class="section">
+<p> We needed to prevent having references from the core to a plugin. 
+        This can be done with the new properties system. You can override any 
+        of the following values via a <span class="codefrag">forrest.properties.xml</span> in your 
+        project.</p>
+<pre class="code">  &lt;property name="dispatcher.theme" value="pelt"/&gt;
+  &lt;property name="dispatcher.fallback.theme" value="common"/&gt;
+  &lt;property name="dispatcher.theme-ext" value=".fv"/&gt;
+  &lt;property name="dispatcher.fallback.theme-ext" value=".fv"/&gt;
+  &lt;property name="dispatcher.themer" value="org.apache.forrest.themes.core"/&gt;
+  &lt;property name="dispatcher.home" value="org.apache.forrest.plugin.internal.dispatcher"/&gt;
+      </pre>
+</div>
+<a name="lm" title="locationmap.xml"> </a>
+<h2 class="underlined_10">locationmap.xml</h2>
+<div class="section">
+<p> One of the main features of the dispatcher is its fallback mechanism. 
+        We are not only looking into one or two places but a sophisticated list 
+        of locations. These locations are defined in the locationmap.xml. Like 
+        with the forrest.properties.xml you can override any match in there by 
+        implementing it in your project locationmap.xml.</p>
+<a name="handson" title="Hands on the lm"> </a>
+<h3 class="underlined_5">Hands on the lm</h3>
+<p>The resolving process of the structurer responsible for the URL 
+            has implemented a high amount of fallbacks. Let us have a look.</p>
+<pre class="code">&lt;match pattern="resolve.structurer.**"&gt;
+  &lt;!-- 
+      FIXME - Problem with the pattern
+      ********************************
+      We have encountered a strange problem with the pattern 'resolve.structurer.**'.
+      The {1} sometimes matches nothing, whereas {../1} is OK.
+      On the contrary, the {../1} sometimes matches nothing, whereas {1} is OK.
+      As a temporary workaround, we put {../1}{1} which covers all the cases.
+      CF. FOR-893
+      
+      structurer templating
+      *********************
+      URL specific structurer templates (project-based) e.g. index.fv
+      * either in the structurer/url
+      * or in the xdocs dir [depreciated]
+      have priority *before* 
+      
+      a) sourcetype based e.g. document-v20.fv
+      b) resourceTypeAction based on meta data e.g. xhtml.fv
+      (demonstrates lenya meta data integration for DOCO)
+      c) RecursiveDirectoryTraversalAction e.g. samples/common.fv
+      c1) url dir
+      c2) xdocs dir [depreciated]
+     
+      If no structurer template can be found in the project, 
+      we use either the templates provided by the
+      a) custom implementation of the themes.core plugin
+      b) themes.core plugin
+      where we test for 
+      1) {project:dispatcher.theme}{project:dispatcher.theme-ext}
+      2) {project:dispatcher.fallback.theme}{project:dispatcher.fallback.theme-ext}
+      --&gt;
+  &lt;select type="exists"&gt;
+    &lt;!-- project-based 
+          url-based (url location) --&gt;
+    &lt;location 
+      src="{project:resources}/structurer/url/{1}{project:dispatcher.theme-ext}" 
+      /&gt;
+    &lt;!-- project-based 
+          url-based (xdocs location)  [depreciated]--&gt;
+    &lt;location src="{project:content.xdocs}{1}{project:dispatcher.theme-ext}" /&gt;
+    &lt;act type="sourcetype" src="{project:content.xdocs}{1}.xml"&gt;
+      &lt;!-- Sourcetype based 
+          http://forrest.apache.org/docs/cap.html--&gt;
+      &lt;location src="lm://dispatcher.structurer.resourceType.{sourcetype}" /&gt;
+    &lt;/act&gt;
+    &lt;act type="resourceTypeAction"&gt;
+      &lt;parameter value="{../1}{1}" name="request"/&gt;
+      &lt;parameter value="{project:content.xdocs}" name="projectDir"/&gt;
+      &lt;parameter value="lm://dispatcher.structurer.resourceType." 
+        name="resourceTypeBase"/&gt;
+      &lt;parameter value=".xml.meta" name="metaExtension"/&gt;
+      &lt;parameter value="resourceType" name="resourceTypeElement"/&gt;
+      &lt;parameter value="http://apache.org/cocoon/lenya/page-envelope/1.0" 
+        name="resourceTypeElementNS"/&gt;
+      &lt;!--  Meta data based --&gt;
+      &lt;location src="{uri}" /&gt;
+    &lt;/act&gt;
+    &lt;act type="RecursiveDirectoryTraversalAction"&gt;
+      &lt;parameter value="{../1}{1}" name="request"/&gt;
+      &lt;parameter value="{project:dispatcher.theme}" name="projectFallback"/&gt;
+      &lt;parameter value="{project:dispatcher.theme-ext}" 
+        name="projectExtension"/&gt;
+      &lt;parameter value="{project:resources}structurer/url/" name="projectDir"/&gt;
+      &lt;!--  url
+            project-based theme-based = directory-based / parent-directory based (recursively) --&gt;
+      &lt;location src="{uri}" /&gt;
+    &lt;/act&gt;
+    &lt;act type="RecursiveDirectoryTraversalAction"&gt;
+      &lt;parameter value="{../1}{1}" name="request"/&gt;
+      &lt;parameter value="{project:dispatcher.theme}" name="projectFallback"/&gt;
+      &lt;parameter value="{project:dispatcher.theme-ext}" 
+        name="projectExtension"/&gt;
+      &lt;parameter value="{project:content.xdocs}" name="projectDir"/&gt;
+      &lt;!--  xdocs  [depreciated]
+            project-based theme-based = directory-based / parent-directory based (recursively) --&gt;
+      &lt;location src="{uri}" /&gt;
+    &lt;/act&gt;
+    &lt;!-- themes-dir: project-application-based theme-dir-based --&gt;
+    &lt;location 
+      src="{lm:themer.project.dir}/{project:dispatcher.theme}{project:dispatcher.theme-ext}" 
+      /&gt;
+    &lt;!-- themes-dir: project-application-based default --&gt;
+    &lt;location 
+      src="{lm:themer.project.dir}/{project:dispatcher.fallback.theme}{project:dispatcher.fallback.theme-ext}" 
+      /&gt;
+    &lt;!-- themer: forrest-application-based theme-based --&gt;
+    &lt;location 
+      src="{lm:dispatcher.themer}/themes/{project:dispatcher.theme}{project:dispatcher.theme-ext}" 
+      /&gt;
+    &lt;!-- themer: forrest-application-based default --&gt;
+    &lt;location 
+      src="{lm:dispatcher.themer}/themes/{project:dispatcher.fallback.theme}{project:dispatcher.fallback.theme-ext}" 
+      /&gt;
+  &lt;/select&gt;
+&lt;/match&gt; </pre>
+</div>
+<!--+ |end content-main +-->
+</div>
+</div>
+<div id="footer">
+<div class="lastmodified">
+<script type="text/javascript">document.write("Last Published: " + document.lastModified);</script>
+</div>
+<div class="copyright">
+            Copyright ©
+             2002-2006 <a href="http://www.acme.org/licenses/">The Acme Software Organisation.</a> </div>
+<!--+ |start compliance links +-->
+<div id="siteinfo-compliance-links">
+<a href="http://validator.w3.org/check?uri=referer">
+<img alt="Valid XHTML 1.0!" height="31" src="http://www.w3.org/Icons/valid-xhtml10" width="88" />
+</a>
+<a href="http://jigsaw.w3.org/css-validator/check/referer">
+<img alt="Valid CSS!" src="http://jigsaw.w3.org/css-validator/images/vcss" style="border:0;width:88px;height:31px" />
+</a>
+</div>
+<!--+ |end compliance links +-->
+<!-- |start siteinfo-credits -->
+<div id="credit">
+<a href="http://forrest.apache.org/">
+<img alt="Built with Apache Forrest - logo" src="../images/built-with-forrest-button.png" style="width: 88px;height: 31px;" title="Built with Apache Forrest" />
+</a>
+<a href="http://cocoon.apache.org/">
+<img alt="Built with Cocoon - logo" src="../&#10;                  http://forrest.apache.org/images/built-with-cocoon.gif" style="" title="Built with Cocoon" />
+</a>
+</div>
+<!--+ |end siteinfo-credits +-->
+</div>
+</div>
+</body>
+</html>

Propchange: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.html
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.pdf?rev=429057&view=auto
==============================================================================
Binary file - no diff available.

Propchange: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/int/index.pdf
------------------------------------------------------------------------------
    svn:mime-type = application/pdf

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/linkmap.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/linkmap.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/linkmap.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/linkmap.html Sat Aug  5 14:21:49 2006
@@ -16,7 +16,7 @@
 }</style>
       <meta content="Apache Forrest" name="Generator" />
 <meta content="0.8" name="Forrest-version" />
-<meta content="pelt" name="Forrest-theme-name" />
+<meta content="${project.theme}" name="Forrest-theme-name" />
 <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
 <!--+ |start navigation links +-->
 <link href="index.html" rel="Index" title="Index..." />
@@ -103,6 +103,9 @@
 <li>
 <a class="base-not-selected" href="how/howto-dispatcher-quickstart.html">HowTo</a>
 </li>
+<li>
+<a class="base-not-selected" href="int/index.html">internals</a>
+</li>
 </ul>
 <!--+ |end Tabs +-->
 <div id="publishedStrip"> <!--+
@@ -151,6 +154,14 @@
 </li>
 </ul>
 </li>
+<li class="pagegroup" id="menu_1.3Title">
+<span onclick="SwitchMenu('menu_1.3')">Internals</span>
+<ul class="menuitemgroup" id="menu_1.3">
+<li class="menuitem">
+<a href="int/index.html" title="">Overview</a>
+</li>
+</ul>
+</li>
 </ul>
 </div>
 <!--+ |end menu +-->
@@ -238,6 +249,18 @@
     <ul>
 <li>
 <a href="how/howto-dispatcher-contracts.html">Contracts</a>   _________________________  <em>contracts</em>
+</li>
+</ul>
+  </ul>
+</ul>
+  <ul>
+<li>
+<a href="int/">Internals</a>   _________________________  <em>internals</em>
+</li>
+<ul>
+    <ul>
+<li>
+<a href="int/index.html">Overview</a>   _________________________  <em>index</em>
 </li>
 </ul>
   </ul>

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/linkmap.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/linkmap.pdf?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
Binary files - no diff available.

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/themes/pelt.screen.css
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/themes/pelt.screen.css?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/themes/pelt.screen.css (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/themes/pelt.screen.css Sat Aug  5 14:21:49 2006
@@ -232,9 +232,9 @@
     padding: 5px 15px 4px;
     width: .1em; /* IE/Win fix */
 }
-#nav-main li a:link {  color: #4C6C8F; }
-#nav-main li a:visited { color: #4C6C8F; }
-#nav-main li a:hover { color: #4C6C8F; }
+#nav-main li a:link {  color: #000000; }
+#nav-main li a:visited { color: #000000; }
+#nav-main li a:hover { color: #000000; }
 
 #nav-main > li a { width: auto; } /* Rest of IE/Win fix */
 
@@ -257,9 +257,9 @@
     background-position: top left;
 }
 
-#nav-main .current a:link {  color: #CEDFEF;  }
-#nav-main .current a:visited { color: #CEDFEF; }
-#nav-main .current a:hover { color: #CEDFEF; }
+#nav-main .current a:link {  color: #000000;  }
+#nav-main .current a:visited { color: #000000; }
+#nav-main .current a:hover { color: #000000; }
 
 #publishedStrip {
     position: relative;

Modified: forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/todo.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/todo.html?rev=429057&r1=429056&r2=429057&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/todo.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/todo.html Sat Aug  5 14:21:49 2006
@@ -16,7 +16,7 @@
 }</style>
       <meta content="Apache Forrest" name="Generator" />
 <meta content="0.8" name="Forrest-version" />
-<meta content="pelt" name="Forrest-theme-name" />
+<meta content="${project.theme}" name="Forrest-theme-name" />
 <meta content="text/html; charset=UTF-8" http-equiv="content-type" />
 <!--+ |start navigation links +-->
 <link href="index.html" rel="Index" title="Index..." />
@@ -106,6 +106,9 @@
 <li>
 <a class="base-not-selected" href="how/howto-dispatcher-quickstart.html">HowTo</a>
 </li>
+<li>
+<a class="base-not-selected" href="int/index.html">internals</a>
+</li>
 </ul>
 <!--+ |end Tabs +-->
 <div id="publishedStrip"> <!--+
@@ -151,6 +154,14 @@
 </li>
 <li class="menuitem">
 <a href="how/howto-dispatcher-contracts.html" title="">Contracts</a>
+</li>
+</ul>
+</li>
+<li class="pagegroup" id="menu_1.3Title">
+<span onclick="SwitchMenu('menu_1.3')">Internals</span>
+<ul class="menuitemgroup" id="menu_1.3">
+<li class="menuitem">
+<a href="int/index.html" title="">Overview</a>
 </li>
 </ul>
 </li>