forrest-site-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r527020 [17/20] - in /forrest/site: ./ docs_0_80/ docs_0_80/howto/ docs_0_80/howto/cvs-ssh/ docs_0_80/howto/multi/ dtdx/ plan/ pluginDocs/plugins_0_70/ pluginDocs/plugins_0_80/ procedures/ procedures/release/ skins/ tools/
Date Tue, 10 Apr 2007 04:44:05 GMT
Modified: forrest/site/pluginDocs/plugins_0_70/usingPlugins.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_70/usingPlugins.html?view=diff&rev=527020&r1=527019&r2=527020
==============================================================================
--- forrest/site/pluginDocs/plugins_0_70/usingPlugins.html (original)
+++ forrest/site/pluginDocs/plugins_0_70/usingPlugins.html Mon Apr  9 21:44:00 2007
@@ -185,85 +185,103 @@
 <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>
+<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>
+<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>
+<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>
+<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>
+<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>

Modified: forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html?view=diff&rev=527020&r1=527019&r2=527020
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.html Mon Apr  9 21:44:00 2007
@@ -205,29 +205,36 @@
 <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>
+<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>
+<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>
+<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.)
@@ -243,91 +250,120 @@
 </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>
+<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>
+<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 &lt;map:generate ...&gt;
-          if you are certain you are going to process the full result. </p>
+<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 &lt;map:generate ...&gt; 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>
+<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>
+<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="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 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>
+<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>
+<p>
+        Plugins will need to conform to a specified directory structure. This
+        mirrors the default forrest directory structure:
+      </p>
 <pre class="code">
 [plugin_name]
   |
@@ -349,8 +385,10 @@
 </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>
+<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
   |
@@ -365,10 +403,13 @@
                     |- 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>
+<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">
+
 &lt;map:match pattern="abs-menulinks"&gt;
   &lt;map:select type="exists"&gt;
     &lt;map:when test="{properties:content.xdocs}imsmanifest.xml"&gt;
@@ -387,33 +428,38 @@
   &lt;/map:when&gt;
   &lt;/map:select&gt;
 &lt;/map:match&gt;
-</pre>
+
+        </pre>
 <div class="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 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>
-      See the 
-      <a href="../../pluginDocs/plugins_0_80/usingPlugins.html">Using Plugins</a>
-      for an overview of how the plugin installation system works and the places and order
-      that will be searched.
-    </p>
-<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 a temporary sitemap that manages plugins for your content object.
-    For example, installing the 
-    IMSManifest plugin described above will result in the following entry 
-    being added to the this temporary sitemap:</p>
+        See the <a href="../../pluginDocs/plugins_0_80/usingPlugins.html">Using Plugins</a> for an overview
+        of how the plugin installation system works and the places and order
+        that will be searched.
+      </p>
+<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 a temporary sitemap that manages plugins for your
+        content object. For example, installing the IMSManifest plugin described
+        above will result in the following entry being added to the this
+        temporary sitemap:
+      </p>
 <pre class="code">
+
 &lt;map:select type="exists"&gt;
   &lt;map:when test="output.xmap"&gt;
     &lt;map:mount uri-prefix="" 
@@ -422,19 +468,23 @@
       pass-through="true"/&gt;
   &lt;/map:when&gt;
 &lt;/map:select&gt;
-  </pre>
-<p>To be more accurate, the entries are made in one of three temporary
-    sitemaps, input.xmap, output.xmap and resources.xmap. These temporary
-    sitemaps are rebuilt each time the content object is built or run, thus
-    we are always guarenteed of having the right plugins installed.</p>
+  
+      </pre>
+<p>
+        To be more accurate, the entries are made in one of three temporary
+        sitemaps, input.xmap, output.xmap and resources.xmap. These temporary
+        sitemaps are rebuilt each time the content object is built or run, thus
+        we are always guarenteed of having the right plugins installed.
+      </p>
 </div>
-
-	
+    
 <a name="N100E7"></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_80/howto/howto-buildPlugin.html">HowTo on Building Plugins</a>.</p>
