forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r376128 [32/34] - in /forrest/site: ./ docs_0_60/ docs_0_60/howto/ docs_0_60/howto/bugzilla-patch/ docs_0_60/howto/multi/ docs_0_70/ docs_0_70/howto/ docs_0_70/howto/cvs-ssh/ docs_0_70/howto/multi/ docs_0_80/ docs_0_80/howto/ docs_0_80/howt...
Date Thu, 09 Feb 2006 00:26:32 GMT
Added: forrest/site/live-sites.source.xml
URL: http://svn.apache.org/viewcvs/forrest/site/live-sites.source.xml?rev=376128&view=auto
==============================================================================
--- forrest/site/live-sites.source.xml (added)
+++ forrest/site/live-sites.source.xml Wed Feb  8 16:26:20 2006
@@ -0,0 +1,161 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  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.
+--><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "http://forrest.apache.org/dtd/document-v12.dtd">
+<document> 
+  <header> 
+    <title>Examples Built-With-Forrest</title> 
+  </header> 
+  <body> 
+    <p>These are some of the sites that were created using Apache Forrest
+     technology.</p>
+
+    <p>
+      If you want your site added to the list, then please send a request to
+      the <link href="site:mail-lists">mailing lists</link> or to the
+      <link href="site:bugs">Issue tracker</link>. Tell us the URL, Name, and
+      catch-phrase.
+    </p>
+     
+     <section id="skinned">
+     <title>Skinned Sites</title>
+     <p>These sites use the skinning system that was part of all releases up
+     to and including 0.7 release. This system is expected to be deprecated soon
+     in favour of a more flexible system called Dispatcher. See the
+     next section for some examples of such sites.</p>
+    <ul>
+      <li><link href="ext:xml.apache.org">Apache XML Project (xml.apache.org)</link></li>
+      <li><link href="ext:forrest">Apache Forrest</link></li>
+      <li><link href="site:references/cocoon">Apache Cocoon</link></li>
+      <li><link href="site:references/lenya">Apache Lenya</link> </li>
+      <li><link href="http://www.xmlbelux.be/">The BeLux XML User's Group</link></li>
+      <li><link href="http://aft.sourceforge.net/">Anteater</link> - Ant-based functional testing</li>
+      <li><link href="http://chaperon.sourceforge.net">Chaperon</link> - text parser</li>
+      <li><link href="http://www.iasandcb.pe.kr/3g/">IAS&amp;CB</link></li>
+      <li>Some <link href="http://www.apache.org/~coar/people.html">Apache
+        Committer</link> personal pages</li>
+      <li><link href="http://incubator.apache.org/">Apache Incubator</link></li>
+      <li><link href="ext:fop">Apache FOP</link>
+        (Formatting Objects Processor)</li>
+      <li><link href="http://www.dream-models.com/">Dream Models</link>
+        - gather information about electric radio controlled helicopters</li>
+      <li><link href="http://people.apache.org/~vgritsenko/stats/">Apache Stats (Vadim's Home Page)</link> - some web statistics</li>
+      <li><link href="http://krysalis.sf.net/">Krysalis Community Project</link></li>
+      <li><link href="http://www.moerser-blechblaesertage.de/">Moerser Blechbläsertage</link></li>
+      <li><link href="http://www.indexgeo.net/zalarm/">Z-alarm - Ensure
+        information server integrity</link></li>
+      <li><link href="http://jakarta.apache.org/poi/">Apache Jakarta POI</link></li>
+      <li><link href="http://terra-intl.com/">Terra-International, Inc. (Japanese)</link></li>
+      <li><link href="http://jakarta.terra-intl.com/poi/">Apache Jakarta POI (Japanese Translation)</link></li>
+      <li><link href="http://xfp.sourceforge.net/">XFP</link> - eXtensible Filtering Pipelines</li>
+      <li><link href="http://www.atlassian.com/software/jira/docs/latest">JIRA bugtracker documentation</link></li>
+      <li><link href="http://www.phpopentracker.de/">phpOpenTracker</link> - A framework solution for the analysis of website traffic and visitor analysis</li>
+      <li><link href="http://ws.apache.org/">Apache Web Services Project</link></li>
+      <li><link href="http://ws.apache.org/wsif/">Apache WSIF Project</link> - Web Services Invocation Framework</li>
+      <li><link href="http://xml.apache.org/xmlbeans/">Apache XMLBeans</link> - An XML-Java binding tool</li>
+      <li><link href="http://druid.sourceforge.net/">Druid: The Database Manager</link> - GUI tool to create databases (GPL)</li>
+      <li><link href="http://ws.apache.org/axis/">Apache Axis</link> - an implementation of the SOAP ("Simple Object Access Protocol")</li>
+      <li><link href="http://ws.apache.org/soap/">Apache SOAP</link> - an implementation of the SOAP submission</li>
+      <li><link href="http://community.in-corp.com/postnuke/html/community.in-corp.com/tng/">Triathlon Northern Gauteng</link></li>
+      <li><link href="http://www.kanaputs.org/">Kanaputs</link> - an interpreter for Java</li>
+      <li><link href="http://cese.sourceforge.net/">Cell Electrophysiology Simulation Environment (CESE)</link>
+        - a framework for computational electrophysiological simulations</li>
+      <li><link href="http://jakarta.apache.org/tapestry/">Apache Jakarta Tapestry</link></li>
+      <li><link href="ext:gump">Apache Gump</link></li>
+      <li><link href="http://www.agssa.net/">AG Software</link></li>
+      <li><link href="http://jakarta.apache.org/hivemind/">HiveMind</link> - a services and configuration microkernel</li>
+      <li><link href="http://www.core.gen.tr/">Core Computer Security Group</link></li>
+      <li><link href="http://jdbc.postgresql.org/">PostgreSQL JDBC Driver</link></li>
+      <li><link href="http://www.sbbi.net/">SuperBonBon Industries</link></li>
+      <li><link href="http://learnlinux.tsf.org.za/">Learn Linux</link> - developing Free/Open Source GNU/Linux Training Materials</li>
+      <li><link href="http://computerdictionary.tsf.org.za">Computer Dictionary Project</link> - develop a DocBook XML computer nomenclature glossary database</li>
+      <li><link href="http://myfaces.apache.org/">Apache MyFaces</link> - open source JavaServer(tm) Faces implementation - MVC web application framework</li>
+      <li><link href="http://www.softoutfit.com/">Cañones Software Outfitter</link></li>
+      <li><link href="http://www.inwords.co.za">InWords</link></li>
+      <li><link href="http://www.tversity.com/">TVersity - Diversifying Television</link>
+        - a UPNP/AV compliant media server that can stream Internet videos to TV screens</li>
+      <li><link href="http://www.cirquedigital.com/">Cirque|Digital, LLC</link></li>
+      <li><link href="http://incubator.apache.org/derby/">Apache Derby</link>
+        - a zero admin, embeddable java rdbms (the project is in the Apache Incubator)</li>
+      <li><link href="http://www.atbymjm.com/">ATbyMJM</link>
+        - Assistive Technology, using augmentive communication devices, by Martha Jane McLellan</li>
+      <li><link href="http://www.cccp-project.org/">CCCP Common Clan Portal</link>
+         - Primarily a J2EE website application for game clans</li>
+      <li><link href="http://www.verit.de/">verit Informationssysteme GmbH</link></li>
+      <li><link href="http://www.sello-propio.com/">Sello Propio</link> - Feng Shui in Columbia</li>
+      <li><link href="http://www.divvun.no/">Sámi proofing tools development project</link></li>
+      <li><link href="http://www.risten.no/">Sámi terminology portal</link> 
+        - (background documentation uses Forrest, the main page uses eXist+Cocoon)</li>
+      <li><link href="http://www.varietee.com.au">varietee&#8482; adjustable golf practice platforms</link></li>
+      <li><link href="http://www.discountdracula.com/">DisCountDracula</link>
+        - bargains/deals on various products and services</li>
+      <li><link href="http://www.cfas.org/">Central Florida Astronomical
+          Society</link>
+        - The Central Florida Astronomical Society, Inc.
+        (CFAS) is a 501(c)(3) organization operating in the Greater Orlando Metropolitan 
+        area and surrounding communities.</li>
+      <li><link href="http://uml2svg.sourceforge.net/">uml2svg</link>
+        - an
+        XSLT-based tool for converting XMI-compliant UML Diagrams into
+        SVG</li>
+      <li><link href="http://www.technicat.com/">technicat</link>
+        - consulting
+        and development expertise to the Internet, educational software,
+        computer graphics and video game industries</li>
+      <li><link href="http://icdl.tsf.org.za/">OpenICDL</link>
+        - training materials for International Computer Driving License certification</li>
+      <li><link href="http://www.thesummitjournal.com/">The Summit Journal</link> -
+        A global, free, translated and syndicated Adventure and Exploration publication. </li>
+      <li><link href="http://www.xprime.com.au/">X'Prime</link>
+        - Software company specialising in optimisation techniques
+        using evolutionary algorithms
+      </li>
+      <li><link href="http://www.art-painter.com/">Snjezana Vidovic - Art Painter</link>
+        - Virtual Gallery
+      </li>
+      <li><link href="http://www.j2world.net/">j2world</link>
+        - smart solutions for a mobile world</li>
+      <li><link href="http://j2ee.by.ru/">J2EE Quick Start</link></li>
+      <li><link href="http://javaworkshop.sourceforge.net ">Java Workshop</link> online web book - show cases some of the tools that every java developer should have in his / her toolbox </li>
+      <li><link href="http://www.krabbelkaefer.de">Die Krabbelkäfer</link> - 
+        homepage of the association for the promotion of child care in Usingen 
+        (Germany).</li>
+<!--  <li><link href=""></link></li> -->
+    </ul>
+    </section>
+    <section id="dispatcher">
+      <title>Sites using upcoming Dispatcher</title>
+      <p>The skinning system in versions of Forrest up to and including 0.7 was great,
+      however, it proved to be too inflexible. Soon we will have
+      brand new system called Dispatcher. The following sites are examples.
+      </p>
+      <note>The Dispatcher is still in development (as of 0.8-dev cycle), please
+      only use them if you know what you are doing. We expect to include them in
+      an upcoming release at which point we will be encouraging their use.</note>
+      <ul>
+      <li><link href="http://floatingsun.net/">Diwaker Gupta ::
+          Web/Blog/Gallery</link></li>
+        <li><link href="http://www.ourlittlestars.org/">Our Little Stars</link> - A non-profit toy library site.
+        This site is interesting because it pulls content from many locations including a Daisy CMS system and 
+        the Amazon ECS service.</li>
+        <li><link href="http://cyriaque.dupoirieux.free.fr/">Cyriaque</link> family website...</li>
+        <li><link href="http://lenya.zones.apache.org/">Apache Lenya 
+          Zone</link> - this site is using v2 with some nice demonstrations of 
+          new features like the theme switcher.</li>
+        <!--  <li><link href=""></link></li> -->
+      </ul>
+    </section>
+  </body>
+</document>
\ No newline at end of file

Propchange: forrest/site/live-sites.source.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Modified: forrest/site/mail-lists.html
URL: http://svn.apache.org/viewcvs/forrest/site/mail-lists.html?rev=376128&r1=376127&r2=376128&view=diff
==============================================================================
--- forrest/site/mail-lists.html (original)
+++ forrest/site/mail-lists.html Wed Feb  8 16:26:20 2006
@@ -250,11 +250,12 @@
         together. This discussion also builds a searchable knowledge-base.
         Doing off-list discussion is not efficient: only one person hears the
         answers and it will cause the volunteers to become burnt out.
+        See FAQ about <a href="docs_0_80/faq.html#jobs">job offers</a>.
       </p>
 </div> 
 
     
-<a name="N10045"></a><a name="Lists"></a>
+<a name="N10049"></a><a name="Lists"></a>
 <h2 class="underlined_10">Lists</h2>
 <div class="section">
 <table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -359,7 +360,7 @@
 </table>
 </div>
     
-<a name="N10115"></a><a name="Mailing+list+in+mbox-format"></a>
+<a name="N10119"></a><a name="Mailing+list+in+mbox-format"></a>
 <h2 class="underlined_10">Mailing list in mbox-format</h2>
 <div class="section">
 <p>
@@ -380,7 +381,7 @@
 </ul>
 </div>
     
-<a name="N10134"></a><a name="Related+Mailing+Lists"></a>
+<a name="N10138"></a><a name="Related+Mailing+Lists"></a>
 <h2 class="underlined_10">Related Mailing Lists</h2>
 <div class="section">
 <ul> 

Modified: forrest/site/mail-lists.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/mail-lists.pdf?rev=376128&r1=376127&r2=376128&view=diff
==============================================================================
Binary files - no diff available.

Added: forrest/site/mail-lists.source.xml
URL: http://svn.apache.org/viewcvs/forrest/site/mail-lists.source.xml?rev=376128&view=auto
==============================================================================
--- forrest/site/mail-lists.source.xml (added)
+++ forrest/site/mail-lists.source.xml Wed Feb  8 16:26:20 2006
@@ -0,0 +1,158 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  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.
+--><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.2//EN" "http://forrest.apache.org/dtd/document-v12.dtd">
+<document> 
+  <header> 
+    <title>Mailing Lists</title> 
+  </header> 
+  <body>
+    <section>
+      <title>Important Notices</title>
+      <p>Before posting a question or problem to any mailing list, please first
+        look at the following resources:</p> 
+      <ul> 
+        <li><link href="site:documentation/faq">Forrest FAQs</link></li> 
+        <li><link href="site:index">Forrest documentation</link></li> 
+        <li><link href="http://cocoon.apache.org/link/">Cocoon Links</link>
+          (section: Related Topics)
+          for pointers to general XML and XSL and Java related resources.
+          Please do not ask such questions here unless they are related to Forrest.</li> 
+        <li>Mailing list <link href="#Lists">archives</link>
+          - a veritable goldmine of Forrest-specific information.</li> 
+        <li>Contribution <link href="contrib.html#tips">notes and tips</link>
+        (e.g. a clear subject heading; being patient).</li>
+      </ul> 
+      <p>If you are posting about a problem that you are having, it will aid in
+        finding a speedy resolution if you provide full configuration details,
+        including the version number of Forrest, your operating system, JDK version, and
+        servlet engine, and full details of any errors encountered including
+        full error messages and stack traces.</p> 
+      <note>
+      Please use our Jira <link href="site:bugs">issue tracker</link>
+      to submit attachments, rather than the mailing list. Create a new
+      issue, if necessary.
+      </note>
+      <p>
+        Please do not send emails directly to individual developers asking for
+        free support. We are non-paid volunteers who help out with the project and we do not
+        necessarily have the time or energy to help people on an individual basis.
+        Instead, we have these mailing lists which contain many
+        individuals who will help to answer. There are numerous benefits of
+        using mailing lists over private communication. It is a shared resource
+        where others can also learn from common mistakes and as a community we all grow
+        together. This discussion also builds a searchable knowledge-base.
+        Doing off-list discussion is not efficient: only one person hears the
+        answers and it will cause the volunteers to become burnt out.
+        See FAQ about <link href="site:faq/jobs">job offers</link>.
+      </p>
+    </section> 
+
+    <section>
+    <title>Lists</title>
+    <table>
+      <tr>
+        <th colspan="1" rowspan="1">Name</th>
+        <th colspan="1" rowspan="1">Archives</th>
+        <th colspan="1" rowspan="1">Purpose</th>
+        <th colspan="1" rowspan="1">Notes</th>
+        <th colspan="1" rowspan="1">Subscription Management</th>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"><anchor id="forrest-user"/><strong>user@forrest</strong></td> 
+        <td colspan="1" rowspan="1"><link href="http://mail-archives.apache.org/mod_mbox/forrest-user">mod_mbox
+          at mail-archives.apache.org</link>
+          <br/><br/>
+          <link href="http://www.mail-archive.com/user@forrest.apache.org/">mail-archive.com</link>
+          <br/><br/>
+          <link href="http://dir.gmane.org/gmane.text.xml.forrest.user">Gmane</link>
+        </td>
+        <td colspan="1" rowspan="1">Any general issue related to the day-to-day use of Forrest.</td>
+        <td colspan="1" rowspan="1">This is a subscriber-only list (in an effort to stop spam), so you must join before you can post.</td>
+        <td colspan="1" rowspan="1">
+          user-subscribe&lt;at&gt;forrest.apache.org<br/>
+          user-unsubscribe&lt;at&gt;forrest.apache.org<br/>
+          user-help&lt;at&gt;forrest.apache.org
+        </td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"><anchor id="forrest-dev"/><strong>dev@forrest</strong></td> 
+        <td colspan="1" rowspan="1">
+          <link href="http://marc.theaimsgroup.com/?l=forrest-dev"> MARC: Mailing list ARChives at AIMS</link>
+          <br/><br/>
+          <link href="http://mail-archives.apache.org/mod_mbox/forrest-dev">mod_mbox
+          at mail-archives.apache.org</link>
+          <br/><br/>
+          <link href="http://www.mail-archive.com/dev@forrest.apache.org/">mail-archive.com</link>
+          <br/><br/>
+          <link href="http://dir.gmane.org/gmane.text.xml.forrest.devel">Gmane</link>
+        </td>
+        <td colspan="1" rowspan="1">Any issue related to development and enhancement.</td>
+        <td colspan="1" rowspan="1">Postings from non-subscribers are moderated.
+              <br/>Read-only NNTP access to forrest-dev is available through the
+              <link href="news://news.gmane.org:119/gmane.text.xml.forrest.devel">gmane.text.xml.forrest.devel  newsgroup</link>
+        </td>
+        <td colspan="1" rowspan="1">
+          dev-subscribe&lt;at&gt;forrest.apache.org<br/>
+          dev-unsubscribe&lt;at&gt;forrest.apache.org<br/>
+          dev-help&lt;at&gt;forrest.apache.org
+        </td>
+      </tr>
+      <tr>
+        <td colspan="1" rowspan="1"><anchor id="forrest-svn"/><strong>svn@forrest</strong></td>
+        <td colspan="1" rowspan="1"><link href="http://mail-archives.apache.org/mod_mbox/forrest-svn">mod_mbox
+        at mail-archives.apache.org</link>
+          <br/><br/>
+          <link href="http://www.mail-archive.com/svn@forrest.apache.org/">mail-archive.com</link>
+          <br/><br/>
+          <link href="http://dir.gmane.org/gmane.text.xml.forrest.cvs">Gmane</link>
+        </td>
+        <td colspan="1" rowspan="1">Receive notifications on changes in the Forrest codebase in the SVN repository.</td>
+        <td colspan="1" rowspan="1">Replies go to dev@forrest</td>
+        <td colspan="1" rowspan="1">
+          svn-subscribe&lt;at&gt;forrest.apache.org<br/>
+          svn-unsubscribe&lt;at&gt;forrest.apache.org<br/>
+          svn-help&lt;at&gt;forrest.apache.org
+        </td>
+      </tr>
+    </table>
+    </section>
+    <section>
+      <title>Mailing list in mbox-format</title>
+      <p>
+       These are Gzipped monthly archives which you can import into your
+       local mail client.
+      </p>
+      <ul>
+      <li><link href="http://forrest.apache.org/mail/user/">user</link> - Since May 2004</li>
+      <li><link href="http://forrest.apache.org/mail/dev/">dev</link> - Since February 2002</li>
+      <li><link href="http://forrest.apache.org/mail/svn/">svn</link> - Since June 2004</li> 
+      </ul>
+    </section>
+    <section>
+      <title>Related Mailing Lists</title>
+      <ul> 
+<li><link href="http://xml.apache.org/mail.html">XML Apache Projects</link>
+- list of mailing lists for all xml.apache.org projects
+</li> 
+<li>Especially
+<link href="http://cocoon.apache.org/mail-lists.html">Apache Cocoon</link>
+</li> 
+<li>All Apache Software Foundation <link href="http://www.apache.org/foundation/mailinglists.html">lists</link>.
+</li> 
+      </ul> 
+    </section> 
+  </body>
+</document>
\ No newline at end of file

Propchange: forrest/site/mail-lists.source.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/mirrors.source.xml
URL: http://svn.apache.org/viewcvs/forrest/site/mirrors.source.xml?rev=376128&view=auto
==============================================================================
--- forrest/site/mirrors.source.xml (added)
+++ forrest/site/mirrors.source.xml Wed Feb  8 16:26:20 2006
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><document><header> <!-- <meta content="HTML Tidy, see www.w3.org" name="generator"/> --> <title>Obtain the Apache Forrest distribution</title></header><body><section id="how"><title id="how">How to download</title><p class="note">Please realise that Forrest is still pre-1.0 release version. It is certainly usable for those who are prepared to move with it. See more notes about <link href="index.html#status">status</link>.</p><p>Use the links below to download a distribution of Apache Forrest from one of our mirrors. It is good practice to <link href="[location]#verify">verify the integrity</link> of the distribution files.</p><p>Apache Forrest is distributed as a <code>zip</code> archive (for Windows) and as a <code>tar.gz</code> archive (for UNIX). The contents are the same, the only difference is the line-endings of all text files.</p><p>The distribution contains all of the source code, documentation, and resources, together with 
 the pre-built ready-to-run forrest binary.</p></section><section id="closest"><title id="closest">Current official release (closest mirror site selected automatically)</title><p>You are currently using <strong>[preferred]</strong>. If you encounter a problem with this mirror, then please select another. If all mirrors are failing, there are backup mirrors at the end of the list. See <link href="http://www.apache.org/mirrors/">status</link> of mirrors.</p><form id="SelectMirror" method="get" action="[location]">Other mirrors: <select name="Preferred"><!--[if-any http] [for http]--><option value="[http]">[http]</option><!--[end] [end]--><!--[if-any ftp] [for ftp]--><option value="[ftp]">[ftp]</option><!--[end] [end]--><!--[if-any backup] [for backup]--><option value="[backup]">[backup] (backup)</option><!--[end] [end]--></select> <input value="Change" type="submit"/></form><p>The current release is Apache Forrest 0.7 (see the <link href="[preferred]/forrest/RELEASE-NOTES-0.7.t
 xt">release notes</link>).</p><ul><li>For UNIX operating systems: <link href="[preferred]/forrest/apache-forrest-0.7.tar.gz">apache-forrest-0.7.tar.gz</link> [<link href="http://www.apache.org/dist/forrest/apache-forrest-0.7.tar.gz.asc">PGP</link>] [<link href="http://www.apache.org/dist/forrest/apache-forrest-0.7.tar.gz.md5">MD5</link>]</li><li>For Windows operating systems: <link href="[preferred]/forrest/apache-forrest-0.7.zip">apache-forrest-0.7.zip</link> [<link href="http://www.apache.org/dist/forrest/apache-forrest-0.7.zip.asc">PGP</link>] [<link href="http://www.apache.org/dist/forrest/apache-forrest-0.7.zip.md5">MD5</link>]</li></ul></section><section id="svn"><title id="svn">Snapshots of current development and head SVN repository</title><p>If you want to use the latest Apache Forrest features, the source code is under version control with Subversion (read how to <link href="site:documentation/developers/build">obtain</link> your working copy). There are also compr
 essed source <link href="http://svn.apache.org/snapshots/forrest/">snapshots</link> that are packed every 6 hours.</p></section><section id="archive"><title id="archive">Archive of old releases</title><p>Older releases are available in the <link href="http://archive.apache.org/dist/forrest/">archive</link>. Those releases are only provided as historical artefacts. We strongly recommend to not use those releases, but upgrade to the most recent release.</p></section><section id="verify"><title id="verify">Verify releases</title><p>It is essential that you verify the integrity of the downloaded files using the PGP and MD5 signatures. MD5 verification ensures the file was not corrupted during the download process. PGP verification ensures that the file came from a certain person.</p><p>The PGP signatures can be verified using <link href="http://www.pgpi.org/">PGP</link> or <link href="http://www.gnupg.org/">GPG</link>. First download the Apache Forrest <link href="http://svn.apa
 che.org/repos/asf/forrest/trunk/KEYS">KEYS</link> as well as the <code>asc</code> signature file for the particular distribution. It is important that you get these files from the ultimate trusted source - the main ASF distribution site, rather than from a mirror. Then verify the signatures using ...</p><pre>% pgpk -a KEYS
+% pgpv apache-forrest-X.Y.tar.gz.asc
+
+<em>or</em>
+
+% pgp -ka KEYS
+% pgp apache-forrest-X.Y.tar.gz.asc
+
+<em>or</em>
+
+% gpg --import KEYS
+% gpg --verify apache-forrest-X.Y.tar.gz.asc
+</pre><p>To verify the MD5 signature on the files, you need to use a program called <code>md5</code> or <code>md5sum</code>, which is included in many unix distributions. It is also available as part of <link href="http://www.gnu.org/software/textutils/textutils.html">GNU Textutils</link>. Windows users can get binary md5 programs from <link href="http://www.fourmilab.ch/md5/">here</link>, <link href="http://www.pc-tools.net/win32/freeware/console/">here</link>, or <link href="http://www.slavasoft.com/fsum/">here</link>.</p><p>We strongly recommend you verify your downloads with both PGP and MD5.</p></section></body></document>
\ No newline at end of file

Propchange: forrest/site/mirrors.source.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/plan/index.source.xml
URL: http://svn.apache.org/viewcvs/forrest/site/plan/index.source.xml?rev=376128&view=auto
==============================================================================
--- forrest/site/plan/index.source.xml (added)
+++ forrest/site/plan/index.source.xml Wed Feb  8 16:26:20 2006
@@ -0,0 +1,60 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  Copyright 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.
+--><document>
+  <header>
+    <title>Planning notes</title>
+  </header>
+  <body>
+    <section id="overview">
+      <title>Overview</title>
+      <p>
+        This is a collection of notes to assist with certain project planning
+        and to co-ordinate development.
+        When the development work is complete, then these docs can be removed
+        because all of the content will have moved into the documentation proper.
+      </p>
+      <p>
+        Refer to the <link href="site:bugs">Issue Tracker</link> for further specific
+        information. Try to keep these notes, and the issues, as concise as possible.
+      </p>
+    </section>
+
+    <section id="topics">
+      <title>Ongoing major development topics</title>
+      <p>Some current topics in no particular order.</p>
+      <ul>
+        <li>
+          <link href="internal-xhtml.html">Internal structure is XHTML2</link>
+        </li>
+        <li>
+          Integrate the "views" facility with the core and rename its components.
+        </li>
+        <li>
+          Forrest profiling, memory consumption, sitemap efficiency.
+        </li>
+        <li>
+          Configuration system.
+        </li>
+        <li>
+          Define strategy for releases.
+        </li>
+        <li>
+          Improve integration of Lenya and Forrest.
+        </li>
+      </ul>
+    </section>
+  </body>
+</document>
\ No newline at end of file

Propchange: forrest/site/plan/index.source.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/plan/internal-xhtml.source.xml
URL: http://svn.apache.org/viewcvs/forrest/site/plan/internal-xhtml.source.xml?rev=376128&view=auto
==============================================================================
--- forrest/site/plan/internal-xhtml.source.xml (added)
+++ forrest/site/plan/internal-xhtml.source.xml Wed Feb  8 16:26:20 2006
@@ -0,0 +1,44 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  Copyright 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.
+--><document>
+  <header>
+    <title>Plan: Internal structure is XHTML2</title>
+  </header>
+  <body>
+    <section id="overview">
+      <title>Overview</title>
+      <p>
+        The internal document structure currently uses document-v13
+        and this is due to become XHTML2.
+      </p>
+      <p>
+        See the parent issue:
+        <link href="http://issues.apache.org/jira/browse/FOR-184">FOR-184</link>
+        which also has links to some of the various email discussion threads.
+      </p>
+    </section>
+
+    <section id="tasks">
+      <title>Tasks</title>
+      <p>
+        The first job is to define what needs to happen. See the email
+        discussion:
+        <link href="http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=112512727827172">Re: Planning the move to XHTML2</link>. Ross has started to add those as
+        subtasks for issue FOR-184.
+      </p>
+    </section>
+  </body>
+</document>
\ No newline at end of file

Propchange: forrest/site/plan/internal-xhtml.source.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/index.source.xml
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/index.source.xml?rev=376128&view=auto
==============================================================================
--- forrest/site/pluginDocs/index.source.xml (added)
+++ forrest/site/pluginDocs/index.source.xml Wed Feb  8 16:26:20 2006
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  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.
+--><document>
+  <header>
+    <title>Plugins documentation for each version</title>
+  </header>
+  <body>
+    <p>
+      Plugins documentation is available for various releases ...
+    </p>
+    <ul>
+      <li><link href="site:v0.70/plugins/index">0.7</link> - the current release</li>
+      <li><link href="site:v0.80/plugins/index">0.8-dev</link> - the current development version</li>
+    </ul>
+  </body>
+</document>
\ No newline at end of file

Propchange: forrest/site/pluginDocs/index.source.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/plugins_0_70/index.source.xml
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_70/index.source.xml?rev=376128&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_70/index.source.xml (added)
+++ forrest/site/pluginDocs/plugins_0_70/index.source.xml Wed Feb  8 16:26:20 2006
@@ -0,0 +1,166 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><document><header><title>Plugins Index</title></header><body><section><title>Plugins Index</title><p>
+            Plugins are a way of extending Forrest to
+            satisfy site-specific needs. If a site requires one or 
+            more plugins then the site designer will 
+            have named them in the <code>project.required.plugins</code> property 
+            in the projects <code>forrest.properties</code> file. When Forrest 
+            builds the site it will automatically discover the plugin and install 
+            it.For more information on how to use 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><note>If you have created a plugin that is not listed
+            here please let us know.</note><note>The minimum version of Forrest is for latest version of
+          the plugin, there may be an earlier versions of the plugin for
+          earlier versions of Forrest. If you do not define a version 
+          number for the plugin it will always use the latest version
+          compatible with your version of Forrest. However, be aware
+          that if you are using a development version of forrest, you
+          will also be using development versions of the plugins.</note><section><title>Released Plugins</title><section><title>Input Plugins</title><p>
+        Input plugins enable Forrest to work with
+        source documents in different formats.
+      </p><section><title>org.apache.forrest.plugin.input.dtdx</title><table><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_80/org.apache.forrest.plugin.input.dtdx">http://forrest.apache.org/pluginDocs/plugins_0_80/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%">Latest Plugin version</th><td>0.2</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8</td></tr></table></section><section><title>org.apache.forrest.plugin.input.excel</title><table><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_80/org.apache.forrest.plugin.input.excel/">http://forrest.apache.org/pluginDocs/plugins_0_80/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%">Latest Plugin version</th><td>0.3-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8</td></tr></table></section><section><title>org.apache.forrest.plugin.input.feeder</title><table><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_80/org.apache.forrest.plugin.input.feeder">http://forrest.apache.org/pluginDocs/plugins_0_80/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%">Latest Plugin version</th><td>0.2</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8</td></tr></table></section><section><title>org.apache.forrest.plugin.input.listLocations</title><table><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_80/org.apache.forrest.plugin.input.listLocations">http://forrest.apache.org/pluginDocs/plugins_0_80/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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8</td></tr></table></section><section><title>org.apache.forrest.plugin.input.OpenOffice.org</title><table><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_80/org.apache.forrest.plugin.input.OpenOffice.org">http://forrest.apache.org/pluginDocs/plugins_0_80/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%">Latest Plugin version</th><td>0.2</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8</td></tr></table></section><section><title>org.apache.forrest.plugin.input.PhotoGallery</title><table><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_80/org.apache.forrest.plugin.input.PhotoGallery">http://forrest.apache.org/pluginDocs/plugins_0_80/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%">Latest Plugin version</th><td>0.2</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8</td></tr></table></section><section><title>org.apache.forrest.plugin.input.projectInfo</title><table><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_80/org.apache.forrest.plugin.input.projectInfo">http://forrest.apache.org/pluginDocs/plugins_0_80/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%">Latest Plugin version</th><td>0.2</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8</td></tr></table></section><section><title>org.apache.forrest.plugin.input.simplifiedDocbook</title><table><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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>org.apache.forrest.plugin.input.wiki</title><table><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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>org.rblasch.forrest.plugin.input.pod</title><table><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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section></section><section><title>Output Plugins</title><p>
+        Output plugins enable Forrest to produce
+        documents in different formats.
+      </p><section><title>org.apache.forrest.plugin.output.pdf</title><table><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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>org.apache.forrest.plugin.output.POD</title><table><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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>org.apache.forrest.plugin.output.Text</title><table><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.output.Text">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.output.Text</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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>s5</title><table><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%">Latest Plugin version</th><td>0.1-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section></section><section><title>Internal Plugins</title><p>
+        Internal plugins change the core behaviour
+        of Forrest.
+      </p></section></section><section><title>Whiteboard Plugins</title><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><section><title>Input Plugins</title><p>
+        Input plugins enable Forrest to work with
+        source documents in different formats.
+      </p><section><title>org.apache.forrest.plugin.input.Daisy</title><table><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/plugins_0_70/org.apache.forrest.plugin.input.Daisy/">http://forrest.apache.org/pluginDocs/plugins_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%">Latest Plugin version</th><td>0.1-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>org.apache.forrest.plugin.input.ecs</title><table><tr><th width="25%">Description</th><td><p>
+      Process responses from Amaozons E-Commerce System web services.
+    </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.ecs/">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.input.ecs/</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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8</td></tr></table></section><section><title>org.apache.forrest.plugin.input.logs</title><table><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/plugins_0_70/org.apache.forrest.plugin.input.logs">http://forrest.apache.org/pluginDocs/plugins_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%">Latest Plugin version</th><td>0.1-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>org.apache.forrest.plugin.input.Resume</title><table><tr><th width="25%">Description</th><td><p>
+      Basic support for Resumes, renders a single resume, or alloes sorting of 
+      a number of resumes on skill.
+    </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.f\ orrest.plugin.input.Resume">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.f\ orrest.plugin.input.Resume</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%">Latest Plugin version</th><td>0.1-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section></section><section><title>Output Plugins</title><p>
+        Output plugins enable Forrest to produce
+        documents in different formats.
+      </p><section><title>org.apache.forrest.plugin.output.Anakia</title><table><tr><th width="25%">Description</th><td><p>
+      Produce output in Anakia "xdoc" 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_80/org.apache.forrest.plugin.output.Anakia/">http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.Anakia/</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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8</td></tr></table></section><section><title>org.apache.forrest.plugin.output.Chart</title><table><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/plugins_0_70/org.apache.forrest.plugin.output.Chart">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.output.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%">Latest Plugin version</th><td>0.1-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>org.apache.forrest.plugin.output.htmlArea</title><table><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/plugins_0_70/org.apache.forrest.plugin.output.htmlArea">http://forrest.apache.org/pluginDocs/plugins_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%">Latest Plugin version</th><td>0.1-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>org.apache.forrest.plugin.output.voice</title><table><tr><th width="25%">Description</th><td><p>
+      Add voiceXML content to a Forrest page. This allows the page to be read by a voice synthesiser
+      and navigated with voice commands.
+    </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_80/org.apache.forrest.plugin.output.voice">http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.voice</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%">Latest Plugin version</th><td>0.1-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8-dev</td></tr></table></section></section><section><title>Internal Plugins</title><p>
+        Internal plugins change the core behaviour
+        of Forrest.
+      </p><section><title>org.apache.forrest.plugin.internal.IMSManifest</title><table><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%">Latest Plugin version</th><td>0.1</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section><section><title>org.apache.forrest.plugin.internal.NoteTaking</title><table><tr><th width="25%">Description</th><td><p>
+      Provides facilities for adding notes to pages when Forrest is run in dynamic mode.
+    </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.NoteTaking">http://forrest.apache.org/pluginDocs/plugins_0_70/org.apache.forrest.plugin.NoteTaking</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%">Latest Plugin version</th><td>0.1-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.8-dev</td></tr></table></section><section><title>org.apache.forrest.plugin.internal.view</title><table><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%">Latest Plugin version</th><td>0.1-dev</td></tr><tr><th width="25%">
+            Minimum Forrest version required *
+          </th><td>0.7</td></tr></table></section></section></section></section></body></document>
\ No newline at end of file

Propchange: forrest/site/pluginDocs/plugins_0_70/index.source.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/plugins_0_70/pluginInfrastructure.source.xml
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_70/pluginInfrastructure.source.xml?rev=376128&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_70/pluginInfrastructure.source.xml (added)
+++ forrest/site/pluginDocs/plugins_0_70/pluginInfrastructure.source.xml Wed Feb  8 16:26:20 2006
@@ -0,0 +1,291 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  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.
+--><document>
+  <header>
+    <title>Plugin Infrastructure</title>
+  </header>
+
+  <body>
+    <section id="overview">
+      <title>Overview</title>
+      <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>
+    </section>
+      
+    <section>
+      <title>What is a Forrest Plugin?</title>
+
+      <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>
+      
+      <section id="pluginTypes">
+        <title>Types of Plugin</title>
+        <p>There are three types of plugin, <code>input</code>,
+        <code>output</code> and <code>internal</code>. Each plugin has a 
+        specific role to play and extends a different part of Forrest:</p>
+        
+<source xml:space="preserve">
+                            internal plugins
+                       (site.xml, abs-linkmap etc.)
+                                   |
+                                  \|/
+                                   .
+          input format --&gt; intermediate format --&gt; output format 
+                        .                       .
+                       /|\                     /|\
+                        |                       |
+                   input plugin            output plugin
+                     (**.xml)         (**.html, **.pdf etc.) 
+</source>
+        
+      
+        <p>The name of the sitemap will reflect the type of plugin in use.
+        That is, an internal plugin will have a sitemap called <code>internal.xmap</code>,
+        an output plugin has <code>output.xmap</code> and an input plugin has
+        <code>input.xmap</code>. In addition, an input plugin can optionally provide a
+        <code>resources.xmap</code>.</p>
+      
+        <section id="inputPlugins">
+          <title>Input Plugins</title>
+          <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 <code>input.xmap</code> 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 <code>resources.xmap</code>
+          file. This can be used to match additional resources that are not 
+          stored in XML files, for example, javascript files.</p>
+        </section>
+        
+        <section id="outputPlugins">
+          <title>Output Plugins</title>
+          
+          <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 <code>output.xmap</code> 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>
+        </section>
+        
+        <section id="internalPlugins">
+          <title>Internal Plugins</title>
+          
+          <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 <code>internal.xmap</code> 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 &lt;map:generate ...&gt;
+          if you are certain you are going to process the full result. </p>
+        </section>
+      </section>
+      
+      <section>
+        <title>Naming Conventions</title>
+        <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>
+        
+        <source xml:space="preserve">org.apache.forrest.plugin.PLUGIN_TYPE.PLUGIN_NAME</source>
+        <source xml:space="preserve">net.sf.forrestPlugins.PLUGIN_TYPE.PLUGIN_NAME</source>
+        
+        <p>Where <code>PLUGIN_TYPE</code> is either "internal", "input" or
+        "output" and <code>PLUGIN_NAME"</code> is a suitable name chosen by
+        yourself.</p>
+        
+        <warning>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 <link href="site:plugins/using">Using Plugins</link> for more 
+        information.</warning>
+        
+      </section>
+      
+      <section>
+        <title>An Example Plugin</title>
+  
+        <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>
+      </section>
+    </section>
+
+    <section>
+      <title>What Does a Forrest Plugin Look Like?</title>
+
+      <p>Plugins will need to conform to a specified directory structure. 
+      This mirrors the default forrest directory structure:</p>
+
+<source xml:space="preserve">
+[plugin_name]
+  |
+  |-- config files (xmap, skinconf etc.)
+  |
+  |-- resources
+      |
+      |-- schema
+      |   |
+      |   |-- catalog.xcat
+      |   |
+      |   |-- dtd (DTDs etc.)
+      |
+      |-- stylesheets (XSLs etc.)
+</source>
+  
+    <section>
+      <title>The IMS Manifest Plugin</title>
+
+      <p>If we consider the IMS Manifest Plugin described above, we see that we
+      will need the following files and directory structure:</p>
+
+     
+<source xml:space="preserve">
+org.apache.forrest.plugin.internal.IMSManifest
+  |
+  |-- internal.xmap
+  |
+  |-- resources
+      |
+      |-- stylesheets
+                    |
+                    |- imsmanifest2site.xsl
+                    |- imsmanifest2tabs.xsl
+                    |- pathutils.xsl
+                    |- repositoryUtils.xsl
+</source>
+
+      <p>The internal.xmap file will override the default behaviour for the 
+      navigation generation matchers in Forrest, for example, it contains 
+      a matcher as follows:</p>
+
+<source xml:space="preserve">
+&lt;map:match pattern="abs-menulinks"&gt;
+  &lt;map:select type="exists"&gt;
+    &lt;map:when test="{project:content.xdocs}imsmanifest.xml"&gt;
+       &lt;map:generate src="{project:content.xdocs}imsmanifest.xml" /&gt;
+       &lt;map:transform src="resources/stylesheets/imsmanifest2site.xsl"/&gt;
+       &lt;map:transform src="{forrest:stylesheets}/absolutize-linkmap.xsl" /&gt;
+       &lt;map:transform src="{forrest:stylesheets}/site2site-normalizetabs.xsl" /&gt;
+     &lt;map:serialize type="xml"/&gt;
+   &lt;/map:when&gt;
+   &lt;map:when test="{project:content.xdocs}site.xml"&gt;
+      &lt;map:generate src="{project:content.xdocs}site.xml" /&gt;
+      &lt;map:transform src="{forrest:stylesheets}/absolutize-linkmap.xsl" /&gt;
+      &lt;map:transform src="{forrest:stylesheets}/site2site-normalizetabs.xsl" /&gt;
+      &lt;map:transform src="{forrest:stylesheets}/normalizehrefs.xsl"/&gt;
+    &lt;map:serialize type="xml"/&gt;
+  &lt;/map:when&gt;
+  &lt;/map:select&gt;
+&lt;/map:match&gt;
+</source>
+
+      <note>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.</note>
+    </section>
+  </section>
+
+  <section>
+    <title>How does Installation work?</title>
+    <p>When Forrest installs a plugin it downloads a zip of the plugin code and 
+    extracts it into the <code>plugins</code> directory of Forrest and an entry is made 
+    in <code>src/plugins/[input|internal|output].xmap</code> (recall the actual sitemap
+    name is dependant on the type of plugin it belongs to. For example, installing the 
+    IMSManifest plugin described above will result in the following entry 
+    being added to the plugin sitemap:</p>
+
+  <source xml:space="preserve">
+&lt;map:select type="exists"&gt;
+  &lt;map:when test="input.xmap"&gt;
+    &lt;map:mount uri-prefix="" 
+      src="sitemap.xmap" 
+      check-reload="yes" 
+      pass-through="true"/&gt;
+  &lt;/map:when&gt;
+&lt;/map:select&gt;
+  </source>
+  
+      <p>Installed plugins are managed by the
+      FORREST_INSTALL_DIR/build/plugins/sitemap.xmap file. This file is mounted
+      by the main Forrest sitemap with the following code:</p>
+  
+  <source xml:space="preserve">
+        &lt;map:pipeline internal-only="false"&gt;
+           &lt;map:mount uri-prefix=""
+                      src="{forrest:plugins}/sitemap.xmap"
+                      check-reload="yes"
+                      pass-through="true"/&gt;
+        &lt;/map:pipeline&gt;
+  </source>
+      
+      <note>The above plugin sitemap.xmap file is automatically managed by Forrest, the 
+      end user need never edit this file.</note>
+    </section>
+
+	<section>
+		<title>Further Reading</title>
+		<p>If you want to build a plugin you might like to start with our 
+		<link href="site:v0.70//howto/buildPlugin">HowTo on Building Plugins</link>.</p>
+	</section>
+  </body>
+</document>
\ No newline at end of file

Propchange: forrest/site/pluginDocs/plugins_0_70/pluginInfrastructure.source.xml
------------------------------------------------------------------------------
    svn:eol-style = native

Added: forrest/site/pluginDocs/plugins_0_70/usingPlugins.source.xml
URL: http://svn.apache.org/viewcvs/forrest/site/pluginDocs/plugins_0_70/usingPlugins.source.xml?rev=376128&view=auto
==============================================================================
--- forrest/site/pluginDocs/plugins_0_70/usingPlugins.source.xml (added)
+++ forrest/site/pluginDocs/plugins_0_70/usingPlugins.source.xml Wed Feb  8 16:26:20 2006
@@ -0,0 +1,117 @@
+<?xml version="1.0" encoding="ISO-8859-1"?><!--
+  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.
+--><document>
+  <header>
+    <title>Extending Forrest with Plugins</title>
+  </header>
+
+  <body>
+    <section id="overview">
+      <title>Overview</title>
+      <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>
+  
+      <section>
+        <title>What plugins are available?</title>
+        <p>You can run the command <code>forrest available-plugins</code> 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 <link href="site:mail-lists">developer mailing list</link>.</p>
+      </section>
+    </section>
+        
+    <section>
+      <title>How is a Plugin Installed?</title>
+  
+      <p>If a site requires one or more plugins then the site designer will 
+      have named them in the <code>project.required.plugins</code> property 
+      in the projects <code>forrest.properties</code> file. When Forrest 
+      builds the site it will automatically discover the plugin and install 
+      it. In otherwords, the user need do nothing. For example, 
+      <code>project.required.plugins=org.apache.forrest.plugin.input.OpenOffice.org,org.apache.forrest.plugin.input.simplifiedDocbook</code>
+      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
+      <code>org.apache.forrest.plugin.input.OpenOffice.org-1.0</code> 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>
+  
+      <section>
+        <title>Upgrading from a Version of Forrest Without Plugins</title>
+        <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
+        <code>project.required.plugins</code> property in the projects 
+        <code>forrest.properties</code> 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 
+        <code>project.required.plugins</code> property in the project's
+        <code>forrest.properties</code>. You can view
+        <code>main/webapp/default-forrest.properties</code>
+        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 
+        <code>project.required.plugins</code> property of 
+        <code>main/webapp/default-forrest.properties</code>
+        it is recomended that you override this value in your project's
+        <code>forrest.properties</code> file.</p>
+      </section>
+    </section>
+    
+    <section>
+      <title>Avoiding Plugin Conflicts</title>
+      <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 
+      <code>project.required.plugins</code> property, therefore the mounting 
+      order and therefore processing precedence is under user control.</p>
+    </section>
+    
+    <section>
+      <title>Further Reading</title>
+      <ul>
+        <li><link href="site:plugins/infrastructure">Plugin Infrastructure</link></li>
+        <li><link href="site:v0.70//howto/buildPlugin">How to build a Plugin</link></li>
+      </ul>
+    </section>
+  </body>
+</document>
\ No newline at end of file

Propchange: forrest/site/pluginDocs/plugins_0_70/usingPlugins.source.xml
------------------------------------------------------------------------------
    svn:eol-style = native



Mime
View raw message