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 2005/06/23 07:36:34 UTC
svn commit: r193078 [63/65] - in /forrest/site: ./ docs_0_60/
docs_0_60/howto/ docs_0_60/howto/bugzilla-patch/
docs_0_60/howto/bugzilla-patch/my-images/ docs_0_60/howto/multi/
docs_0_60/images/ docs_0_70/ docs_0_70/howto/ docs_0_70/howto/cvs-ssh/
docs_...
Added: forrest/site/pluginDocs/plugins_0_80/index.html
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_80/index.html?rev=193078&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/index.html (added)
+++ forrest/site/pluginDocs/plugins_0_80/index.html Wed Jun 22 22:36:19 2005
@@ -0,0 +1,838 @@
+<!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>Plugins Index (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">
+<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>
+<div class="header">
+<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>
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="../../images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<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 attr="value" name="Search" value="Search" type="submit">
+</form>
+</div>
+<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>
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<div id="level2tabs">
+<a class="base-not-selected" href="../../pluginDocs/plugins_0_70/index.html">0.70 (current)</a> | <a class="base-selected" href="../../pluginDocs/plugins_0_80/index.html">0.80-dev (under development)</a>
+</div>
+<script type="text/javascript"><!--
+document.write("<text>Last Published:</text> " + document.lastModified);
+// --></script>
+</div>
+<div class="breadtrail">
+
+
+ </div>
+<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 Plugins</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">Index</div>
+</div>
+<div class="menuitem">
+<a href="../../pluginDocs/plugins_0_80/usingPlugins.html">Using Plugins</a>
+</div>
+<div class="menuitem">
+<a href="../../pluginDocs/plugins_0_80/pluginInfrastructure.html">Plugin Infrastructure</a>
+</div>
+</div>
+<div id="credit">
+<hr>
+ This is documentation for development version v0.8
+ (<a href="/pluginDocs/index.html">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>
+<div id="credit2">
+<a href="http://apachecon.com/"><img border="0" title="ApacheCon Europe 2005" alt="ApacheCon Europe 2005 - logo" src="http://apache.org/images/ac2005eu_135x50.gif" style="width: 135px;height: 50px;"></a>
+</div>
+</div>
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="index.pdf"><img alt="PDF -icon" src="../../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">
+<text>Font size:</text>
+ <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>Plugins Index</h1>
+<div id="motd-area">
+ This is documentation for development version v0.8
+ (<a href="/pluginDocs/index.html">More</a>)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#Plugins+Index">Plugins Index</a>
+<ul class="minitoc">
+<li>
+<a href="#Released+Plugins">Released Plugins</a>
+<ul class="minitoc">
+<li>
+<a href="#Input+Plugins">Input Plugins</a>
+</li>
+<li>
+<a href="#Output+Plugins">Output Plugins</a>
+</li>
+<li>
+<a href="#Internal+Plugins">Internal Plugins</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Whiteboard+Plugins">Whiteboard Plugins</a>
+<ul class="minitoc">
+<li>
+<a href="#Input+Plugins-N102F1">Input Plugins</a>
+</li>
+<li>
+<a href="#Output+Plugins-N10381">Output Plugins</a>
+</li>
+<li>
+<a href="#Internal+Plugins-N103E3">Internal Plugins</a>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+</ul>
+</div>
+<a name="N10007"></a><a name="Plugins+Index"></a>
+<h2 class="underlined_10">Plugins Index</h2>
+<div class="section">
+<p>
+ Plugins are a way of extending Forrest to
+ satisfy site-specific needs. For more
+ information on plugins see
+ <a href="http://forrest.apache.org/pluginDocs/plugins_0_70/usingPlugins.html">
+ Extending Forrest with Plugins
+ </a>.
+ </p>
+<p>
+ This page lists all plugins that have been
+ recognised by the Apache Forrest project. There are two
+ sections to this page, the first is the released plugins,
+ The second is the whiteboard plugins. Any
+ plugins in the released section have been verified as
+ working in the versions of Forrest specified. However,
+ this verification does not imply that the plugins are mature,
+ merely that they work as documented. See the plugin
+ documentation for how mature they are and the features they
+ support.
+ </p>
+<p>The second section lists plugins in the whiteboard, that is
+ plugins that may change considerably in how they work before
+ their first official release. These plugins may not be fully
+ funcitonal, in most cases they are usable, but use them with
+ caution as they are not considered stable.</p>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">If you have created a plugin that is not listed
+ here please let us know.</div>
+</div>
+<a name="N1001D"></a><a name="Released+Plugins"></a>
+<h3 class="underlined_5">Released Plugins</h3>
+<a name="N10021"></a><a name="Input+Plugins"></a>
+<h4>Input Plugins</h4>
+<p>
+ Input plugins enable Forrest to work with
+ source documents in different formats.
+ </p>
+<a name="N10027"></a><a name="org.apache.forrest.plugin.input.dtdx"></a>
+<h5>org.apache.forrest.plugin.input.dtdx</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Use the NekoDTD tool packaged as a Cocoon Generator to automatically generate
+ some hyperlinked DTD reference documentation.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.dtdx">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.dtdx</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10055"></a><a name="org.apache.forrest.plugin.input.excel"></a>
+<h5>org.apache.forrest.plugin.input.excel</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Reads (simple) Excel sheets from the Excel "Save As" (Type=XML).
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.excel/">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.excel/</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins">http://forrest.apache.org/plugins</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.3-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10083"></a><a name="org.apache.forrest.plugin.input.feeder"></a>
+<h5>org.apache.forrest.plugin.input.feeder</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Embed syndicated content in a Forrest site.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.feeder">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.feeder</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins">http://forrest.apache.org/plugins</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N100B1"></a><a name="org.apache.forrest.plugin.input.listLocations"></a>
+<h5>org.apache.forrest.plugin.input.listLocations</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Use lists of locations maintained in a simple xml format
+ and transform them to documents.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.listLocations">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.listLocations</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N100DF"></a><a name="org.apache.forrest.plugin.input.OpenOffice.org"></a>
+<h5>org.apache.forrest.plugin.input.OpenOffice.org</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Use various OpenOffice.org document formats as input sources.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.OpenOffice.org">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.OpenOffice.org</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins">http://forrest.apache.org/plugins</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N1010D"></a><a name="org.apache.forrest.plugin.input.PhotoGallery"></a>
+<h5>org.apache.forrest.plugin.input.PhotoGallery</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Create a photo Gallery by simply dropping your photos into a directory.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.PhotoGallery">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.PhotoGallery</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins">http://forrest.apache.org/plugins</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N1013B"></a><a name="org.apache.forrest.plugin.input.projectInfo"></a>
+<h5>org.apache.forrest.plugin.input.projectInfo</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Generates project info such as changelog and todo list.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.projectInfo">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.projectInfo</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10169"></a><a name="org.apache.forrest.plugin.input.simplifiedDocbook"></a>
+<h5>org.apache.forrest.plugin.input.simplifiedDocbook</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Enable Simplified Docbook to be used as input.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.simplifiedDocbook">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.simplifiedDocbook</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10197"></a><a name="org.apache.forrest.plugin.input.wiki"></a>
+<h5>org.apache.forrest.plugin.input.wiki</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Embed various wiki documents in a Forrest site.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.wiki">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.wiki</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N101C5"></a><a name="org.rblasch.forrest.plugin.input.pod"></a>
+<h5>org.rblasch.forrest.plugin.input.pod</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Embed Pod (Plain Old Documentation) documents in a Forrest site.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Ronald Blaschke</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://www.rblasch.org/projects/pod-input/">http://www.rblasch.org/projects/pod-input/</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://www.rblasch.org/projects/pod-input">http://www.rblasch.org/projects/pod-input</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N101F3"></a><a name="Output+Plugins"></a>
+<h4>Output Plugins</h4>
+<p>
+ Output plugins enable Forrest to produce
+ documents in different formats.
+ </p>
+<a name="N101F9"></a><a name="org.apache.forrest.plugin.output.pdf"></a>
+<h5>org.apache.forrest.plugin.output.pdf</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Enable Forrest documents to be output in PDF format.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.output.pdf">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.output.pdf</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10227"></a><a name="org.apache.forrest.plugin.output.POD"></a>
+<h5>org.apache.forrest.plugin.output.POD</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Enable Forrest documents to be output in Plain Old
+ Documentation (POD) format.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.output.POD">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.output.POD</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10255"></a><a name="org.apache.forrest.plugin.output.Text"></a>
+<h5>org.apache.forrest.plugin.output.Text</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Enable Forrest documents to be output in Text format.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.text-output">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.text-output</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10283"></a><a name="s5"></a>
+<h5>s5</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Create S5: A Simple Standards-Based Slide Show System presentations
+ from xdocs.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Ross Gardler</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/~rgardler/testingGround/forrestPlugins/s5">http://forrest.apache.org/~rgardler/testingGround/forrestPlugins/s5</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://www.apache.org/~rgardler/testingGround/forrestPlugins/">http://www.apache.org/~rgardler/testingGround/forrestPlugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N102B1"></a><a name="Internal+Plugins"></a>
+<h4>Internal Plugins</h4>
+<p>
+ Internal plugins change the core behaviour
+ of Forrest.
+ </p>
+<a name="N102B7"></a><a name="org.apache.forrest.plugin.internal.IMSManifest"></a>
+<h5>org.apache.forrest.plugin.internal.IMSManifest</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Use an IMS Manifest file to manage site structure. Generates site.xml and
+ tabs.xml from an imsmanifest.xml file when one is available.
+
+ Also enables content in one Content Package to be embedded in another.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.internal.IMSManifest">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.internal.IMSManifest</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N102E5"></a><a name="Whiteboard+Plugins"></a>
+<h3 class="underlined_5">Whiteboard Plugins</h3>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">Plugins in this section may not automatically
+ deploy when you run Forrest as they are still in development.
+ You may need to perform some manual installation steps to use
+ them. See the plugin documentation for more details.</div>
+</div>
+<a name="N102F1"></a><a name="Input+Plugins-N102F1"></a>
+<h4>Input Plugins</h4>
+<p>
+ Input plugins enable Forrest to work with
+ source documents in different formats.
+ </p>
+<a name="N102F7"></a><a name="org.apache.forrest.plugin.input.Daisy"></a>
+<h5>org.apache.forrest.plugin.input.Daisy</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Allow content to be included from a Daisy CMS repository.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.input.Daisy/">http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.input.Daisy/</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins">http://forrest.apache.org/plugins</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.3-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10325"></a><a name="org.apache.forrest.plugin.input.excel-N10325"></a>
+<h5>org.apache.forrest.plugin.input.excel</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Reads (simple) Excel sheets from the Excel "Save As" (Type=XML).
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.input.excel/">http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.input.excel/</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins">http://forrest.apache.org/plugins</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.3-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10353"></a><a name="org.apache.forrest.plugin.input.logs"></a>
+<h5>org.apache.forrest.plugin.input.logs</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Embed log file output in Forrest sites. If Forrest is running in a
+ dynamic environment, then pages can be updated to show recent changes in the
+ log whenever required.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.input.logs">http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.input.logs</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins">http://forrest.apache.org/plugins</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N10381"></a><a name="Output+Plugins-N10381"></a>
+<h4>Output Plugins</h4>
+<p>
+ Output plugins enable Forrest to produce
+ documents in different formats.
+ </p>
+<a name="N10387"></a><a name="org.apache.forrest.plugin.Chart"></a>
+<h5>org.apache.forrest.plugin.Chart</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Charting plugin that utilises JChart.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.Chart">http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.Chart</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N103B5"></a><a name="org.apache.forrest.plugin.output.htmlArea"></a>
+<h5>org.apache.forrest.plugin.output.htmlArea</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ WYSIWYG editing of HTML documents (requires Forrest to be running dynamically).
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.output.htmlArea">http://forrest.apache.org/pluginDocs/plugin_0_70/org.apache.forrest.plugin.output.htmlArea</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+<a name="N103E3"></a><a name="Internal+Plugins-N103E3"></a>
+<h4>Internal Plugins</h4>
+<p>
+ Internal plugins change the core behaviour
+ of Forrest.
+ </p>
+<a name="N103E9"></a><a name="org.apache.forrest.plugin.internal.view"></a>
+<h5>org.apache.forrest.plugin.internal.view</h5>
+<table class="ForrestTable" cellspacing="1" cellpadding="4">
+<tr>
+<th width="25%">Description</th><td>
+<p>
+ Enable Forrest to use page-specific views and contracts. Next generation skinning.
+ </p>
+</td>
+</tr>
+<tr>
+<th width="25%">Author</th><td>Apache Forrest Project</td>
+</tr>
+<tr>
+<th width="25%">Website</th><td><a href="http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.view">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.view</a></td>
+</tr>
+<tr>
+<th width="25%">Download URL:</th><td><a href="http://forrest.apache.org/plugins/">http://forrest.apache.org/plugins/</a></td>
+</tr>
+<tr>
+<th width="25%">Plugin version</th><td>0.1-dev</td>
+</tr>
+<tr>
+<th width="25%">
+ Minimum Forrest version required
+ </th><td>0.7</td>
+</tr>
+</table>
+</div>
+</div>
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("<text>Last Published:</text> " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright ©
+ 2002-2005 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+<div id="logos">
+<a href="http://validator.w3.org/check/referer"><img style="height: 31px; width: 88px;" title="Valid HTML 4.01!" alt="Valid HTML 4.01!" src="../../skin/images/valid-html401.png" class="logoImage"></a><a href="http://jigsaw.w3.org/css-validator/check/referer"><img style="height: 31px; width: 88px;" title="Valid CSS!" alt="Valid CSS!" src="../../skin/images/vcss.png" class="logoImage"></a><a href="http://forrest.apache.org/"><img border="0" title="Built with Apache Forrest" alt="Built with Apache Forrest - logo" src="../../skin/images/built-with-forrest-button.png" style="width: 88px;height: 31px;"></a><a href="http://cocoon.apache.org/"><img border="0" title="Built with Apache Cocoon" alt="Built with Apache Cocoon - logo" src="../../images/built-with-cocoon.gif" style="width: 88px;height: 31px;"></a><a href="http://www.apache.org/foundation/thanks.html"><img border="0" title="thanks to ASF, thanks from ASF" alt="thanks to ASF, thanks from ASF - logo" src="../../images/icon.pn
g" style="width: 26px;height: 22px;"></a>
+</div>
+</div>
+</body>
+</html>
Propchange: forrest/site/pluginDocs/plugins_0_80/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/pluginDocs/plugins_0_80/index.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_80/index.pdf?rev=193078&view=auto
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/pluginDocs/plugins_0_80/index.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html?rev=193078&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html (added)
+++ forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html Wed Jun 22 22:36:19 2005
@@ -0,0 +1,403 @@
+<!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>Plugin Infrastructure (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">
+<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>
+<div class="header">
+<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>
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="../../images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<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 attr="value" name="Search" value="Search" type="submit">
+</form>
+</div>
+<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>
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<div id="level2tabs">
+<a class="base-not-selected" href="../../pluginDocs/plugins_0_70/index.html">0.70 (current)</a> | <a class="base-selected" href="../../pluginDocs/plugins_0_80/index.html">0.80-dev (under development)</a>
+</div>
+<script type="text/javascript"><!--
+document.write("<text>Last Published:</text> " + document.lastModified);
+// --></script>
+</div>
+<div class="breadtrail">
+
+
+ </div>
+<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 Plugins</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../../pluginDocs/plugins_0_80/index.html">Index</a>
+</div>
+<div class="menuitem">
+<a href="../../pluginDocs/plugins_0_80/usingPlugins.html">Using Plugins</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Plugin Infrastructure</div>
+</div>
+</div>
+<div id="credit">
+<hr>
+ This is documentation for development version v0.8
+ (<a href="/pluginDocs/index.html">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>
+<div id="credit2">
+<a href="http://apachecon.com/"><img border="0" title="ApacheCon Europe 2005" alt="ApacheCon Europe 2005 - logo" src="http://apache.org/images/ac2005eu_135x50.gif" style="width: 135px;height: 50px;"></a>
+</div>
+</div>
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="pluginInfrastructure.pdf"><img alt="PDF -icon" src="../../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">
+<text>Font size:</text>
+ <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>Plugin Infrastructure</h1>
+<div id="motd-area">
+ This is documentation for development version v0.8
+ (<a href="/pluginDocs/index.html">More</a>)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#overview">Overview</a>
+</li>
+<li>
+<a href="#What+is+a+Forrest+Plugin%3F">What is a Forrest Plugin?</a>
+<ul class="minitoc">
+<li>
+<a href="#pluginTypes">Types of Plugin</a>
+<ul class="minitoc">
+<li>
+<a href="#inputPlugins">Input Plugins</a>
+</li>
+<li>
+<a href="#outputPlugins">Output Plugins</a>
+</li>
+<li>
+<a href="#internalPlugins">Internal Plugins</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Naming+Conventions">Naming Conventions</a>
+</li>
+<li>
+<a href="#An+Example+Plugin">An Example Plugin</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#What+Does+a+Forrest+Plugin+Look+Like%3F">What Does a Forrest Plugin Look Like?</a>
+<ul class="minitoc">
+<li>
+<a href="#The+IMS+Manifest+Plugin">The IMS Manifest Plugin</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#How+does+Installation+work%3F">How does Installation work?</a>
+</li>
+<li>
+<a href="#Further+Reading">Further Reading</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000D"></a><a name="overview"></a>
+<h2 class="underlined_10">Overview</h2>
+<div class="section">
+<p>Forrest can be extended with the addition of plugins. This document
+ describes what a plugin is and outlines the plugin infrastructure so
+ that you can start building your own Forrest extensions.</p>
+</div>
+
+
+<a name="N10017"></a><a name="What+is+a+Forrest+Plugin%3F"></a>
+<h2 class="underlined_10">What is a Forrest Plugin?</h2>
+<div class="section">
+<p>A Forrest plugin is a set of resources and configuration files that
+ extend the functionality of Forrest. They will typically consist of a
+ sitemap, zero or more stylesheets and zero or more schemas.</p>
+<p>The plugins sitemap is mounted by Forrest's sitemap after the project
+ specific sitemap but before the Forrest default matchers. This allows
+ a plugin to override/extend default Forrest behaviour. By adopting a
+ plugin model we can keep the core of Forrest tightly
+ focused on the basic functionality, whilst still facilitating extensions
+ to suit individual projects needs.</p>
+<a name="N10023"></a><a name="pluginTypes"></a>
+<h3 class="underlined_5">Types of Plugin</h3>
+<p>There are three types of plugin, <span class="codefrag">input</span>,
+ <span class="codefrag">output</span> and <span class="codefrag">internal</span>. Each plugin has a
+ specific role to play and extends a different part of Forrest:</p>
+<pre class="code">
+ internal plugins
+ (site.xml, abs-linkmap etc.)
+ |
+ \|/
+ .
+ input format --> intermediate format --> output format
+ . .
+ /|\ /|\
+ | |
+ input plugin output plugin
+ (**.xml) (**.html, **.pdf etc.)
+</pre>
+<a name="N10039"></a><a name="inputPlugins"></a>
+<h4>Input Plugins</h4>
+<p>Input plugins provide a new source format. For example, the
+ OpenOffice.org plugin extends Forrest to allow the use of
+ OpenOffice.org Application file formats.</p>
+<p>An input plugin provides an <span class="codefrag">input.xmap</span> file.
+ This provides the source matchers (i.e. **.xml), it is
+ mounted in forrest.xmap before the default forrest **.xml behaviour
+ and therefore can override that default behaviour but it will not
+ interfere with any internal Forrest infrastructure matches, or any
+ other plugins infrastructure matches.</p>
+<p>An input plugin may also provide a <span class="codefrag">resources.xmap</span>
+ file. This can be used to match additional resources that are not
+ stored in XML files, for example, javascript files.</p>
+<a name="N1004F"></a><a name="outputPlugins"></a>
+<h4>Output Plugins</h4>
+<p>Output plugins provide a new output format. For example, the
+ s5 plugin extends Forrest to produce HTML slides from Forrest
+ documents.</p>
+<p>An output plugin provides an <span class="codefrag">output.xmap</span> file.
+ This provides the relevant output matchers (i.e.
+ **.html, **.pdf, **.slides), it is mounted before any of the default
+ matchers for Forrest and so can override this default behaviour.</p>
+<a name="N1005F"></a><a name="internalPlugins"></a>
+<h4>Internal Plugins</h4>
+<p>Internal plugins are for advanced use only. They provide ways
+ of extending or overriding Forrest's
+ internal operations. For example, the IMSManifest plugin
+ allows Forrest projects to use an IMS Manifest file instead of
+ a site.xml and tabs.xml configuration files.</p>
+<p>Internal plugins provide an <span class="codefrag">internal.xmap</span> file.
+ This provides the infrastructure matchers (i.e.
+ site.xml, faq.xml, issues.xml), and will be mounted before
+ *any* of the Forrest matches. This sitemap can override any behaviour
+ within Forrest and so developers of these plugins must be especially
+ careful with the construction of their matchers, since they will be
+ processed before any other matchers and consequently can easily break
+ existing functionality. You must only do a <map:generate ...>
+ if you are certain you are going to process the full result. </p>
+<a name="N10070"></a><a name="Naming+Conventions"></a>
+<h3 class="underlined_5">Naming Conventions</h3>
+<p>Technically you can name a plugin anything you like with one
+ small restriction (see below). However, we
+ do have some naming conventions that we recomend you follow. This is
+ to minimise the chances of collision between plugins from different
+ developers.</p>
+<p>The name should be structured like a java package name, and should
+ include a relevant reverse domain name. For example:</p>
+<pre class="code">org.apache.forrest.plugin.PLUGIN_TYPE.PLUGIN_NAME</pre>
+<pre class="code">net.sf.forrestPlugins.PLUGIN_TYPE.PLUGIN_NAME</pre>
+<p>Where <span class="codefrag">PLUGIN_TYPE</span> is either "internal", "input" or
+ "output" and <span class="codefrag">PLUGIN_NAME"</span> is a suitable name chosen by
+ yourself.</p>
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">Plugin names cannot have a '-' character in them. This character
+ is used to indicate the start of a version number when defining a plugin
+ to be used. See <a href="../../pluginDocs/plugins_0_80/usingPlugins.html">Using Plugins</a> for more
+ information.</div>
+</div>
+<a name="N10095"></a><a name="An+Example+Plugin"></a>
+<h3 class="underlined_5">An Example Plugin</h3>
+<p>In order to fully understand the applicability of Forrest Plugins we
+ will consider an extension to the way in which Forrest defines the
+ structure of the site. By default Forrest uses a site.xml file to
+ define navigation through the site and a tabs.xml file to define the
+ tabs across the top of the page. But what if we want to use a different
+ file to describe site structure? For example, what if we want to use an
+ IMS Manifest file from the SCORM content package standards
+ (http://www.adlnet.org/).</p>
+<p>An IMS Manifest file describes the structure of a site. It is also
+ possible to define a set of rules for extracting tab information from
+ such a file. Consequently, it is possible to use an IMSManifest file to
+ create Forrest's site.xml and tabs.xml files. The advantage would be that
+ we can then use SCORM compliant content objects within Forrest.</p>
+<p>Unfortunately, IMS Manifests are much more complex than site.xml and
+ tabs.xml files. Therefore, not all users will want to use them. Adding
+ the functionality as an optional plugin seems to be the ideal
+ solution.</p>
+</div>
+
+
+<a name="N100A6"></a><a name="What+Does+a+Forrest+Plugin+Look+Like%3F"></a>
+<h2 class="underlined_10">What Does a Forrest Plugin Look Like?</h2>
+<div class="section">
+<p>Plugins will need to conform to a specified directory structure.
+ This mirrors the default forrest directory structure:</p>
+<pre class="code">
+[plugin_name]
+ |
+ |-- config files (xmap, skinconf etc.)
+ |
+ |-- resources
+ |
+ |-- schema
+ | |
+ | |-- catalog.xcat
+ | |
+ | |-- dtd (DTDs etc.)
+ |
+ |-- stylesheets (XSLs etc.)
+</pre>
+<a name="N100B3"></a><a name="The+IMS+Manifest+Plugin"></a>
+<h3 class="underlined_5">The IMS Manifest Plugin</h3>
+<p>If we consider the IMS Manifest Plugin described above, we see that we
+ will need the following files and directory structure:</p>
+<pre class="code">
+org.apache.forrest.plugin.internal.IMSManifest
+ |
+ |-- sitemap.xmap
+ |
+ |-- resources
+ |
+ |-- stylesheets
+ |
+ |- imsmanifest2site.xsl
+ |- imsmanifest2tabs.xsl
+ |- pathutils.xsl
+ |- repositoryUtils.xsl
+</pre>
+<p>The sitemap.xmap file will override the default behaviour for the
+ navigation generation matchers in Forrest, for example, it contains
+ a matcher as follows:</p>
+<pre class="code">
+<map:match pattern="abs-menulinks">
+ <map:select type="exists">
+ <map:when test="{project:content.xdocs}imsmanifest.xml">
+ <map:generate src="{project:content.xdocs}imsmanifest.xml" />
+ <map:transform src="resources/stylesheets/imsmanifest2site.xsl"/>
+ <map:transform src="{forrest:stylesheets}/absolutize-linkmap.xsl" />
+ <map:transform src="{forrest:stylesheets}/site2site-normalizetabs.xsl" />
+ <map:serialize type="xml"/>
+ </map:when>
+ <map:when test="{project:content.xdocs}site.xml">
+ <map:generate src="{project:content.xdocs}site.xml" />
+ <map:transform src="{forrest:stylesheets}/absolutize-linkmap.xsl" />
+ <map:transform src="{forrest:stylesheets}/site2site-normalizetabs.xsl" />
+ <map:transform src="{forrest:stylesheets}/normalizehrefs.xsl"/>
+ <map:serialize type="xml"/>
+ </map:when>
+ </map:select>
+</map:match>
+</pre>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">Note that this matcher will default to the behaviour provided by
+ Forrest if there is no imsmanifest.xml file present in the project.
+ At present it is necessary to copy this default behaviour from the original
+ Forrest *.xmap files. We hope to improve on this in the future.</div>
+</div>
+</div>
+
+
+<a name="N100CC"></a><a name="How+does+Installation+work%3F"></a>
+<h2 class="underlined_10">How does Installation work?</h2>
+<div class="section">
+<p>When Forrest installs a plugin it downloads a zip of the plugin code and
+ extracts it into the <span class="codefrag">plugins</span> directory of Forrest and an entry is made
+ in <span class="codefrag">src/plugins/sitemap.xmap</span>. For example, installing the
+ IMSManifest plugin described above will result in the following entry
+ being added to the plugin sitemap:</p>
+<pre class="code">
+<map:select type="exists">
+ <map:when test="sitemap.xmap">
+ <map:mount uri-prefix=""
+ src="sitemap.xmap"
+ check-reload="yes"
+ pass-through="true"/>
+ </map:when>
+</map:select>
+ </pre>
+<p>Installed plugins are managed by the
+ FORREST_INSTALL_DIR/plugins/sitemap.xmap file. This file is mounted
+ by the main Forrest sitemap with the following code:</p>
+<pre class="code">
+ <map:pipeline internal-only="false">
+ <map:mount uri-prefix=""
+ src="{forrest:plugins}/sitemap.xmap"
+ check-reload="yes"
+ pass-through="true"/>
+ </map:pipeline>
+ </pre>
+<div class="frame note">
+<div class="label">Note</div>
+<div class="content">The plugin sitemap.xmap file is automatically managed by Forrest, the
+ end user need never edit this file.</div>
+</div>
+</div>
+
+
+<a name="N100EA"></a><a name="Further+Reading"></a>
+<h2 class="underlined_10">Further Reading</h2>
+<div class="section">
+<p>If you want to build a plugin you might like to start with our
+ <a href="../../docs_0_70/howto/howto-buildPlugin.html">HowTo on Building Plugins</a>.</p>
+</div>
+
+</div>
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("<text>Last Published:</text> " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright ©
+ 2002-2005 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+</div>
+</body>
+</html>
Propchange: forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.pdf?rev=193078&view=auto
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/site/pluginDocs/plugins_0_80/usingPlugins.html
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_80/usingPlugins.html?rev=193078&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/usingPlugins.html (added)
+++ forrest/site/pluginDocs/plugins_0_80/usingPlugins.html Wed Jun 22 22:36:19 2005
@@ -0,0 +1,246 @@
+<!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>Extending Forrest with Plugins (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">
+<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>
+<div class="header">
+<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>
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="../../images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<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 attr="value" name="Search" value="Search" type="submit">
+</form>
+</div>
+<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>
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<div id="level2tabs">
+<a class="base-not-selected" href="../../pluginDocs/plugins_0_70/index.html">0.70 (current)</a> | <a class="base-selected" href="../../pluginDocs/plugins_0_80/index.html">0.80-dev (under development)</a>
+</div>
+<script type="text/javascript"><!--
+document.write("<text>Last Published:</text> " + document.lastModified);
+// --></script>
+</div>
+<div class="breadtrail">
+
+
+ </div>
+<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 Plugins</div>
+<div id="menu_selected_1.1" class="selectedmenuitemgroup" style="display: block;">
+<div class="menuitem">
+<a href="../../pluginDocs/plugins_0_80/index.html">Index</a>
+</div>
+<div class="menupage">
+<div class="menupagetitle">Using Plugins</div>
+</div>
+<div class="menuitem">
+<a href="../../pluginDocs/plugins_0_80/pluginInfrastructure.html">Plugin Infrastructure</a>
+</div>
+</div>
+<div id="credit">
+<hr>
+ This is documentation for development version v0.8
+ (<a href="/pluginDocs/index.html">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>
+<div id="credit2">
+<a href="http://apachecon.com/"><img border="0" title="ApacheCon Europe 2005" alt="ApacheCon Europe 2005 - logo" src="http://apache.org/images/ac2005eu_135x50.gif" style="width: 135px;height: 50px;"></a>
+</div>
+</div>
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="usingPlugins.pdf"><img alt="PDF -icon" src="../../skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">
+<text>Font size:</text>
+ <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>Extending Forrest with Plugins</h1>
+<div id="motd-area">
+ This is documentation for development version v0.8
+ (<a href="/pluginDocs/index.html">More</a>)</div>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#overview">Overview</a>
+<ul class="minitoc">
+<li>
+<a href="#What+plugins+are+available%3F">What plugins are available?</a>
+</li>
+</ul>
+</li>
+<li>
+<a href="#How+is+a+Plugin+Installed%3F">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>
+</li>
+</ul>
+</li>
+<li>
+<a href="#Avoiding+Plugin+Conflicts">Avoiding Plugin Conflicts</a>
+</li>
+<li>
+<a href="#Further+Reading">Further Reading</a>
+</li>
+</ul>
+</div>
+
+<a name="N1000D"></a><a name="overview"></a>
+<h2 class="underlined_10">Overview</h2>
+<div class="section">
+<p>Forrest provides the core functionality for generating documentation
+ in various output formats from a range of input formats. However, it
+ 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>
+<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>
+<p>If you would like to have your own plugin added to this list then
+ contact the <a href="../../mail-lists.html">developer mailing list</a>.</p>
+</div>
+
+
+<a name="N1002B"></a><a name="How+is+a+Plugin+Installed%3F"></a>
+<h2 class="underlined_10">How is a Plugin Installed?</h2>
+<div class="section">
+<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>
+<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
+ extracted into a plugin. However, we have not broken backward
+ compatability with earlier versions. In the absence of a
+ <span class="codefrag">project.required.plugins</span> property in the projects
+ <span class="codefrag">forrest.properties</span> file all plugins that contain
+ functionality previously part of Forrest itself will be loaded
+ automatically. Unless you intend to use new functionality provided
+ by a plugin you will not need to make any changes top your project.</p>
+<p>If you do require additional plugin functionality, be sure to
+ include all required plugins in the
+ <span class="codefrag">project.required.plugins</span> property in the project's
+ <span class="codefrag">forrest.properties</span>. You can view
+ <span class="codefrag">main/webapp/default-forrest.properties</span>
+ to see the names of plugins that provide previously core
+ functionality.</p>
+<p>It is also worth noting that there is a small performance
+ improvement if you remove plugins that are not in use. Therefore,
+ if you do not use one or more of the plugins named in the
+ <span class="codefrag">project.required.plugins</span> property of
+ <span class="codefrag">main/webapp/default-forrest.properties</span>
+ it is recomended that you override this value in your project's
+ <span class="codefrag">forrest.properties</span> file.</p>
+</div>
+
+
+<a name="N1006F"></a><a name="Avoiding+Plugin+Conflicts"></a>
+<h2 class="underlined_10">Avoiding Plugin Conflicts</h2>
+<div class="section">
+<p>Clashes between plugins can occur. For example, the simplified-docbook
+ and full docbook plugins may try and process the same files. In this
+ instance the one that is mounted first will take precedence. Plugins
+ are mounted in the order they appear in the
+ <span class="codefrag">project.required.plugins</span> property, therefore the mounting
+ order and therefore processing precedence is under user control.</p>
+</div>
+
+
+<a name="N1007C"></a><a name="Further+Reading"></a>
+<h2 class="underlined_10">Further Reading</h2>
+<div class="section">
+<ul>
+
+<li>
+<a href="../../pluginDocs/plugins_0_80/pluginInfrastructure.html">Plugin Infrastructure</a>
+</li>
+
+<li>
+<a href="../../docs_0_70/howto/howto-buildPlugin.html">How to build a Plugin</a>
+</li>
+
+</ul>
+</div>
+
+</div>
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("<text>Last Published:</text> " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright ©
+ 2002-2005 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+</div>
+</body>
+</html>
Propchange: forrest/site/pluginDocs/plugins_0_80/usingPlugins.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/pluginDocs/plugins_0_80/usingPlugins.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_80/usingPlugins.pdf?rev=193078&view=auto
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/pluginDocs/plugins_0_80/usingPlugins.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/site/proposal-asf-forrestbot.html
URL: http://svn.apache.org/viewcvs/forrest/site/proposal-asf-forrestbot.html?rev=193078&view=auto
==============================================================================
--- forrest/site/proposal-asf-forrestbot.html (added)
+++ forrest/site/proposal-asf-forrestbot.html Wed Jun 22 22:36:19 2005
@@ -0,0 +1,217 @@
+<!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>Draft: Proposal for ASF-wide Forrestbot</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">
+<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>
+<div class="header">
+<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>
+<div class="projectlogo">
+<a href="http://forrest.apache.org/"><img class="logoImage" alt="Forrest" src="images/project-logo.gif" title="Apache Forrest"></a>
+</div>
+<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 attr="value" name="Search" value="Search" type="submit">
+</form>
+</div>
+<ul id="tabs">
+<li>
+<a class="base-not-selected" href="index.html">Welcome</a>
+</li>
+<li class="current">
+<a class="base-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>
+</div>
+</div>
+<div id="main">
+<div id="publishedStrip">
+<div id="level2tabs"></div>
+<script type="text/javascript"><!--
+document.write("<text>Last Published:</text> " + document.lastModified);
+// --></script>
+</div>
+<div class="breadtrail">
+
+
+ </div>
+<div id="menu">
+<div onclick="SwitchMenu('menu_1.1', 'skin/')" id="menu_1.1Title" class="menutitle">Getting Involved</div>
+<div id="menu_1.1" class="menuitemgroup">
+<div class="menuitem">
+<a href="contrib.html">Contributing</a>
+</div>
+<div class="menuitem">
+<a href="http://svn.apache.org/viewcvs.cgi/forrest/trunk/">Browse SVN</a>
+</div>
+<div class="menuitem">
+<a href="mail-lists.html">Mail lists</a>
+</div>
+<div class="menuitem">
+<a href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=12310000">Bugs and Issues</a>
+</div>
+<div class="menuitem">
+<a href="forrest-issues.html">Release Issues</a>
+</div>
+<div class="menuitem">
+<a href="http://vmgump.apache.org/gump/public/forrest/">Gump Integration</a>
+</div>
+<div class="menuitem">
+<a href="guidelines.html">Project guidelines</a>
+</div>
+</div>
+<div onclick="SwitchMenu('menu_selected_1.2', 'skin/')" id="menu_selected_1.2Title" class="menutitle" style="background-image: url('skin/images/chapter_open.gif');">Proposals</div>
+<div id="menu_selected_1.2" class="selectedmenuitemgroup" style="display: block;">
+<div class="menupage">
+<div class="menupagetitle">ASF Forrestbot</div>
+</div>
+</div>
+<div id="credit"></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>
+<div id="credit2">
+<a href="http://apachecon.com/"><img border="0" title="ApacheCon Europe 2005" alt="ApacheCon Europe 2005 - logo" src="http://apache.org/images/ac2005eu_135x50.gif" style="width: 135px;height: 50px;"></a>
+</div>
+</div>
+<div id="content">
+<div title="Portable Document Format" class="pdflink">
+<a class="dida" href="proposal-asf-forrestbot.pdf"><img alt="PDF -icon" src="skin/images/pdfdoc.gif" class="skin"><br>
+ PDF</a>
+</div>
+<div class="trail">
+<text>Font size:</text>
+ <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>Draft: Proposal for ASF-wide Forrestbot</h1>
+<div id="minitoc-area">
+<ul class="minitoc">
+<li>
+<a href="#overview">Overview</a>
+</li>
+<li>
+<a href="#forrestbot">About Forrestbot</a>
+</li>
+<li>
+<a href="#requirements">Requirements</a>
+</li>
+<li>
+<a href="#demo">Demonstration</a>
+</li>
+</ul>
+</div>
+
+<div class="frame warning">
+<div class="label">Warning</div>
+<div class="content">This is a draft proposal document. It is not yet the
+ consensus of ASF nor the Infrastructure committee.
+ </div>
+</div>
+
+
+<a name="N10010"></a><a name="overview"></a>
+<h2 class="underlined_10">Overview</h2>
+<div class="section">
+<p>All ASF projects need to be able to concentrate on their projects
+ and the content of their websites, rather than get tangled up in
+ arcane website publication procedures.
+ </p>
+<p>A proposal is currently being discussed for
+ <a href="http://people.apache.org/~crossley/proposal-asf-publish.html">ASF-wide documentation staging
+ and publishing</a>.
+ </p>
+<p>The context of this Forrestbot proposal is at
+ Item C through to Item G of that infrastructure, the "staging server".
+ This does not preclude other mechanisms - some projects might choose
+ to use Forrestbot.
+ </p>
+</div>
+
+
+<a name="N10024"></a><a name="forrestbot"></a>
+<h2 class="underlined_10">About Forrestbot</h2>
+<div class="section">
+<p>The Forrestbot enables the automated building and deployment of
+ websites. It will retrieve the source from SVN or CVS, build the
+ website, and then deploy it. Notifications can be sent. It keeps a
+ log of the build process.
+ See more <a href="tools/forrestbot.html">detailed explanation</a>.
+ </p>
+<p>There is also a "web interface" component to Forrestbot to enable
+ the project committers to easily trigger their website build, view
+ the result, and deploy it to the staging server.
+ See more <a href="tools/forrestbot-web-interface.html">detailed explanation</a>.
+ </p>
+</div>
+
+
+<a name="N10039"></a><a name="requirements"></a>
+<h2 class="underlined_10">Requirements</h2>
+<div class="section">
+<p>The staging server (e.g. stage.apache.org) would be a virtual server.
+ A stable version of "forrest" and "forrestbot" would be installed there.
+ Each project that uses forrestbot would have a forrestbot configuration
+ file. This defines the SVN or CVS repository to get the source from,
+ where to deploy the built site, and various other parameters.
+ </p>
+<p>The Forrestbot web interface requires a servlet container (e.g.
+ <a href="http://jakarta.apache.org/tomcat/">Apache Tomcat</a>) and
+ an <a href="http://httpd.apache.org/">Apache HTTP Server</a> would be
+ used to view the staging sites.
+ </p>
+</div>
+
+
+<a name="N1004E"></a><a name="demo"></a>
+<h2 class="underlined_10">Demonstration</h2>
+<div class="section">
+<p>
+ The recent demonstration on brutus is now gone.
+ Soon we will set up a new demo on our zone machine.
+ </p>
+</div>
+
+</div>
+<div class="clearboth"> </div>
+</div>
+<div id="footer">
+<div class="lastmodified">
+<script type="text/javascript"><!--
+document.write("<text>Last Published:</text> " + document.lastModified);
+// --></script>
+</div>
+<div class="copyright">
+ Copyright ©
+ 2002-2005 <a href="http://www.apache.org/licenses/">The Apache Software Foundation.</a>
+</div>
+</div>
+</body>
+</html>
Propchange: forrest/site/proposal-asf-forrestbot.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/proposal-asf-forrestbot.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/proposal-asf-forrestbot.pdf?rev=193078&view=auto
==============================================================================
Binary file - no diff available.
Propchange: forrest/site/proposal-asf-forrestbot.pdf
------------------------------------------------------------------------------
svn:mime-type = application/pdf
Added: forrest/site/skin/CommonMessages_de.xml
URL: http://svn.apache.org/viewcvs/forrest/site/skin/CommonMessages_de.xml?rev=193078&view=auto
==============================================================================
--- forrest/site/skin/CommonMessages_de.xml (added)
+++ forrest/site/skin/CommonMessages_de.xml Wed Jun 22 22:36:19 2005
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Copyright 1999-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<catalogue>
+ <message key="Font size:">Schriftgrösse:</message>
+ <message key="Last Published:">Zuletzt veröffentlicht:</message>
+ <message key="Search">Suche:</message>
+ <message key="Search the site with">Suche auf der Seite mit</message>
+</catalogue>
Propchange: forrest/site/skin/CommonMessages_de.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/skin/CommonMessages_en_US.xml
URL: http://svn.apache.org/viewcvs/forrest/site/skin/CommonMessages_en_US.xml?rev=193078&view=auto
==============================================================================
--- forrest/site/skin/CommonMessages_en_US.xml (added)
+++ forrest/site/skin/CommonMessages_en_US.xml Wed Jun 22 22:36:19 2005
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Copyright 1999-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<catalogue>
+ <message key="Font size:">Font size:</message>
+ <message key="Last Published:">Last Published:</message>
+ <message key="Search">Search</message>
+ <message key="Search the site with">Search the site with</message>
+</catalogue>
Propchange: forrest/site/skin/CommonMessages_en_US.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/skin/CommonMessages_es.xml
URL: http://svn.apache.org/viewcvs/forrest/site/skin/CommonMessages_es.xml?rev=193078&view=auto
==============================================================================
--- forrest/site/skin/CommonMessages_es.xml (added)
+++ forrest/site/skin/CommonMessages_es.xml Wed Jun 22 22:36:19 2005
@@ -0,0 +1,24 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Copyright 1999-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<catalogue>
+ <message key="Font size:">Tamaño del texto:</message>
+ <message key="Last Published:">Fecha de publicación:</message>
+ <message key="Search">Buscar</message>
+ <message key="Search the site with">Buscar en</message>
+</catalogue>
+
Propchange: forrest/site/skin/CommonMessages_es.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/skin/CommonMessages_fr.xml
URL: http://svn.apache.org/viewcvs/forrest/site/skin/CommonMessages_fr.xml?rev=193078&view=auto
==============================================================================
--- forrest/site/skin/CommonMessages_fr.xml (added)
+++ forrest/site/skin/CommonMessages_fr.xml Wed Jun 22 22:36:19 2005
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Copyright 1999-2004 The Apache Software Foundation or its licensors,
+ as applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+<catalogue>
+ <message key="Font size:">Taille :</message>
+ <message key="Last Published:">Dernière publication :</message>
+ <message key="Search">Rechercher</message>
+ <message key="Search the site with">Rechercher sur le site avec</message>
+</catalogue>
Propchange: forrest/site/skin/CommonMessages_fr.xml
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/skin/basic.css
URL: http://svn.apache.org/viewcvs/forrest/site/skin/basic.css?rev=193078&view=auto
==============================================================================
--- forrest/site/skin/basic.css (added)
+++ forrest/site/skin/basic.css Wed Jun 22 22:36:19 2005
@@ -0,0 +1,147 @@
+/*
+* Copyright 2002-2005 The Apache Software Foundation or its licensors,
+* as applicable.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+/**
+ * General
+ */
+
+img { border: 0; }
+
+#content table {
+ border: 0;
+ width: 100%;
+}
+/*Hack to get IE to render the table at 100%*/
+* html #content table { margin-left: -3px; }
+
+#content th,
+#content td {
+ margin: 0;
+ padding: 0;
+ vertical-align: top;
+}
+
+.clearboth {
+ clear: both;
+}
+
+.frame {
+ border: solid black 1px;
+ margin: 1em 3em;
+}
+
+.frame .label {
+ background: #369;
+ color: white;
+ font-weight: bold;
+ padding: 5px 10px;
+}
+.frame .content {
+ padding: 5px 10px;
+ background: #F0F0FF;
+ color: black;
+ line-height: 120%;
+ font-size: 90%;
+}
+.warning .label {
+ background: #C00;
+ color: white;
+}
+.warning .content {
+ background: #FFF0F0;
+ color: black;
+}
+.fixme .label {
+ background: #C6C600;
+}
+
+/**
+ * Typography
+ */
+
+body {
+ font-family: verdana, "Trebuchet MS", arial, helvetica, sans-serif;
+ font-size: 100%;
+}
+
+#content {
+ font-family: Georgia, Palatino, Times, serif;
+ font-size: 95%;
+}
+#tabs {
+ font-size: 70%;
+}
+#menu {
+ font-size: 80%;
+}
+#footer {
+ font-size: 70%;
+}
+
+h1, h2, h3, h4, h5, h6 {
+ font-family: "Trebuchet MS", verdana, arial, helvetica, sans-serif;
+ font-weight: bold;
+ margin-top: 1em;
+ margin-bottom: .5em;
+}
+
+h1 {
+ margin-top: 0;
+ margin-bottom: 1em;
+ font-size: 1.4em;
+}
+#content h1 {
+ font-size: 160%;
+ margin-bottom: .5em;
+}
+#menu h1 {
+ margin: 0;
+ padding: 10px;
+ background: #336699;
+ color: white;
+}
+h2 { font-size: 120%; }
+h3 { font-size: 100%; }
+h4 { font-size: 90%; }
+h5 { font-size: 80%; }
+h6 { font-size: 75%; }
+
+p {
+ line-height: 120%;
+ text-align: left;
+ margin-top: .5em;
+ margin-bottom: 1em;
+}
+
+#content li,
+#content th,
+#content td {
+ line-height: 110%;
+ margin-top: .1em;
+ margin-bottom: .1em;
+}
+
+#content .attribution {
+ text-align: right;
+ font-style: italic;
+ font-size: 85%;
+ margin-top: 1em;
+}
+
+.codefrag {
+ font-family: "Courier New", Courier, monospace;
+ font-size: 110%;
+}
\ No newline at end of file
Propchange: forrest/site/skin/basic.css
------------------------------------------------------------------------------
svn:eol-style = native
Added: forrest/site/skin/breadcrumbs-optimized.js
URL: http://svn.apache.org/viewcvs/forrest/site/skin/breadcrumbs-optimized.js?rev=193078&view=auto
==============================================================================
--- forrest/site/skin/breadcrumbs-optimized.js (added)
+++ forrest/site/skin/breadcrumbs-optimized.js Wed Jun 22 22:36:19 2005
@@ -0,0 +1,90 @@
+/*
+* Copyright 2002-2004 The Apache Software Foundation or its licensors,
+* as applicable.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+var PREPREND_CRUMBS=new Array();
+var link1="@skinconfig.trail.link1.name@";
+var link2="@skinconfig.trail.link2.name@";
+var link3="@skinconfig.trail.link3.name@";
+if(!(link1=="")&&!link1.indexOf( "@" ) == 0){
+ PREPREND_CRUMBS.push( new Array( link1, @skinconfig.trail.link1.href@ ) ); }
+if(!(link2=="")&&!link2.indexOf( "@" ) == 0){
+ PREPREND_CRUMBS.push( new Array( link2, @skinconfig.trail.link2.href@ ) ); }
+if(!(link3=="")&&!link3.indexOf( "@" ) == 0){
+ PREPREND_CRUMBS.push( new Array( link3, @skinconfig.trail.link3.href@ ) ); }
+var DISPLAY_SEPARATOR=" > ";
+var DISPLAY_PREPREND=" > ";
+var DISPLAY_POSTPREND=":";
+var CSS_CLASS_CRUMB="breadcrumb";
+var CSS_CLASS_TRAIL="breadcrumbTrail";
+var CSS_CLASS_SEPARATOR="crumbSeparator";
+var FILE_EXTENSIONS=new Array( ".html", ".htm", ".jsp", ".php", ".php3", ".php4" );
+var PATH_SEPARATOR="/";
+
+function sc(s) {
+ var l=s.toLowerCase();
+ return l.substr(0,1).toUpperCase()+l.substr(1);
+}
+function getdirs() {
+ var t=document.location.pathname.split(PATH_SEPARATOR);
+ var lc=t[t.length-1];
+ for(var i=0;i < FILE_EXTENSIONS.length;i++)
+ {
+ if(lc.indexOf(FILE_EXTENSIONS[i]))
+ return t.slice(1,t.length-1); }
+ return t.slice(1,t.length);
+}
+function getcrumbs( d )
+{
+ var pre = "/";
+ var post = "/";
+ var c = new Array();
+ if( d != null )
+ {
+ for(var i=0;i < d.length;i++) {
+ pre+=d[i]+postfix;
+ c.push(new Array(d[i],pre)); }
+ }
+ if(PREPREND_CRUMBS.length > 0 )
+ return PREPREND_CRUMBS.concat( c );
+ return c;
+}
+function gettrail( c )
+{
+ var h=DISPLAY_PREPREND;
+ for(var i=0;i < c.length;i++)
+ {
+ h+='<a href="'+c[i][1]+'" >'+sc(c[i][0])+'</a>';
+ if(i!=(c.length-1))
+ h+=DISPLAY_SEPARATOR; }
+ return h+DISPLAY_POSTPREND;
+}
+
+function gettrailXHTML( c )
+{
+ var h='<span class="'+CSS_CLASS_TRAIL+'">'+DISPLAY_PREPREND;
+ for(var i=0;i < c.length;i++)
+ {
+ h+='<a href="'+c[i][1]+'" class="'+CSS_CLASS_CRUMB+'">'+sc(c[i][0])+'</a>';
+ if(i!=(c.length-1))
+ h+='<span class="'+CSS_CLASS_SEPARATOR+'">'+DISPLAY_SEPARATOR+'</span>'; }
+ return h+DISPLAY_POSTPREND+'</span>';
+}
+
+if(document.location.href.toLowerCase().indexOf("http://")==-1)
+ document.write(gettrail(getcrumbs()));
+else
+ document.write(gettrail(getcrumbs(getdirs())));
+
Propchange: forrest/site/skin/breadcrumbs-optimized.js
------------------------------------------------------------------------------
svn:eol-style = native