You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by cr...@apache.org on 2006/04/01 05:31:44 UTC
svn commit: r390585 [2/2] - in /forrest/site: ./ docs_0_60/ docs_0_70/
docs_0_80/ docs_0_80/howto/ docs_0_80/howto/multi/ dtdx/
pluginDocs/plugins_0_80/
Added: forrest/site/docs_0_80/howto/howto-dispatcher-install.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-dispatcher-install.html?rev=390585&view=auto
==============================================================================
--- forrest/site/docs_0_80/howto/howto-dispatcher-install.html (added)
+++ forrest/site/docs_0_80/howto/howto-dispatcher-install.html Fri Mar 31 19:31:38 2006
@@ -0,0 +1,511 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+<html>
+<head>
+<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta content="Apache Forrest" name="Generator">
+<meta name="Forrest-version" content="0.8-dev">
+<meta name="Forrest-skin-name" content="pelt">
+<title>How to install the "dispatcher" (v0.8-dev)</title>
+<link type="text/css" href="../../skin/basic.css" rel="stylesheet">
+<link media="screen" type="text/css" href="../../skin/screen.css" rel="stylesheet">
+<link media="print" type="text/css" href="../../skin/print.css" rel="stylesheet">
+<link type="text/css" href="../../skin/profile.css" rel="stylesheet">
+<script src="../../skin/getBlank.js" language="javascript" type="text/javascript"></script><script src="../../skin/getMenu.js" language="javascript" type="text/javascript"></script><script src="../../skin/fontsize.js" language="javascript" type="text/javascript"></script>
+<link rel="shortcut icon" href="../../favicon.ico">
+</head>
+<body onload="init()">
+<script type="text/javascript">ndeSetTextSize();</script>
+<div id="top">
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+<a href="http://www.apache.org/">apache</a> > <a href="http://forrest.apache.org/">forrest</a><script src="../../skin/breadcrumbs.js" language="JavaScript" type="text/javascript"></script>
+</div>
+<!--+
+ |header
+ +-->
+<div class="header">
+<!--+
+ |start group logo
+ +-->
+<div class="grouplogo">
+<a href="http://www.apache.org/"><img class="logoImage" alt="Apache" src="../../images/apache-forrest.png" title="The Apache Software Foundation"></a>
+</div>
+<!--+
+ |end group logo
+ +-->
+<!--+
+ |start Project Logo
+ +-->
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="../../images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<!--+
+ |end Project Logo
+ +-->
+<!--+
+ |start Search
+ +-->
+<div class="searchbox">
+<form action="http://www.google.com/search" method="get" class="roundtopsmall">
+<input value="forrest.apache.org" name="sitesearch" type="hidden"><input onFocus="getBlank (this, 'Search the site with google');" size="25" name="q" id="query" type="text" value="Search the site with google">
+ <input name="Search" value="Search" type="submit">
+</form>
+</div>
+<!--+
+ |end search
+ +-->
+<!--+
+ |start Tabs
+ +-->
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="../../index.html">Welcome</a>
+</li>
+<li>
+<a class="base-not-selected" href="../../contrib.html">Project</a>
+</li>
+<li>
+<a class="base-not-selected" href="../../versions/index.html">Versioned Docs</a>
+</li>
+<li>
+<a class="base-not-selected" href="../../pluginDocs/index.html">Plugins</a>
+</li>
+<li>
+<a class="base-not-selected" href="../../tools/index.html">Tools</a>
+</li>
+</ul>
+<!--+
+ |end Tabs
+ +-->
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<!--+
+ |start Subtabs
+ +-->
+<div id="level2tabs"></div>
+<!--+
+ |end Endtabs
+ +-->
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<!--+
+ |breadtrail
+ +-->
+<div class="breadtrail">
+
+
+ </div>
+<!--+
+ |start Menu, mainarea
+ +-->
+<!--+
+ |start Menu
+ +-->
+<div id="menu">
+<div onclick="SwitchMenu('menu_selected_1.1', '../../skin/')" id="menu_selected_1.1Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">0.80-dev</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../../docs_0_80/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/faq.html">FAQs</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/changes.html">Changes</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/todo.html">Todo</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/your-project.html">Using Forrest</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/locationmap.html">Locationmap</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/validation.html">XML Validation</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/linking.html">Menus and Linking</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/searching.html">Searching</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/skins.html">Default Skins</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/skin-package.html">Skin Packages</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/dispatcher.html">Dispatcher development</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/forrest-contract.html">Our Contract</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/compliance.html">Standards Compliance</a>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.15', '../../skin/')" id="menu_selected_1.1.15Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">How-To</div>
+<div id="menu_selected_1.1.15" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../../docs_0_80/howto/index.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-howto.html">Write a How-to</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-dev.html">Be a developer</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-asf-mirror.html">Download mirror</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-pdf-tab.html">Create tab PDF</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-editcss.html">Edit CSS (WYSIWYG)</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-corner-images.html">CSS corner SVG</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-forrest-from-maven.html">Maven Integration</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-buildPlugin.html">Build a Plugin</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-custom-html-source.html">Custom html source</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.15.11', '../../skin/')" id="menu_1.1.15.11Title" class="menutitle">Multipage HowTo</div>
+<div id="menu_1.1.15.11" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../docs_0_80/howto/multi/howto-multi.html">Introduction</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/multi/step1.html">Step 1</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/multi/step2.html">Step 2</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/multi/step3.html">Step 3</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.1.15.12', '../../skin/')" id="menu_selected_1.1.15.12Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Dispatcher</div>
+<div id="menu_selected_1.1.15.12" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">Install</div>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-dispatcher-quickstart.html">Quickstart</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/howto-structurer-contracts.html">Contracts</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.16', '../../skin/')" id="menu_1.1.16Title" class="menutitle">Advanced Topics</div>
+<div id="menu_1.1.16" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../docs_0_80/build.html">Building Forrest</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/catalog.html">Using DTD Catalogs</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/sitemap-ref.html">Sitemap Reference</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/project-sitemap.html">Project sitemap</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/cap.html">Sourcetype Action</a>
+</div>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/upgrading_08.html">Upgrading to 0.8</a>
+</div>
+<div onclick="SwitchMenu('menu_1.1.18', '../../skin/')" id="menu_1.1.18Title" class="menutitle">Reference docs</div>
+<div id="menu_1.1.18" class="menuitemgroup">
+<div onclick="SwitchMenu('menu_1.1.18.1', '../../skin/')" id="menu_1.1.18.1Title" class="menutitle">DTD documentation</div>
+<div id="menu_1.1.18.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../dtdx/dtd-docs.html">Overview</a>
+</div>
+<div class="menuitem">
+<a href="../../dtdx/document-v20.dtdx.html">document-v20</a>
+</div>
+<div class="menuitem">
+<a href="../../dtdx/howto-v20.dtdx.html">howto-v20</a>
+</div>
+<div class="menuitem">
+<a href="../../dtdx/faq-v20.dtdx.html">faq-v20</a>
+</div>
+<div class="menuitem">
+<a href="../../dtdx/document-v13.dtdx.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../../dtdx/howto-v13.dtdx.html">howto-v13</a>
+</div>
+<div class="menuitem">
+<a href="../../dtdx/faq-v13.dtdx.html">faq-v13</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.18.2', '../../skin/')" id="menu_1.1.18.2Title" class="menutitle">Doc samples</div>
+<div id="menu_1.1.18.2" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../dtdx/document-v13.html">document-v13</a>
+</div>
+<div class="menuitem">
+<a href="../../dtdx/document-v20.html">document-v20</a>
+</div>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_1.1.19', '../../skin/')" id="menu_1.1.19Title" class="menutitle">Older Docs</div>
+<div id="menu_1.1.19" class="menuitemgroup">
+<div class="menuitem">
+<a href="../../docs_0_80/primer.html">Forrest Primer</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/libre-intro.html">Libre</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/dreams.html">Dream list</a>
+</div>
+<div class="menuitem">
+<a href="../../docs_0_80/howto/cvs-ssh/howto-cvs-ssh.html">CVS over SSH</a>
+</div>
+</div>
+</div>
+<div id="credit">
+<hr>
+ This is documentation for development version v0.8
+ (<a href="http://forrest.apache.org/versions/">More</a>)</div>
+<div id="roundbottom">
+<img style="display: none" class="corner" height="15" width="15" alt="" src="../../skin/images/rc-b-l-15-1body-2menu-3menu.png"></div>
+<!--+
+ |alternative credits
+ +-->
+<div id="credit2">
+<a href="http://apachecon.com/"><img border="0" title="ApacheCon EU 2006" alt="ApacheCon EU 2006 - logo" src="http://www.eu.apachecon.com/konferenzen/apachecon06/images/header-left.gif" style="width: 150px;height: 50px;"></a>
+</div>
+</div>
+<!--+
+ |end Menu
+ +-->
+<!--+
+ |start content
+ +-->
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="howto-dispatcher-install.pdf"><img alt="PDF -icon" src="../../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">Font size:
+ <input value="Reset" class="resetfont" title="Reset text" onclick="ndeSetTextSize('reset'); return false;" type="button">
+ <input value="-a" class="smallerfont" title="Shrink text" onclick="ndeSetTextSize('decr'); return false;" type="button">
+ <input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
+</div>
+<h1>How to install the "dispatcher"</h1>
+<div class="abstract">
+ This How-To describes the setup of the plugins (needed to work with forrest:views and forrest:contracts) and a fresh v2 seed site.
+ </div>
+<div id="motd-area">
+ This is documentation for development version v0.8
+ (<a href="http://forrest.apache.org/versions/">More</a>)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Intended Audience">Intended Audience</a>
+</li>
+<li>
+<a href="#Purpose">Purpose</a>
+</li>
+<li>
+<a href="#Prerequisites">Prerequisites</a>
+</li>
+<li>
+<a href="#Steps">Steps</a>
+<ul class="minitoc">
+<li>
+<a href="#localBuild">Build the internal.dispatcher and the themes.core plugins</a>
+</li>
+<li>
+<a href="#newSeed">Seed a new project</a>
+</li>
+<li>
+<a href="#forrestProperties">Modify forrest.properties</a>
+</li>
+<li>
+<a href="#testing">Test your new "dispatcher" based project</a>
+</li>
+<li>
+<a href="#availableContracts">Available contracts</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Further Reading">Further Reading</a>
+</li>
+<li>
+<a href="#Feedback">Feedback</a>
+</li>
+</ul>
+</div>
+<a name="N10010"></a><a name="Intended Audience"></a>
+<h2 class="underlined_10">Intended Audience</h2>
+<div class="section">
+<div class="warning">
+<div class="label">Warning</div>
+<div class="content">
+The "Dispatcher" (aka "Views") is new functionality which is still in development phase. That is why it is in the
+"whiteboard" section of the Forrest distribution. This HowTo is a good start but still needs more work.
+</div>
+</div>
+<p>
+ Developers who want to get started with "dispatcher" development and want to help testing and developing the "dispatcher".
+ </p>
+</div>
+<a name="N1001B"></a><a name="Purpose"></a>
+<h2 class="underlined_10">Purpose</h2>
+<div class="section">
+<p>
+ Quick guide installing the "dispatcher". This is the "getting started" setup guide.
+ </p>
+</div>
+<a name="N10023"></a><a name="Prerequisites"></a>
+<h2 class="underlined_10">Prerequisites</h2>
+<div class="section">
+<ul>
+
+<li>Need the SVN trunk version of Forrest for using the "dispatcher" because it is in an early stage.</li>
+
+<li>Read <a href="../../docs_0_80/howto/howto-buildPlugin.html">How to Build a Plugin</a>
+ especially the section about using Forrest's own Ant.</li>
+
+<li>Installing a mozilla browser and the
+ <a href="../../tools/forrestbar.html">Forrestbar</a> helps a lot in developing.</li>
+
+</ul>
+</div>
+<a name="N1003C"></a><a name="Steps"></a>
+<h2 class="underlined_10">Steps</h2>
+<div class="section">
+<p>
+ The process of setting up the plugin should be easy. Still it has too many stages and it
+ will become easier in the future.
+ </p>
+<a name="N10044"></a><a name="localBuild"></a>
+<h3 class="underlined_5">Build the internal.dispatcher and the themes.core plugins</h3>
+<p>
+ The first step is to build and deploy the internal.dispatcher and the themes.core plugins.
+ </p>
+<p>
+ Do your usual 'svn update' on forrest (build it clean and normal), then ...
+ </p>
+<pre class="code">
+cd whiteboard/plugins/org.apache.forrest.plugin.internal.dispatcher/
+$FORREST_HOME/tools/ant/bin/ant local-deploy
+cd ../org.apache.forrest.themes.core/
+$FORREST_HOME/tools/ant/bin/ant local-deploy
+ </pre>
+<a name="N10055"></a><a name="newSeed"></a>
+<h3 class="underlined_5">Seed a new project</h3>
+<p> Go to the directory where you want to seed a new project and seed it ...
+ </p>
+<pre class="code">cd ~/src/
+mkdir dispatcher
+cd dispatcher/
+forrest seed </pre>
+<a name="N10063"></a><a name="forrestProperties"></a>
+<h3 class="underlined_5">Modify forrest.properties</h3>
+<p>
+ Make sure to tell forrest to use the dispatcher plugins. <br>
+ Edit forrest.properties to add the required plugins:
+ </p>
+<pre class="code">
+project.required.plugins=org.apache.forrest.themes.core,org.apache.forrest.plugin.internal.dispatcher
+ </pre>
+<a name="N10073"></a><a name="testing"></a>
+<h3 class="underlined_5">Test your new "dispatcher" based project</h3>
+<p>
+ Now you have finished the preparation and the setup to finally do
+ <span class="codefrag">'forrest run'</span> and
+ point your browser to <span class="codefrag">http://localhost:8888/</span> and you will see the default
+ dispatcher-based site.
+ </p>
+<a name="N10083"></a><a name="availableContracts"></a>
+<h3 class="underlined_5">Available contracts</h3>
+<p>
+ To start working with the dispatcher, you need to know which contracts you can use.
+ Forrestbar is a nice way to see available contracts. See the menu point "Devs"
+ (ls.contracts and/or ls.contracts.project)
+ </p>
+<p>
+ You can point your browser to e.g. <span class="codefrag">http://localhost:8888/ls.contracts.html</span>
+ ... On this page you will find all contracts that you can use in your project provided by the core themes.
+ </p>
+</div>
+<a name="N10092"></a><a name="Further Reading"></a>
+<h2 class="underlined_10">Further Reading</h2>
+<div class="section">
+<p>
+ Congratulations you are now able to work with the dispatcher.
+ From here we recommend to read the following How-To's (in this order):
+ </p>
+<ul>
+
+<li>
+<a href="../../docs_0_80/howto/howto-structurer-dsl.html">Getting started with the "structurer"</a>
+</li>
+
+<li>
+<a href="../../docs_0_80/howto/howto-structurer-contracts.html">Create your own contract implementation</a>
+</li>
+
+</ul>
+</div>
+<a name="N100A9"></a><a name="Feedback"></a>
+<h2 class="underlined_10">Feedback</h2>
+<div class="section">
+<p>
+ Please provide feedback about this document via the "dev"
+ <a href="../../mail-lists.html">mailing list</a>.
+ </p>
+</div>
+</div>
+<!--+
+ |end content
+ +-->
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<!--+
+ |start bottomstrip
+ +-->
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("Last Published: " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright ©
+ 2002-2005 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+<!--+
+ |end bottomstrip
+ +-->
+</div>
+</body>
+</html>
Propchange: forrest/site/docs_0_80/howto/howto-dispatcher-install.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/docs_0_80/howto/howto-dispatcher-install.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-dispatcher-install.pdf?rev=390585&view=auto
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/docs_0_80/howto/howto-dispatcher-install.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Modified: forrest/site/docs_0_80/howto/howto-dispatcher-quickstart.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-dispatcher-quickstart.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-dispatcher-quickstart.html (original)
+++ forrest/site/docs_0_80/howto/howto-dispatcher-quickstart.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_selected_1.1.15.12', '../../skin/')" id="menu_selected_1.1.15.12Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Dispatcher</div>
<div id="menu_selected_1.1.15.12" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
-<a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
@@ -432,9 +432,11 @@
<li>Do 'svn update' or at least use r373699.</li>
+<li>Do the 'build clean; build' (necessary because the Dispatcher is changing rapidly and uses some Java)</li>
+
<li>Apply the patch from https://issues.apache.org/jira/browse/FOR-796</li>
-<li>Deploy both dispatcher plugins.</li>
+<li>Deploy both dispatcher plugins ...</li>
</ul>
<pre class="code">
@@ -443,7 +445,11 @@
cd ../org.apache.forrest.themes.core
$FORREST_HOME/tools/ant/bin/ant local-deploy
</pre>
-<a name="N1005C"></a><a name="enable"></a>
+<p>The build and deploy steps can be done using the convenience script:
+ <span class="codefrag">$FORREST_HOME/etc/builddispatcher.sh|bat</span>
+
+</p>
+<a name="N10065"></a><a name="enable"></a>
<h3 class="underlined_5">Dispatcher-enable the existing site</h3>
<ul>
@@ -451,12 +457,10 @@
,org.apache.forrest.plugin.internal.dispatcher,org.apache.forrest.themes.core
</li>
-<li>Deploy both dispatcher plugins with etc/structurer.sh</li>
-
<li>localhost:8888/index.html ... fantastic. See the default view.</li>
</ul>
-<a name="N1006F"></a><a name="another-theme"></a>
+<a name="N10075"></a><a name="another-theme"></a>
<h3 class="underlined_5">Use another theme</h3>
<ul>
@@ -467,7 +471,7 @@
<li>localhost:8888/index.html ... See the new view.</li>
</ul>
-<a name="N10082"></a><a name="our-structurer"></a>
+<a name="N10088"></a><a name="our-structurer"></a>
<h3 class="underlined_5">Create our own structurer by copy-and-customise</h3>
<p>
Copy the default structurer for the pelt theme and make local changes.
@@ -501,7 +505,7 @@
From here on there is no need to re-start 'forrest run'. Just edit
the structurer and see the effect.
</p>
-<a name="N1009E"></a><a name="remove-default-contract"></a>
+<a name="N100A4"></a><a name="remove-default-contract"></a>
<h3 class="underlined_5">Remove a default contract</h3>
<ul>
@@ -510,7 +514,7 @@
</li>
</ul>
-<a name="N100AB"></a><a name="add-default-contract"></a>
+<a name="N100B1"></a><a name="add-default-contract"></a>
<h3 class="underlined_5">Add a default contract</h3>
<p>
Forrest provides many default contracts. If you are using the
@@ -540,7 +544,7 @@
Notice that you did not need to copy any other code to your project space.
Forrest finds the default contract in its core (the theme.core plugin).
</p>
-<a name="N100C5"></a><a name="add-project-contract"></a>
+<a name="N100CB"></a><a name="add-project-contract"></a>
<h3 class="underlined_5">Add a new project contract</h3>
<div class="warning">
<div class="label">Warning</div>
@@ -589,7 +593,7 @@
Forrestbar "Devs => ls.contracts.project". Otherwise visit
localhost:8888/ls.contracts.project.html
</p>
-<a name="N100EB"></a><a name="manage"></a>
+<a name="N100F1"></a><a name="manage"></a>
<h3 class="underlined_5">Decide how to manage your contracts</h3>
<div class="fixme">
<div class="label">Fixme (open)</div>
@@ -599,7 +603,7 @@
</div>
</div>
</div>
-<a name="N100FA"></a><a name="Further Reading"></a>
+<a name="N10100"></a><a name="Further Reading"></a>
<h2 class="underlined_10">Further Reading</h2>
<div class="section">
<p> Congratulations you are now able to work with the Dispatcher. From here
@@ -621,7 +625,7 @@
</ul>
</div>
-<a name="N10113"></a><a name="Feedback"></a>
+<a name="N10119"></a><a name="Feedback"></a>
<h2 class="underlined_10">Feedback</h2>
<div class="section">
<p> Please provide feedback about this document via the <a href="../../mail-lists.html">mailing lists</a>. </p>
Modified: forrest/site/docs_0_80/howto/howto-dispatcher-quickstart.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-dispatcher-quickstart.pdf?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/docs_0_80/howto/howto-editcss.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-editcss.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-editcss.html (original)
+++ forrest/site/docs_0_80/howto/howto-editcss.html Fri Mar 31 19:31:38 2006
@@ -203,7 +203,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/howto/howto-forrest-from-maven.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-forrest-from-maven.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-forrest-from-maven.html (original)
+++ forrest/site/docs_0_80/howto/howto-forrest-from-maven.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/howto/howto-howto.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-howto.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-howto.html (original)
+++ forrest/site/docs_0_80/howto/howto-howto.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/howto/howto-pdf-tab.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-pdf-tab.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-pdf-tab.html (original)
+++ forrest/site/docs_0_80/howto/howto-pdf-tab.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/howto/howto-structurer-contracts.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-structurer-contracts.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-structurer-contracts.html (original)
+++ forrest/site/docs_0_80/howto/howto-structurer-contracts.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_selected_1.1.15.12', '../../skin/')" id="menu_selected_1.1.15.12Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Dispatcher</div>
<div id="menu_selected_1.1.15.12" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
-<a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
@@ -390,7 +390,7 @@
<ul>
<li>
- You have a ready-to-go new seed-v2 (v2) based on the dispatcher like described in <a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>.
+ You have a ready-to-go new seed-v2 (v2) based on the dispatcher like described in <a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>.
</li>
<li>
Modified: forrest/site/docs_0_80/howto/howto-structurer-dsl.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/howto-structurer-dsl.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/howto-structurer-dsl.html (original)
+++ forrest/site/docs_0_80/howto/howto-structurer-dsl.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_selected_1.1.15.12', '../../skin/')" id="menu_selected_1.1.15.12Title" class="menutitle" style="background-image: url('../../skin/images/chapter_open.gif');">Dispatcher</div>
<div id="menu_selected_1.1.15.12" class="selectedmenuitemgroup" style="display: block;">
<div class="menuitem">
-<a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menupage">
<div class="menupagetitle">Structurer</div>
@@ -389,7 +389,7 @@
<ul>
<li> You have a ready-to-go new dispatcher based project like
- described in <a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>. </li>
+ described in <a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>. </li>
<li> Reading that how-to is as well a good idea to understand the used
directory structure in this how-to. </li>
@@ -479,7 +479,7 @@
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 themer-plugin for the index page of the <a href="../../docs_0_80/howto/howto-structurer-install.html">v2</a>. For that we will create a
+ default structurer of the themer-plugin for the index page of the <a href="../../docs_0_80/howto/howto-dispatcher-install.html">v2</a>. 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>
Modified: forrest/site/docs_0_80/howto/index.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/index.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/index.html (original)
+++ forrest/site/docs_0_80/howto/index.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
@@ -403,12 +403,16 @@
- When integrating legacy html documents into a Forrest-built site, additional processing
of the html sources might be required.
</li>
+
+<li>
+<a href="../../docs_0_80/howto/howto-dispatcher-quickstart.html">Dispatcher Quickstart</a> - Guide to working with the upcoming dispatcher development.
+ </li>
</ul>
</div>
-<a name="N10054"></a><a name="Extending+Forrest"></a>
+<a name="N1005A"></a><a name="Extending+Forrest"></a>
<h2 class="underlined_10">Extending Forrest</h2>
<div class="section">
<ul>
Modified: forrest/site/docs_0_80/howto/index.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/index.pdf?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/docs_0_80/howto/multi/howto-multi.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/multi/howto-multi.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/multi/howto-multi.html (original)
+++ forrest/site/docs_0_80/howto/multi/howto-multi.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../../../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/howto/multi/step1.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/multi/step1.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/multi/step1.html (original)
+++ forrest/site/docs_0_80/howto/multi/step1.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../../../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/howto/multi/step2.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/multi/step2.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/multi/step2.html (original)
+++ forrest/site/docs_0_80/howto/multi/step2.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../../../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/howto/multi/step3.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/howto/multi/step3.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/howto/multi/step3.html (original)
+++ forrest/site/docs_0_80/howto/multi/step3.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../../../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../../../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../../../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../../../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/index.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/index.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/index.html (original)
+++ forrest/site/docs_0_80/index.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/libre-intro.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/libre-intro.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/libre-intro.html (original)
+++ forrest/site/docs_0_80/libre-intro.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/linking.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/linking.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/linking.html (original)
+++ forrest/site/docs_0_80/linking.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/locationmap.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/locationmap.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/locationmap.html (original)
+++ forrest/site/docs_0_80/locationmap.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/menu-index.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/menu-index.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/menu-index.html (original)
+++ forrest/site/docs_0_80/menu-index.html Fri Mar 31 19:31:38 2006
@@ -136,7 +136,7 @@
<ul>
<li>
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</li>
<li>
Modified: forrest/site/docs_0_80/primer.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/primer.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/primer.html (original)
+++ forrest/site/docs_0_80/primer.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/project-sitemap.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/project-sitemap.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/project-sitemap.html (original)
+++ forrest/site/docs_0_80/project-sitemap.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/searching.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/searching.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/searching.html (original)
+++ forrest/site/docs_0_80/searching.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/sitemap-ref.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/sitemap-ref.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/sitemap-ref.html (original)
+++ forrest/site/docs_0_80/sitemap-ref.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/skin-package.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/skin-package.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/skin-package.html (original)
+++ forrest/site/docs_0_80/skin-package.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/skins.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/skins.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/skins.html (original)
+++ forrest/site/docs_0_80/skins.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/todo.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/todo.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/todo.html (original)
+++ forrest/site/docs_0_80/todo.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/upgrading_08.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/upgrading_08.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/upgrading_08.html (original)
+++ forrest/site/docs_0_80/upgrading_08.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/validation.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/validation.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/validation.html (original)
+++ forrest/site/docs_0_80/validation.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/docs_0_80/your-project.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/your-project.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/docs_0_80/your-project.html (original)
+++ forrest/site/docs_0_80/your-project.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/document-v12.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/document-v12.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/document-v12.html (original)
+++ forrest/site/dtdx/document-v12.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/document-v13.dtdx.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/document-v13.dtdx.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/document-v13.dtdx.html (original)
+++ forrest/site/dtdx/document-v13.dtdx.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/document-v13.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/document-v13.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/document-v13.html (original)
+++ forrest/site/dtdx/document-v13.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/document-v20.dtdx.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/document-v20.dtdx.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/document-v20.dtdx.html (original)
+++ forrest/site/dtdx/document-v20.dtdx.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/document-v20.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/document-v20.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/document-v20.html (original)
+++ forrest/site/dtdx/document-v20.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/dtd-docs.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/dtd-docs.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/dtd-docs.html (original)
+++ forrest/site/dtdx/dtd-docs.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/faq-v13.dtdx.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/faq-v13.dtdx.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/faq-v13.dtdx.html (original)
+++ forrest/site/dtdx/faq-v13.dtdx.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/faq-v20.dtdx.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/faq-v20.dtdx.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/faq-v20.dtdx.html (original)
+++ forrest/site/dtdx/faq-v20.dtdx.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/howto-v13.dtdx.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/howto-v13.dtdx.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/howto-v13.dtdx.html (original)
+++ forrest/site/dtdx/howto-v13.dtdx.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/dtdx/howto-v20.dtdx.html
URL: http://svn.apache.org/viewcvs/forrest/site/dtdx/howto-v20.dtdx.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/dtdx/howto-v20.dtdx.html (original)
+++ forrest/site/dtdx/howto-v20.dtdx.html Fri Mar 31 19:31:38 2006
@@ -202,7 +202,7 @@
<div onclick="SwitchMenu('menu_1.1.15.12', '../skin/')" id="menu_1.1.15.12Title" class="menutitle">Dispatcher</div>
<div id="menu_1.1.15.12" class="menuitemgroup">
<div class="menuitem">
-<a href="../docs_0_80/howto/howto-structurer-install.html">Install</a>
+<a href="../docs_0_80/howto/howto-dispatcher-install.html">Install</a>
</div>
<div class="menuitem">
<a href="../docs_0_80/howto/howto-structurer-dsl.html">Structurer</a>
Modified: forrest/site/forrest-issues.html
URL: http://svn.apache.org/viewcvs/forrest/site/forrest-issues.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/forrest-issues.html (original)
+++ forrest/site/forrest-issues.html Fri Mar 31 19:31:38 2006
@@ -219,6 +219,9 @@
<a href="#%5BFOR-707%5D+Document+i18n+features+of+Forrest">[FOR-707] Document i18n features of Forrest</a>
</li>
<li>
+<a href="#%5BFOR-639%5D+define+terminology+for+the+various+aspects+of+Dispatcher">[FOR-639] define terminology for the various aspects of Dispatcher</a>
+</li>
+<li>
<a href="#%5BFOR-241%5D+character+entities+%28e.g.+ampersand%29+are+expanded+again+for+href+or+src+attributes">[FOR-241] character entities (e.g. ampersand) are expanded again for href or src attributes</a>
</li>
<li>
@@ -260,9 +263,6 @@
<li>
<a href="#%5BFOR-677%5D+leading+slash+in+gathered+URIs+causes+double+the+number+of+links+to+be+processed">[FOR-677] leading slash in gathered URIs causes double the number of links to be processed</a>
</li>
-<li>
-<a href="#%5BFOR-699%5D+Beginner+HowTos+for+installing+Forrest">[FOR-699] Beginner HowTos for installing Forrest</a>
-</li>
</ul>
</div>
<div class="note">
@@ -447,7 +447,19 @@
<br>
We could, at the very least use the locationmap to pull this content into our site [OT: I wonder if this could be a way to generate more documentation?)</p>
</div>
-<a name="N10089"></a><a name="%5BFOR-241%5D+character+entities+%28e.g.+ampersand%29+are+expanded+again+for+href+or+src+attributes"></a>
+<a name="N10089"></a><a name="%5BFOR-639%5D+define+terminology+for+the+various+aspects+of+Dispatcher"></a>
+<h2 class="underlined_10">[FOR-639] define terminology for the various aspects of Dispatcher</h2>
+<div class="section">
+<p>
+<a href="http://issues.apache.org/jira/browse/FOR-639">http://issues.apache.org/jira/browse/FOR-639</a>
+</p>
+<p>See the email thread:
+<br>
+<a href="http://marc.theaimsgroup.com/?t=112276643700001">http://marc.theaimsgroup.com/?t=112276643700001</a>
+<br>
+</p>
+</div>
+<a name="N10095"></a><a name="%5BFOR-241%5D+character+entities+%28e.g.+ampersand%29+are+expanded+again+for+href+or+src+attributes"></a>
<h2 class="underlined_10">[FOR-241] character entities (e.g. ampersand) are expanded again for href or src attributes</h2>
<div class="section">
<p>
@@ -493,7 +505,7 @@
<br>
the ampersand in the link href attribute is not.</p>
</div>
-<a name="N10095"></a><a name="%5BFOR-211%5D+whole-site+html+and+pdf%3A+broken+ext+links"></a>
+<a name="N100A1"></a><a name="%5BFOR-211%5D+whole-site+html+and+pdf%3A+broken+ext+links"></a>
<h2 class="underlined_10">[FOR-211] whole-site html and pdf: broken ext links</h2>
<div class="section">
<p>
@@ -501,7 +513,7 @@
</p>
<p>In the the generated site.html all of the external links are broken (i.e. the href attributes are like ... error:#ext:forrest).</p>
</div>
-<a name="N100A1"></a><a name="%5BFOR-210%5D+whole-site+html+and+pdf%3A+broken+link+faq%2C+broken+image+links"></a>
+<a name="N100AD"></a><a name="%5BFOR-210%5D+whole-site+html+and+pdf%3A+broken+link+faq%2C+broken+image+links"></a>
<h2 class="underlined_10">[FOR-210] whole-site html and pdf: broken link faq, broken image links</h2>
<div class="section">
<p>
@@ -511,7 +523,7 @@
<br>
</p>
</div>
-<a name="N100AD"></a><a name="%5BFOR-209%5D+First+level+selected+tab+is+not+highlighted+when+containing+2nd+level+tabs"></a>
+<a name="N100B9"></a><a name="%5BFOR-209%5D+First+level+selected+tab+is+not+highlighted+when+containing+2nd+level+tabs"></a>
<h2 class="underlined_10">[FOR-209] First level selected tab is not highlighted when containing 2nd level tabs</h2>
<div class="section">
<p>
@@ -525,7 +537,7 @@
<br>
</p>
</div>
-<a name="N100B9"></a><a name="%5BFOR-203%5D+2nd+level+tabs+are+not+selected+appropriately"></a>
+<a name="N100C5"></a><a name="%5BFOR-203%5D+2nd+level+tabs+are+not+selected+appropriately"></a>
<h2 class="underlined_10">[FOR-203] 2nd level tabs are not selected appropriately</h2>
<div class="section">
<p>
@@ -547,7 +559,7 @@
<br>
&nbsp;&nbsp;Lorenz Froihofer.</p>
</div>
-<a name="N100C5"></a><a name="%5BFOR-200%5D+Locationmap+for+Forrest+and+Users"></a>
+<a name="N100D1"></a><a name="%5BFOR-200%5D+Locationmap+for+Forrest+and+Users"></a>
<h2 class="underlined_10">[FOR-200] Locationmap for Forrest and Users</h2>
<div class="section">
<p>
@@ -559,7 +571,7 @@
<br>
Beware that it will not work for raw files that are not linked, as this &quot;feature&quot; currently uses a fixed dir being being copied by Ant.</p>
</div>
-<a name="N100D1"></a><a name="%5BFOR-546%5D+Sitemap+reference+doc+should+be+updated+to+reflect+plugin+architecture"></a>
+<a name="N100DD"></a><a name="%5BFOR-546%5D+Sitemap+reference+doc+should+be+updated+to+reflect+plugin+architecture"></a>
<h2 class="underlined_10">[FOR-546] Sitemap reference doc should be updated to reflect plugin architecture</h2>
<div class="section">
<p>
@@ -591,7 +603,7 @@
<br>
I found out about this because my sitemap uses the fo2pdf too (docbook to PDF), and had to add the serializer.</p>
</div>
-<a name="N100DD"></a><a name="%5BFOR-560%5D+Remove+duplicate+jars+from+eclipse+plugins"></a>
+<a name="N100E9"></a><a name="%5BFOR-560%5D+Remove+duplicate+jars+from+eclipse+plugins"></a>
<h2 class="underlined_10">[FOR-560] Remove duplicate jars from eclipse plugins</h2>
<div class="section">
<p>
@@ -599,7 +611,7 @@
</p>
<p>tools/eclipse/plugins/org.apache.forrest.eclipse.servletEngine/lib contains some duplicate jars to those in the main Forrest trunk. We should find a way of reusing the jars from their existing location.</p>
</div>
-<a name="N100E9"></a><a name="%5BFOR-562%5D+Update+Plugins+howto"></a>
+<a name="N100F5"></a><a name="%5BFOR-562%5D+Update+Plugins+howto"></a>
<h2 class="underlined_10">[FOR-562] Update Plugins howto</h2>
<div class="section">
<p>
@@ -627,7 +639,7 @@
<br>
</p>
</div>
-<a name="N100F5"></a><a name="%5BFOR-645%5D+patches+for+whitespace+cleanup"></a>
+<a name="N10101"></a><a name="%5BFOR-645%5D+patches+for+whitespace+cleanup"></a>
<h2 class="underlined_10">[FOR-645] patches for whitespace cleanup</h2>
<div class="section">
<p>
@@ -635,7 +647,7 @@
</p>
<p>Use this issue to provide patches for the whitespace cleanup.</p>
</div>
-<a name="N10101"></a><a name="%5BFOR-644%5D+whitespace+cleanup"></a>
+<a name="N1010D"></a><a name="%5BFOR-644%5D+whitespace+cleanup"></a>
<h2 class="underlined_10">[FOR-644] whitespace cleanup</h2>
<div class="section">
<p>
@@ -647,7 +659,7 @@
<br>
This Issue will be used to announce which section of the repository is due to be cleaned next. Please keep discussion on that mail thread.</p>
</div>
-<a name="N1010D"></a><a name="%5BFOR-726%5D+use+locationmap+in+all+of+the+plugins"></a>
+<a name="N10119"></a><a name="%5BFOR-726%5D+use+locationmap+in+all+of+the+plugins"></a>
<h2 class="underlined_10">[FOR-726] use locationmap in all of the plugins</h2>
<div class="section">
<p>
@@ -659,7 +671,7 @@
<br>
(Perhaps we need Jira sub-tasks for each plugin.)</p>
</div>
-<a name="N10119"></a><a name="%5BFOR-721%5D+entries+without+labels+in+site.xml+are+now+being+crawled+and+generated"></a>
+<a name="N10125"></a><a name="%5BFOR-721%5D+entries+without+labels+in+site.xml+are+now+being+crawled+and+generated"></a>
<h2 class="underlined_10">[FOR-721] entries without labels in site.xml are now being crawled and generated</h2>
<div class="section">
<p>
@@ -671,7 +683,7 @@
<br>
This is most likely a side-effect of the workaround for issue FOR-675</p>
</div>
-<a name="N10125"></a><a name="%5BFOR-677%5D+leading+slash+in+gathered+URIs+causes+double+the+number+of+links+to+be+processed"></a>
+<a name="N10131"></a><a name="%5BFOR-677%5D+leading+slash+in+gathered+URIs+causes+double+the+number+of+links+to+be+processed"></a>
<h2 class="underlined_10">[FOR-677] leading slash in gathered URIs causes double the number of links to be processed</h2>
<div class="section">
<p>
@@ -690,14 +702,6 @@
<br>
However, we do have a sitemap transformer to &quot;relativize&quot; and &quot;absolutize&quot; the links. Should it always trim the leading slash? Or are there cases where that should not happen, so cannot generalise?</p>
-</div>
-<a name="N10131"></a><a name="%5BFOR-699%5D+Beginner+HowTos+for+installing+Forrest"></a>
-<h2 class="underlined_10">[FOR-699] Beginner HowTos for installing Forrest</h2>
-<div class="section">
-<p>
-<a href="http://issues.apache.org/jira/browse/FOR-699">http://issues.apache.org/jira/browse/FOR-699</a>
-</p>
-<p>These are a whole group of HowTos that I wrote for my local users (probably a tutorial would be a better format). They are not complete, nor tidied at this point, but they cover a lot of basic step-by-step stuff specifically geared towards Linux with Gnome desktop and Windows XP. Figured I would put them out there so we can pull out bits we may want to use.</p>
</div>
</div>
<!--+
Modified: forrest/site/forrest-issues.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/forrest-issues.pdf?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/pluginDocs/plugins_0_80/usingPlugins.html
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_80/usingPlugins.html?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/usingPlugins.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/usingPlugins.html Fri Mar 31 19:31:38 2006
@@ -161,23 +161,35 @@
<a href="#overview">Overview</a>
<ul class="minitoc">
<li>
-<a href="#What+plugins+are+available%3F">What plugins are available?</a>
+<a href="#available">What plugins are available?</a>
</li>
</ul>
</li>
<li>
-<a href="#How+is+a+Plugin+Installed%3F">How is a Plugin Installed?</a>
+<a href="#install">How is a Plugin Installed?</a>
<ul class="minitoc">
<li>
-<a href="#Upgrading+from+a+Version+of+Forrest+Without+Plugins">Upgrading from a Version of Forrest Without Plugins</a>
+<a href="#required">List of Plugins Needed by the Project</a>
+</li>
+<li>
+<a href="#version">What Version of Plugins will be used ?</a>
+</li>
+<li>
+<a href="#sources">Where does Forrest look for Plugins sources ?</a>
+</li>
+<li>
+<a href="#local-deploy">Editing plugins sources to enhance functionality</a>
+</li>
+<li>
+<a href="#no-plugins">Upgrading from a Version of Forrest Without Plugins</a>
</li>
</ul>
</li>
<li>
-<a href="#Avoiding+Plugin+Conflicts">Avoiding Plugin Conflicts</a>
+<a href="#conflict">Avoiding Plugin Conflicts</a>
</li>
<li>
-<a href="#Further+Reading">Further Reading</a>
+<a href="#more">Further Reading</a>
</li>
</ul>
</div>
@@ -190,7 +202,7 @@
does not end there. Forrest can be extended through the addition of
plugins. This document serves as an introduction to the Forrest
plugin mechanism.</p>
-<a name="N10016"></a><a name="What+plugins+are+available%3F"></a>
+<a name="N10016"></a><a name="available"></a>
<h3 class="underlined_5">What plugins are available?</h3>
<p>You can run the command <span class="codefrag">forrest available-plugins</span> to get
a list of the known plugins for Forrest.</p>
@@ -199,33 +211,82 @@
</div>
-<a name="N1002B"></a><a name="How+is+a+Plugin+Installed%3F"></a>
+<a name="N1002B"></a><a name="install"></a>
<h2 class="underlined_10">How is a Plugin Installed?</h2>
<div class="section">
+<a name="N10031"></a><a name="required"></a>
+<h3 class="underlined_5">List of Plugins Needed by the Project</h3>
<p>If a site requires one or more plugins then the site designer will
- have named them in the <span class="codefrag">project.required.plugins</span> property
- in the projects <span class="codefrag">forrest.properties</span> file. When Forrest
- builds the site it will automatically discover the plugin and install
- it. In otherwords, the user need do nothing. For example,
- <span class="codefrag">project.required.plugins=org.apache.forrest.plugin.input.OpenOffice.org,org.apache.forrest.plugin.input.simplifiedDocbook</span>
- will cause Forrest to load the plugins called "org.apache.forrest.plugin.input.OpenOffice.org" and
- "org.apache.forrest.plugin.input.simplifiedDocbook".</p>
-<p>In the absence of a version number for the plugin (as is the case in the examples above)
- the most recent version that is applicabe to your release of Forrest will be used. This
- may result in unexpected behaviour if a new version of the plugin has been released that
- is incompatible with your current site. To force Forrest into using a specific version of
- a plugin you shuld add "-VERSION_NUMBER" to the end of the plugin name. For example,
- to force forrest to use the 1.0 version of the OpenOffice.org plugin you would use
- <span class="codefrag">org.apache.forrest.plugin.input.OpenOffice.org-1.0</span> If you define a version of the
- plugin that does not exist then it will fall back to using the most recent version avialable.
- This feature is useful when
- developing a new site as you can quickly force a plugin upgrade by deleting all installed
- plugins (use the command 'ant cleanPlugins'). However, this might result in the installation
- of an in-development plugin, therefore in a production environment you should always specify
- a known working version.</p>
-<p>By default a new forrest project includes plugins to generate
- PDF output from your source documents.</p>
-<a name="N10046"></a><a name="Upgrading+from+a+Version+of+Forrest+Without+Plugins"></a>
+ have to list them in the <span class="codefrag">project.required.plugins</span> property
+ in the projects <span class="codefrag">forrest.properties</span> file. When Forrest
+ builds the site it will automatically discover the plugins and install
+ them. In otherwords, the user needs do nothing.</p>
+<p>For example,</p>
+<pre class="code">project.required.plugins=org.apache.forrest.plugin.input.OpenOffice.org,org.apache.forrest.plugin.input.simplifiedDocbook</pre>
+<p>
+ will cause Forrest to load the plugins called "org.apache.forrest.plugin.input.OpenOffice.org" and
+ "org.apache.forrest.plugin.input.simplifiedDocbook".</p>
+<div class="note">
+<div class="label">Note</div>
+<div class="content">By default a new forrest project has that property configured
+ to include some plugins. Currently there is only one to generate
+ PDF output from your source documents.</div>
+</div>
+<a name="N1004E"></a><a name="version"></a>
+<h3 class="underlined_5">What Version of Plugins will be used ?</h3>
+<p>In the absence of a version number for the plugin (as is the case in the example above)
+ the most recent version that is applicabe to your release of Forrest will be used. This
+ may result in unexpected behaviour if a new version of the plugin has been released that
+ is incompatible with your current site. To force Forrest into using a specific version of
+ a plugin you should add "-VERSION_NUMBER" to the end of the plugin name. For example,
+ to force forrest to use the 1.0 version of the OpenOffice.org plugin you would use
+ <span class="codefrag">org.apache.forrest.plugin.input.OpenOffice.org-1.0</span>. If you define a version of the
+ plugin that does not exist then it will fall back to using the most recent version avialable.
+ This feature is useful when
+ developing a new site as you can quickly force a plugin upgrade by deleting all installed
+ plugins (use the command 'ant cleanPlugins'). However, this might result in the installation
+ of an in-development plugin, therefore in a production environment you should always specify
+ a known working version.</p>
+<a name="N1005B"></a><a name="sources"></a>
+<h3 class="underlined_5">Where does Forrest look for Plugins sources ?</h3>
+<p>By default, forrest looks into the two following directories to find plugins sources : <span class="codefrag">${forrest.home}/plugins</span> and <span class="codefrag">${forrest.home}/whiteboard/plugins</span>.
+ It is possible to add other sources locations by specifying the <span class="codefrag">project.required.plugins.src</span> property
+ in the projects <span class="codefrag">forrest.properties</span> file.</p>
+<p>For example,</p>
+<pre class="code">project.required.plugins.src=${forrest.home}/plugins,${forrest.home}/whiteboard/plugins,${project.home}/plugins</pre>
+<p>
+ will add the project specific directory <span class="codefrag">${project.home}/plugins</span> to the list of directories to search in.</p>
+<p>if sources are not found, forrest will try to get them from the Web. Forrest <em>knows</em> the plugins description with plugins descriptors files
+ in which plugins are described as follows :</p>
+<pre class="code"><plugin name="org.apache.forrest.plugin.output.pdf"
+ type="output"
+ author="Apache Forrest Project"
+ website="http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf"
+ url="http://forrest.apache.org/plugins/"
+ version="0.2">
+ <description>
+ Enable Forrest documents to be output in PDF format.
+ </description>
+ <forrestVersion>0.8</forrestVersion>
+</plugin></pre>
+<p>The url to download the different plugins is indicated in this file.</p>
+<p>By default, forrest gets the two following plugins descriptors files : <span class="codefrag">http://forrest.apache.org/plugins/plugins.xml</span> and <span class="codefrag">http://forrest.apache.org/plugins/whiteboard-plugins.xml</span>.
+ It is possible to add other plugins descriptors files by specifying the <span class="codefrag">forrest.plugins.descriptors</span> property
+ in the projects <span class="codefrag">forrest.properties</span> file.</p>
+<p>For example,</p>
+<pre class="code">forrest.plugins.descriptors=http://forrest.apache.org/plugins/plugins.xml,http://forrest.apache.org/plugins/whiteboard-plugins.xml,file:///${project.home}/plugins/plugins.xml</pre>
+<p>
+ will add the project specific plugins descriptors file <span class="codefrag">file:///${project.home}/plugins/plugins.xml</span> to the list of descriptors.</p>
+<a name="N100A7"></a><a name="local-deploy"></a>
+<h3 class="underlined_5">Editing plugins sources to enhance functionality</h3>
+<p>
+ Until issue
+ <a href="http://issues.apache.org/jira/browse/FOR-388">FOR-388</a>
+ is fixed to enable the use of plugins in-place, any changes to
+ sources need to be locally deployed.
+ See <a href="#more">Further reading</a> for "How to build a Plugin".
+ </p>
+<a name="N100B9"></a><a name="no-plugins"></a>
<h3 class="underlined_5">Upgrading from a Version of Forrest Without Plugins</h3>
<p>The plugin functionality was introduced in version 0.7 of Forrest.
At this time some of the functionality previously in Forrest was
@@ -253,7 +314,7 @@
</div>
-<a name="N1006F"></a><a name="Avoiding+Plugin+Conflicts"></a>
+<a name="N100E2"></a><a name="conflict"></a>
<h2 class="underlined_10">Avoiding Plugin Conflicts</h2>
<div class="section">
<p>Clashes between plugins can occur. For example, the simplified-docbook
@@ -265,7 +326,7 @@
</div>
-<a name="N1007C"></a><a name="Further+Reading"></a>
+<a name="N100EF"></a><a name="more"></a>
<h2 class="underlined_10">Further Reading</h2>
<div class="section">
<ul>
@@ -275,7 +336,7 @@
</li>
<li>
-<a href="../../docs_0_70/howto/howto-buildPlugin.html">How to build a Plugin</a>
+<a href="../../docs_0_80/howto/howto-buildPlugin.html">How to build a Plugin</a>
</li>
</ul>
Modified: forrest/site/pluginDocs/plugins_0_80/usingPlugins.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_80/usingPlugins.pdf?rev=390585&r1=390584&r2=390585&view=diff
==============================================================================
Binary files - no diff available.