+<p>
+        If you want to build a plugin you might like to start with our
+        <a href="../../docs_0_80/howto/howto-buildPlugin.html">HowTo on Building Plugins</a>.
+      </p>
 </div>
   
 </div>

Modified: forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/pluginInfrastructure.pdf?view=diff&rev=527020&r1=527019&r2=527020
==============================================================================
Binary files - no diff available.

Modified: forrest/site/pluginDocs/plugins_0_80/usingPlugins.html
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/usingPlugins.html?view=diff&rev=527020&r1=527019&r2=527020
==============================================================================
--- forrest/site/pluginDocs/plugins_0_80/usingPlugins.html (original)
+++ forrest/site/pluginDocs/plugins_0_80/usingPlugins.html Mon Apr  9 21:44:00 2007
@@ -202,112 +202,165 @@
 <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>
+<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="available"></a>
 <h3 class="underlined_5">What plugins are available?</h3>
-<p>You can run the command <span class="codefrag">forrest available-plugins</span> to get
-        a list of the known plugins for Forrest.</p>
-<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>
+<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="install"></a>
 <h2 class="underlined_10">How is a Plugin Installed?</h2>
 <div class="section">
 <a name="N10031"></a><a name="required"></a>
 <h3 class="underlined_5">List of Plugins Needed by the Project</h3>
-<p>If a site requires one or more plugins then the site designer will
-           have to list them in the <span class="codefrag">project.required.plugins</span> property
-           in the projects <span class="codefrag">forrest.properties</span> file. When Forrest
-           builds the site it will automatically discover the plugins and install
-           them. In otherwords, the user needs do nothing.</p>
-<p>For example,</p>
+<p>
+          If a site requires one or more plugins then the site designer will
+          have to list them in the <span class="codefrag">project.required.plugins</span>
+          property in the projects <span class="codefrag">forrest.properties</span> file. When
+          Forrest builds the site it will automatically discover the plugins and
+          install them. In otherwords, the user needs do nothing.
+        </p>
+<p>
+          For example,
+        </p>
 <pre class="code">project.required.plugins=org.apache.forrest.plugin.input.OpenOffice.org,org.apache.forrest.plugin.input.simplifiedDocbook</pre>
 <p>
-           will cause Forrest to load the plugins called "org.apache.forrest.plugin.input.OpenOffice.org" and
-           "org.apache.forrest.plugin.input.simplifiedDocbook".</p>
+          will cause Forrest to load the plugins called
+          "org.apache.forrest.plugin.input.OpenOffice.org" and
+          "org.apache.forrest.plugin.input.simplifiedDocbook".
+        </p>
 <div class="note">
 <div class="label">Note</div>
-<div class="content">By default a new forrest project has that property configured
-           to include some plugins. Currently there is only one to generate
-           PDF output from your source documents.</div>
+<div class="content">
+          By default a new forrest project has that property configured to
+          include some plugins. Currently there is only one to generate PDF
+          output from your source documents.
+        </div>
 </div>
 <a name="N1004E"></a><a name="version"></a>
 <h3 class="underlined_5">What Version of Plugins will be used ?</h3>
