You are viewing a plain text version of this content. The canonical link for it is here.
Posted to svn@forrest.apache.org by cr...@apache.org on 2006/05/17 07:13:05 UTC
svn commit: r407160 - in /forrest/site: ./ docs_0_60/ docs_0_70/ docs_0_80/
Author: crossley
Date: Tue May 16 22:13:04 2006
New Revision: 407160
URL: http://svn.apache.org/viewcvs?rev=407160&view=rev
Log:
Automatic publish from forrestbot
Modified:
forrest/site/changes.rss
forrest/site/changes.xml
forrest/site/docs_0_60/changes.html
forrest/site/docs_0_60/changes.pdf
forrest/site/docs_0_60/changes.rss
forrest/site/docs_0_70/changes.html
forrest/site/docs_0_70/changes.pdf
forrest/site/docs_0_70/changes.rss
forrest/site/docs_0_70/changes.xml
forrest/site/docs_0_80/changes.html
forrest/site/docs_0_80/changes.pdf
forrest/site/docs_0_80/changes.rss
forrest/site/docs_0_80/changes.xml
forrest/site/docs_0_80/faq.html
forrest/site/docs_0_80/faq.pdf
forrest/site/docs_0_80/faq.xml
Modified: forrest/site/changes.rss
URL: http://svn.apache.org/viewcvs/forrest/site/changes.rss?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/changes.rss (original)
+++ forrest/site/changes.rss Tue May 16 22:13:04 2006
@@ -55,7 +55,7 @@
DC
:
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
</description></item>
<item><title>code update</title><link>changes.html</link><description>code update
by
@@ -4387,7 +4387,7 @@
DC
:
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
</description></item><item><title>code update</title><link>changes.html</link><description>code update
by
AG
Modified: forrest/site/changes.xml
URL: http://svn.apache.org/viewcvs/forrest/site/changes.xml?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/changes.xml (original)
+++ forrest/site/changes.xml Tue May 16 22:13:04 2006
@@ -70,7 +70,7 @@
See <link href="site:v0.80//locationmap">locationmap docs</link> for more information.
(RDG)</li><li><icon alt="update" src="images/update.jpg"/>
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
(DC)</li><li><icon alt="update" src="images/update.jpg"/>
Updated xerces to 2.8.0, xml-apis to 1.3.03, log4j to 1.2.13 and ehcache to 1.2.
(AG)</li><li><icon alt="update" src="images/update.jpg"/>
Modified: forrest/site/docs_0_60/changes.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/changes.html?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_60/changes.html (original)
+++ forrest/site/docs_0_60/changes.html Tue May 16 22:13:04 2006
@@ -546,7 +546,7 @@
(RDG)</li>
<li>
<img class="icon" alt="update" src="../images/update.jpg">
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
(DC)</li>
<li>
<img class="icon" alt="update" src="../images/update.jpg">
Modified: forrest/site/docs_0_60/changes.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/changes.pdf?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/docs_0_60/changes.rss
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_60/changes.rss?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_60/changes.rss (original)
+++ forrest/site/docs_0_60/changes.rss Tue May 16 22:13:04 2006
@@ -55,7 +55,7 @@
DC
:
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
</description></item>
<item><title>code update</title><link>changes.html</link><description>code update
by
@@ -4387,7 +4387,7 @@
DC
:
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
</description></item><item><title>code update</title><link>changes.html</link><description>code update
by
AG
Modified: forrest/site/docs_0_70/changes.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/changes.html?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_70/changes.html (original)
+++ forrest/site/docs_0_70/changes.html Tue May 16 22:13:04 2006
@@ -585,7 +585,7 @@
(RDG)</li>
<li>
<img class="icon" alt="update" src="../images/update.jpg">
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
(DC)</li>
<li>
<img class="icon" alt="update" src="../images/update.jpg">
Modified: forrest/site/docs_0_70/changes.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/changes.pdf?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/docs_0_70/changes.rss
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/changes.rss?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_70/changes.rss (original)
+++ forrest/site/docs_0_70/changes.rss Tue May 16 22:13:04 2006
@@ -55,7 +55,7 @@
DC
:
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
</description></item>
<item><title>code update</title><link>changes.html</link><description>code update
by
@@ -4387,7 +4387,7 @@
DC
:
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
</description></item><item><title>code update</title><link>changes.html</link><description>code update
by
AG
Modified: forrest/site/docs_0_70/changes.xml
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_70/changes.xml?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_70/changes.xml (original)
+++ forrest/site/docs_0_70/changes.xml Tue May 16 22:13:04 2006
@@ -70,7 +70,7 @@
See <link href="site:v0.80//locationmap">locationmap docs</link> for more information.
(RDG)</li><li><icon alt="update" src="../images/update.jpg"/>
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
(DC)</li><li><icon alt="update" src="../images/update.jpg"/>
Updated xerces to 2.8.0, xml-apis to 1.3.03, log4j to 1.2.13 and ehcache to 1.2.
(AG)</li><li><icon alt="update" src="../images/update.jpg"/>
Modified: forrest/site/docs_0_80/changes.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/changes.html?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_80/changes.html (original)
+++ forrest/site/docs_0_80/changes.html Tue May 16 22:13:04 2006
@@ -600,7 +600,7 @@
(RDG)</li>
<li>
<img class="icon" alt="update" src="../images/update.jpg">
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
(DC)</li>
<li>
<img class="icon" alt="update" src="../images/update.jpg">
Modified: forrest/site/docs_0_80/changes.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/changes.pdf?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/docs_0_80/changes.rss
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/changes.rss?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_80/changes.rss (original)
+++ forrest/site/docs_0_80/changes.rss Tue May 16 22:13:04 2006
@@ -55,7 +55,7 @@
DC
:
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
</description></item>
<item><title>code update</title><link>changes.html</link><description>code update
by
@@ -4387,7 +4387,7 @@
DC
:
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
</description></item><item><title>code update</title><link>changes.html</link><description>code update
by
AG
Modified: forrest/site/docs_0_80/changes.xml
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/changes.xml?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_80/changes.xml (original)
+++ forrest/site/docs_0_80/changes.xml Tue May 16 22:13:04 2006
@@ -70,7 +70,7 @@
See <link href="site:v0.80//locationmap">locationmap docs</link> for more information.
(RDG)</li><li><icon alt="update" src="../images/update.jpg"/>
- Updated to Ant-1.6.5
+ Updated to Apache-Ant-1.6.5 release, jsch-0.1.28, apache-jakarta-commons-net-1.4.1
(DC)</li><li><icon alt="update" src="../images/update.jpg"/>
Updated xerces to 2.8.0, xml-apis to 1.3.03, log4j to 1.2.13 and ehcache to 1.2.
(AG)</li><li><icon alt="update" src="../images/update.jpg"/>
Modified: forrest/site/docs_0_80/faq.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/faq.html?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_80/faq.html (original)
+++ forrest/site/docs_0_80/faq.html Tue May 16 22:13:04 2006
@@ -677,7 +677,8 @@
if you need to temporarily exclude then.
</p>
<p>
- Another useful technique is to use 'wget' or Ant to retrieve individual files, e.g.
+ Another useful technique is to use 'wget' or Apache Ant's Get task
+ to retrieve individual files, e.g.
Do 'forrest run' and then 'wget http://localhost:8888/index.pdf'.
</p>
</div>
@@ -1589,8 +1590,58 @@
in the components section of the sitemap. See the
<a href="http://cocoon.apache.org/2.1/userdocs/serializers/xhtml-serializer.html">Cocoon
docs</a> for the elements you need to add to define this component. You can see examples
- of other components being added in the <span class="codefrag">FORREST_HOME/main/webapp/sitemap.xmap</span> file.</p>
-<p> You can also use a mixture of the two methods, some handled automatically by Forrest and
+ of other components being added in the <span class="codefrag">FORREST_HOME/main/webapp/sitemap.xmap</span> file.
+ Alternatively use the "html" DocBook stylesheets and the default Cocoon serializer,
+ i.e. <map:serialize type="html"/>
+ </p>
+<p>
+ The output of the above sitemap will be plain html not adorned with
+ a Forrest theme and navigation. If instead you need the latter, then
+ use the following technique instead. This transforms DocBook xml to
+ html, then uses a Forrest core stylesheet to transform and serialize
+ to the internal xml format, then the normal machinery takes over and
+ does the output transformation. This use the Content Aware Pipelines
+ (<a href="../docs_0_80/cap.html">SourceTypeAction</a>)
+ to peek at the source xml. If it is DocBook-4.2
+ then this sitemap match is triggered, if not then it falls through to the core of Forrest.
+ </p>
+<pre class="code"><?xml version="1.0"?>
+<map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0">
+ <map:components>
+ <map:actions>
+ <map:action logger="sitemap.action.sourcetype"
+ name="sourcetype"src="org.apache.forrest.sourcetype.SourceTypeAction">
+ <sourcetype name="docbook-v4.2">
+ <document-declaration public-id="-//OASIS//DTD DocBook XML V4.2//EN"/>
+ </sourcetype>
+ </map:action>
+ </map:actions>
+ <map:selectors default="parameter">
+ <map:selector logger="sitemap.selector.parameter"
+ name="parameter" src="org.apache.cocoon.selection.ParameterSelector"/>
+ </map:selectors>
+ </map:components>
+ <map:pipelines>
+ <map:pipeline>
+ <map:match pattern="**.xml">
+ <map:act type="sourcetype" src="{project:content.xdocs}{1}.xml">
+ <map:select type="parameter">
+ <map:parameter name="parameter-selector-test" value="{sourcetype}"/>
+ <map:when test="docbook-v4.2">
+ <map:generate src="{project:content.xdocs}{../1}.xml"/>
+ <map:transform
+ src="file:///usr/share/sgml/docbook/xsl-stylesheets/html/docbook.xsl"/>
+ <map:transform src="{forrest:stylesheets}/html-to-document.xsl"/>
+ <map:transform type="idgen"/>
+ <map:serialize type="xml-document"/>
+ </map:when>
+ </map:select>
+ </map:act>
+ </map:match>
+ </map:pipeline>
+ </map:pipelines>
+</map:sitemap></pre>
+<p> You can also use a mixture of the methods, some handled automatically by Forrest and
some directly using DocBook stylesheets. You can also have a mixture of source files as
"document-v*" DTD and DocBook. </p>
<p> Ensure that the document type declaration in your XML instance is well specified. Use a
@@ -1598,7 +1649,7 @@
different DTDs, then see <a href="../docs_0_80/your-project.html#new_dtd">Using Forrest</a> for
configuration guidance. </p>
</div>
-<a name="N10500"></a><a name="version"></a>
+<a name="N1050B"></a><a name="version"></a>
<h4 class="faq">5.3. How to report which version of Forrest is being used and the properties that are
set? </h4>
<div align="right">
@@ -1611,7 +1662,7 @@
watch the build messages. Doing <span class="codefrag">'forrest -v'</span> will provide verbose build
messages. </p>
</div>
-<a name="N10514"></a><a name="logs"></a>
+<a name="N1051F"></a><a name="logs"></a>
<h4 class="faq">5.4. Where are the log files to find more infomation about errors? </h4>
<div align="right">
<a href="#logs-menu">^</a>
@@ -1630,7 +1681,7 @@
<p> Doing <span class="codefrag">'forrest -v'</span> will provide verbose build messages to the standard
output. </p>
</div>
-<a name="N10538"></a><a name="how_can_I_help"></a>
+<a name="N10543"></a><a name="how_can_I_help"></a>
<h4 class="faq">5.5. How to help? </h4>
<div align="right">
<a href="#how_can_I_help-menu">^</a>
@@ -1641,7 +1692,7 @@
particularly from newcomers—often, close proximity blinds software developers to
faults that are obvious to everyone else. Don't be shy! </p>
</div>
-<a name="N10544"></a><a name="patch"></a>
+<a name="N1054F"></a><a name="patch"></a>
<h4 class="faq">5.6. How to contribute a patch? </h4>
<div align="right">
<a href="#patch-menu">^</a>
@@ -1652,7 +1703,7 @@
<p>More info about contributing can be found at the <a href="../contrib.html">Contributing
to Forrest</a> page. It is always a good idea to check the Forrest <a href="../issues.html">issue tracker</a> before diving in. </p>
</div>
-<a name="N1055F"></a><a name="jobs"></a>
+<a name="N1056A"></a><a name="jobs"></a>
<h4 class="faq">5.7. How can job positions be advertised? </h4>
<div align="right">
<a href="#jobs-menu">^</a>
Modified: forrest/site/docs_0_80/faq.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/faq.pdf?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/docs_0_80/faq.xml
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/faq.xml?rev=407160&r1=407159&r2=407160&view=diff
==============================================================================
--- forrest/site/docs_0_80/faq.xml (original)
+++ forrest/site/docs_0_80/faq.xml Tue May 16 22:13:04 2006
@@ -107,7 +107,8 @@
if you need to temporarily exclude then.
</p>
<p>
- Another useful technique is to use 'wget' or Ant to retrieve individual files, e.g.
+ Another useful technique is to use 'wget' or Apache Ant's Get task
+ to retrieve individual files, e.g.
Do 'forrest run' and then 'wget http://localhost:8888/index.pdf'.
</p>
</section><section id="cygwin_mutex_error"><title>1.8. When running <code>./build.sh</code> in cygwin, I get an error: <code>cygpath.exe:
@@ -695,8 +696,58 @@
in the components section of the sitemap. See the
<link href="http://cocoon.apache.org/2.1/userdocs/serializers/xhtml-serializer.html">Cocoon
docs</link> for the elements you need to add to define this component. You can see examples
- of other components being added in the <code>FORREST_HOME/main/webapp/sitemap.xmap</code> file.</p>
- <p> You can also use a mixture of the two methods, some handled automatically by Forrest and
+ of other components being added in the <code>FORREST_HOME/main/webapp/sitemap.xmap</code> file.
+ Alternatively use the "html" DocBook stylesheets and the default Cocoon serializer,
+ i.e. <map:serialize type="html"/>
+ </p>
+ <p>
+ The output of the above sitemap will be plain html not adorned with
+ a Forrest theme and navigation. If instead you need the latter, then
+ use the following technique instead. This transforms DocBook xml to
+ html, then uses a Forrest core stylesheet to transform and serialize
+ to the internal xml format, then the normal machinery takes over and
+ does the output transformation. This use the Content Aware Pipelines
+ (<link href="site:v0.80//cap">SourceTypeAction</link>)
+ to peek at the source xml. If it is DocBook-4.2
+ then this sitemap match is triggered, if not then it falls through to the core of Forrest.
+ </p>
+ <source xml:space="preserve"><?xml version="1.0"?>
+<map:sitemap xmlns:map="http://apache.org/cocoon/sitemap/1.0">
+ <map:components>
+ <map:actions>
+ <map:action logger="sitemap.action.sourcetype"
+ name="sourcetype"src="org.apache.forrest.sourcetype.SourceTypeAction">
+ <sourcetype name="docbook-v4.2">
+ <document-declaration public-id="-//OASIS//DTD DocBook XML V4.2//EN"/>
+ </sourcetype>
+ </map:action>
+ </map:actions>
+ <map:selectors default="parameter">
+ <map:selector logger="sitemap.selector.parameter"
+ name="parameter" src="org.apache.cocoon.selection.ParameterSelector"/>
+ </map:selectors>
+ </map:components>
+ <map:pipelines>
+ <map:pipeline>
+ <map:match pattern="**.xml">
+ <map:act type="sourcetype" src="{project:content.xdocs}{1}.xml">
+ <map:select type="parameter">
+ <map:parameter name="parameter-selector-test" value="{sourcetype}"/>
+ <map:when test="docbook-v4.2">
+ <map:generate src="{project:content.xdocs}{../1}.xml"/>
+ <map:transform
+ src="file:///usr/share/sgml/docbook/xsl-stylesheets/html/docbook.xsl"/>
+ <map:transform src="{forrest:stylesheets}/html-to-document.xsl"/>
+ <map:transform type="idgen"/>
+ <map:serialize type="xml-document"/>
+ </map:when>
+ </map:select>
+ </map:act>
+ </map:match>
+ </map:pipeline>
+ </map:pipelines>
+</map:sitemap></source>
+ <p> You can also use a mixture of the methods, some handled automatically by Forrest and
some directly using DocBook stylesheets. You can also have a mixture of source files as
"document-v*" DTD and DocBook. </p>
<p> Ensure that the document type declaration in your XML instance is well specified. Use a