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/04 10:11:16 UTC
svn commit: r399597 - in /forrest/site: docs_0_80/faq.html docs_0_80/faq.pdf
docs_0_80/faq.xml events.html events.pdf guidelines.html guidelines.pdf
Author: crossley
Date: Thu May 4 01:11:13 2006
New Revision: 399597
URL: http://svn.apache.org/viewcvs?rev=399597&view=rev
Log:
Automatic publish from forrestbot
Modified:
forrest/site/docs_0_80/faq.html
forrest/site/docs_0_80/faq.pdf
forrest/site/docs_0_80/faq.xml
forrest/site/events.html
forrest/site/events.pdf
forrest/site/guidelines.html
forrest/site/guidelines.pdf
Modified: forrest/site/docs_0_80/faq.html
URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/faq.html?rev=399597&r1=399596&r2=399597&view=diff
==============================================================================
--- forrest/site/docs_0_80/faq.html (original)
+++ forrest/site/docs_0_80/faq.html Thu May 4 01:11:13 2006
@@ -447,57 +447,60 @@
<a href="#technical">3. Technical</a>
<ul class="minitoc">
<li>
-<a href="#proxy_config">3.1. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
+<a href="#java-code">3.1. Where is the Java code?</a>
+</li>
+<li>
+<a href="#proxy_config">3.2. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
do?</a>
</li>
<li>
-<a href="#CVS_revison_tags">3.2. How can I generate html-pages to show the revision tag of cvs?</a>
+<a href="#CVS_revison_tags">3.3. How can I generate html-pages to show the revision tag of cvs?</a>
</li>
<li>
-<a href="#cli-xconf">3.3. How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include
+<a href="#cli-xconf">3.4. How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include
other additional ones. </a>
</li>
<li>
-<a href="#ignoring_javadocs">3.4. How do I stop Forrest breaking on links to external files that may not exist, like
+<a href="#ignoring_javadocs">3.5. How do I stop Forrest breaking on links to external files that may not exist, like
javadocs? </a>
</li>
<li>
-<a href="#claimed_patterns">3.5. Some of my files are not being processed because they use common filenames. </a>
+<a href="#claimed_patterns">3.6. Some of my files are not being processed because they use common filenames. </a>
</li>
<li>
-<a href="#build_msg_a">3.6. What do the symbols and numbers mean when Forrest lists each document that it has
+<a href="#build_msg_a">3.7. What do the symbols and numbers mean when Forrest lists each document that it has
built? </a>
</li>
<li>
-<a href="#headless_operation">3.7. When generating PNG images from SVG, I get an error: Can't connect to X11 window
+<a href="#headless_operation">3.8. When generating PNG images from SVG, I get an error: Can't connect to X11 window
server using ':0.0' as the value of the DISPLAY variable. </a>
</li>
<li>
-<a href="#project-logo-svg">3.8.
+<a href="#project-logo-svg">3.9.
The project logo that is generated from SVG is truncating my project name.
</a>
</li>
<li>
-<a href="#catalog">3.9. How do i configure my favourite XML editor or parser to find the local Forrest
+<a href="#catalog">3.10. How do i configure my favourite XML editor or parser to find the local Forrest
DTDs? </a>
</li>
<li>
-<a href="#skin">3.10. How to make the site look better and change its skin? </a>
+<a href="#skin">3.11. How to make the site look better and change its skin? </a>
</li>
<li>
-<a href="#xsp">3.11. How do I enable XSP processing?</a>
+<a href="#xsp">3.12. How do I enable XSP processing?</a>
</li>
<li>
-<a href="#breadcrumbs">3.12. How do breadcrumbs work? Why don't they work locally?</a>
+<a href="#breadcrumbs">3.13. How do breadcrumbs work? Why don't they work locally?</a>
</li>
<li>
-<a href="#run_port">3.13. How do I make forrest run listen on a different port?</a>
+<a href="#run_port">3.14. How do I make forrest run listen on a different port?</a>
</li>
<li>
-<a href="#debugging">3.14. Can I run Forrest with Java debugging turned on?</a>
+<a href="#debugging">3.15. Can I run Forrest with Java debugging turned on?</a>
</li>
<li>
-<a href="#checksums">3.15. How do I enable Cocoon's document checksum feature?</a>
+<a href="#checksums">3.16. How do I enable Cocoon's document checksum feature?</a>
</li>
</ul>
</li>
@@ -1179,8 +1182,31 @@
</div>
<a name="N102EE"></a><a name="technical"></a>
<h3 class="underlined_5">3. Technical</h3>
-<a name="N102F2"></a><a name="proxy_config"></a>
-<h4 class="faq">3.1. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
+<a name="N102F2"></a><a name="java-code"></a>
+<h4 class="faq">3.1. Where is the Java code?</h4>
+<div align="right">
+<a href="#java-code-menu">^</a>
+</div>
+<div style="margin-left: 15px">
+<p>
+ Because we are based on Apache Cocoon, a lot of the functionality is
+ provided behind-the-scenes, i.e. we use Cocoon's sitemaps and sitemap components
+ such as XSLT transformers. So there is not much need for Java code in Forrest.
+ </p>
+<p>
+ For Forrest developers who want to explore or enhance that code, see the
+ Apache Cocoon SVN trunk. From time-to-time we update Forrest's packaged
+ version of Cocoon and so can include your contributions.
+ </p>
+<p>
+ That said, you will find some Java code in Forrest at main/java/...
+ for Cocoon components that have been developed at Forrest, e.g.
+ Locationmap and Dispatcher. There is also Java code for some plugins
+ with specialised purpose, e.g. PhotoGallery.
+ </p>
+</div>
+<a name="N10300"></a><a name="proxy_config"></a>
+<h4 class="faq">3.2. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
do?</h4>
<div align="right">
<a href="#proxy_config-menu">^</a>
@@ -1195,8 +1221,8 @@
To avoid to edit every project <span class="codefrag">forrest.properties</span> files, you can do once in your <span class="codefrag">${user.home}/forrest.properties</span> !</div>
</div>
</div>
-<a name="N10316"></a><a name="CVS_revison_tags"></a>
-<h4 class="faq">3.2. How can I generate html-pages to show the revision tag of cvs?</h4>
+<a name="N10324"></a><a name="CVS_revison_tags"></a>
+<h4 class="faq">3.3. How can I generate html-pages to show the revision tag of cvs?</h4>
<div align="right">
<a href="#CVS_revison_tags-menu">^</a>
</div>
@@ -1208,8 +1234,8 @@
<p>This technique could also be used for a modification date with $Date: 2004/01/15 08:52:47
$</p>
</div>
-<a name="N10328"></a><a name="cli-xconf"></a>
-<h4 class="faq">3.3. How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include
+<a name="N10336"></a><a name="cli-xconf"></a>
+<h4 class="faq">3.4. How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include
other additional ones. </h4>
<div align="right">
<a href="#cli-xconf-menu">^</a>
@@ -1246,8 +1272,8 @@
<strong>foo/**</strong> to match that. </div>
</div>
</div>
-<a name="N10365"></a><a name="ignoring_javadocs"></a>
-<h4 class="faq">3.4. How do I stop Forrest breaking on links to external files that may not exist, like
+<a name="N10373"></a><a name="ignoring_javadocs"></a>
+<h4 class="faq">3.5. How do I stop Forrest breaking on links to external files that may not exist, like
javadocs? </h4>
<div align="right">
<a href="#ignoring_javadocs-menu">^</a>
@@ -1257,8 +1283,8 @@
<span class="codefrag">cli.xconf</span>
</a> Cocoon config file, and defining patterns for URLs to exclude. </p>
</div>
-<a name="N10374"></a><a name="claimed_patterns"></a>
-<h4 class="faq">3.5. Some of my files are not being processed because they use common filenames. </h4>
+<a name="N10382"></a><a name="claimed_patterns"></a>
+<h4 class="faq">3.6. Some of my files are not being processed because they use common filenames. </h4>
<div align="right">
<a href="#claimed_patterns-menu">^</a>
</div>
@@ -1273,8 +1299,8 @@
with this issue (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
</p>
</div>
-<a name="N10386"></a><a name="build_msg_a"></a>
-<h4 class="faq">3.6. What do the symbols and numbers mean when Forrest lists each document that it has
+<a name="N10394"></a><a name="build_msg_a"></a>
+<h4 class="faq">3.7. What do the symbols and numbers mean when Forrest lists each document that it has
built? </h4>
<div align="right">
<a href="#build_msg_a-menu">^</a>
@@ -1304,8 +1330,8 @@
</ul>
</div>
-<a name="N103A4"></a><a name="headless_operation"></a>
-<h4 class="faq">3.7. When generating PNG images from SVG, I get an error: Can't connect to X11 window
+<a name="N103B2"></a><a name="headless_operation"></a>
+<h4 class="faq">3.8. When generating PNG images from SVG, I get an error: Can't connect to X11 window
server using ':0.0' as the value of the DISPLAY variable. </h4>
<div align="right">
<a href="#headless_operation-menu">^</a>
@@ -1317,8 +1343,8 @@
<pre class="code">forrest -Dforrest.jvmargs=-Djava.awt.headless=true site</pre>
<p> See also <a href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html">Cocoon FAQ</a>. </p>
</div>
-<a name="N103C0"></a><a name="project-logo-svg"></a>
-<h4 class="faq">3.8.
+<a name="N103CE"></a><a name="project-logo-svg"></a>
+<h4 class="faq">3.9.
The project logo that is generated from SVG is truncating my project name.
</h4>
<div align="right">
@@ -1337,8 +1363,8 @@
<a href="http://www.w3.org/Graphics/SVG/">SVG</a> resources.
</p>
</div>
-<a name="N103D8"></a><a name="catalog"></a>
-<h4 class="faq">3.9. How do i configure my favourite XML editor or parser to find the local Forrest
+<a name="N103E6"></a><a name="catalog"></a>
+<h4 class="faq">3.10. How do i configure my favourite XML editor or parser to find the local Forrest
DTDs? </h4>
<div align="right">
<a href="#catalog-menu">^</a>
@@ -1347,8 +1373,8 @@
<p> Notes are provided for various tools at <a href="../docs_0_80/catalog.html">Using Catalog Entity
Resolver for local DTDs</a>. </p>
</div>
-<a name="N103E4"></a><a name="skin"></a>
-<h4 class="faq">3.10. How to make the site look better and change its skin? </h4>
+<a name="N103F2"></a><a name="skin"></a>
+<h4 class="faq">3.11. How to make the site look better and change its skin? </h4>
<div align="right">
<a href="#skin-menu">^</a>
</div>
@@ -1359,8 +1385,8 @@
<p> See notes about <a href="../docs_0_80/your-project.html#skins">configuration</a> of the skins.
Some projects may have special needs and can define their <a href="../docs_0_80/your-project.html#new_skin">own skin</a>. </p>
</div>
-<a name="N103FB"></a><a name="xsp"></a>
-<h4 class="faq">3.11. How do I enable XSP processing?</h4>
+<a name="N10409"></a><a name="xsp"></a>
+<h4 class="faq">3.12. How do I enable XSP processing?</h4>
<div align="right">
<a href="#xsp-menu">^</a>
</div>
@@ -1407,8 +1433,8 @@
</ol>
<p>See also the <a href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</a> Wiki page.</p>
</div>
-<a name="N10436"></a><a name="breadcrumbs"></a>
-<h4 class="faq">3.12. How do breadcrumbs work? Why don't they work locally?</h4>
+<a name="N10444"></a><a name="breadcrumbs"></a>
+<h4 class="faq">3.13. How do breadcrumbs work? Why don't they work locally?</h4>
<div align="right">
<a href="#breadcrumbs-menu">^</a>
</div>
@@ -1426,8 +1452,8 @@
are viewing the site locally, there is no domain and so there will be no extra
breadcrumbs, only the ones that are specified in <span class="codefrag">skinconf.xml</span>. </p>
</div>
-<a name="N1044B"></a><a name="run_port"></a>
-<h4 class="faq">3.13. How do I make forrest run listen on a different port?</h4>
+<a name="N10459"></a><a name="run_port"></a>
+<h4 class="faq">3.14. How do I make forrest run listen on a different port?</h4>
<div align="right">
<a href="#run_port-menu">^</a>
</div>
@@ -1442,8 +1468,8 @@
</p>
</div>
-<a name="N1045F"></a><a name="debugging"></a>
-<h4 class="faq">3.14. Can I run Forrest with Java debugging turned on?</h4>
+<a name="N1046D"></a><a name="debugging"></a>
+<h4 class="faq">3.15. Can I run Forrest with Java debugging turned on?</h4>
<div align="right">
<a href="#debugging-menu">^</a>
</div>
@@ -1454,8 +1480,8 @@
to the <span class="codefrag">forrest.jvmargs</span> property in the <span class="codefrag">forrest.properties</span>
file. Don't forget to ensure the property is uncommented in that file.</p>
</div>
-<a name="N10470"></a><a name="checksums"></a>
-<h4 class="faq">3.15. How do I enable Cocoon's document checksum feature?</h4>
+<a name="N1047E"></a><a name="checksums"></a>
+<h4 class="faq">3.16. How do I enable Cocoon's document checksum feature?</h4>
<div align="right">
<a href="#checksums-menu">^</a>
</div>
@@ -1488,9 +1514,9 @@
installation-wide cli.xconf file.
</p>
</div>
-<a name="N1048C"></a><a name="old_faqs"></a>
+<a name="N1049A"></a><a name="old_faqs"></a>
<h3 class="underlined_5">4. Older version: 0.6</h3>
-<a name="N10490"></a><a name="old_claimed_patterns"></a>
+<a name="N1049E"></a><a name="old_claimed_patterns"></a>
<h4 class="faq">4.1. Some of my files are not being processed because they use common filenames. </h4>
<div align="right">
<a href="#old_claimed_patterns-menu">^</a>
@@ -1506,9 +1532,9 @@
with this issue (<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
</p>
</div>
-<a name="N104A2"></a><a name="general"></a>
+<a name="N104B0"></a><a name="general"></a>
<h3 class="underlined_5">5. General</h3>
-<a name="N104A6"></a><a name="generating_menus"></a>
+<a name="N104B4"></a><a name="generating_menus"></a>
<h4 class="faq">5.1. What is the relationship between site.xml and book.xml? </h4>
<div align="right">
<a href="#generating_menus-menu">^</a>
@@ -1522,7 +1548,7 @@
<span class="codefrag">site.xml</span>-generated menus aren't appropriate. See <a href="../docs_0_80/linking.html">Menus and
Linking</a>. </p>
</div>
-<a name="N104C1"></a><a name="docbook"></a>
+<a name="N104CF"></a><a name="docbook"></a>
<h4 class="faq">5.2. How do I use DocBook as the XML documentation format? </h4>
<div align="right">
<a href="#docbook-menu">^</a>
@@ -1568,7 +1594,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="N104EF"></a><a name="version"></a>
+<a name="N104FD"></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">
@@ -1581,7 +1607,7 @@
watch the build messages. Doing <span class="codefrag">'forrest -v'</span> will provide verbose build
messages. </p>
</div>
-<a name="N10503"></a><a name="logs"></a>
+<a name="N10511"></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>
@@ -1600,7 +1626,7 @@
<p> Doing <span class="codefrag">'forrest -v'</span> will provide verbose build messages to the standard
output. </p>
</div>
-<a name="N10527"></a><a name="how_can_I_help"></a>
+<a name="N10535"></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>
@@ -1611,7 +1637,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="N10533"></a><a name="patch"></a>
+<a name="N10541"></a><a name="patch"></a>
<h4 class="faq">5.6. How to contribute a patch? </h4>
<div align="right">
<a href="#patch-menu">^</a>
@@ -1622,7 +1648,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="N1054E"></a><a name="jobs"></a>
+<a name="N1055C"></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=399597&r1=399596&r2=399597&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=399597&r1=399596&r2=399597&view=diff
==============================================================================
--- forrest/site/docs_0_80/faq.xml (original)
+++ forrest/site/docs_0_80/faq.xml Thu May 4 01:11:13 2006
@@ -435,21 +435,38 @@
Search for "javascript" then follow to the
<map:resource name="skin-read"> section.
</p>
- </section></section><section id="technical"><title>3. Technical</title><section id="proxy_config"><title>3.1. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
+ </section></section><section id="technical"><title>3. Technical</title><section id="java-code"><title>3.1. Where is the Java code?</title>
+ <p>
+ Because we are based on Apache Cocoon, a lot of the functionality is
+ provided behind-the-scenes, i.e. we use Cocoon's sitemaps and sitemap components
+ such as XSLT transformers. So there is not much need for Java code in Forrest.
+ </p>
+ <p>
+ For Forrest developers who want to explore or enhance that code, see the
+ Apache Cocoon SVN trunk. From time-to-time we update Forrest's packaged
+ version of Cocoon and so can include your contributions.
+ </p>
+ <p>
+ That said, you will find some Java code in Forrest at main/java/...
+ for Cocoon components that have been developed at Forrest, e.g.
+ Locationmap and Dispatcher. There is also Java code for some plugins
+ with specialised purpose, e.g. PhotoGallery.
+ </p>
+ </section><section id="proxy_config"><title>3.2. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
do?</title>
<p>You can configure the proxy in the <code>forrest.properties</code> file. Set the
<code>proxy.host</code> and <code>proxy.port</code> accordingly.</p>
<p>You can also cross an authenticated proxy by setting the <code>proxy.user</code> and <code>proxy.password</code> accordingly.</p>
<note label="Generalise the proxy configuration">You certainly need to cross your proxy for every Forrest projects you have.
To avoid to edit every project <code>forrest.properties</code> files, you can do once in your <code>${user.home}/forrest.properties</code> !</note>
- </section><section id="CVS_revison_tags"><title>3.2. How can I generate html-pages to show the revision tag of cvs?</title>
+ </section><section id="CVS_revison_tags"><title>3.3. How can I generate html-pages to show the revision tag of cvs?</title>
<p>If you have:<code><version>$Revision: 1.30
$</version></code>The '1.30' will be extracted and
displayed at the bottom of the page as "version 1.30". See for example the
bottom of the <link href="site:v0.80//your-project"> Using Forrest</link> document.</p>
<p>This technique could also be used for a modification date with $Date: 2004/01/15 08:52:47
$</p>
- </section><section id="cli-xconf"><title>3.3. How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include
+ </section><section id="cli-xconf"><title>3.4. How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include
other additional ones. </title>
<p> Forrest uses a configuration file to control the processing done by the Apache Cocoon
command-line called cli.xconf </p>
@@ -477,12 +494,12 @@
<note> Wildcards may be used. These are a powerful feature of Cocoon's <link href="site:v0.80//sitemap-ref">sitemap</link>. For example, <strong>foo/*</strong> would match
<code>foo/bar</code>, but not <code>foo/bar/baz</code> — use
<strong>foo/**</strong> to match that. </note>
- </section><section id="ignoring_javadocs"><title>3.4. How do I stop Forrest breaking on links to external files that may not exist, like
+ </section><section id="ignoring_javadocs"><title>3.5. How do I stop Forrest breaking on links to external files that may not exist, like
javadocs? </title>
<p> This can be done by overriding the <link href="#cli-xconf">
<code>cli.xconf</code>
</link> Cocoon config file, and defining patterns for URLs to exclude. </p>
- </section><section id="claimed_patterns"><title>3.5. Some of my files are not being processed because they use common filenames. </title>
+ </section><section id="claimed_patterns"><title>3.6. Some of my files are not being processed because they use common filenames. </title>
<p> Certain patterns are claimed by the default sitemaps for special processing. These
include: <code>site, changes, todo, faq, images, my-images, skinconf, community,
howto</code>
@@ -491,7 +508,7 @@
interview-faq.html would be fine. In future versions of Forrest we will attempt to deal
with this issue (<link href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</link>).
</p>
- </section><section id="build_msg_a"><title>3.6. What do the symbols and numbers mean when Forrest lists each document that it has
+ </section><section id="build_msg_a"><title>3.7. What do the symbols and numbers mean when Forrest lists each document that it has
built? </title>
<p>
Each time that Cocoon processes a link, it will report the status messages ...
@@ -510,14 +527,14 @@
<li>Column 4 is the time taken.</li>
<li>Column 5 is the page size.</li>
</ul>
- </section><section id="headless_operation"><title>3.7. When generating PNG images from SVG, I get an error: Can't connect to X11 window
+ </section><section id="headless_operation"><title>3.8. When generating PNG images from SVG, I get an error: Can't connect to X11 window
server using ':0.0' as the value of the DISPLAY variable. </title>
<p> If you are using JDK 1.4.0 or newer, you can enable <em>headless</em> operation by
running Forrest with the <code>forrest.jvmarg</code> parameter set to
<code>-Djava.awt.headless=true</code>, like this: </p>
<source xml:space="preserve">forrest -Dforrest.jvmargs=-Djava.awt.headless=true site</source>
<p> See also <link href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html">Cocoon FAQ</link>. </p>
- </section><section id="project-logo-svg"><title>3.8.
+ </section><section id="project-logo-svg"><title>3.9.
The project logo that is generated from SVG is truncating my project name.
</title>
<p>
@@ -531,17 +548,17 @@
attribute of the <svg> element. For further details see
<link href="http://www.w3.org/Graphics/SVG/">SVG</link> resources.
</p>
- </section><section id="catalog"><title>3.9. How do i configure my favourite XML editor or parser to find the local Forrest
+ </section><section id="catalog"><title>3.10. How do i configure my favourite XML editor or parser to find the local Forrest
DTDs? </title>
<p> Notes are provided for various tools at <link href="site:v0.80//catalog">Using Catalog Entity
Resolver for local DTDs</link>. </p>
- </section><section id="skin"><title>3.10. How to make the site look better and change its skin? </title>
+ </section><section id="skin"><title>3.11. How to make the site look better and change its skin? </title>
<p> There are <link href="site:v0.80//skins">default skins</link> provided, which are configurable
and so should meet the needs of most projects. The aim is to provide many capabilities so
that extra skins are not needed. </p>
<p> See notes about <link href="site:v0.80//your-project/skins">configuration</link> of the skins.
Some projects may have special needs and can define their <link href="site:v0.80//your-project/new-skin">own skin</link>. </p>
- </section><section id="xsp"><title>3.11. How do I enable <acronym title="eXtensible Server Pages">XSP</acronym> processing?</title>
+ </section><section id="xsp"><title>3.12. How do I enable <acronym title="eXtensible Server Pages">XSP</acronym> processing?</title>
<p>First consider whether your needs would be better met by Cocoon itself, rather than
Forrest. </p>
<p>That said, there are valid reasons for wanting programmatically generated content, so
@@ -571,7 +588,7 @@
</li>
</ol>
<p>See also the <link href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</link> Wiki page.</p>
- </section><section id="breadcrumbs"><title>3.12. How do breadcrumbs work? Why don't they work locally?</title>
+ </section><section id="breadcrumbs"><title>3.13. How do breadcrumbs work? Why don't they work locally?</title>
<p>Breadcrumbs begin with up to three URLs specified in <code>skinconf.xml</code>. Here is
what the Forrest site uses:</p>
<source xml:space="preserve">
@@ -584,20 +601,20 @@
the URL for the current page and makes a link for each directory after the domain. If you
are viewing the site locally, there is no domain and so there will be no extra
breadcrumbs, only the ones that are specified in <code>skinconf.xml</code>. </p>
- </section><section id="run_port"><title>3.13. How do I make <code>forrest run</code> listen on a different port?</title>
+ </section><section id="run_port"><title>3.14. How do I make <code>forrest run</code> listen on a different port?</title>
<p>
<code>forrest run -Dforrest.jvmargs="-Djetty.port=80"</code>
</p>
<p>Or copy Forrest's main/webapp/jettyconf.xml file to your project's src/documentation
directory and set the port number in that file. Then do <code>forrest run</code>
</p>
- </section><section id="debugging"><title>3.14. Can I run Forrest with Java debugging turned on?</title>
+ </section><section id="debugging"><title>3.15. Can I run Forrest with Java debugging turned on?</title>
<p>If you use an IDE like Eclipse and want to debug java code in Forrest
you need to start Forrest with debugging mode turned on. To do this you need
to add <code>-Xdebug -Xrunjdwp:transport=dt_socket,address=8000,server=y,susp end=n</code>
to the <code>forrest.jvmargs</code> property in the <code>forrest.properties</code>
file. Don't forget to ensure the property is uncommented in that file.</p>
- </section><section id="checksums"><title>3.15. How do I enable Cocoon's document checksum feature?</title>
+ </section><section id="checksums"><title>3.16. How do I enable Cocoon's document checksum feature?</title>
<p>
Why might you want to do this? There is really no effect
on Cocoon processing, but a little time can be
Modified: forrest/site/events.html
URL: http://svn.apache.org/viewcvs/forrest/site/events.html?rev=399597&r1=399596&r2=399597&view=diff
==============================================================================
--- forrest/site/events.html (original)
+++ forrest/site/events.html Thu May 4 01:11:13 2006
@@ -190,7 +190,7 @@
in web-development</a>
</li>
<li>
-<a href="#MOH9-dublin-2006">ApacheCon Session: MOH9: Build an Apache Forrest site mixing from different Content sources</a>
+<a href="#MOH9-dublin-2006">ApacheCon Tutorial: MOH9: Build an Apache Forrest site mixing from different Content sources</a>
</li>
<li>
<a href="#FR19-dublin-2006">ApacheCon Session: FR19: Single Source Publishing with Apache Forrest</a>
@@ -269,7 +269,7 @@
Note: Subject to attendance numbers.
</p>
<a name="N1003E"></a><a name="MOH9-dublin-2006"></a>
-<h4>ApacheCon Session: MOH9: Build an Apache Forrest site mixing from different Content sources</h4>
+<h4>ApacheCon Tutorial: MOH9: Build an Apache Forrest site mixing from different Content sources</h4>
<p>
Monday 26 June - Official ApacheCon half-day tutorial
conducted by Juan Jose Pablos.
Modified: forrest/site/events.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/events.pdf?rev=399597&r1=399596&r2=399597&view=diff
==============================================================================
Binary files - no diff available.
Modified: forrest/site/guidelines.html
URL: http://svn.apache.org/viewcvs/forrest/site/guidelines.html?rev=399597&r1=399596&r2=399597&view=diff
==============================================================================
--- forrest/site/guidelines.html (original)
+++ forrest/site/guidelines.html Thu May 4 01:11:13 2006
@@ -1081,6 +1081,9 @@
http://marc.theaimsgroup.com/?t=113830245600001
[Proposal] code freeze on dispatcher related resources
+http://marc.theaimsgroup.com/?t=114667400800004
+[Proposal] Refining our Development Process
+
Document our use of Branches for development
http://issues.apache.org/jira/browse/FOR-631
</pre>
Modified: forrest/site/guidelines.pdf
URL: http://svn.apache.org/viewcvs/forrest/site/guidelines.pdf?rev=399597&r1=399596&r2=399597&view=diff
==============================================================================
Binary files - no diff available.