You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-svn@forrest.apache.org by cr...@apache.org on 2011/01/20 07:47:28 UTC
svn commit: r1061134 [6/10] - in /forrest/site: ./ docs_0_70/
docs_0_70/howto/ docs_0_70/howto/cvs-ssh/ docs_0_70/howto/multi/ docs_0_80/
docs_0_80/howto/ docs_0_80/howto/cvs-ssh/ docs_0_80/howto/multi/ docs_0_90/
docs_0_90/howto/ docs_0_90/howto/cvs-s...
Modified: forrest/site/docs_0_90/faq.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/faq.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/faq.html (original)
+++ forrest/site/docs_0_90/faq.html Thu Jan 20 06:47:23 2011
@@ -577,21 +577,21 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10008"></a><a name="getting_started"></a>
+<a name="getting_started"></a>
<h2 class="underlined_10">1. Getting Started and Building Forrest</h2>
<div class="section">
-<a name="N1000C"></a><a name="faq"></a>
+<a name="faq"></a>
<h3 class="underlined_5">1.1. How to use these FAQs? </h3>
<p>
There is no particular order to these FAQs. Use your browser's "Find
in this page" facility to search for keywords.
</p>
-<a name="N10014"></a><a name="overview"></a>
+<a name="overview"></a>
<h3 class="underlined_5">1.2. Where can I read an overview about how to work with Forrest? </h3>
<p>
See the <a href="../docs_0_90/your-project.html">Using Forrest</a> guide.
</p>
-<a name="N10020"></a><a name="docs"></a>
+<a name="docs"></a>
<h3 class="underlined_5">1.3. Where is all of the documentation?</h3>
<p>
You have a local copy of the main documentation with your version of
@@ -609,7 +609,7 @@ document.write("Last Published: " + docu
forrest run'. Every hour the forrestbot generates a static version of
this documentation on our <a href="http://forrest.zones.apache.org/">testing zone</a>.
</p>
-<a name="N10039"></a><a name="requirements"></a>
+<a name="requirements"></a>
<h3 class="underlined_5">1.4. What are the system requirements for Forrest? </h3>
<p>
Forrest includes everything necessary to build and run, except of
@@ -622,13 +622,13 @@ document.write("Last Published: " + docu
intend to enhance and rebuild Forrest (or use the Forrest sources with
Subversion or use a source snapshot) then you need the full JDK.
</p>
-<a name="N10044"></a><a name="cvs"></a>
+<a name="cvs"></a>
<h3 class="underlined_5">1.5. The old xml-forrest CVS code repository seems to be stale. What happened? </h3>
<p>
Forrest switched from a CVS code repository to SVN (Subversion) code
repository. The old CVS repository is closed and not kept current.
</p>
-<a name="N1004C"></a><a name="svn"></a>
+<a name="svn"></a>
<h3 class="underlined_5">1.6. How can I use SVN to keep up to date with the latest codebase? </h3>
<p>
Follow these <a href="../docs_0_90/howto/../build.html">Building Forrest</a> notes.
@@ -638,7 +638,7 @@ document.write("Last Published: " + docu
further step-by-step assistance in getting started with Forrest for
your project.
</p>
-<a name="N1005F"></a><a name="older-plugins"></a>
+<a name="older-plugins"></a>
<h3 class="underlined_5">1.7. How to use older versions of specific plugins? </h3>
<p>
Sometimes one does not want to use the most recent functionality of a
@@ -663,7 +663,7 @@ document.write("Last Published: " + docu
(due in version 0.8). So do this ...
</p>
<pre class="code">project.required.plugins=org.apache.forrest.plugin.input.projectInfo-0.1,...</pre>
-<a name="N10080"></a><a name="single-document"></a>
+<a name="single-document"></a>
<h3 class="underlined_5">1.8. What is the best way to generate "standalone documents" using Forrest? </h3>
<p>
There is a trick that can cut down your turnaround time with building.
@@ -708,7 +708,7 @@ forrest -Dproject.start-uri=live-sites.h
<span class="codefrag">'wget http://localhost:8888/index.pdf'</span>
</p>
-<a name="N100A9"></a><a name="cygwin_mutex_error"></a>
+<a name="cygwin_mutex_error"></a>
<h3 class="underlined_5">1.9. When running ./build.sh in cygwin, I get an error: cygpath.exe:
*** can't create title mutex, Win32 error 6. </h3>
<p>
@@ -716,7 +716,7 @@ forrest -Dproject.start-uri=live-sites.h
<a href="http://issues.apache.org/jira/browse/FOR-10">appears
to be a bug in cygwin</a>. Please use the .bat script instead.
</p>
-<a name="N100BB"></a><a name="oldjing"></a>
+<a name="oldjing"></a>
<h3 class="underlined_5">1.10. On Java 6 fails validate-sitemap task. Missing the RELAX NG datatype library.</h3>
<pre class="code">
validate-sitemap:
@@ -741,14 +741,14 @@ error: datatype library "http://www.w3.o
to expose the "forrest.validate.sitemap" property and set it to "false".
Might need to do the same for the "forrest.validate.stylesheets" property.
</p>
-<a name="N100DB"></a><a name="winjava"></a>
+<a name="winjava"></a>
<h3 class="underlined_5">1.11. Windows gets confused about which Java version to use.</h3>
<p>
Cough, yes!. See this
<a href="http://mail-archives.apache.org/mod_mbox/forrest-user/200704.mbox/%3c462CA40F.5020400@rblasch.org%3e">explanation</a>
on the Forrest mail lists.
</p>
-<a name="N100E7"></a><a name="maxmemory"></a>
+<a name="maxmemory"></a>
<h3 class="underlined_5">1.12. How can I specify the amount of memory to be used by Java? </h3>
<p>
There are two ways to control this. If you get an OutOfMemoryError
@@ -768,7 +768,7 @@ error: datatype library "http://www.w3.o
forrest. The exact value you set it to is dependant on your JVM, but
something like <span class="codefrag">ANT_OPTS=-Xmx500M</span> will probably work.
</p>
-<a name="N10104"></a><a name="debug"></a>
+<a name="debug"></a>
<h3 class="underlined_5">1.13. How can I start forrest in Java debug mode? </h3>
<p>
The <span class="codefrag">forrest.jvmargs</span> property in the
@@ -778,10 +778,10 @@ error: datatype library "http://www.w3.o
</p>
</div>
-<a name="N10115"></a><a name="content_faqs"></a>
+<a name="content_faqs"></a>
<h2 class="underlined_10">2. Content Creation</h2>
<div class="section">
-<a name="N10119"></a><a name="edit-content"></a>
+<a name="edit-content"></a>
<h3 class="underlined_5">2.1. What tools can be used to edit the content?</h3>
<p>
If you are using the Apache Forrest XML
@@ -803,7 +803,7 @@ error: datatype library "http://www.w3.o
can use text editors or "html editors" such as the one provided with
the Mozilla web browser.
</p>
-<a name="N10133"></a><a name="site-xml"></a>
+<a name="site-xml"></a>
<h3 class="underlined_5">2.2.
How to use the site.xml configuration file for menus and linking.
</h3>
@@ -846,7 +846,7 @@ error: datatype library "http://www.w3.o
<pre class="code">
<a href="site:docbook"> link to the DocBook FAQ in the Tech FAQs
</pre>
-<a name="N10161"></a><a name="examples"></a>
+<a name="examples"></a>
<h3 class="underlined_5">2.3.
Where are examples of documents and site.xml and tabs.xml files?
</h3>
@@ -855,7 +855,7 @@ error: datatype library "http://www.w3.o
website documents are included with the distribution (<span class="codefrag">cd
forrest/site-author; forrest run</span>).
</p>
-<a name="N1016C"></a><a name="crawler"></a>
+<a name="crawler"></a>
<h3 class="underlined_5">2.4.
Help, one of my documents is not being rendered.
</h3>
@@ -874,7 +874,7 @@ error: datatype library "http://www.w3.o
not follow and process off-site links. The new locationmap (0.8+)
enables content to be drawn from remote sources.
</p>
-<a name="N1017A"></a><a name="PDF-output"></a>
+<a name="PDF-output"></a>
<h3 class="underlined_5">2.5. How can I generate one pdf-file out of the whole site or selected pages of the site?</h3>
<p>
Add the following entries to your site.xml file.
@@ -910,7 +910,7 @@ error: datatype library "http://www.w3.o
issue tracker and mail lists.
</div>
</div>
-<a name="N1019A"></a><a name="pageBreaks"></a>
+<a name="pageBreaks"></a>
<h3 class="underlined_5">2.6. How do I insert page breaks into documents?</h3>
<p>
Page breaks do not make a great deal of sense in HTML documents
@@ -939,7 +939,7 @@ error: datatype library "http://www.w3.o
margin-bottom: 0;
page-break-after: always;
} </pre>
-<a name="N101B8"></a><a name="clickable-email-address"></a>
+<a name="clickable-email-address"></a>
<h3 class="underlined_5">2.7. How can I generate html-pages to show a 'clickable' email-address (of the
author-element)?</h3>
<p>
@@ -947,14 +947,14 @@ error: datatype library "http://www.w3.o
$FORREST_HOME/main/webapp/skins/common/xslt/html/document-to-html.xsl</span>
and edit the "headers/authors" template.
</p>
-<a name="N101C3"></a><a name="link_raw"></a>
+<a name="link_raw"></a>
<h3 class="underlined_5">2.8. How do I link to raw files such as config.txt and brochure.pdf? </h3>
<p>
Handling of raw files was significantly changed in Forrest 0.7. See
<a href="../docs_0_70/upgrading_07.html#raw">Upgrading to Apache Forrest
0.7</a> for all the details.
</p>
-<a name="N101CF"></a><a name="pdf_images"></a>
+<a name="pdf_images"></a>
<h3 class="underlined_5">2.9. Images don't display in PDFs. How do I fix this?</h3>
<p>
Forrest uses <a href="http://xml.apache.org/fop/">Apache FOP</a>
@@ -993,7 +993,7 @@ error: datatype library "http://www.w3.o
Forrest.
</div>
</div>
-<a name="N101FE"></a><a name="tab-index"></a>
+<a name="tab-index"></a>
<h3 class="underlined_5">2.10. The tab link in my site incorrectly assumes that 'index.html' is present in the
linked-to directory. How do I fix this? </h3>
<p>
@@ -1016,12 +1016,12 @@ error: datatype library "http://www.w3.o
<map:redirect-to uri="manual/Introduction.html"/>
</map:match>
</pre>
-<a name="N1021A"></a><a name="tab-site"></a>
+<a name="tab-site"></a>
<h3 class="underlined_5">2.11. I need help with the interaction between tabs.xml and site.xml </h3>
<p>
See the <a href="../docs_0_90/linking.html#tab-site">tips</a>.
</p>
-<a name="N10226"></a><a name="defaultFileName"></a>
+<a name="defaultFileName"></a>
<h3 class="underlined_5">2.12. How can I change the default file name that Forrest will look for when I request a
URL like http://myserver or http://myserver/mydir/ ? </h3>
<p>
@@ -1050,7 +1050,7 @@ error: datatype library "http://www.w3.o
</li>
</ol>
-<a name="N1024E"></a><a name="defaultStartPage"></a>
+<a name="defaultStartPage"></a>
<h3 class="underlined_5">2.13. How can I use a start-up-page other than index.html? </h3>
<p>
Forrest by default assumes that the first page (home page) of your
@@ -1086,7 +1086,7 @@ error: datatype library "http://www.w3.o
<li>Don't forget to create that page and refer to it in your site.xml</li>
</ol>
-<a name="N10272"></a><a name="output-filename-extension"></a>
+<a name="output-filename-extension"></a>
<h3 class="underlined_5">2.14. How to use a different filename extension for output, e.g. *.php? </h3>
<p>
Use the power of the Cocoon sitemaps. There is default handling for *.php (see main/webapp/sitemap.xmap) to map the 'php' extension to an internal request for "html". See more about <a href="#php">PHP</a> below.
@@ -1094,7 +1094,7 @@ error: datatype library "http://www.w3.o
<p>
Use the same internal re-direction technique for your special needs, e.g. copy that php match to your project sitemap and use ".htm" instead.
</p>
-<a name="N10281"></a><a name="php"></a>
+<a name="php"></a>
<h3 class="underlined_5">2.15. How to generate pages ready for serving via PHP? </h3>
<p>
Use the *.php filename extension (see <a href="#output-filename-extension">above</a>)
@@ -1105,7 +1105,7 @@ error: datatype library "http://www.w3.o
"processing-instruction nodes in source are not always passed through to html output"
whereby only PIs in certain body elements are handled.
</p>
-<a name="N10294"></a><a name="label-entity"></a>
+<a name="label-entity"></a>
<h3 class="underlined_5">2.16. How to use special characters in the labels of the site.xml file? </h3>
<p>
Use the numeric values for character entities. For example, rather
@@ -1123,7 +1123,7 @@ error: datatype library "http://www.w3.o
<a href="http://issues.apache.org/jira/browse/FOR-244">Issue
FOR-244</a>.
</p>
-<a name="N102AD"></a><a name="encoding"></a>
+<a name="encoding"></a>
<h3 class="underlined_5">2.17. Does Forrest handle accents for non-English languages?</h3>
<p>
Yes, Forrest can process text in any language, so you can include:
@@ -1197,7 +1197,7 @@ error: datatype library "http://www.w3.o
<a href="http://www.alanwood.net/unicode/">Alan Wood's Unicode
resources</a>.
</p>
-<a name="N102FF"></a><a name="xml-entities"></a>
+<a name="xml-entities"></a>
<h3 class="underlined_5">2.18. How to use XML entities, for example string
replacement?</h3>
<p>
@@ -1209,7 +1209,7 @@ error: datatype library "http://www.w3.o
trademark symbol "My Project Name™". Avoid lengthy typing and
potential spelling errors.
</p>
-<a name="N1030E"></a><a name="cleanSite"></a>
+<a name="cleanSite"></a>
<h3 class="underlined_5">2.19. How to make Forrest clean up the project build directories? </h3>
<p>
By default Forrest does not clean its build directories in the project
@@ -1223,7 +1223,7 @@ error: datatype library "http://www.w3.o
which include the Cocoon cache and the Cocoon logs). Doing 'forrest
clean' will remove both sections.
</p>
-<a name="N10319"></a><a name="i18n"></a>
+<a name="i18n"></a>
<h3 class="underlined_5">2.20. How can I internationalise (i18n) my content?</h3>
<p>
For example, navigation
@@ -1238,7 +1238,7 @@ error: datatype library "http://www.w3.o
<a href="http://cocoon.apache.org/2.1/userdocs/i18nTransformer.html">Cocoon
i18n Transformer</a>.
</p>
-<a name="N1032B"></a><a name="rawHTML"></a>
+<a name="rawHTML"></a>
<h3 class="underlined_5">2.21. How can I include HTML content that is not to be skinned by Forrest?</h3>
<p>
To serve, for example a legacy HTML site, add something like the
@@ -1286,7 +1286,7 @@ error: datatype library "http://www.w3.o
</li>
</ol>
-<a name="N10357"></a><a name="javascript"></a>
+<a name="javascript"></a>
<h3 class="underlined_5">2.22. How to include additional Javascript and CSS files?</h3>
<p>
Place various resources (e.g. javascript, css) into the "project
@@ -1303,7 +1303,7 @@ error: datatype library "http://www.w3.o
forrest/main/webapp/resources.xmap Search for "javascript" then follow
to the <map:resource name="skin-read"> section.
</p>
-<a name="N10365"></a><a name="linkmap"></a>
+<a name="linkmap"></a>
<h3 class="underlined_5">2.23. How to show a Table Of Contents for the whole site?</h3>
<p>
Every site has an automatically generated document at
@@ -1327,10 +1327,10 @@ error: datatype library "http://www.w3.o
project.start-uri in the forrest.properties file.
</p>
</div>
-<a name="N10383"></a><a name="technical"></a>
+<a name="technical"></a>
<h2 class="underlined_10">3. Technical</h2>
<div class="section">
-<a name="N10387"></a><a name="java-code"></a>
+<a name="java-code"></a>
<h3 class="underlined_5">3.1. Where is the Java code?</h3>
<p>
Because we are based on Apache Cocoon, a lot of the functionality is
@@ -1349,7 +1349,7 @@ error: datatype library "http://www.w3.o
Locationmap and Dispatcher. There is also Java code for some plugins
with specialised purpose, e.g. PhotoGallery.
</p>
-<a name="N10395"></a><a name="populate-cache"></a>
+<a name="populate-cache"></a>
<h3 class="underlined_5">3.2. How to enhance the responsiveness of the cache?</h3>
<p>
Apache Cocoon has a sophisticated cache. When running Forrest in
@@ -1374,7 +1374,7 @@ error: datatype library "http://www.w3.o
proxy server, e.g. Apache HTTP Server as a frontend. See
<a href="http://wiki.apache.org/cocoon/ApacheModProxy">CocoonAndApacheModProxy</a>.
</p>
-<a name="N103AF"></a><a name="proxy_config"></a>
+<a name="proxy_config"></a>
<h3 class="underlined_5">3.3. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I
do?</h3>
<p>
@@ -1395,7 +1395,7 @@ error: datatype library "http://www.w3.o
<span class="codefrag">${user.home}/forrest.properties</span> !
</div>
</div>
-<a name="N103D3"></a><a name="CVS_revison_tags"></a>
+<a name="CVS_revison_tags"></a>
<h3 class="underlined_5">3.4. How can I generate html-pages to show the Revision tag of CVS or SVN?</h3>
<p>
If you have:<span class="codefrag"><version>$Revision: 1.30
@@ -1412,7 +1412,7 @@ error: datatype library "http://www.w3.o
When using Subversion, remember to set the relevant svn:keywords
properties.
</p>
-<a name="N103E8"></a><a name="cli-xconf"></a>
+<a name="cli-xconf"></a>
<h3 class="underlined_5">3.5. How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include
other additional ones. </h3>
<p>
@@ -1471,7 +1471,7 @@ error: datatype library "http://www.w3.o
which explains how to include non-linked extra documents to the processing
using the Cocoon CLI.
</p>
-<a name="N1042C"></a><a name="ignoring_javadocs"></a>
+<a name="ignoring_javadocs"></a>
<h3 class="underlined_5">3.6. How do I stop Forrest breaking on links to external files that may not exist, like
javadocs? </h3>
<p>
@@ -1479,7 +1479,7 @@ error: datatype library "http://www.w3.o
<span class="codefrag">cli.xconf</span> </a> Cocoon config file, and defining
patterns for URLs to exclude.
</p>
-<a name="N1043B"></a><a name="claimed_patterns"></a>
+<a name="claimed_patterns"></a>
<h3 class="underlined_5">3.7. Some of my files are not being processed because they use common filenames. </h3>
<p>
Certain patterns are claimed by the default sitemaps for special
@@ -1493,7 +1493,7 @@ error: datatype library "http://www.w3.o
of Forrest we will attempt to deal with this issue
(<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
</p>
-<a name="N1044D"></a><a name="build_msg_a"></a>
+<a name="build_msg_a"></a>
<h3 class="underlined_5">3.8. What do the symbols and numbers mean when Forrest lists each document that it has
built? </h3>
<p>
@@ -1522,7 +1522,7 @@ X [0] /docs_0_80/upgrading_08.ht
<li>Column 5 is the page size.</li>
</ul>
-<a name="N1046B"></a><a name="headless_operation"></a>
+<a name="headless_operation"></a>
<h3 class="underlined_5">3.9. 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. </h3>
<p>
@@ -1536,7 +1536,7 @@ X [0] /docs_0_80/upgrading_08.ht
<a href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html">Cocoon
FAQ</a>.
</p>
-<a name="N10487"></a><a name="project-logo-svg"></a>
+<a name="project-logo-svg"></a>
<h3 class="underlined_5">3.10.
The project logo that is generated from SVG is truncating my project name.
</h3>
@@ -1552,7 +1552,7 @@ X [0] /docs_0_80/upgrading_08.ht
details see <a href="http://www.w3.org/Graphics/SVG/">SVG</a>
resources.
</p>
-<a name="N1049F"></a><a name="catalog"></a>
+<a name="catalog"></a>
<h3 class="underlined_5">3.11. How do i configure my favourite XML editor or parser to find the local Forrest
DTDs? </h3>
<p>
@@ -1560,24 +1560,24 @@ X [0] /docs_0_80/upgrading_08.ht
<a href="../docs_0_90/catalog.html">Using Catalog Entity Resolver for local
DTDs</a>.
</p>
-<a name="N104AB"></a><a name="project-dtd"></a>
+<a name="project-dtd"></a>
<h3 class="underlined_5">3.12. How to configure the Catalog Entity Resolver to use my own local project DTDs?</h3>
<p>
See <a href="../docs_0_90/your-project.html#new_dtd">Using Forrest</a> for
configuration guidance.
</p>
-<a name="N104B7"></a><a name="local-catalog"></a>
+<a name="local-catalog"></a>
<h3 class="underlined_5">3.13. We need an additional system-wide catalog to share DTDs between projects</h3>
<p>
See <a href="../docs_0_90/validation.html#catalog">Using Forrest</a> for
configuration guidance.
</p>
-<a name="N104C3"></a><a name="debug-catalog"></a>
+<a name="debug-catalog"></a>
<h3 class="underlined_5">3.14. How to debug the Catalog Entity Resolver and local DTDs?</h3>
<p>
See <a href="../docs_0_90/validation.html#debug-catalog">XML validation</a>.
</p>
-<a name="N104CF"></a><a name="skin"></a>
+<a name="skin"></a>
<h3 class="underlined_5">3.15. How to make the site look better and change its skin? </h3>
<p>
There are <a href="../docs_0_90/your-project.html#skins">default skins</a> provided, which
@@ -1591,7 +1591,7 @@ X [0] /docs_0_80/upgrading_08.ht
skins. Some projects may have special needs and can define their
<a href="../docs_0_90/your-project.html#new_skin">own skin</a>.
</p>
-<a name="N104E6"></a><a name="xsp"></a>
+<a name="xsp"></a>
<h3 class="underlined_5">3.16. How do I enable XSP processing?</h3>
<p>
First consider whether your needs would be better met by Cocoon
@@ -1650,7 +1650,7 @@ X [0] /docs_0_80/upgrading_08.ht
<a href="http://wiki.apache.org/cocoon/AddingXSPToForrest">AddingXSPToForrest</a>
Wiki page.
</p>
-<a name="N1051D"></a><a name="breadcrumbs"></a>
+<a name="breadcrumbs"></a>
<h3 class="underlined_5">3.17. How do breadcrumbs work? Why don't they work locally?</h3>
<p>
Breadcrumbs begin with up to three URLs specified in
@@ -1671,7 +1671,7 @@ X [0] /docs_0_80/upgrading_08.ht
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>
-<a name="N10532"></a><a name="run_port"></a>
+<a name="run_port"></a>
<h3 class="underlined_5">3.18. How do I make forrest run listen on a different port?</h3>
<p>
@@ -1684,7 +1684,7 @@ X [0] /docs_0_80/upgrading_08.ht
do <span class="codefrag">forrest run</span>
</p>
-<a name="N10546"></a><a name="debugging"></a>
+<a name="debugging"></a>
<h3 class="underlined_5">3.19. Can I run Forrest with Java debugging turned on?</h3>
<p>
If you use an IDE like Eclipse and want to debug java code in Forrest
@@ -1695,7 +1695,7 @@ X [0] /docs_0_80/upgrading_08.ht
<span class="codefrag">forrest.properties</span> file. Don't forget to ensure the
property is uncommented in that file.
</p>
-<a name="N10557"></a><a name="checksums"></a>
+<a name="checksums"></a>
<h3 class="underlined_5">3.20. How do I enable Cocoon's document checksum feature?</h3>
<p>
Why might you want to do this? There is really no effect on Cocoon
@@ -1723,7 +1723,7 @@ X [0] /docs_0_80/upgrading_08.ht
<a href="#cli-xconf">Cocoon cli.xconf</a>) or use the default
installation-wide cli.xconf file.
</p>
-<a name="N10573"></a><a name="sitemap-entities"></a>
+<a name="sitemap-entities"></a>
<h3 class="underlined_5">3.21. How to configure some Cocoon sitemap components, e.g. output html encoding or doctype?</h3>
<p>
The core Cocoon components are defined in the
@@ -1746,7 +1746,7 @@ X [0] /docs_0_80/upgrading_08.ht
file into your project symbols file and edit the entity declaration.
Re-start Forrest.
</p>
-<a name="N1058D"></a><a name="svn-eol-style"></a>
+<a name="svn-eol-style"></a>
<h3 class="underlined_5">3.22. Why are there SVN diffs for some documents, even though they have not changed?</h3>
<p>
These un-necessary differences happen because the comitter who did 'svn add' for those files
@@ -1755,10 +1755,10 @@ X [0] /docs_0_80/upgrading_08.ht
about rectifying this issue.
</p>
</div>
-<a name="N10599"></a><a name="old_faqs"></a>
+<a name="old_faqs"></a>
<h2 class="underlined_10">4. Older version: 0.6</h2>
<div class="section">
-<a name="N1059D"></a><a name="old_claimed_patterns"></a>
+<a name="old_claimed_patterns"></a>
<h3 class="underlined_5">4.1. Some of my files are not being processed because they use common filenames. </h3>
<p>
Certain patterns are claimed by the default sitemaps for special
@@ -1773,10 +1773,10 @@ X [0] /docs_0_80/upgrading_08.ht
(<a href="http://issues.apache.org/jira/browse/FOR-217">FOR-217</a>).
</p>
</div>
-<a name="N105AF"></a><a name="general"></a>
+<a name="general"></a>
<h2 class="underlined_10">5. General</h2>
<div class="section">
-<a name="N105B3"></a><a name="generating_menus"></a>
+<a name="generating_menus"></a>
<h3 class="underlined_5">5.1. What is the relationship between site.xml and book.xml? </h3>
<p>
One <span class="codefrag">site.xml</span> file in your project root can replace all the book.xml files
@@ -1788,7 +1788,7 @@ X [0] /docs_0_80/upgrading_08.ht
where <span class="codefrag">site.xml</span>-generated menus aren't appropriate. See
<a href="../docs_0_90/linking.html">Menus and Linking</a>.
</p>
-<a name="N105CE"></a><a name="docbook"></a>
+<a name="docbook"></a>
<h3 class="underlined_5">5.2. How do I use DocBook as the XML documentation format? </h3>
<p>
There are two ways. Forrest has a <span class="codefrag">simplifiedDocbook</span>
@@ -1898,7 +1898,7 @@ X [0] /docs_0_80/upgrading_08.ht
<a href="../docs_0_90/your-project.html#new_dtd">Using Forrest</a> for
configuration guidance.
</p>
-<a name="N10607"></a><a name="version"></a>
+<a name="version"></a>
<h3 class="underlined_5">5.3. How to report which version of Forrest is being used and the properties that are
set? </h3>
<p>
@@ -1933,7 +1933,7 @@ X [0] /docs_0_80/upgrading_08.ht
See the documentation about the new <a href="../docs_0_90/properties.html">Properties</a>
system.
</p>
-<a name="N1063D"></a><a name="logs"></a>
+<a name="logs"></a>
<h3 class="underlined_5">5.4. Where are the log files to find more infomation about errors? </h3>
<p>
The logfiles are at <span class="codefrag">build/webapp/WEB-INF/logs/</span>
@@ -1955,7 +1955,7 @@ X [0] /docs_0_80/upgrading_08.ht
Doing <span class="codefrag">'forrest -v'</span> will provide verbose build messages to
the standard output.
</p>
-<a name="N10661"></a><a name="verbose-ant"></a>
+<a name="verbose-ant"></a>
<h3 class="underlined_5">5.5. How to filter or reduce the standard output messages? </h3>
<p>
Where normally you would do
@@ -1969,7 +1969,7 @@ X [0] /docs_0_80/upgrading_08.ht
Doing <span class="codefrag">'forrest -v'</span> will provide very verbose build messages to
the standard output.
</p>
-<a name="N1067B"></a><a name="coloured-ant"></a>
+<a name="coloured-ant"></a>
<h3 class="underlined_5">5.6. How to enabled coloured standard output messages? </h3>
<p>
Adding colour to the forrest output messages will greatly assist
@@ -1996,7 +1996,7 @@ X [0] /docs_0_80/upgrading_08.ht
<p>
Note that not all terminals support ANSI color codes.
</p>
-<a name="N1069B"></a><a name="how_can_I_help"></a>
+<a name="how_can_I_help"></a>
<h3 class="underlined_5">5.7. How to help? </h3>
<p>
Join one of the Forrest project <a href="../mail-lists.html">mailing
@@ -2005,7 +2005,7 @@ X [0] /docs_0_80/upgrading_08.ht
newcomers—often, close proximity blinds software developers to
faults that are obvious to everyone else. Don't be shy!
</p>
-<a name="N106A7"></a><a name="patch"></a>
+<a name="patch"></a>
<h3 class="underlined_5">5.8. How to contribute a patch? </h3>
<p>
Please send all contributions via our <a href="../issues.html">issue
@@ -2019,7 +2019,7 @@ X [0] /docs_0_80/upgrading_08.ht
<a href="../issues.html">issue tracker</a> before diving
in.
</p>
-<a name="N106C2"></a><a name="jobs"></a>
+<a name="jobs"></a>
<h3 class="underlined_5">5.9. How can job positions be advertised? </h3>
<p>
Employers can send notices about employment opportunities. There is a
@@ -2038,7 +2038,7 @@ X [0] /docs_0_80/upgrading_08.ht
(<a href="http://www.apache.org/licenses/">CCLA</a>) with The
Apache Software Foundation.
</p>
-<a name="N106D5"></a><a name="press"></a>
+<a name="press"></a>
<h3 class="underlined_5">5.10. Is there a press kit? Who can journalists contact?</h3>
<p>
Press enquiries should be co-ordinated through the ASF Public Relations Committee (PRC).
@@ -2057,7 +2057,7 @@ X [0] /docs_0_80/upgrading_08.ht
are available.
Unfortunately the logo is only available as PNG.
</p>
-<a name="N106F8"></a><a name="security"></a>
+<a name="security"></a>
<h3 class="underlined_5">5.11. How to report a security issue?</h3>
<p>
Security and vulnerability issues are co-ordinated through the
Modified: forrest/site/docs_0_90/glossary.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/glossary.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/glossary.html (original)
+++ forrest/site/docs_0_90/glossary.html Thu Jan 20 06:47:23 2011
@@ -358,20 +358,16 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10008"></a><a name="Introduction"></a>
+<a name="Introduction"></a>
<h2 class="underlined_10">Introduction</h2>
<div class="section">
-<introduction>
-
<p>
This is a glossary of terms and their definitions for the Apache Forrest
project. Some plugins also have a glossary, for example
<a href="http://forrest.apache.org/pluginDocs/plugins_0_80/org.apache.forrest.plugin.internal.dispatcher/dispatcher-glossary.html">Dispatcher</a>.
</p>
-
-</introduction>
</div>
-<a name="N10015"></a><a name="a"></a>
+<a name="a"></a>
<h2 class="underlined_10">A</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -441,7 +437,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N1006C"></a><a name="c"></a>
+<a name="c"></a>
<h2 class="underlined_10">C</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -474,7 +470,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N10099"></a><a name="d"></a>
+<a name="d"></a>
<h2 class="underlined_10">D</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -517,7 +513,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N100C9"></a><a name="g"></a>
+<a name="g"></a>
<h2 class="underlined_10">G</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -549,7 +545,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N100F3"></a><a name="i"></a>
+<a name="i"></a>
<h2 class="underlined_10">I</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -575,7 +571,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N10117"></a><a name="l"></a>
+<a name="l"></a>
<h2 class="underlined_10">L</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -636,7 +632,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N10153"></a><a name="p"></a>
+<a name="p"></a>
<h2 class="underlined_10">P</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -711,7 +707,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N101B5"></a><a name="r"></a>
+<a name="r"></a>
<h2 class="underlined_10">R</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -728,7 +724,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N101D2"></a><a name="s"></a>
+<a name="s"></a>
<h2 class="underlined_10">S</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -893,7 +889,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N10293"></a><a name="t"></a>
+<a name="t"></a>
<h2 class="underlined_10">T</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -926,7 +922,7 @@ document.write("Last Published: " + docu
</tr>
</table>
</div>
-<a name="N102BD"></a><a name="x"></a>
+<a name="x"></a>
<h2 class="underlined_10">X</h2>
<div class="section">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
Modified: forrest/site/docs_0_90/howto/cvs-ssh/howto-cvs-ssh.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/cvs-ssh/howto-cvs-ssh.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/cvs-ssh/howto-cvs-ssh.html (original)
+++ forrest/site/docs_0_90/howto/cvs-ssh/howto-cvs-ssh.html Thu Jan 20 06:47:23 2011
@@ -197,7 +197,7 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10013"></a><a name="Intended-audience"></a>
+<a name="Intended-audience"></a>
<h2 class="underlined_10">Intended audience</h2>
<div class="section">
<p>
@@ -205,7 +205,7 @@ document.write("Last Published: " + docu
to CVS repositories for particular projects.
</p>
</div>
-<a name="N1001B"></a><a name="Purpose"></a>
+<a name="Purpose"></a>
<h2 class="underlined_10">Purpose</h2>
<div class="section">
<p>
@@ -215,7 +215,7 @@ document.write("Last Published: " + docu
password every time you need access to CVS through SSH.
</p>
</div>
-<a name="N10023"></a><a name="Prerequisites"></a>
+<a name="Prerequisites"></a>
<h2 class="underlined_10">Prerequisites</h2>
<div class="section">
<ul>
@@ -240,13 +240,13 @@ document.write("Last Published: " + docu
</div>
</div>
</div>
-<a name="N10044"></a><a name="Steps"></a>
+<a name="Steps"></a>
<h2 class="underlined_10">Steps</h2>
<div class="section">
<p>
How to proceed.
</p>
-<a name="N1004C"></a><a name="Terms"></a>
+<a name="Terms"></a>
<h3 class="underlined_5">Terms</h3>
<dl>
@@ -268,7 +268,7 @@ document.write("Last Published: " + docu
<strong>$</strong> represents local, <strong>%</strong> remote machine.
</div>
</div>
-<a name="N10071"></a><a name="Setting+up+domain+users"></a>
+<a name="Setting+up+domain+users"></a>
<h3 class="underlined_5">Setting up domain users</h3>
<div class="note">
<div class="label">Note</div>
@@ -309,7 +309,7 @@ $ exit
$ whoami
userxxx
</pre>
-<a name="N1009C"></a><a name="ssh_access"></a>
+<a name="ssh_access"></a>
<h3 class="underlined_5">Setting up SSH access</h3>
<p>
Start Cygwin/shell, then enter:
@@ -339,7 +339,7 @@ $ ssh-user-config
passphrase retaining.
</div>
</div>
-<a name="N100B3"></a><a name="Setting+up+passphrase+access"></a>
+<a name="Setting+up+passphrase+access"></a>
<h3 class="underlined_5">Setting up passphrase access</h3>
<p>
Perform the following:
@@ -380,7 +380,7 @@ $ ssh userxxx@cvs.apache.org
If now you are logged in to the to the CVS machine without entering the
password then everything's Ok.
</p>
-<a name="N100D7"></a><a name="Getting+the+project+from+CVS"></a>
+<a name="Getting+the+project+from+CVS"></a>
<h3 class="underlined_5">Getting the project from CVS</h3>
<p>
Now you are ready to get a project from CVS using SSH connection.
@@ -392,7 +392,7 @@ $ ssh userxxx@cvs.apache.org
$ export CVS_RSH=/bin/ssh
$ cvs -d :ext:userxxx@cvs.apache.org:/home/cvs co xml-cocoon2
</pre>
-<a name="N100E8"></a><a name="How+to+setup+WinCVS"></a>
+<a name="How+to+setup+WinCVS"></a>
<h3 class="underlined_5">How to setup WinCVS</h3>
<ul>
@@ -423,7 +423,7 @@ $ cvs -d :ext:userxxx@cvs.apache.org:/ho
<li>Click Ok</li>
</ul>
-<a name="N1011B"></a><a name="References"></a>
+<a name="References"></a>
<h3 class="underlined_5">References</h3>
<p>
You can find more on CVS, SSH and WinCVS here:
Modified: forrest/site/docs_0_90/howto/howto-asf-mirror.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/howto-asf-mirror.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/howto-asf-mirror.html (original)
+++ forrest/site/docs_0_90/howto/howto-asf-mirror.html Thu Jan 20 06:47:23 2011
@@ -359,7 +359,7 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10010"></a><a name="Intended-Audience"></a>
+<a name="Intended-Audience"></a>
<h2 class="underlined_10">Intended Audience</h2>
<div class="section">
<ul>
@@ -374,7 +374,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10021"></a><a name="Purpose"></a>
+<a name="Purpose"></a>
<h2 class="underlined_10">Purpose</h2>
<div class="section">
<p>
@@ -388,7 +388,7 @@ document.write("Last Published: " + docu
from anywhere in the site. So we explain how to process additional files.
</p>
</div>
-<a name="N1002C"></a><a name="Prerequisites"></a>
+<a name="Prerequisites"></a>
<h2 class="underlined_10">Prerequisites</h2>
<div class="section">
<ul>
@@ -406,7 +406,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10045"></a><a name="Steps"></a>
+<a name="Steps"></a>
<h2 class="underlined_10">Steps</h2>
<div class="section">
<p>
@@ -418,7 +418,7 @@ $FORREST_HOME/site-author/content/xdocs/
$FORREST_HOME/site-author/content/mirrors.cgi
$FORREST_HOME/site-author/conf/cli.xconf (search for "mirrors")
$FORREST_HOME/site-author/forrest.properties (search for "project.configfile")</pre>
-<a name="N10051"></a><a name="cgi"></a>
+<a name="cgi"></a>
<h3 class="underlined_5">Add the mirrors.cgi as a raw file</h3>
<p>
As explained in the mirrors document, there will be a two-line CGI
@@ -432,7 +432,7 @@ $FORREST_HOME/site-author/forrest.proper
project's
<a href="http://svn.apache.org/repos/asf/forrest/trunk/site-author/content/mirrors.cgi">mirrors.cgi</a>)
</p>
-<a name="N10068"></a><a name="html"></a>
+<a name="html"></a>
<h3 class="underlined_5">Add the mirrors.html to xdocs directory</h3>
<p>
This file contains the html content of your mirror page, including the
@@ -450,7 +450,7 @@ $FORREST_HOME/site-author/forrest.proper
Note that the special tokens (e.g. [if-any http] [for http]) need to be
encompassed by xml comments.
</p>
-<a name="N1007F"></a><a name="menu"></a>
+<a name="menu"></a>
<h3 class="underlined_5">Add a menu entry for Download</h3>
<p>
Add an entry to your site.xml navigation. For example ...
@@ -464,7 +464,7 @@ $FORREST_HOME/site-author/forrest.proper
<download_html href="mirrors.html"/><!-- so the page is part of a tab -->
...
</pre>
-<a name="N1008D"></a><a name="link"></a>
+<a name="link"></a>
<h3 class="underlined_5">Cause the mirrors.html to be processed as an extra file</h3>
<p>
Forrest gathers the links that are to be crawled, by reading site.xml
@@ -509,7 +509,7 @@ $FORREST_HOME/site-author/forrest.proper
</uri>
</uris>
</pre>
-<a name="N100B4"></a><a name="exclude"></a>
+<a name="exclude"></a>
<h3 class="underlined_5">Exclude mirrors CGI token URIs from processing</h3>
<p>
The mirrors.html has special URIs which are processed by the mirrors CGI script.
@@ -522,7 +522,7 @@ $FORREST_HOME/site-author/forrest.proper
<exclude pattern="[preferred]/**"/>
<exclude pattern="[location]"/>
</pre>
-<a name="N100C2"></a><a name="forrest"></a>
+<a name="forrest"></a>
<h3 class="underlined_5">Run 'forrest' to build your site</h3>
<p>
That is all that you need to do, Forrest will take care of it from
Modified: forrest/site/docs_0_90/howto/howto-buildPlugin.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/howto-buildPlugin.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/howto-buildPlugin.html (original)
+++ forrest/site/docs_0_90/howto/howto-buildPlugin.html Thu Jan 20 06:47:23 2011
@@ -442,7 +442,7 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10013"></a><a name="Intended-Audience"></a>
+<a name="Intended-Audience"></a>
<h2 class="underlined_10">Intended Audience</h2>
<div class="section">
<p>
@@ -457,7 +457,7 @@ document.write("Last Published: " + docu
</div>
</div>
</div>
-<a name="N1001E"></a><a name="Purpose"></a>
+<a name="Purpose"></a>
<h2 class="underlined_10">Purpose</h2>
<div class="section">
<p>
@@ -465,7 +465,7 @@ document.write("Last Published: " + docu
configure a Forrest project to use their plugin.
</p>
</div>
-<a name="N10026"></a><a name="Prerequisites"></a>
+<a name="Prerequisites"></a>
<h2 class="underlined_10">Prerequisites</h2>
<div class="section">
<p>
@@ -486,20 +486,20 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10040"></a><a name="Steps"></a>
+<a name="Steps"></a>
<h2 class="underlined_10">Steps</h2>
<div class="section">
<p>
Here is how to proceed.
</p>
-<a name="N10048"></a><a name="typeOfPlugin"></a>
+<a name="typeOfPlugin"></a>
<h3 class="underlined_5">Type of Plugin</h3>
<p>
There are three types of plugin, each with a clear purpose, you must
first decide which <a href="../../pluginDocs/plugins_0_90/pluginInfrastructure.html">type of
plugin</a> you need to build.
</p>
-<a name="N10056"></a><a name="ant"></a>
+<a name="ant"></a>
<h3 class="underlined_5">Make ant available on the command-line</h3>
<p>
The following instructions rely heavily on
@@ -518,7 +518,7 @@ document.write("Last Published: " + docu
network to get the DTDs on every xml parse. Be aware that Forrest might
be relying on some Ant features in its version.
</p>
-<a name="N1006A"></a><a name="seed"></a>
+<a name="seed"></a>
<h3 class="underlined_5">Seed a New Plugin</h3>
<p>
Regardless of the type of plugin you are building, the directory
@@ -580,7 +580,7 @@ document.write("Last Published: " + docu
more information about the plugin directory structure and configuration
files.
</p>
-<a name="N100A8"></a><a name="edit-template"></a>
+<a name="edit-template"></a>
<h4>Edit the Plugin Template</h4>
<p>
You now have a skeleton plugin project. However, it doesn't do
@@ -590,7 +590,7 @@ document.write("Last Published: " + docu
<p>
Here are some general notes:
</p>
-<a name="N100B4"></a><a name="status"></a>
+<a name="status"></a>
<h5>status.xml</h5>
<p>
This file is used to track changes to the plugin project and to
@@ -604,19 +604,19 @@ document.write("Last Published: " + docu
this file so that it can then be used as a changelog for your
plugin.
</p>
-<a name="N100C4"></a><a name="forrest-properties"></a>
+<a name="forrest-properties"></a>
<h5>forrest.properties</h5>
<p>
This file defines many configuration parameters for Forrest. It does
not need to be customised in most cases. However, see for more
details.
</p>
-<a name="N100CE"></a><a name="build-xml"></a>
+<a name="build-xml"></a>
<h5>build.xml</h5>
<p>
If the plugin uses Java, then set the "requires-java" property to true.
</p>
-<a name="N100D8"></a><a name="skinconf"></a>
+<a name="skinconf"></a>
<h5>src/documentation/skinconf.xml</h5>
<p>
This configures the skin for your plugins documentation.
@@ -627,14 +627,14 @@ document.write("Last Published: " + docu
If this is not and ASF-hosted plugin, then copy the skinconf.xml from a fresh
'forrest seed-sample' site instead.
</p>
-<a name="N100E5"></a><a name="doc"></a>
+<a name="doc"></a>
<h5>Documentation</h5>
<p>
It is also a good idea to start writing the documentation at this
stage. The above process created a very simple plugin documentation
site for you. All you have to do is add the content.
</p>
-<a name="N100EF"></a><a name="hosted"></a>
+<a name="hosted"></a>
<h5>Style notes for plugins hosted at forrest.apache.org</h5>
<p>
After seeding a new plugin, copy some configuration from an existing
@@ -643,7 +643,7 @@ document.write("Last Published: " + docu
and
src/documentation/content/xdocs/favicon.ico
</p>
-<a name="N100FB"></a><a name="edit-sitemap"></a>
+<a name="edit-sitemap"></a>
<h3 class="underlined_5">Edit the Plugin sitemap file(s)</h3>
<p>
The plugin <span class="codefrag">xmap</span> file is a Cocoon sitemap that is mounted at
@@ -673,7 +673,7 @@ document.write("Last Published: " + docu
<a href="../../mail-lists.html#forrest-dev">developer mailing list</a> a very
good resource (check the archives before posting, please).
</p>
-<a name="N10128"></a><a name="components"></a>
+<a name="components"></a>
<h4>Components, Actions and Resources</h4>
<p>
If your plugin uses any components (i.e. generators, transformers or
@@ -694,7 +694,7 @@ document.write("Last Published: " + docu
<p>
See the examples below for more details.
</p>
-<a name="N10151"></a><a name="resources"></a>
+<a name="resources"></a>
<h3 class="underlined_5">Create the Necessary Resource Files</h3>
<div class="fixme">
<div class="label">Fixme (open)</div>
@@ -702,7 +702,7 @@ document.write("Last Published: " + docu
Discuss the XSL files and other such resources
</div>
</div>
-<a name="N1015B"></a><a name="dtd-catalog"></a>
+<a name="dtd-catalog"></a>
<h4>Entity catalog for DTDs and other resources</h4>
<p>
If the plugin uses non-core DTDs and other entities, then add them to
@@ -711,7 +711,7 @@ document.write("Last Published: " + docu
another plugin (e.g. "listLocations" has a simple example; "glossary"
has a more complex example) and edit it to suit.
</p>
-<a name="N10169"></a><a name="samples"></a>
+<a name="samples"></a>
<h3 class="underlined_5">Create Samples in the Documentation</h3>
<p>
Plugin documentation should provide (as a minimum) an index page that
@@ -725,7 +725,7 @@ document.write("Last Published: " + docu
Try to provide a sample for all the major functions of your plugin and
document any configuration that is available.
</p>
-<a name="N1017F"></a><a name="test"></a>
+<a name="test"></a>
<h3 class="underlined_5">Testing a Plugin</h3>
<p>
Since your documentation for the plugin illustrates all of its
@@ -762,7 +762,7 @@ document.write("Last Published: " + docu
Ensure that your sitemaps are robust and handle matches for files in
sub-directories, as well as those at the root level.
</p>
-<a name="N101AD"></a><a name="Testing+During+Development"></a>
+<a name="Testing+During+Development"></a>
<h4>Testing During Development</h4>
<p>
In the current plugin system plugins are not used from their src
@@ -789,9 +789,9 @@ document.write("Last Published: " + docu
files in the <span class="codefrag">conf</span> directory you will, most likely, have
to restart Forrest to see these changes.
</p>
-<a name="N101C7"></a><a name="descriptor"></a>
+<a name="descriptor"></a>
<h3 class="underlined_5">Managing the plugins descriptors</h3>
-<a name="N101CD"></a><a name="explain-descriptor"></a>
+<a name="explain-descriptor"></a>
<h4>Explanation</h4>
<p>
The files plugins/plugins.xml and
@@ -851,7 +851,7 @@ document.write("Last Published: " + docu
<li>When ready do the plugin release process, and do <span class="codefrag">'ant deploy'</span> and <span class="codefrag">'ant release'</span> etc.</li>
</ul>
-<a name="N10217"></a><a name="register"></a>
+<a name="register"></a>
<h4>Register the Plugin with Apache Forrest</h4>
<div class="fixme">
<div class="label">Fixme (open)</div>
@@ -860,9 +860,9 @@ document.write("Last Published: " + docu
In the meantime just ask on the dev mail list.
</div>
</div>
-<a name="N10223"></a><a name="release"></a>
+<a name="release"></a>
<h3 class="underlined_5">Deploying and Releasing a Plugin</h3>
-<a name="N10229"></a><a name="explain-deploy"></a>
+<a name="explain-deploy"></a>
<h4>Explanation</h4>
<div class="fixme">
<div class="label">Fixme (open)</div>
@@ -882,7 +882,7 @@ document.write("Last Published: " + docu
<li>a text document at $FORREST_HOME/plugins/RELEASE_PROCESS.txt</li>
</ul>
-<a name="N10241"></a><a name="deploy"></a>
+<a name="deploy"></a>
<h4>Deploying the Plugin</h4>
<p>
To deploy the plugin so that others can use it, it must be made
@@ -920,7 +920,7 @@ document.write("Last Published: " + docu
cycle, but we feel the peace of mind is worth it.
</div>
</div>
-<a name="N10274"></a><a name="experimental"></a>
+<a name="experimental"></a>
<h3 class="underlined_5">Experimental Functionality</h3>
<div class="warning">
<div class="label">Warning</div>
@@ -939,7 +939,7 @@ document.write("Last Published: " + docu
<span class="codefrag">org.apache.forrest.internal.NoteTaking</span> plugin.
</div>
</div>
-<a name="N10283"></a><a name="Locationmap"></a>
+<a name="Locationmap"></a>
<h4>Locationmap</h4>
<p>
Plugins can use the Forrest locationmap to expose resources to your
@@ -951,7 +951,7 @@ document.write("Last Published: " + docu
<a href="http://issues.apache.org/jira/browse/FOR-200">issue</a> for
the status of locationmap development.
</p>
-<a name="N10297"></a><a name="Dispatcher"></a>
+<a name="Dispatcher"></a>
<h4>Dispatcher</h4>
<p>
Dispatcher (previous codename Forrest Views) is the collective name
@@ -998,7 +998,7 @@ document.write("Last Published: " + docu
locationmap which is generated when you seed a new plugin, but for now
it must be done manually.
</p>
-<a name="N102B7"></a><a name="Plugin+Properties"></a>
+<a name="Plugin+Properties"></a>
<h4>Plugin Properties</h4>
<p>
Plugins can define properties that each project can over-ride. For
@@ -1009,13 +1009,13 @@ document.write("Last Published: " + docu
<a href="http://issues.apache.org/jira/browse/FOR-588">issue</a> for
the status of this new configuration system.
</p>
-<a name="N102C9"></a><a name="examples"></a>
+<a name="examples"></a>
<h3 class="underlined_5">Examples</h3>
<p>
This section will provide some example plugins to help illustrate the
steps discussed above.
</p>
-<a name="N102D2"></a><a name="input"></a>
+<a name="input"></a>
<h4>Input Plugin</h4>
<div class="fixme">
<div class="label">Fixme (open)</div>
@@ -1023,7 +1023,7 @@ document.write("Last Published: " + docu
Discuss a simple example of an "input" plugin here.
</div>
</div>
-<a name="N102DD"></a><a name="output"></a>
+<a name="output"></a>
<h4>Output Plugin</h4>
<div class="fixme">
<div class="label">Fixme (open)</div>
@@ -1031,7 +1031,7 @@ document.write("Last Published: " + docu
Discuss a simple example of an "output" plugin here.
</div>
</div>
-<a name="N102E8"></a><a name="internal"></a>
+<a name="internal"></a>
<h4>Internal Plugin</h4>
<div class="fixme">
<div class="label">Fixme (open)</div>
@@ -1039,7 +1039,7 @@ document.write("Last Published: " + docu
Discuss a simple example of an "internal" plugin here.
</div>
</div>
-<a name="N102F4"></a><a name="extension"></a>
+<a name="extension"></a>
<h3 class="underlined_5">Further Reading</h3>
<ul>
@@ -1050,7 +1050,7 @@ document.write("Last Published: " + docu
<a href="../../pluginDocs/plugins_0_90/">Plugins Documentation</a> for users</li>
</ul>
-<a name="N1030A"></a><a name="summarise"></a>
+<a name="summarise"></a>
<h3 class="underlined_5">Summarise the Entire Process</h3>
<div class="fixme">
<div class="label">Fixme (open)</div>
Modified: forrest/site/docs_0_90/howto/howto-corner-images.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/howto-corner-images.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/howto-corner-images.html (original)
+++ forrest/site/docs_0_90/howto/howto-corner-images.html Thu Jan 20 06:47:23 2011
@@ -352,7 +352,7 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10010"></a><a name="Intended-Audience"></a>
+<a name="Intended-Audience"></a>
<h2 class="underlined_10">Intended Audience</h2>
<div class="section">
<p>
@@ -364,7 +364,7 @@ document.write("Last Published: " + docu
corner image generation process.
</p>
</div>
-<a name="N1001B"></a><a name="Purpose"></a>
+<a name="Purpose"></a>
<h2 class="underlined_10">Purpose</h2>
<div class="section">
<p>
@@ -374,7 +374,7 @@ document.write("Last Published: " + docu
for your own skin colors.
</p>
</div>
-<a name="N10028"></a><a name="Prerequisites"></a>
+<a name="Prerequisites"></a>
<h2 class="underlined_10">Prerequisites</h2>
<div class="section">
<ul>
@@ -388,7 +388,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N1003E"></a><a name="Steps"></a>
+<a name="Steps"></a>
<h2 class="underlined_10">Steps</h2>
<div class="section">
<p>
@@ -397,7 +397,7 @@ document.write("Last Published: " + docu
for these images by modifying the
<span class="codefrag">src/documentation/skinconf.xml</span> of a project.
</p>
-<a name="N10049"></a><a name="css-files"></a>
+<a name="css-files"></a>
<h3 class="underlined_5">Understand how corner images are named (the contract)</h3>
<p>
The corner images are referenced in some .css files of the above-named
@@ -564,7 +564,7 @@ images/{$name}-{$v-orientation}-{$h-orie
directly generating it.
</div>
</div>
-<a name="N10122"></a><a name="skinconfig"></a>
+<a name="skinconfig"></a>
<h3 class="underlined_5">Modifying the skinconf.xml of your project</h3>
<p>
modifying the <span class="codefrag">skinconf.xml</span> of your project (by default you
@@ -626,7 +626,7 @@ images/{$name}-{$v-orientation}-{$h-orie
color (<span class="codefrag">-3tab-selected</span>) are set to red (remember: we defined
<span class="codefrag">#FF0000</span> as the "color" value of <span class="codefrag">tab-selected</span>).
</p>
-<a name="N10179"></a><a name="css_modify"></a>
+<a name="css_modify"></a>
<h3 class="underlined_5">Modifying .css files</h3>
<p>
In addition to the modification of <span class="codefrag">skinconf.xml</span> you can
@@ -661,7 +661,7 @@ images/{$name}-{$v-orientation}-{$h-orie
Horrible, isn't it?
</p>
</div>
-<a name="N101A9"></a><a name="Feedback"></a>
+<a name="Feedback"></a>
<h2 class="underlined_10">Feedback</h2>
<div class="section">
<p>
Modified: forrest/site/docs_0_90/howto/howto-custom-html-source.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/howto-custom-html-source.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/howto-custom-html-source.html (original)
+++ forrest/site/docs_0_90/howto/howto-custom-html-source.html Thu Jan 20 06:47:23 2011
@@ -395,7 +395,7 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10010"></a><a name="Intended-Audience"></a>
+<a name="Intended-Audience"></a>
<h2 class="underlined_10">Intended Audience</h2>
<div class="section">
<p>
@@ -403,7 +403,7 @@ document.write("Last Published: " + docu
everybody who wants to learn more about Forrest's pipelines in general.
</p>
</div>
-<a name="N10018"></a><a name="Purpose"></a>
+<a name="Purpose"></a>
<h2 class="underlined_10">Purpose</h2>
<div class="section">
<p>
@@ -413,7 +413,7 @@ document.write("Last Published: " + docu
does not suffice.
</p>
</div>
-<a name="N10020"></a><a name="Prerequisites"></a>
+<a name="Prerequisites"></a>
<h2 class="underlined_10">Prerequisites</h2>
<div class="section">
<p>
@@ -451,7 +451,7 @@ document.write("Last Published: " + docu
</ol>
</div>
-<a name="N10043"></a><a name="Understanding-the-HTML-Pipeline"></a>
+<a name="Understanding-the-HTML-Pipeline"></a>
<h2 class="underlined_10">Understanding the HTML-Pipeline</h2>
<div class="section">
<p>
@@ -460,7 +460,7 @@ document.write("Last Published: " + docu
documents. If you already know how pipelines work, then skip to the
section about <a href="#custom">Customizing the html pipeline</a>.
</p>
-<a name="N1004F"></a><a name="example"></a>
+<a name="example"></a>
<h3 class="underlined_5">Driven by Example</h3>
<p>
The best way to learn about Forrest pipelines is follow the processing
@@ -472,7 +472,7 @@ document.write("Last Published: " + docu
<br>
'http://my.domain.org/mytest/mybad.html'.
</p>
-<a name="N1005E"></a><a name="sitemap"></a>
+<a name="sitemap"></a>
<h3 class="underlined_5">Finding the Sitemap</h3>
<p>
Like all applications based on Apache Cocoon, each request for a given
@@ -501,7 +501,7 @@ map:sitemap
are other sitemaps (which we will see later on), we always start looking
for a matching pattern right here.
</p>
-<a name="N10079"></a><a name="pipelines"></a>
+<a name="pipelines"></a>
<h3 class="underlined_5">Find the Beginning of the Pipelines Section</h3>
<p>
Modular as everything else in Cocoon, Forrest's sitemap starts with a
@@ -525,7 +525,7 @@ map:pipelines
bottom until it encounters a Pipeline that will take care of our
request.
</p>
-<a name="N10090"></a><a name="matches"></a>
+<a name="matches"></a>
<h3 class="underlined_5">Looking for a Match</h3>
<p>
Like all Cocoon applications, Forrest knows which pipeline to use for
@@ -565,7 +565,7 @@ map:pipelines
*.something in Cocoon matches only files in the root directory.
</div>
</div>
-<a name="N100B4"></a><a name="html-pipeline"></a>
+<a name="html-pipeline"></a>
<h3 class="underlined_5">Processing in the '**/*.html' Pipeline</h3>
<p>
Let's take a quick look at this pipeline to understand what's happening
@@ -619,7 +619,7 @@ map:pipelines
comes from. To find out, we have to look at the sources of the
aggregation.
</p>
-<a name="N100D5"></a><a name="protocols"></a>
+<a name="protocols"></a>
<h3 class="underlined_5">Following the Pseudo-Protocols</h3>
<p>
To find out what goes into our aggregation, we'll need to look at the
@@ -683,7 +683,7 @@ map:pipelines
As you can easily tell, we are suddenly calling for a whole new
document. Let's see where that takes us:
</p>
-<a name="N10139"></a><a name="call"></a>
+<a name="call"></a>
<h3 class="underlined_5">Second Call for Content</h3>
<p>
Processing of cocoon-calls is not much different from normal requests by
@@ -702,7 +702,7 @@ map:pipelines
</span> from the beginning of the sitemap to see where we find our next
match.
</p>
-<a name="N10151"></a><a name="match-1"></a>
+<a name="match-1"></a>
<h3 class="underlined_5">First Match for '**body-*.html'</h3>
<p>
Our first match is different to the previous ones because there is a
@@ -724,7 +724,7 @@ map:pipelines
So we have a pipeline, but it doesn't do anything. In this case Forrest
will simply keep looking for the next match further down.
</p>
-<a name="N10167"></a><a name="match-2"></a>
+<a name="match-2"></a>
<h3 class="underlined_5">Second Match for '**body-*.html'</h3>
<p class="instruction">
Continue searching downwards for '**body-*.html' in the sitemap-file.
@@ -787,7 +787,7 @@ map:pipelines
<pre class="code">
<map:generate src="cocoon:/mytests/mybad.xml"/>
</pre>
-<a name="N101CF"></a><a name="match-3"></a>
+<a name="match-3"></a>
<h3 class="underlined_5">Third Call for Content</h3>
<p class="instruction">
So let's scan the main sitemap looking for a match for
@@ -847,7 +847,7 @@ map:pipelines
for the existence of the file with different extensions. '.html' is
third in this list and leads to the processing steps shown below:
</p>
-<a name="N1020A"></a><a name="process-html"></a>
+<a name="process-html"></a>
<h3 class="underlined_5">html-Default Processing</h3>
<p>
The default processing of html-files consists of three processing steps:
@@ -900,7 +900,7 @@ map:pipelines
that name).
</div>
</div>
-<a name="N1023E"></a><a name="body"></a>
+<a name="body"></a>
<h3 class="underlined_5">Returning to the '**body-*.html'-Pipeline</h3>
<p>
On returning into the '**body-*.html'-Pipeline (in sitemap.xmap),
@@ -947,7 +947,7 @@ map:pipelines
that name).
</div>
</div>
-<a name="N10266"></a><a name="aggregate"></a>
+<a name="aggregate"></a>
<h3 class="underlined_5">Returning to the '**/*.html'-Pipeline</h3>
<p>
At the end of this pipeline, processing returns the results into the
@@ -955,13 +955,13 @@ map:pipelines
Pipeline</a>, merges it with other data, skins and serializes for
presentation in the requesting client.
</p>
-<a name="N10274"></a><a name="custom"></a>
+<a name="custom"></a>
<h3 class="underlined_5">Customizing the html pipeline</h3>
<p>
In this last part of this document, we will show how to customize the
HTML-pipeline to add your additional steps to the default processing.
</p>
-<a name="N1027D"></a><a name="when"></a>
+<a name="when"></a>
<h4>When to customize?</h4>
<p>
The html-Pipeline in Forrest is designed to be able to also integrate
@@ -983,7 +983,7 @@ map:pipelines
will see the original page from your legacy website, menu and all,
embedded in your new Forrest site.
</p>
-<a name="N1028D"></a><a name="how"></a>
+<a name="how"></a>
<h4>How to customize?</h4>
<p>
To add your own custom processing for a group of pages, you will
@@ -1003,7 +1003,7 @@ map:pipelines
pipeline'), your pipeline intercepts practically all of Forrest's
standard pipelines.
</p>
-<a name="N1029D"></a><a name="what"></a>
+<a name="what"></a>
<h4>What to intercept?</h4>
<p>
Where to intercept standard processing is really a matter of your
@@ -1021,7 +1021,7 @@ map:pipelines
new pipeline that intercepts **.xml for our pages, copy the steps the
original processor is doing and add a transformation of our own to it.
</p>
-<a name="N102AD"></a><a name="intercept"></a>
+<a name="intercept"></a>
<h4>Intercept pattern</h4>
<p>
Take great care when intercepting very basic pipelines. Instead of
Modified: forrest/site/docs_0_90/howto/howto-editcss.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/howto-editcss.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/howto-editcss.html (original)
+++ forrest/site/docs_0_90/howto/howto-editcss.html Thu Jan 20 06:47:23 2011
@@ -357,7 +357,7 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10010"></a><a name="Intended-Audience"></a>
+<a name="Intended-Audience"></a>
<h2 class="underlined_10">Intended Audience</h2>
<div class="section">
<p>
@@ -365,7 +365,7 @@ document.write("Last Published: " + docu
with changing certain CSS-styles settings to see what happens.
</p>
</div>
-<a name="N10018"></a><a name="Purpose"></a>
+<a name="Purpose"></a>
<h2 class="underlined_10">Purpose</h2>
<div class="section">
<p>
@@ -380,7 +380,7 @@ document.write("Last Published: " + docu
property will have on the look and feel of your Forrest.
</p>
</div>
-<a name="N10023"></a><a name="Prerequisites"></a>
+<a name="Prerequisites"></a>
<h2 class="underlined_10">Prerequisites</h2>
<div class="section">
<p>
@@ -429,10 +429,10 @@ document.write("Last Published: " + docu
</ol>
</div>
-<a name="N1004C"></a><a name="Steps"></a>
+<a name="Steps"></a>
<h2 class="underlined_10">Steps</h2>
<div class="section">
-<a name="N10051"></a><a name="openForrest"></a>
+<a name="openForrest"></a>
<h3 class="underlined_5">Open your Forrest</h3>
<p class="instruction">
Start your Firefox Browser and open the Forrest you'd like to work
@@ -441,7 +441,7 @@ document.write("Last Published: " + docu
<p>
The page you have pointed to will show up in Firefox's main window.
</p>
-<a name="N1005F"></a><a name="OpenEditCSS"></a>
+<a name="OpenEditCSS"></a>
<h3 class="underlined_5">Open the EditCSS-Sidebar</h3>
<p class="instruction">
Select View-Sidebar-EditCSS from Firefox's main menu to open the EditCSS
@@ -451,7 +451,7 @@ document.write("Last Published: " + docu
The EditCSS sidebar will show next to the main window and load all the
styles from the main page.
</p>
-<a name="N1006D"></a><a name="changeCSS"></a>
+<a name="changeCSS"></a>
<h3 class="underlined_5">Change any CSS</h3>
<p class="instruction">
Change any style you'd like to experiment with or add new settings and
@@ -469,7 +469,7 @@ document.write("Last Published: " + docu
windows for every character you type.
</div>
</div>
-<a name="N1007E"></a><a name="saveChanges"></a>
+<a name="saveChanges"></a>
<h3 class="underlined_5">How to save changes?</h3>
<p>
Since it takes a few explanations to apply the changes to your Forrest,
@@ -477,7 +477,7 @@ document.write("Last Published: " + docu
extend Forrest-CSS"
</p>
</div>
-<a name="N10088"></a><a name="Feedback-and-further-development-of-this-How-To"></a>
+<a name="Feedback-and-further-development-of-this-How-To"></a>
<h2 class="underlined_10">Feedback and further development of this How-To</h2>
<div class="section">
<p>
Modified: forrest/site/docs_0_90/howto/howto-forrest-from-maven.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/howto-forrest-from-maven.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/howto-forrest-from-maven.html (original)
+++ forrest/site/docs_0_90/howto/howto-forrest-from-maven.html Thu Jan 20 06:47:23 2011
@@ -355,14 +355,14 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10010"></a><a name="Intended-Audience"></a>
+<a name="Intended-Audience"></a>
<h2 class="underlined_10">Intended Audience</h2>
<div class="section">
<p>
Users who want to run Forrest from within Maven.
</p>
</div>
-<a name="N10018"></a><a name="Purpose"></a>
+<a name="Purpose"></a>
<h2 class="underlined_10">Purpose</h2>
<div class="section">
<p>
@@ -370,7 +370,7 @@ document.write("Last Published: " + docu
using Forrest in lieu of Maven's site plugin.
</p>
</div>
-<a name="N10020"></a><a name="Prerequisites"></a>
+<a name="Prerequisites"></a>
<h2 class="underlined_10">Prerequisites</h2>
<div class="section">
<ul>
@@ -379,21 +379,21 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N1002F"></a><a name="Steps"></a>
+<a name="Steps"></a>
<h2 class="underlined_10">Steps</h2>
<div class="section">
<p>
The procedure outlined below describes how to add a goal to your project's
maven.xml that will invoke Forrest's <span class="codefrag">site</span> target.
</p>
-<a name="N1003A"></a><a name="set-maven-home"></a>
+<a name="set-maven-home"></a>
<h3 class="underlined_5">Set the FORREST_HOME environment variable</h3>
<p>
Make sure the FORREST_HOME environment variable points to your Forrest
home directory (i.e. the directory that contains
<span class="codefrag">forrest.build.xml</span>) (e.g. C:\opt\apache-forrest-0.7)
</p>
-<a name="N10047"></a><a name="define-ant-environment-prop"></a>
+<a name="define-ant-environment-prop"></a>
<h3 class="underlined_5">Initialize an Ant environment property at the top of
maven.xml</h3>
<p>
@@ -402,7 +402,7 @@ document.write("Last Published: " + docu
<pre class="code">
<property environment="env" />
</pre>
-<a name="N10055"></a><a name="add-forrest-goal-to-maven-xml"></a>
+<a name="add-forrest-goal-to-maven-xml"></a>
<h3 class="underlined_5">Add forrest goal to maven.xml</h3>
<p>
Paste the following goal into your project's maven.xml:
@@ -432,14 +432,14 @@ document.write("Last Published: " + docu
makes use of the copy of Ant 1.6 that is bundled with Forrest, so it's
not even necessary to have Ant 1.6 installed separately.
</p>
-<a name="N10066"></a><a name="Alternative+file"></a>
+<a name="Alternative+file"></a>
<h3 class="underlined_5">Alternative file</h3>
<p>
Under <span class="codefrag">$FORREST_HOME/tools/targets/maven.xml</span>
</p>
</div>
-<a name="N10073"></a><a name="Feedback"></a>
+<a name="Feedback"></a>
<h2 class="underlined_10">Feedback</h2>
<div class="section">
<p>
Modified: forrest/site/docs_0_90/howto/howto-pdf-tab.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/howto-pdf-tab.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/howto-pdf-tab.html (original)
+++ forrest/site/docs_0_90/howto/howto-pdf-tab.html Thu Jan 20 06:47:23 2011
@@ -361,7 +361,7 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10010"></a><a name="Intended-Audience"></a>
+<a name="Intended-Audience"></a>
<h2 class="underlined_10">Intended Audience</h2>
<div class="section">
<p>
@@ -369,7 +369,7 @@ document.write("Last Published: " + docu
of documents.
</p>
</div>
-<a name="N10018"></a><a name="Purpose"></a>
+<a name="Purpose"></a>
<h2 class="underlined_10">Purpose</h2>
<div class="section">
<p>
@@ -379,7 +379,7 @@ document.write("Last Published: " + docu
certain parts of the site.
</p>
</div>
-<a name="N10020"></a><a name="Prerequisites"></a>
+<a name="Prerequisites"></a>
<h2 class="underlined_10">Prerequisites</h2>
<div class="section">
<ul>
@@ -389,26 +389,26 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N1002F"></a><a name="Steps"></a>
+<a name="Steps"></a>
<h2 class="underlined_10">Steps</h2>
<div class="section">
<p>
The procedure outlined below will define a project
<span class="codefrag">sitemap.xmap</span> and create a new <span class="codefrag">pdf-tab.xmap</span>.
</p>
-<a name="N1003D"></a><a name="sitemap"></a>
+<a name="sitemap"></a>
<h3 class="underlined_5">Create your project's main sitemap.xmap</h3>
<p>
If you do not have already a sitemap then create a new empty one in your
<span class="codefrag">src/documentation</span> directory (or wherever
${project.sitemap-dir} points to).
</p>
-<a name="N1004A"></a><a name="aggregator"></a>
+<a name="aggregator"></a>
<h3 class="underlined_5">Create another sitemap: pdf-tab.xmap</h3>
<p>
Like before create an empty sitemap and name it pdf-tab.xmap.
</p>
-<a name="N10054"></a><a name="mount"></a>
+<a name="mount"></a>
<h3 class="underlined_5">Edit project sitemap.xmap to mount pdf-tab.xmap</h3>
<p>
Your sitemap should look something like this.
@@ -430,7 +430,7 @@ document.write("Last Published: " + docu
</map:pipelines>
</map:sitemap>
</pre>
-<a name="N10062"></a><a name="edit-aggregator"></a>
+<a name="edit-aggregator"></a>
<h3 class="underlined_5">Edit the file pdf-tab.xmap</h3>
<p>
The <span class="codefrag">
@@ -462,7 +462,7 @@ document.write("Last Published: " + docu
</map:pipelines>
</map:sitemap>
</pre>
-<a name="N10075"></a><a name="edit-site"></a>
+<a name="edit-site"></a>
<h3 class="underlined_5">Edit your site.xml</h3>
<div class="note">
<div class="label">Note</div>
@@ -519,7 +519,7 @@ document.write("Last Published: " + docu
do)!!!
</div>
</div>
-<a name="N100A9"></a><a name="explain"></a>
+<a name="explain"></a>
<h3 class="underlined_5">Explanation of the operation</h3>
<p>
Line 4 of our example
@@ -574,7 +574,7 @@ document.write("Last Published: " + docu
</p>
</div>
-<a name="N100E0"></a><a name="Feedback-and-further-development-of-this-How-To"></a>
+<a name="Feedback-and-further-development-of-this-How-To"></a>
<h2 class="underlined_10">Feedback and further development of this How-To</h2>
<div class="section">
<p>
Modified: forrest/site/docs_0_90/howto/index.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/index.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/index.html (original)
+++ forrest/site/docs_0_90/howto/index.html Thu Jan 20 06:47:23 2011
@@ -332,7 +332,7 @@ document.write("Last Published: " + docu
</div>
</div>
-<a name="N1000D"></a><a name="Forrest+Site+and+Documentation"></a>
+<a name="Forrest+Site+and+Documentation"></a>
<h2 class="underlined_10">Forrest Site and Documentation</h2>
<div class="section">
<ul>
@@ -355,7 +355,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10023"></a><a name="Using+and+developing+with+Forrest"></a>
+<a name="Using+and+developing+with+Forrest"></a>
<h2 class="underlined_10">Using and developing with Forrest</h2>
<div class="section">
<p>
@@ -398,7 +398,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N1004E"></a><a name="Extending+Forrest"></a>
+<a name="Extending+Forrest"></a>
<h2 class="underlined_10">Extending Forrest</h2>
<div class="section">
<ul>
Modified: forrest/site/docs_0_90/howto/multi/howto-multi.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/multi/howto-multi.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/multi/howto-multi.html (original)
+++ forrest/site/docs_0_90/howto/multi/howto-multi.html Thu Jan 20 06:47:23 2011
@@ -349,21 +349,21 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N10010"></a><a name="Intended-audience"></a>
+<a name="Intended-audience"></a>
<h2 class="underlined_10">Intended audience</h2>
<div class="section">
<p>
Describe the audience here.
</p>
</div>
-<a name="N10018"></a><a name="Purpose"></a>
+<a name="Purpose"></a>
<h2 class="underlined_10">Purpose</h2>
<div class="section">
<p>
Explain the purpose of the howto here.
</p>
</div>
-<a name="N10020"></a><a name="Prerequisites"></a>
+<a name="Prerequisites"></a>
<h2 class="underlined_10">Prerequisites</h2>
<div class="section">
<p>
@@ -387,7 +387,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N1003D"></a><a name="Various-Steps"></a>
+<a name="Various-Steps"></a>
<h2 class="underlined_10">Various Steps</h2>
<div class="section">
<p>
@@ -410,14 +410,14 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10057"></a><a name="Real-World-Extension"></a>
+<a name="Real-World-Extension"></a>
<h2 class="underlined_10">Real World Extension</h2>
<div class="section">
<p>
Briefly describe some relevant extensions that go beyond these basics.
</p>
</div>
-<a name="N1005F"></a><a name="Tips"></a>
+<a name="Tips"></a>
<h2 class="underlined_10">Tips</h2>
<div class="section">
<p>
@@ -432,7 +432,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10070"></a><a name="Related-Resources"></a>
+<a name="Related-Resources"></a>
<h2 class="underlined_10">Related Resources</h2>
<div class="section">
<p>
@@ -446,7 +446,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10082"></a><a name="Feedback"></a>
+<a name="Feedback"></a>
<h2 class="underlined_10">Feedback</h2>
<div class="section">
<p>
Modified: forrest/site/docs_0_90/howto/multi/step1.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/multi/step1.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/multi/step1.html (original)
+++ forrest/site/docs_0_90/howto/multi/step1.html Thu Jan 20 06:47:23 2011
@@ -333,15 +333,15 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N1000D"></a><a name="Step-1:-Do-foo"></a>
+<a name="Step-1:-Do-foo"></a>
<h2 class="underlined_10">Step 1: Do foo</h2>
<div class="section">
-<a name="N10012"></a><a name="First+section+of+this+step"></a>
+<a name="First+section+of+this+step"></a>
<h3 class="underlined_5">First section of this step</h3>
<p>
Description here.
</p>
-<a name="N1001C"></a><a name="Second+section+of+this+step"></a>
+<a name="Second+section+of+this+step"></a>
<h3 class="underlined_5">Second section of this step</h3>
<p>
Description here.
Modified: forrest/site/docs_0_90/howto/multi/step2.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/multi/step2.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/multi/step2.html (original)
+++ forrest/site/docs_0_90/howto/multi/step2.html Thu Jan 20 06:47:23 2011
@@ -333,15 +333,15 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N1000D"></a><a name="Step-2:-Do-foobar"></a>
+<a name="Step-2:-Do-foobar"></a>
<h2 class="underlined_10">Step 2: Do foobar</h2>
<div class="section">
-<a name="N10012"></a><a name="First+section+of+this+step"></a>
+<a name="First+section+of+this+step"></a>
<h3 class="underlined_5">First section of this step</h3>
<p>
Description here.
</p>
-<a name="N1001C"></a><a name="Second+section+of+this+step"></a>
+<a name="Second+section+of+this+step"></a>
<h3 class="underlined_5">Second section of this step</h3>
<p>
Description here.
Modified: forrest/site/docs_0_90/howto/multi/step3.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/howto/multi/step3.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/howto/multi/step3.html (original)
+++ forrest/site/docs_0_90/howto/multi/step3.html Thu Jan 20 06:47:23 2011
@@ -333,15 +333,15 @@ document.write("Last Published: " + docu
</ul>
</div>
</div>
-<a name="N1000D"></a><a name="Step-3:-Finish-up"></a>
+<a name="Step-3:-Finish-up"></a>
<h2 class="underlined_10">Step 3: Finish up</h2>
<div class="section">
-<a name="N10012"></a><a name="First+section+of+this+step"></a>
+<a name="First+section+of+this+step"></a>
<h3 class="underlined_5">First section of this step</h3>
<p>
Description here.
</p>
-<a name="N1001C"></a><a name="Second+section+of+this+step"></a>
+<a name="Second+section+of+this+step"></a>
<h3 class="underlined_5">Second section of this step</h3>
<p>
Description here.
Modified: forrest/site/docs_0_90/libre-intro.html
URL: http://svn.apache.org/viewvc/forrest/site/docs_0_90/libre-intro.html?rev=1061134&r1=1061133&r2=1061134&view=diff
==============================================================================
--- forrest/site/docs_0_90/libre-intro.html (original)
+++ forrest/site/docs_0_90/libre-intro.html Thu Jan 20 06:47:23 2011
@@ -406,7 +406,7 @@ document.write("Last Published: " + docu
</div>
</div>
-<a name="N10010"></a><a name="Intro"></a>
+<a name="Intro"></a>
<h2 class="underlined_10">Intro</h2>
<div class="section">
<div class="warning">
@@ -448,7 +448,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10029"></a><a name="Using+Libre+now+%280.0+alfa%29"></a>
+<a name="Using+Libre+now+%280.0+alfa%29"></a>
<h2 class="underlined_10">Using Libre now (0.0 alfa)</h2>
<div class="section">
<div class="warning">
@@ -462,7 +462,7 @@ document.write("Last Published: " + docu
this time)
</div>
</div>
-<a name="N10034"></a><a name="Generated+Output"></a>
+<a name="Generated+Output"></a>
<h3 class="underlined_5">Generated Output</h3>
<p>
The XML output that comes out of the generator largely follows this
@@ -510,7 +510,7 @@ document.write("Last Published: " + docu
The number and value (and its meaning) of the attributes on these
elements are specified in the libre.xml file.
</p>
-<a name="N1004E"></a><a name="Contents"></a>
+<a name="Contents"></a>
<h3 class="underlined_5">libre.xml Contents</h3>
<p>
That libre.xml file follows the
@@ -555,7 +555,7 @@ document.write("Last Published: " + docu
regex CDATA #IMPLIED
substitute CDATA #IMPLIED
></pre>
-<a name="N10060"></a><a name="Building+Blocks"></a>
+<a name="Building+Blocks"></a>
<h4>Building Blocks</h4>
<p>
The following elements get the following meaning when interpreted by
@@ -735,12 +735,12 @@ document.write("Last Published: " + docu
</ul>
</ul>
-<a name="N1016C"></a><a name="Important+Side+Effects"></a>
+<a name="Important+Side+Effects"></a>
<h3 class="underlined_5">Important Side Effects</h3>
<p>
There are some things that libre is doing that you should be aware of.
</p>
-<a name="N10175"></a><a name="No+libre.xml"></a>
+<a name="No+libre.xml"></a>
<h4>No libre.xml</h4>
<p>
When using an <span class="codefrag"><auto> </span>section, the filter will
@@ -748,7 +748,7 @@ document.write("Last Published: " + docu
output. You can however include a manual <span class="codefrag"><entry></span>
to point to the <span class="codefrag">libre.xml</span> file if needed.
</p>
-<a name="N1018B"></a><a name="No+Duplicates"></a>
+<a name="No+Duplicates"></a>
<h4>No Duplicates</h4>
<p>
You can combine multiple <span class="codefrag"><entry></span> and
@@ -759,7 +759,7 @@ document.write("Last Published: " + docu
<span class="codefrag">libre.xml</span> file can include already accepted files or
directories, they will only show up once in the output.
</p>
-<a name="N101A8"></a><a name="Example+Constructs"></a>
+<a name="Example+Constructs"></a>
<h3 class="underlined_5">Example Constructs</h3>
<p>
Adding sorting and filtering to the filesystem with libre becomes a
@@ -771,7 +771,7 @@ document.write("Last Published: " + docu
that sets up the directories to store those files and writes the
<span class="codefrag">libre.xml</span> files.
</p>
-<a name="N101B7"></a><a name="Sorting+your+files+or+your+menu+entries%3F"></a>
+<a name="Sorting+your+files+or+your+menu+entries%3F"></a>
<h4>Sorting your files or your menu entries?</h4>
<p>
In every case the very pragmatic approach can become something like
@@ -824,7 +824,7 @@ document.write("Last Published: " + docu
directory structures can all benefit from this same
filenaming/sorting strategy.
</p>
-<a name="N101E5"></a><a name="Naming+your+files+or+asking+them+their+name%3F"></a>
+<a name="Naming+your+files+or+asking+them+their+name%3F"></a>
<h4>Naming your files or asking them their name?</h4>
<p>
Given the poor expressiveness of the filesystem, the labels that
@@ -856,7 +856,7 @@ document.write("Last Published: " + docu
</libre></pre>
</div>
-<a name="N101F5"></a><a name="Next+Libre+%280.1%29"></a>
+<a name="Next+Libre+%280.1%29"></a>
<h2 class="underlined_10">Next Libre (0.1)</h2>
<div class="section">
<div class="note">
@@ -867,7 +867,7 @@ document.write("Last Published: " + docu
happens...
</div>
</div>
-<a name="N10202"></a><a name="Itches"></a>
+<a name="Itches"></a>
<h3 class="underlined_5">Itches</h3>
<p>
There is quite a number of fast code patches that can/need to happen
@@ -904,14 +904,14 @@ document.write("Last Published: " + docu
early optimizations :-P</li>
</ul>
-<a name="N1022A"></a><a name="Upcoming+Features"></a>
+<a name="Upcoming+Features"></a>
<h3 class="underlined_5">Upcoming Features</h3>
<p>
More importantly however there is a major set of new features that is
waiting to get in there. It all boils down in fact to having a more
expressive libre.xml file... some of the thoughts:
</p>
-<a name="N10233"></a><a name="Combinations+of+filter+logic"></a>
+<a name="Combinations+of+filter+logic"></a>
<h4>Combinations of filter logic</h4>
<p>
Some itching stuff:
@@ -946,7 +946,7 @@ document.write("Last Published: " + docu
</not>
</filter>
</pre>
-<a name="N10253"></a><a name="Separating+property-retrieval+from+formatting+and%0A++++++++++++testing"></a>
+<a name="Separating+property-retrieval+from+formatting+and%0A++++++++++++testing"></a>
<h4>Separating property-retrieval from formatting and
testing</h4>
<p>
@@ -993,7 +993,7 @@ document.write("Last Published: " + docu
And more logically introduce other tests like <span class="codefrag"><globtest
match="..."></span> or <span class="codefrag"><availabletest></span> or...
</p>
-<a name="N1028C"></a><a name="Replace+the+introspection+with+semantically+richer+named%0A++++++++++++properties+to+read."></a>
+<a name="Replace+the+introspection+with+semantically+richer+named%0A++++++++++++properties+to+read."></a>
<h4>Replace the introspection with semantically richer named
properties to read.</h4>
<p>
@@ -1046,7 +1046,7 @@ document.write("Last Published: " + docu
<p>
The DTD would then list the possible attributeValues.
</p>
-<a name="N102D0"></a><a name="Avalonising"></a>
+<a name="Avalonising"></a>
<h3 class="underlined_5">Avalonising</h3>
<p>
There are a number of perceived opportunities in taking up a stronger
@@ -1069,7 +1069,7 @@ document.write("Last Published: " + docu
HierarchyReader the (avalon) environment he needs.</li>
</ul>
-<a name="N102E6"></a><a name="Unresolved+Discussions"></a>
+<a name="Unresolved+Discussions"></a>
<h3 class="underlined_5">Unresolved Discussions</h3>
<ul>
@@ -1089,7 +1089,7 @@ document.write("Last Published: " + docu
</ul>
</div>
-<a name="N10303"></a><a name="Libre+Design"></a>
+<a name="Libre+Design"></a>
<h2 class="underlined_10">Libre Design</h2>
<div class="section">
<p>
@@ -1131,7 +1131,7 @@ document.write("Last Published: " + docu
<p>
... hope this somewhat clarifies how things have been setup for now.
</p>
-<a name="N1032E"></a><a name="Dependencies"></a>
+<a name="Dependencies"></a>
<h3 class="underlined_5">Dependencies</h3>
<ul>