-<p>In the absence of a version number for the plugin (as is the case in the example above)
-          the most recent version that is applicabe to your release of Forrest will be used. This
-          may result in unexpected behaviour if a new version of the plugin has been released that
-          is incompatible with your current site. To force Forrest into using a specific version of
-          a plugin you should add "-VERSION_NUMBER" to the end of the plugin name. For example,
-          to force forrest to use the 1.0 version of the OpenOffice.org plugin you would use
-          <span class="codefrag">org.apache.forrest.plugin.input.OpenOffice.org-1.0</span>. If you define a version of the
-          plugin that does not exist then it will fall back to using the most recent version available.
-          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>
+          In the absence of a version number for the plugin (as is the case in
+          the example above) the most recent version that is applicabe to your
+          release of Forrest will be used. This may result in unexpected
+          behaviour if a new version of the plugin has been released that is
+          incompatible with your current site. To force Forrest into using a
+          specific version of a plugin you should add "-VERSION_NUMBER" to the
+          end of the plugin name. For example, to force forrest to use the 1.0
+          version of the OpenOffice.org plugin you would use
+          <span class="codefrag">org.apache.forrest.plugin.input.OpenOffice.org-1.0</span>. If
+          you define a version of the plugin that does not exist then it will
+          fall back to using the most recent version available. This feature is
+          useful when developing a new site as you can quickly force a plugin
+          upgrade by deleting all installed plugins (use the command 'ant
+          cleanPlugins'). However, this might result in the installation of an
+          in-development plugin, therefore in a production environment you
+          should always specify a known working version.
+        </p>
 <a name="N1005B"></a><a name="sources"></a>
 <h3 class="underlined_5">Where does Forrest look for Plugins sources?</h3>
 <a name="N10061"></a><a name="Overview"></a>
 <h4>Overview</h4>
-<p>This is fairly complex, so here is a simple overview. If you want to know the
-            details you need to read the rest of this section. For most people this overview
-            will be sufficient.</p>
-<p>Forrest will try and retrieve a plugin from local source files first, if that
-            fails it will look on a remote distribution server. Once it finds a copy of the
-            plugin it will deploy it to the local Forrest instance and use it from there.</p>
-<p>The local directories that will be searched are defined in the <span class="codefrag">project.required.plugins.src</span>
-            property, which is defined in the <span class="codefrag">forrest.properties</span> file. By default
-            this is set to <span class="codefrag">${forrest.home}/plugins,${forrest.home}/whiteboard/plugins</span>,
-            which means that these two directories will be searched for plugins.</p>
-<p>If you have a collection of local plugins you would like Forrest to use then you
-            need to add the directory to this property. For example: 
+<p>
+            This is fairly complex, so here is a simple overview. If you want to
+            know the details you need to read the rest of this section. For most
+            people this overview will be sufficient.
+          </p>
+<p>
+            Forrest will try and retrieve a plugin from local source files
+            first, if that fails it will look on a remote distribution server.
+            Once it finds a copy of the plugin it will deploy it to the local
+            Forrest instance and use it from there.
+          </p>
+<p>
+            The local directories that will be searched are defined in the
+            <span class="codefrag">project.required.plugins.src</span> property, which is defined
+            in the <span class="codefrag">forrest.properties</span> file. By default this is set
+            to
+            <span class="codefrag">${forrest.home}/plugins,${forrest.home}/whiteboard/plugins</span>,
+            which means that these two directories will be searched for plugins.
+          </p>
+<p>
+            If you have a collection of local plugins you would like Forrest to
+            use then you need to add the directory to this property. For
+            example:
             <span class="codefrag">project.required.plugins.src=${forrest.home}/plugins,${forrest.home}/whiteboard/plugins,/export/forrest_plugins</span>
+          
 </p>
-<p>You can add this line to your projects <span class="codefrag">forrest.properties</span> file. However,
-            it may be more convenient to add it to a <span class="codefrag">forrest.properties</span> file
-            in your users home directory.</p>
-<p>Forrest uses a fall back mecanism to find the plugins to install for a project.</p>
-<p>For an unversionned plugin, Forrest tries to get it from :</p>
+<p>
+            You can add this line to your projects
+            <span class="codefrag">forrest.properties</span> file. However, it may be more
+            convenient to add it to a <span class="codefrag">forrest.properties</span> file in
+            your users home directory.
+          </p>
+<p>
+          Forrest uses a fall back mecanism to find the plugins to install for a
+          project.
+        </p>
+<p>
+          For an unversionned plugin, Forrest tries to get it from :
+        </p>
 <ol>
-            
+          
 <li>different local sources directories (<span class="codefrag">project.required.plugins.src</span> property)</li>
-            
+          
 <li>if not found : the remote site in the forrest version directory</li>
-            
-<li>if not found : the remote site (with no forrest version directory)</li>
           
+<li>if not found : the remote site (with no forrest version directory)</li>
+        
 </ol>
-<p>For a versionned plugin, Forrest tries to get :</p>
+<p>
+          For a versionned plugin, Forrest tries to get :
+        </p>
 <ol>
-            
+          
 <li>the versionned plugin from different local sources directories (<span class="codefrag">project.required.plugins.src</span> property)</li>
-            
+          
 <li>if not found : the versionned plugin from the remote site in the forrest version directory</li>
-            
+          
 <li>if not found : the unversionned plugin in different local sources directory (<span class="codefrag">project.required.plugins.src</span> property again)</li>
-            
+          
 <li>if not found : the unversionned plugin from the remote site in the forrest version directory</li>
-            
-<li>if not found : the remote site (with no forrest version directory)</li>
           
+<li>if not found : the remote site (with no forrest version directory)</li>
+        
 </ol>
-<p>By default, forrest looks into the two following directories to find plugins sources : <span class="codefrag">${forrest.home}/plugins</span> and <span class="codefrag">${forrest.home}/whiteboard/plugins</span>.
-          It is possible to add other sources locations by specifying the <span class="codefrag">project.required.plugins.src</span> property
-          in the projects <span class="codefrag">forrest.properties</span> file.</p>
-<p>For example,</p>
+<p>
+          By default, forrest looks into the two following directories to find
+          plugins sources : <span class="codefrag">${forrest.home}/plugins</span> and
+          <span class="codefrag">${forrest.home}/whiteboard/plugins</span>. It is possible to add
+          other sources locations by specifying the
+          <span class="codefrag">project.required.plugins.src</span> property in the projects
+          <span class="codefrag">forrest.properties</span> file.
+        </p>
+<p>
+          For example,
+        </p>
 <pre class="code">project.required.plugins.src=${forrest.home}/plugins,${forrest.home}/whiteboard/plugins,/export/forrest_plugins</pre>
 <p>
-           will add the project specific directory <span class="codefrag">${project.home}/plugins</span> to the list of directories to search in.</p>
-<p>If sources are not found, forrest will try to get them from the Web. Forrest <em>knows</em> the plugins description with plugins descriptors files
-          in which plugins are described as follows :</p>
-<pre class="code">&lt;plugin name="org.apache.forrest.plugin.output.pdf"
+          will add the project specific directory
+          <span class="codefrag">${project.home}/plugins</span> to the list of directories to
+          search in.
+        </p>
+<p>
+          If sources are not found, forrest will try to get them from the Web.
+          Forrest <em>knows</em> the plugins description with plugins
+          descriptors files in which plugins are described as follows :
+        </p>
+<pre class="code">
+&lt;plugin name="org.apache.forrest.plugin.output.pdf"
   type="output"
   author="Apache Forrest Project"
   website="http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.output.pdf"
@@ -317,87 +370,113 @@
     Enable Forrest documents to be output in PDF format.
   &lt;/description&gt;
   &lt;forrestVersion&gt;0.8&lt;/forrestVersion&gt;
-&lt;/plugin&gt;</pre>
-<p>The url to download the different plugins is indicated in this file.</p>
-<p>By default, forrest gets the two following plugins descriptors files : <span class="codefrag">http://forrest.apache.org/plugins/plugins.xml</span> and <span class="codefrag">http://forrest.apache.org/plugins/whiteboard-plugins.xml</span>.
-          It is possible to add other plugins descriptors files by specifying the <span class="codefrag">forrest.plugins.descriptors</span> property
-          in the projects <span class="codefrag">forrest.properties</span> file.</p>
-<p>For example,</p>
+&lt;/plugin&gt;
+        </pre>
+<p>
+          The url to download the different plugins is indicated in this file.
+        </p>
+<p>
+          By default, forrest gets the two following plugins descriptors files :
+          <span class="codefrag">http://forrest.apache.org/plugins/plugins.xml</span> and
+          <span class="codefrag">http://forrest.apache.org/plugins/whiteboard-plugins.xml</span>.
+          It is possible to add other plugins descriptors files by specifying
+          the <span class="codefrag">forrest.plugins.descriptors</span> property in the projects
+          <span class="codefrag">forrest.properties</span> file.
+        </p>
+<p>
+          For example,
+        </p>
 <pre class="code">forrest.plugins.descriptors=http://forrest.apache.org/plugins/plugins.xml,http://forrest.apache.org/plugins/whiteboard-plugins.xml,file:///${project.home}/plugins/plugins.xml</pre>
 <p>
-          will add the project specific plugins descriptors file <span class="codefrag">file:///${project.home}/plugins/plugins.xml</span> to the list of descriptors.</p>
+          will add the project specific plugins descriptors file
+          <span class="codefrag">file:///${project.home}/plugins/plugins.xml</span> to the list
+          of descriptors.
+        </p>
 </div>
     
-<a name="N100FF"></a><a name="local-deploy"></a>
+<a name="N10100"></a><a name="local-deploy"></a>
 <h2 class="underlined_10">Editing plugins sources to enhance functionality</h2>
 <div class="section">
 <div class="note">
 <div class="label">Note</div>
-<div class="content">Until issue <a href="http://issues.apache.org/jira/browse/FOR-388">FOR-388</a> is fixed to 
-      enable the use of plugins in-place, any change to sources requires you to either
-      restart forrest or to manually deploy the plugin locally with "ant local-deploy".
-      See Further reading for "How to build a Plugin". It is worth noting that if your
-      changes are to Java files you will always have to restart Forrest to ensure the
-      class loader loads your new classes.</div>
-</div>
-<p>If you need to add specific behaviour to an existing plugin, you should first consider
-      whether your changes will be of use to all users of the plugin or not. If they are of
-      general use then you can edit the plugin source files in their original location (i.e. 
-      not in the build directory). Once you have completed your changes please 
-      <a href="../../contrib.html#patch">prepare a patch
-      and submit it for inclusion</a> in code base.</p>
-<p>If your changes are specific to your own use of the plugin you can create a local
-      copy of the plugin for this. However, we strongly advise against this 
-      since you will need to manually update your plugin each time a new release of the original
-      is made. In the vast majority of cases local enhancements to a plugin wil be of use
-      to the wider communtiy. Please donate back to the project and help keep it vibrant and
-      useful. See the Further Reading section at the end of this document for links to
-      documents with more information.</p>
+<div class="content">
+        Until issue
+        <a href="http://issues.apache.org/jira/browse/FOR-388">FOR-388</a> is
+        fixed to enable the use of plugins in-place, any change to sources
+        requires you to either restart forrest or to manually deploy the plugin
+        locally with "ant local-deploy". See Further reading for "How to build a
+        Plugin". It is worth noting that if your changes are to Java files you
+        will always have to restart Forrest to ensure the class loader loads
+        your new classes.
+      </div>
+</div>
+<p>
+        If you need to add specific behaviour to an existing plugin, you should
+        first consider whether your changes will be of use to all users of the
+        plugin or not. If they are of general use then you can edit the plugin
+        source files in their original location (i.e. not in the build
+        directory). Once you have completed your changes please
+        <a href="../../contrib.html#patch">prepare a patch and submit it for
+        inclusion</a> in code base.
+      </p>
+<p>
+        If your changes are specific to your own use of the plugin you can
+        create a local copy of the plugin for this. However, we strongly advise
+        against this since you will need to manually update your plugin each
+        time a new release of the original is made. In the vast majority of
+        cases local enhancements to a plugin wil be of use to the wider
+        communtiy. Please donate back to the project and help keep it vibrant
+        and useful. See the Further Reading section at the end of this document
+        for links to documents with more information.
+      </p>
 </div>
     
-    
-<a name="N10117"></a><a name="no-plugins"></a>
+<a name="N10118"></a><a name="no-plugins"></a>
 <h2 class="underlined_10">Upgrading from a Version of Forrest Without Plugins</h2>
 <div class="section">
-<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 to 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>
+<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 to 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="N1013F"></a><a name="conflict"></a>
+<a name="N10140"></a><a name="conflict"></a>
 <h2 class="underlined_10">Avoiding Plugin Conflicts</h2>
 <div class="section">
-<p>Clashes between plugins can occur. For example, the simplified-docbook
-      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>
+<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="N1014C"></a><a name="more"></a>
+<a name="N1014D"></a><a name="more"></a>
 <h2 class="underlined_10">Further Reading</h2>
 <div class="section">
 <ul>

Modified: forrest/site/pluginDocs/plugins_0_80/usingPlugins.pdf
URL: http://svn.apache.org/viewvc/forrest/site/pluginDocs/plugins_0_80/usingPlugins.pdf?view=diff&rev=527020&r1=527019&r2=527020
==============================================================================
Binary files - no diff available.

Modified: forrest/site/procedures/How_to_publish_docs.html
URL: http://svn.apache.org/viewvc/forrest/site/procedures/How_to_publish_docs.html?view=diff&rev=527020&r1=527019&r2=527020
==============================================================================
--- forrest/site/procedures/How_to_publish_docs.html (original)
+++ forrest/site/procedures/How_to_publish_docs.html Mon Apr  9 21:44:00 2007
@@ -231,8 +231,10 @@
 	          &nbsp;<input value="+a" class="biggerfont" title="Enlarge text" onclick="ndeSetTextSize('incr'); return false;" type="button">
 </div>
 <h1>How to Publish Forrest Documentation</h1>
-<div class="abstract">This documents the steps that the Documentation Coordinator should follow to update the Forrest
-            Website.</div>
+<div class="abstract">
+      This documents the steps that the Documentation Coordinator should follow
+      to update the Forrest Website.
+    </div>
 <div id="minitoc-area">
 <ul class="minitoc">
 <li>
@@ -246,72 +248,90 @@
 </li>
 </ul>
 </div>
-
-        
+    
 <div class="fixme">
 <div class="label">Fixme (open)</div>
-<div class="content">This is work in progress!</div>
+<div class="content">
+      This is work in progress!
+    </div>
 </div>
-        
+    
 <a name="N10014"></a><a name="About"></a>
 <h2 class="underlined_10">Introduction</h2>
 <div class="section">
-<p>All documentation about Apache Forrest is managed as a Forrest-built project located in the
-              site-author directory of forrest/trunk SVN. The Apapce Forrest website is updated by generating static pages from
-              the site-author-project and committing them to the forrest/site SVN, which is then
-              'svn checkout' on the forrest.apache.org webserver to create the website.</p>
 <p>
-            See other notes for the Documentation Coordinator <a href="../roles.html">role</a>.
-          </p>
+        All documentation about Apache Forrest is managed as a Forrest-built
+        project located in the site-author directory of forrest/trunk SVN. The
+        Apapce Forrest website is updated by generating static pages from the
+        site-author-project and committing them to the forrest/site SVN, which
+        is then 'svn checkout' on the forrest.apache.org webserver to create the
+        website.
+      </p>
+<p>
+        See other notes for the Documentation Coordinator
+        <a href="../roles.html">role</a>.
+      </p>
 </div>
-        
+    
 <a name="N10025"></a><a name="forrestbot-local"></a>
 <h2 class="underlined_10">Updating the site with a local forrestbot</h2>
 <div class="section">
-<p>Do once, create $FORREST_HOME/deploy.svn.settings file. These 
-            credentials are needed by forrestbot so that it can do your 'svn add' 
-            and 'svn commit' etc. to the forrest/site/ repository. The 
-            deploy.svn.settings file looks like:</p>
-<pre class="code">&lt;?xml version="1.0"?&gt;
+<p>
+        Do once, create $FORREST_HOME/deploy.svn.settings file. These
+        credentials are needed by forrestbot so that it can do your 'svn add'
+        and 'svn commit' etc. to the forrest/site/ repository. The
+        deploy.svn.settings file looks like:
+      </p>
+<pre class="code">
+&lt;?xml version="1.0"?&gt;
 &lt;project&gt;
     &lt;property name="deploy.svn.user" value="myApacheUsername"/&gt;
     &lt;property name="deploy.svn.password" value="myPassword"/&gt;
-&lt;/project&gt; </pre>
-<p>Generating and publishing the main docs is very easy using a local forrestbot:
-          </p>
+&lt;/project&gt;
+      </pre>
+<p>
+        Generating and publishing the main docs is very easy using a local
+        forrestbot:
+      </p>
 <pre class="code">cd site-author
 forrest -f publish.xml build
 forrest -f publish.xml deploy</pre>
-<p>This builds the documentation locally then deploys it by committing
-            it to the <a href="https://svn.apache.org/repos/asf/forrest/site">forrest/site SVN</a>.
-            Then a cronjob on the server will automatically publish it. However, if
-            instant turnaround is required, then do this:
-          </p>
+<p>
+        This builds the documentation locally then deploys it by committing it
+        to the
+        <a href="https://svn.apache.org/repos/asf/forrest/site">forrest/site
+        SVN</a>. Then a cronjob on the server will automatically publish it.
+        However, if instant turnaround is required, then do this:
+      </p>
 <pre class="code">ssh people.apache.org
 cd /www/forrest.apache.org
 svn update</pre>
 <p>
-            Publishing documentation for a particular plugin is done by:
-          </p>
+        Publishing documentation for a particular plugin is done by:
+      </p>
 <pre class="code">cd plugins/myPluginName
 $FORREST_HOME/tools/ant/bin/ant deploy-docs</pre>
 <p>
-            See further information in the 
-            <a href="../docs_0_80/howto/howto-buildPlugin.html">buildPlugin</a> doc.
-          </p>
-<p>See some general notes about managing
-            <a href="http://www.apache.org/dev/project-site.html">project websites</a>.
-          </p>
+        See further information in the
+        <a href="../docs_0_80/howto/howto-buildPlugin.html">buildPlugin</a> doc.
+      </p>
+<p>
+        See some general notes about managing
+        <a href="http://www.apache.org/dev/project-site.html">project
+        websites</a>.
+      </p>
 </div>
-
-        
+    
 <a name="N1005A"></a><a name="OrgDoc"></a>
 <h2 class="underlined_10">original docs</h2>
 <div class="section">
-<p>There have been a few explantions of our docs processing on the forrest-dev mail list.
-              Need to glean the info from them. Here is the content of some:</p>
+<p>
+        There have been a few explantions of our docs processing on the
+        forrest-dev mail list. Need to glean the info from them. Here is the
+        content of some:
+      </p>
 <pre class="code">
-                
+
                 To publish from trunk/site-author/
                 
                 Do once:
@@ -359,27 +379,28 @@
                 The second word is treated as an ant target to be called.
                 Just leave it out and forrestbot will use a default message.
                  
-            </pre>
-<p>Some more notes that need to be integrated above ...
-        </p>
-<p>Note that forrestbot does not remove docs from the forrest/site SVN (FOR-392).
-          So need to manually delete: 'cd /svn/forrest/site; svn delete oldDoc'.
-          Then remove it from the forrestbot work directories:
-          'cd $FORREST_HOME/site-author; rm build/forrest-docs/oldDoc; rm work/svn-deploy/forrest-docs/oldDoc'.
-        </p>
-<p>
-The generated docs are in build/forrest-docs
-which is the name given to it in the forrestbot descriptor (site-author/publish.xml).
-Here is a trick for reviewing changes that forrestbot is ready to deploy ...
-        </p>
+      </pre>
+<p>
+        Some more notes that need to be integrated above ...
+      </p>
+<p>
+        Note that forrestbot does not remove docs from the forrest/site SVN
+        (FOR-392). So need to manually delete: 'cd /svn/forrest/site; svn delete
+        oldDoc'. Then remove it from the forrestbot work directories: 'cd
+        $FORREST_HOME/site-author; rm build/forrest-docs/oldDoc; rm
+        work/svn-deploy/forrest-docs/oldDoc'.
+      </p>
+<p>
+        The generated docs are in build/forrest-docs which is the name given to
+        it in the forrestbot descriptor (site-author/publish.xml). Here is a
+        trick for reviewing changes that forrestbot is ready to deploy ...
+      </p>
 <pre class="code">
 forrest -f publish.xml build
 svn update work/svn-deploy/forrest-docs
 diff -rq build/forrest-docs work/svn-deploy/forrest-docs | grep -v "\.svn" | grep differ</pre>
 </div>
-
-
-    
+  
 </div>
 <!--+
     |end content

Modified: forrest/site/procedures/How_to_publish_docs.pdf
URL: http://svn.apache.org/viewvc/forrest/site/procedures/How_to_publish_docs.pdf?view=diff&rev=527020&r1=527019&r2=527020
==============================================================================
Binary files - no diff available.



Mime
View raw message