brondsem 2003/12/17 15:08:24
Modified: targets/forrest abs-linkmap abs-menulinks cap.html
changes.html compliance.html contrib.html
document-v11.dtdx.html document-v12.html
dreams.html dtd-docs.html faq-v11.dtdx.html
faq.html forrest-contract.html forrest-issues.html
forrestbar.html forrestbot-intro-old.html
forrestbot-old.html forrestbot.html forrestbot.pdf
howto-v10.dtdx.html index.html libre-intro.html
license.html linking.html linkmap-index.html
live-sites.html mail-archives.html mail-lists.html
menu-index.html primer.html sitemap-ref.html
skin-package.html todo.html upgrading_05.html
validation.html who.html wiki-sample.html
your-project.html
Log:
new 'building forrest' page
Revision Changes Path
1.8 +1 -0 xml-site/targets/forrest/abs-linkmap
Index: abs-linkmap
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/abs-linkmap,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- abs-linkmap 9 Dec 2003 23:45:48 -0000 1.7
+++ abs-linkmap 17 Dec 2003 23:08:23 -0000 1.8
@@ -84,6 +84,7 @@
</community>
<getting-involved label="Getting Involved">
<contrib label="Contributing" href="contrib.html"/>
+ <build label="Building Forrest" href="build.html"/>
<CVS label="Browse CVS"
href="http://cvs.apache.org/viewcvs/xml-forrest/"/>
<mail-lists label="Mail lists" href="mail-lists.html">
<forrest-dev href="mail-lists.html#forrest-dev"/>
1.8 +1 -0 xml-site/targets/forrest/abs-menulinks
Index: abs-menulinks
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/abs-menulinks,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- abs-menulinks 9 Dec 2003 23:45:48 -0000 1.7
+++ abs-menulinks 17 Dec 2003 23:08:23 -0000 1.8
@@ -84,6 +84,7 @@
</community>
<getting-involved tab="home" label="Getting Involved">
<contrib tab="home" label="Contributing" href="contrib.html"/>
+ <build tab="home" label="Building Forrest" href="build.html"/>
<CVS tab="home" label="Browse CVS"
href="http://cvs.apache.org/viewcvs/xml-forrest/"/>
<mail-lists tab="home" label="Mail lists" href="mail-lists.html">
<forrest-dev tab="home" href="mail-lists.html#forrest-dev"/>
1.23 +4 -0 xml-site/targets/forrest/cap.html
Index: cap.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/cap.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- cap.html 9 Dec 2003 23:45:48 -0000 1.22
+++ cap.html 17 Dec 2003 23:08:23 -0000 1.23
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.29 +4 -0 xml-site/targets/forrest/changes.html
Index: changes.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/changes.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- changes.html 9 Dec 2003 23:45:48 -0000 1.28
+++ changes.html 17 Dec 2003 23:08:23 -0000 1.29
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.22 +4 -0 xml-site/targets/forrest/compliance.html
Index: compliance.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/compliance.html,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- compliance.html 9 Dec 2003 23:45:48 -0000 1.21
+++ compliance.html 17 Dec 2003 23:08:23 -0000 1.22
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.26 +4 -0 xml-site/targets/forrest/contrib.html
Index: contrib.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/contrib.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- contrib.html 9 Dec 2003 23:45:48 -0000 1.25
+++ contrib.html 17 Dec 2003 23:08:23 -0000 1.26
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.24 +4 -0 xml-site/targets/forrest/document-v11.dtdx.html
Index: document-v11.dtdx.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/document-v11.dtdx.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- document-v11.dtdx.html 9 Dec 2003 23:45:48 -0000 1.23
+++ document-v11.dtdx.html 17 Dec 2003 23:08:23 -0000 1.24
@@ -329,6 +329,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.12 +4 -0 xml-site/targets/forrest/document-v12.html
Index: document-v12.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/document-v12.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- document-v12.html 9 Dec 2003 23:45:48 -0000 1.11
+++ document-v12.html 17 Dec 2003 23:08:23 -0000 1.12
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.25 +4 -0 xml-site/targets/forrest/dreams.html
Index: dreams.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/dreams.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- dreams.html 9 Dec 2003 23:45:48 -0000 1.24
+++ dreams.html 17 Dec 2003 23:08:23 -0000 1.25
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.24 +4 -0 xml-site/targets/forrest/dtd-docs.html
Index: dtd-docs.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/dtd-docs.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- dtd-docs.html 9 Dec 2003 23:45:48 -0000 1.23
+++ dtd-docs.html 17 Dec 2003 23:08:23 -0000 1.24
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.24 +4 -0 xml-site/targets/forrest/faq-v11.dtdx.html
Index: faq-v11.dtdx.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/faq-v11.dtdx.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- faq-v11.dtdx.html 9 Dec 2003 23:45:48 -0000 1.23
+++ faq-v11.dtdx.html 17 Dec 2003 23:08:23 -0000 1.24
@@ -329,6 +329,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.36 +30 -30 xml-site/targets/forrest/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/faq.html,v
retrieving revision 1.35
retrieving revision 1.36
diff -u -r1.35 -r1.36
--- faq.html 9 Dec 2003 23:45:48 -0000 1.35
+++ faq.html 17 Dec 2003 23:08:23 -0000 1.36
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
@@ -506,7 +510,7 @@
<div style="margin-left: 15 ; border: 2px">
<p>
Follow these
- <a href="your-project.html#getting_from_source">Using Forrest</a>
notes.
+ <a href="build.html">Building Forrest</a> notes.
</p>
</div>
<a name="N100D8"></a><a name="checked_out_now_what"></a>
@@ -516,19 +520,15 @@
</h5>
<div style="margin-left: 15 ; border: 2px">
<p>
- Run "<span class="codefrag">./build.sh</span>" to build forrest,
then run
- "<span class="codefrag">forrest</span>" to generate the
documentation
- for Forrest, built with Forrest.
- The documentation is generated in the <span
class="codefrag">build/site/</span> directory.
- Logfiles are in the <span
class="codefrag">build/tmp/context/WEB-INF/logs/</span> directory.
- When you thereafter update your cvs, then run "build clean" before
building.
+ Follow these
+ <a href="build.html">Building Forrest</a> notes.
</p>
<p>
The <a href="your-project.html">Using Forrest</a> guide provides
further step-by-step assistance in getting started with Forrest
for your project.
</p>
</div>
-<a name="N100F6"></a><a name="cygwin_mutex_error"></a>
+<a name="N100EE"></a><a name="cygwin_mutex_error"></a>
<h5>1.4.
When running ./build.sh in cygwin, I get an error:
cygpath.exe: *** can't create title mutex, Win32 error 6.
@@ -540,7 +540,7 @@
to be a bug in cygwin</a>. Please use the .bat script instead.
</p>
</div>
-<a name="N10108"></a><a name="maxmemory"></a>
+<a name="N10100"></a><a name="maxmemory"></a>
<h5>1.5.
How can i specify the amount of memory to be used by Java?
<span style="float: right"><a href="#maxmemory-menu">^</a></span>
@@ -555,10 +555,10 @@
</p>
</div>
</div>
-<a name="N10119"></a><a name="technical"></a>
+<a name="N10111"></a><a name="technical"></a>
<h4>2. Technical</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1011D"></a><a name="PDF-output"></a>
+<a name="N10115"></a><a name="PDF-output"></a>
<h5>2.1. How can I generate one pdf-file out of
the whole site or selected pages of the site?<span style="float:
right"><a href="#PDF-output-menu">^</a></span>
</h5>
@@ -579,7 +579,7 @@
structure and navigation, rather than the old book.xml method.
</p>
</div>
-<a name="N1012C"></a><a name="clickable-email-adress"></a>
+<a name="N10124"></a><a name="clickable-email-adress"></a>
<h5>2.2. How can I generate html-pages show a
'clickable' email-address (of the author-element)?<span style="float:
right"><a href="#clickable-email-adress-menu">^</a></span>
</h5>
@@ -589,7 +589,7 @@
and edit the "headers/authors" template.
</p>
</div>
-<a name="N10137"></a><a name="CVS_revison_tags"></a>
+<a name="N1012F"></a><a name="CVS_revison_tags"></a>
<h5>2.3. How can I generate html-pages show the
revision tag of cvs?<span style="float: right"><a
href="#CVS_revison_tags-menu">^</a></span>
</h5>
@@ -601,7 +601,7 @@
http://xml.apache.org/forrest/your-project.html</a>
</p>
</div>
-<a name="N10145"></a><a name="ignoring_javadocs"></a>
+<a name="N1013D"></a><a name="ignoring_javadocs"></a>
<h5>2.4.
How do I stop Forrest breaking on links to external files that may
not
exist, like javadocs?
@@ -641,7 +641,7 @@
</div>
</div>
</div>
-<a name="N10176"></a><a name="link_raw"></a>
+<a name="N1016E"></a><a name="link_raw"></a>
<h5>2.5. How do I link to raw files such as config.txt and brochure.pdf?
<span style="float: right"><a href="#link_raw-menu">^</a></span>
</h5>
@@ -654,7 +654,7 @@
project for a demonstration of this ability.
</p>
</div>
-<a name="N10181"></a><a name="build_msg_a"></a>
+<a name="N10179"></a><a name="build_msg_a"></a>
<h5>2.6. What do the symbols and numbers mean when Forrest lists each
document that it has built?
<span style="float: right"><a href="#build_msg_a-menu">^</a></span>
@@ -677,7 +677,7 @@
Column 4 is the page size.
</p>
</div>
-<a name="N1018E"></a><a name="pdf_images"></a>
+<a name="N10186"></a><a name="pdf_images"></a>
<h5>2.7. Images don't display in PDFs. How do I fix this?<span style="float:
right"><a href="#pdf_images-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -717,7 +717,7 @@
Forrest</div>
</div>
</div>
-<a name="N101C0"></a><a name="index.html"></a>
+<a name="N101B8"></a><a name="index.html"></a>
<h5>2.8.
The tab link in my site incorrectly assumes that 'index.html' is
present in
the linked-to directory. How do I fix this?
@@ -742,7 +742,7 @@
</map:match>
</pre>
</div>
-<a name="N101DE"></a><a name="headless_operation"></a>
+<a name="N101D6"></a><a name="headless_operation"></a>
<h5>2.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.
<span style="float: right"><a
href="#headless_operation-menu">^</a></span>
@@ -755,7 +755,7 @@
</p>
<pre class="code">forrest -Dforrest.jvmargs=-Djava.awt.headless=true
site</pre>
</div>
-<a name="N101F4"></a><a name="xsp"></a>
+<a name="N101EC"></a><a name="xsp"></a>
<h5>2.10. How do I enable XSP processing?<span style="float: right"><a
href="#xsp-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -799,10 +799,10 @@
<p>See also the <a
href="http://wiki.cocoondev.org/Wiki.jsp?page=AddingXSPToForrest";>AddingXSPToForrest</a>
Wiki page.</p>
</div>
</div>
-<a name="N1022B"></a><a name="old_faqs"></a>
+<a name="N10223"></a><a name="old_faqs"></a>
<h4>3. Older versions</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1022F"></a><a name="unresolved_project.home"></a>
+<a name="N10227"></a><a name="unresolved_project.home"></a>
<h5>3.1. When invoking Forrest 0.4 from the
forrest.antproxy.xml, the build fails because
${project.home} isn't resolved.
@@ -822,7 +822,7 @@
<classpath refid="forrest-classpath"/>
<jvmarg value="-Dforrest.home=${forrest.home}"/></pre>
</div>
-<a name="N10245"></a><a name="odd_html"></a>
+<a name="N1023D"></a><a name="odd_html"></a>
<h5>3.2.
After upgrading to 0.4 my HTML looks significantly different, and
table
widths are wrong. What happened?
@@ -842,7 +842,7 @@
<doctype-system>http://www.w3.org/TR/html4/loose.dtd</doctype-system>
</pre>
</div>
-<a name="N10258"></a><a name="validation_error-doctype_root_null"></a>
+<a name="N10250"></a><a name="validation_error-doctype_root_null"></a>
<h5>3.3.
When building my project, I get an validation error: Document root
element "site", must match DOCTYPE root "null"..
@@ -863,7 +863,7 @@
listed to prevent an attempt at DTD-based validation.
</p>
</div>
-<a name="N10275"></a><a name="building_error-custom_sitemap"></a>
+<a name="N1026D"></a><a name="building_error-custom_sitemap"></a>
<h5>3.4.
When building my project, I get any of these errors:
menu.xmap (The system cannot find the file specified)
@@ -878,10 +878,10 @@
</p>
</div>
</div>
-<a name="N1028A"></a><a name="general"></a>
+<a name="N10282"></a><a name="general"></a>
<h4>4. General</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1028E"></a><a name="generating_menus"></a>
+<a name="N10286"></a><a name="generating_menus"></a>
<h5>4.1. What is the relationship between site.xml and
book.xml?
<span style="float: right"><a
href="#generating_menus-menu">^</a></span>
@@ -898,7 +898,7 @@
See <a href="linking.html">Menus and Linking</a>.
</p>
</div>
-<a name="N102A9"></a><a name="docbook"></a>
+<a name="N102A1"></a><a name="docbook"></a>
<h5>4.2.
How do I use DocBook as the xml documentation format?
<span style="float: right"><a href="#docbook-menu">^</a></span>
@@ -943,7 +943,7 @@
for configuration guidance.
</p>
</div>
-<a name="N102C7"></a><a name="version"></a>
+<a name="N102BF"></a><a name="version"></a>
<h5>4.3.
How to report which version of Forrest is being used and the
properties that are set?
@@ -960,7 +960,7 @@
Doing <span class="codefrag">'forrest -v'</span> will provide
verbose build messages.
</p>
</div>
-<a name="N102DB"></a><a name="how_can_I_help"></a>
+<a name="N102D3"></a><a name="how_can_I_help"></a>
<h5>4.4.
How can I help?
<span style="float: right"><a href="#how_can_I_help-menu">^</a></span>
1.23 +4 -0 xml-site/targets/forrest/forrest-contract.html
Index: forrest-contract.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/forrest-contract.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- forrest-contract.html 9 Dec 2003 23:45:48 -0000 1.22
+++ forrest-contract.html 17 Dec 2003 23:08:23 -0000 1.23
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.14 +98 -82 xml-site/targets/forrest/forrest-issues.html
Index: forrest-issues.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/forrest-issues.html,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -r1.13 -r1.14
--- forrest-issues.html 9 Dec 2003 23:45:48 -0000 1.13
+++ forrest-issues.html 17 Dec 2003 23:08:23 -0000 1.14
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
@@ -337,10 +341,16 @@
</table>
<ul class="minitoc">
<li>
+<a href="#Can%26apos%3Bt+find+custom+XSL">Can&apos;t find custom XSL</a>
+</li>
+<li>
+<a href="#indirect+linking+and+anchors">indirect linking and anchors</a>
+</li>
+<li>
<a href="#Reference+to+site2xhtml+invalid">Reference to site2xhtml
invalid</a>
</li>
<li>
-<a href="#%26quot%3Bflat%26quot%3B+navigation">&quot;flat&quot;
navigation</a>
+<a href="#flat+navigation">flat navigation</a>
</li>
<li>
<a href="#Deployed+war+fails">Deployed war fails</a>
@@ -370,9 +380,6 @@
<a href="#Some+TOC+links+do+not+work">Some TOC links do not work</a>
</li>
<li>
-<a href="#build+broken+by+forrest.xmap+XSP+additions">build broken by
forrest.xmap XSP additions</a>
-</li>
-<li>
<a href="#Reference+to+xml2html+missing">Reference to xml2html missing</a>
</li>
<li>
@@ -393,16 +400,81 @@
<li>
<a href="#Generating+content+pages+with+non+.html+extensions">Generating
content pages with non .html extensions</a>
</li>
-<li>
-<a href="#WAI+ideas">WAI ideas</a>
-</li>
</ul>
<div class="frame note">
<div class="label">Note</div>
<div class="content">These are the open issues in our <a
href="http://issues.cocoondev.org/jira/secure/BrowseProject.jspa?id=10000";>bug
tracking system</a>.
They are regenerated on each Forrest run.</div>
</div>
-<a name="N1000D"></a><a name="Reference+to+site2xhtml+invalid"></a>
+<a name="N1000D"></a><a name="Can%26apos%3Bt+find+custom+XSL"></a>
+<h3>Can&apos;t find custom XSL</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+<a
href="http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-96";>http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-96</a>
+</p>
+<p>I've got a bunch of custom content types, with stylesheets in
src/documentation/resources/stylesheets/, and a grammar in
src/documentation/resources/grammars/. Forrest/Cocoon looks for them in
build/webapp/resources/(stylesheets|grammars), but they don't get copied there
because of the editing-in-source stuff (which is really cool, but just needs to
be finished up :)
+<br>
+
+<br>
+Output from "forrest":
+<br>
+
+<br>
+X [0] calendar/index.html BROKEN: SAXException:
org.apache.cocoon.ProcessingException: Error during resolving of
+<br>
+'resources/grammars/grm.xlex'.:
org.apache.excalibur.source.SourceNotFoundException:
file:/home/forrest/build/webapp/resources/grammars
+<br>
+/grm.xlex doesn't exist.
+<br>
+X [0] activities/academic.html BROKEN:
/home/forrest/build/webapp/resources/stylesheets/activities2documl (No such
file or directory)
+<br>
+X [0] activities/clubs.html BROKEN:
/home/forrest/build/webapp/resources/stylesheets/activities2documl (No such
file or directory)
+<br>
+
+<br>
+
+<br>
+Output from "forrest run" when I go to a page using a custom
content type:
+<br>
+
+<br>
+11:13:04.173 EVENT ERROR (2003-12-15) 11:13.04:171 [access ]
(/activities/academic.html) PoolThread-3/CocoonServlet: Internal Cocoon Problem
+<br>
+org.apache.cocoon.ProcessingException: Failed to execute pipeline.:
org.apache.cocoon.ProcessingException: Unable to get transformer handler for
resources/stylesheets/activities2document.xsl:
org.apache.excalibur.xml.xslt.XSLTProcessorException: Exception in creating
Transform Handler
+<br>
+ at
org.apache.cocoon.components.pipeline.AbstractProcessingPipeline.processXMLPipeline(AbstractProcessingPipeline.java:554)
+<br>
+ at
org.apache.cocoon.components.pipeline.impl.AbstractCachingProcessingPipeline.processXMLPipeline(AbstractCachingProcessingPipeline.java:196)
+<br>
+ at
org.apache.cocoon.components.pipeline.AbstractProcessingPipeline.process(AbstractProcessingPipeline.java:492)
+<br>
+ at
org.apache.cocoon.components.treeprocessor.sitemap.SerializeNode.invoke(SerializeNode.java:147)
+<br>
+ at
org.apache.cocoon.components.treeprocessor.AbstractParentProcessingNode.invokeNodes(AbstractParentProcessingNode.java:108)
+<br>
+ at
org.apache.cocoon.components.treeprocessor.ContainerNode.invoke(ContainerNode.java:66)
+<br>
+ at
org.apache.cocoon.components.treeprocessor.sitemap.CallNode.invoke(CallNode.java:128)
+<br>
+</p>
+</div>
+<a name="N1001B"></a><a name="indirect+linking+and+anchors"></a>
+<h3>indirect linking and anchors</h3>
+<div style="margin-left: 0 ; border: 2px">
+<p>
+<a
href="http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-95";>http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-95</a>
+</p>
+<p>I would be nice if Forrest supported anchors with indirect linking. That
is, something like this: <link
href="site:somepage#someanchor">. (or something similar, like
<link href="site:somepage" anchor="someanchor">)
+<br>
+
+<br>
+If somepage pointed to somepage.html, then the resultant link would be
somepage.html#someanchor.
+<br>
+
+<br>
+Using the above link currently fails with an "invalid xpath" error
since "somepage#someanchor" is not a valid qname.</p>
+</div>
+<a name="N10029"></a><a name="Reference+to+site2xhtml+invalid"></a>
<h3>Reference to site2xhtml invalid</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -430,8 +502,8 @@
<br>
Browser refresh - Internal server error - file not found</p>
</div>
-<a name="N1001B"></a><a name="%26quot%3Bflat%26quot%3B+navigation"></a>
-<h3>&quot;flat&quot; navigation</h3>
+<a name="N10037"></a><a name="flat+navigation"></a>
+<h3>flat navigation</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
<a
href="http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-91";>http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-91</a>
@@ -466,7 +538,7 @@
<br>
See the mailing list thread here: <a
href="http://marc.theaimsgroup.com/?t=107007134500002&r=1&w=2";>http://marc.theaimsgroup.com/?t=107007134500002&r=1&w=2</a></p>
</div>
-<a name="N10029"></a><a name="Deployed+war+fails"></a>
+<a name="N10045"></a><a name="Deployed+war+fails"></a>
<h3>Deployed war fails</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -476,7 +548,7 @@
<br>
</p>
</div>
-<a name="N10037"></a><a
name="forrestbot2%3A+clean%2C+notify+after+failure"></a>
+<a name="N10053"></a><a
name="forrestbot2%3A+clean%2C+notify+after+failure"></a>
<h3>forrestbot2: clean, notify after failure</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -488,7 +560,7 @@
<br>
If the 'site' target fails, continue so that 'notify' will happen.</p>
</div>
-<a name="N10045"></a><a name="Build+of+project+fails"></a>
+<a name="N10061"></a><a name="Build+of+project+fails"></a>
<h3>Build of project fails</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -526,7 +598,7 @@
<br>
The project neither builds with version 0.5.1 when I update the files
site.xml, tabs.xml and when I change the DOCTYPE declaration from
document-v11.dtd to document-v12.dtd</p>
</div>
-<a name="N10053"></a><a name="Storing+DTDs+in+zips"></a>
+<a name="N1006F"></a><a name="Storing+DTDs+in+zips"></a>
<h3>Storing DTDs in zips</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -548,7 +620,7 @@
<br>
</p>
</div>
-<a name="N10061"></a><a name="PDF+generation+of+RSS+feeds+fails"></a>
+<a name="N1007D"></a><a name="PDF+generation+of+RSS+feeds+fails"></a>
<h3>PDF generation of RSS feeds fails</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -566,7 +638,7 @@
<br>
</p>
</div>
-<a name="N1006F"></a><a name="FAQ+for+memory+limits"></a>
+<a name="N1008B"></a><a name="FAQ+for+memory+limits"></a>
<h3>FAQ for memory limits</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -574,7 +646,7 @@
</p>
<p>There should be an FAQ for "out of memory" errors. I don't
know about running as a webapp, but the following applies to the CLI. The
first suggestion would be to set forrest.maxmemory in forrest.properties.
However, this only affects Cocoon; if the out of memory error happens in
copy-content or any other part of the ant buildfile, the $ANT_OPTS env var
should be set to the appropriate Java VM options. That of course is only
specific to linux/unix. I've never had memory problems in Windows though.</p>
</div>
-<a name="N1007D"></a><a
name="site2book.xsl+should+handle+book%26apos%3Bs+type+attribute."></a>
+<a name="N10099"></a><a
name="site2book.xsl+should+handle+book%26apos%3Bs+type+attribute."></a>
<h3>site2book.xsl should handle book&apos;s type attribute.</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -608,7 +680,7 @@
<br>
This is not currently transform by the site2book stylesheet</p>
</div>
-<a name="N1008B"></a><a
name="obfuscate-mail-links+option+to+skinconf.xml"></a>
+<a name="N100A7"></a><a
name="obfuscate-mail-links+option+to+skinconf.xml"></a>
<h3>obfuscate-mail-links option to skinconf.xml</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -664,7 +736,7 @@
<br>
--Jeff</p>
</div>
-<a name="N10099"></a><a name="Some+TOC+links+do+not+work"></a>
+<a name="N100B5"></a><a name="Some+TOC+links+do+not+work"></a>
<h3>Some TOC links do not work</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -722,19 +794,7 @@
<br>
I use forrest-0.6dev, krysalis-skin but the links are broken in
forrest-skin, too.</p>
</div>
-<a name="N100A7"></a><a
name="build+broken+by+forrest.xmap+XSP+additions"></a>
-<h3>build broken by forrest.xmap XSP additions</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-<a
href="http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-63";>http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-63</a>
-</p>
-<p>Hi, i need to rush out, but last night i commented-out cheche's
-<br>
-recent change to forrest.xmap where he added XSP support.
-<br>
-Would some please attend to that.</p>
-</div>
-<a name="N100B5"></a><a name="Reference+to+xml2html+missing"></a>
+<a name="N100C3"></a><a name="Reference+to+xml2html+missing"></a>
<h3>Reference to xml2html missing</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -754,7 +814,7 @@
<br>
</p>
</div>
-<a name="N100C3"></a><a
name="move+upgrade_cocoon_jars.sh+to+an+ant+target"></a>
+<a name="N100D1"></a><a
name="move+upgrade_cocoon_jars.sh+to+an+ant+target"></a>
<h3>move upgrade_cocoon_jars.sh to an ant target</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -762,7 +822,7 @@
</p>
<p>To allow people from other platforms to upgrade to a newer version of
cocoon a ant script would be needed.</p>
</div>
-<a name="N100D1"></a><a name="Custom+xmaps+support"></a>
+<a name="N100DF"></a><a name="Custom+xmaps+support"></a>
<h3>Custom xmaps support</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -770,7 +830,7 @@
</p>
<p>Allow custom xmaps than differ from the one used by forrest, this allows
users to be in sync with the lastest version of forrest.</p>
</div>
-<a name="N100DF"></a><a name="Integrate+Forrest+Maven+plugin"></a>
+<a name="N100ED"></a><a name="Integrate+Forrest+Maven+plugin"></a>
<h3>Integrate Forrest Maven plugin</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -782,7 +842,7 @@
<br>
<a
href="http://marc.theaimsgroup.com/?t=105438050900001&r=1&w=2";>http://marc.theaimsgroup.com/?t=105438050900001&r=1&w=2</a></p>
</div>
-<a name="N100ED"></a><a name="Port+javascript+menus+to+all+skins"></a>
+<a name="N100FB"></a><a name="Port+javascript+menus+to+all+skins"></a>
<h3>Port javascript menus to all skins</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -802,7 +862,7 @@
<br>
See forrest-dev thread 'Menu questions' for more info.</p>
</div>
-<a name="N100FB"></a><a name="xlink+problems+with+SVG+files"></a>
+<a name="N10109"></a><a name="xlink+problems+with+SVG+files"></a>
<h3>xlink problems with SVG files</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -876,7 +936,7 @@
<br>
</p>
</div>
-<a name="N10109"></a><a
name="Generating+content+pages+with+non+.html+extensions"></a>
+<a name="N10117"></a><a
name="Generating+content+pages+with+non+.html+extensions"></a>
<h3>Generating content pages with non .html extensions</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -895,50 +955,6 @@
<br>
Just an enhancement... in my case not having it prevents me from using
forrest (this time; I'm rather sad about that), but I see a future version
where I can use it to make life easier.</p>
-</div>
-<a name="N10117"></a><a name="WAI+ideas"></a>
-<h3>WAI ideas</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
-<a
href="http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-24";>http://issues.cocoondev.org/jira//ViewIssue.jspa?key=FOR-24</a>
-</p>
-<p>As per <a
href="http://xml.apache.org/forrest/compliance.html#N1003A";>http://xml.apache.org/forrest/compliance.html#N1003A</a>
-<br>
-
-<br>
-One postulate that could be easily achieved for viewing the site with lynx
(or redhat's links) ASCII browser is [Priority 3] (Checkpoint 13.6) <a
href="http://www.w3.org/TR/WCAG10-TECHS/#tech-group-links";>http://www.w3.org/TR/WCAG10-TECHS/#tech-group-links</a>
.
-<br>
-One option is to use the MAP as in <a
href="http://www.w3.org/TR/WCAG10-HTML-TECHS/#group-bypass";>http://www.w3.org/TR/WCAG10-HTML-TECHS/#group-bypass</a>
-<br>
-or how I did it and contend that it better renders graphically as well as
ASCII-wise is:
-<br>
-1) after <div class="menu">, add
-<br>
- <a href="#contentStart" style="line-height: 0px;border:
none;">
-<br>
- <img src="../../skins/common/images/1PxTranspa.gif"
-<br>
- alt="Bypass Navigation Bar" /></a>
-<br>
-2) after <div class="content">
-<br>
- add <a id="contentStart"></a>
-<br>
-
-<br>
-What do you think?
-<br>
-
-<br>
-Re 1) I tried to add this in book2menu.xsl as
-<br>
-<xsl:template match="menu">
-<br>
- <div class="menu">
-<br>
-but unfortunately, it was ignored...
-<br>
-</p>
</div>
<div class="attribution"></div>
</div>
1.13 +4 -0 xml-site/targets/forrest/forrestbar.html
Index: forrestbar.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/forrestbar.html,v
retrieving revision 1.12
retrieving revision 1.13
diff -u -r1.12 -r1.13
--- forrestbar.html 9 Dec 2003 23:45:48 -0000 1.12
+++ forrestbar.html 17 Dec 2003 23:08:23 -0000 1.13
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.2 +4 -0 xml-site/targets/forrest/forrestbot-intro-old.html
Index: forrestbot-intro-old.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/forrestbot-intro-old.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- forrestbot-intro-old.html 9 Dec 2003 23:45:48 -0000 1.1
+++ forrestbot-intro-old.html 17 Dec 2003 23:08:23 -0000 1.2
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.2 +4 -0 xml-site/targets/forrest/forrestbot-old.html
Index: forrestbot-old.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/forrestbot-old.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- forrestbot-old.html 9 Dec 2003 23:45:49 -0000 1.1
+++ forrestbot-old.html 17 Dec 2003 23:08:23 -0000 1.2
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.23 +12 -20 xml-site/targets/forrest/forrestbot.html
Index: forrestbot.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/forrestbot.html,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- forrestbot.html 9 Dec 2003 23:45:49 -0000 1.22
+++ forrestbot.html 17 Dec 2003 23:08:23 -0000 1.23
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
@@ -588,7 +592,8 @@
<td colspan="1" rowspan="1">getsrc.cvs.module</td>
- <td colspan="1" rowspan="1">CVS module name</td>
+ <td colspan="1" rowspan="1">CVS module name (an alias, or full
path) to the directory that
+ contains forrest.properties</td>
<td colspan="1" rowspan="1">${ant.project.name}</td>
@@ -599,19 +604,6 @@
<tr>
-<td colspan="1" rowspan="1">getsrc.cvs.root-dir</td>
-
- <td colspan="1" rowspan="1">Directory within module that
contains the forrest project</td>
-
- <td colspan="1" rowspan="1"></td>
-
- <td colspan="1" rowspan="1">No</td>
-
-</tr>
-
-
-<tr>
-
<td colspan="1" rowspan="1">getsrc.cvs.tag</td>
<td colspan="1" rowspan="1">CVS tag or branch name</td>
@@ -624,7 +616,7 @@
</table>
</div>
-<a name="N1019F"></a><a name="build.forrest"></a>
+<a name="N10189"></a><a name="build.forrest"></a>
<h5>build.forrest</h5>
<div style="margin-left: 0 ; border: 2px">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -656,7 +648,7 @@
</table>
</div>
-<a name="N101D7"></a><a name="deploy.local"></a>
+<a name="N101C1"></a><a name="deploy.local"></a>
<h5>deploy.local</h5>
<div style="margin-left: 0 ; border: 2px">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -689,7 +681,7 @@
</table>
</div>
-<a name="N1020F"></a><a name="notify"></a>
+<a name="N101F9"></a><a name="notify"></a>
<h5>notify</h5>
<div style="margin-left: 0 ; border: 2px">
<p>These settings are used by all notify implementations.</p>
@@ -761,12 +753,12 @@
</table>
</div>
-<a name="N1028B"></a><a name="notify.local"></a>
+<a name="N10275"></a><a name="notify.local"></a>
<h5>notify.local</h5>
<div style="margin-left: 0 ; border: 2px">
<p>No properties.</p>
</div>
-<a name="N10295"></a><a name="notify.email"></a>
+<a name="N1027F"></a><a name="notify.email"></a>
<h5>notify.email</h5>
<div style="margin-left: 0 ; border: 2px">
<table class="ForrestTable" cellspacing="1" cellpadding="4">
@@ -815,7 +807,7 @@
</div>
-<a name="N102E6"></a><a name="Forrestbot+design"></a>
+<a name="N102D0"></a><a name="Forrestbot+design"></a>
<h3>Forrestbot design</h3>
<div style="margin-left: 0 ; border: 2px">
<p>Forrest and forrestbot use ant buildfiles extensively. Ant 1.6's
1.20 +54 -54 xml-site/targets/forrest/forrestbot.pdf
<<Binary file>>
1.24 +4 -0 xml-site/targets/forrest/howto-v10.dtdx.html
Index: howto-v10.dtdx.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/howto-v10.dtdx.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- howto-v10.dtdx.html 9 Dec 2003 23:45:49 -0000 1.23
+++ howto-v10.dtdx.html 17 Dec 2003 23:08:23 -0000 1.24
@@ -329,6 +329,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.31 +4 -0 xml-site/targets/forrest/index.html
Index: index.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/index.html,v
retrieving revision 1.30
retrieving revision 1.31
diff -u -r1.30 -r1.31
--- index.html 9 Dec 2003 23:45:49 -0000 1.30
+++ index.html 17 Dec 2003 23:08:23 -0000 1.31
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.24 +4 -0 xml-site/targets/forrest/libre-intro.html
Index: libre-intro.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/libre-intro.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- libre-intro.html 9 Dec 2003 23:45:49 -0000 1.23
+++ libre-intro.html 17 Dec 2003 23:08:23 -0000 1.24
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.25 +4 -0 xml-site/targets/forrest/license.html
Index: license.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/license.html,v
retrieving revision 1.24
retrieving revision 1.25
diff -u -r1.24 -r1.25
--- license.html 9 Dec 2003 23:45:49 -0000 1.24
+++ license.html 17 Dec 2003 23:08:23 -0000 1.25
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.19 +4 -0 xml-site/targets/forrest/linking.html
Index: linking.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/linking.html,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- linking.html 9 Dec 2003 23:45:49 -0000 1.18
+++ linking.html 17 Dec 2003 23:08:23 -0000 1.19
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.8 +1 -0 xml-site/targets/forrest/linkmap-index.html
Index: linkmap-index.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/linkmap-index.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- linkmap-index.html 9 Dec 2003 23:45:49 -0000 1.7
+++ linkmap-index.html 17 Dec 2003 23:08:23 -0000 1.8
@@ -82,6 +82,7 @@
</community>
<getting-involved label="Getting Involved">
<contrib label="Contributing" href="contrib.html"/>
+ <build label="Building Forrest" href="build.html"/>
<CVS label="Browse CVS"
href="http://cvs.apache.org/viewcvs/xml-forrest/"/>
<mail-lists label="Mail lists" href="mail-lists.html">
<forrest-dev href="mail-lists.html#forrest-dev"/>
1.29 +4 -0 xml-site/targets/forrest/live-sites.html
Index: live-sites.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/live-sites.html,v
retrieving revision 1.28
retrieving revision 1.29
diff -u -r1.28 -r1.29
--- live-sites.html 12 Dec 2003 03:12:22 -0000 1.28
+++ live-sites.html 17 Dec 2003 23:08:23 -0000 1.29
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.26 +4 -0 xml-site/targets/forrest/mail-archives.html
Index: mail-archives.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/mail-archives.html,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- mail-archives.html 9 Dec 2003 23:45:49 -0000 1.25
+++ mail-archives.html 17 Dec 2003 23:08:23 -0000 1.26
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.27 +4 -0 xml-site/targets/forrest/mail-lists.html
Index: mail-lists.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/mail-lists.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- mail-lists.html 9 Dec 2003 23:45:49 -0000 1.26
+++ mail-lists.html 17 Dec 2003 23:08:23 -0000 1.27
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.5 +4 -0 xml-site/targets/forrest/menu-index.html
Index: menu-index.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/menu-index.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- menu-index.html 9 Dec 2003 23:45:49 -0000 1.4
+++ menu-index.html 17 Dec 2003 23:08:23 -0000 1.5
@@ -140,6 +140,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.27 +4 -0 xml-site/targets/forrest/primer.html
Index: primer.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/primer.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- primer.html 9 Dec 2003 23:45:49 -0000 1.26
+++ primer.html 17 Dec 2003 23:08:23 -0000 1.27
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.9 +4 -0 xml-site/targets/forrest/sitemap-ref.html
Index: sitemap-ref.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/sitemap-ref.html,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- sitemap-ref.html 9 Dec 2003 23:45:49 -0000 1.8
+++ sitemap-ref.html 17 Dec 2003 23:08:23 -0000 1.9
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.3 +4 -0 xml-site/targets/forrest/skin-package.html
Index: skin-package.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/skin-package.html,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- skin-package.html 9 Dec 2003 23:45:49 -0000 1.2
+++ skin-package.html 17 Dec 2003 23:08:23 -0000 1.3
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.24 +4 -0 xml-site/targets/forrest/todo.html
Index: todo.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/todo.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- todo.html 9 Dec 2003 23:45:49 -0000 1.23
+++ todo.html 17 Dec 2003 23:08:23 -0000 1.24
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.8 +4 -0 xml-site/targets/forrest/upgrading_05.html
Index: upgrading_05.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/upgrading_05.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- upgrading_05.html 9 Dec 2003 23:45:49 -0000 1.7
+++ upgrading_05.html 17 Dec 2003 23:08:23 -0000 1.8
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.24 +4 -0 xml-site/targets/forrest/validation.html
Index: validation.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/validation.html,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- validation.html 9 Dec 2003 23:45:49 -0000 1.23
+++ validation.html 17 Dec 2003 23:08:23 -0000 1.24
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.27 +4 -0 xml-site/targets/forrest/who.html
Index: who.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/who.html,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- who.html 9 Dec 2003 23:45:49 -0000 1.26
+++ who.html 17 Dec 2003 23:08:23 -0000 1.27
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.12 +4 -0 xml-site/targets/forrest/wiki-sample.html
Index: wiki-sample.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/wiki-sample.html,v
retrieving revision 1.11
retrieving revision 1.12
diff -u -r1.11 -r1.12
--- wiki-sample.html 9 Dec 2003 23:45:49 -0000 1.11
+++ wiki-sample.html 17 Dec 2003 23:08:23 -0000 1.12
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
1.28 +42 -80 xml-site/targets/forrest/your-project.html
Index: your-project.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/your-project.html,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -r1.27 -r1.28
--- your-project.html 9 Dec 2003 23:45:49 -0000 1.27
+++ your-project.html 17 Dec 2003 23:08:23 -0000 1.28
@@ -252,6 +252,10 @@
</li>
<li>
+<a href="build.html">Building Forrest</a>
+</li>
+
+<li>
<a href="http://cvs.apache.org/viewcvs/xml-forrest/";>Browse CVS</a>
</li>
@@ -341,10 +345,7 @@
<a href="#intro">Introduction</a>
</li>
<li>
-<a href="#getting_from_source">Getting the Forrest source</a>
-</li>
-<li>
-<a href="#installing">Building and Installing Forrest</a>
+<a href="#installing">Installing Forrest</a>
</li>
<li>
<a href="#seeding_new">Seeding a new project</a>
@@ -418,71 +419,32 @@
</p>
</div>
-
-<a name="N10023"></a><a name="getting_from_source"></a>
-<h3>Getting the Forrest source</h3>
-<div style="margin-left: 0 ; border: 2px">
-<p>
- Currently, the primary way to get Forrest is through CVS. Please
consult <a href="primer.html#cvs">The Forrest Primer</a> for a description of
what
- this involves.</p>
-<p>Here is how to get Forrest with a shell-based CVS client:</p>
-<pre class="code">
-~/apache$ export CVSROOT=:pserver:[EMAIL PROTECTED]:/home/cvspublic
-~/apache$ cvs login
-Logging in to :pserver:[EMAIL PROTECTED]:2401/home/cvspublic
-CVS password:
-~/apache$ cvs checkout xml-forrest
-U xml-forrest/.cvsignore
-U xml-forrest/appendcp.bat
-U xml-forrest/build-old.xml
-U xml-forrest/build.bat
-....
- </pre>
-</div>
-
-<a name="N10039"></a><a name="installing"></a>
-<h3>Building and Installing Forrest</h3>
+<a name="N10023"></a><a name="installing"></a>
+<h3>Installing Forrest</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
- To build Forrest, type <span class="codefrag">build</span> on
Windows, or <span class="codefrag">./build.sh</span> on
- Unix. If everything is successful, you should see a message like this:
+
+<a href="http://www.apache.org/dyn/closer.cgi/xml/forrest/";>Download</a> the
latest release of Forrest, or
+ if you want to try the development version, <a href="build.html">build
+ Forrest</a> from source.
</p>
-<pre class="code">
- *-----------------------------------------------------------------
- | installation notice
- *-----------------------------------------------------------------
- | You have succesfully built the shell-bat distribution of Forrest.
- | Please find it at: ./build/dist/shbat
- | Please copy the contents to the install directory of your choice
- | Please have the environment variable FORREST_HOME point to it.
- | It is recommended to add
- | unix: $FORREST_HOME/bin: to your $PATH
- | win: %FORREST_HOME%\bin; to your %PATH%
- | Calling
- | unix: $FORREST_HOME/bin/forrest -projecthelp
- | win: %FORREST_HOME%\bin\forrest -projecthelp
- | will list options for the 'forrest' command
- | More help at http://xml.apache.org/forrest/ and [EMAIL PROTECTED]
- *-----------------------------------------------------------------
- </pre>
<p>
- You now have the binary distribution built in <span
class="codefrag">build/dist/shbat</span>.
- Copy it somewhere more sensible if you like (e.g.
- <span class="codefrag">/usr/local/forrest</span> on Unix), though if
you intend to update your
- Forrest from CVS, leaving it where it is would be best.</p>
-<p>
- As the message says, you need to add the distribution's <span
class="codefrag">bin/</span>
- ("binary") directory to your PATH variable, so the <span
class="codefrag">'forrest'</span>
- command is available everywhere:
+ After downloading and extracting forrest, you need to add environment
variables. In Unix/Linux:
</p>
<pre class="code">
-~/apache/xml-forrest$ export FORREST_HOME=`pwd`/build/dist/shbat
-~/apache/xml-forrest$ export PATH=$PATH:$FORREST_HOME/bin
+~/apache-forrest-0.5.1$ export FORREST_HOME=`pwd`
+~/apache-forrest-0.5.1$ export PATH=$PATH:$FORREST_HOME/bin
</pre>
<p>
+ In Windows, go to "My Computer", "Properties", "Advanced", "Environment
Variables" and add:
+ <span class="codefrag">FORREST_HOME</span> as <span
class="codefrag">C:\full\path\to\apache-forrest-0.5.1</span> and
+ <span class="codefrag">PATH</span> as <span
class="codefrag">%PATH%;%FORREST_HOME%\bin</span>
+
+</p>
+<p>
To see what the forrest command can do, type 'forrest -projecthelp'
- </p>
+ </p>
<pre class="code">
Apache Forrest. Run 'forrest -projecthelp' to list options
@@ -519,7 +481,7 @@
</div>
-<a name="N10070"></a><a name="seeding_new"></a>
+<a name="N10057"></a><a name="seeding_new"></a>
<h3>Seeding a new project</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -640,7 +602,7 @@
<img class="figure" alt="New project" src="images/new-project.png"
height="356" width="500"></div>
</div>
-<a name="N10099"></a><a name="seeding_existing"></a>
+<a name="N10080"></a><a name="seeding_existing"></a>
<h3>Seeding an existing project</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -659,7 +621,7 @@
</p>
</div>
-<a name="N100AD"></a><a name="customizing"></a>
+<a name="N10094"></a><a name="customizing"></a>
<h3>Customizing your project</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -667,7 +629,7 @@
to your project's needs. Here we will deal with configuring the
skin, and
changing the project layout.
</p>
-<a name="N100B6"></a><a name="skinconf.xml"></a>
+<a name="N1009D"></a><a name="skinconf.xml"></a>
<h4>Configuring the Forrest skin: skinconf.xml</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -760,7 +722,7 @@
command in the site root, and the site should be updated.
</p>
</div>
-<a name="N100D4"></a><a name="Changing_the_layout"></a>
+<a name="N100BB"></a><a name="Changing_the_layout"></a>
<h4>Changing the layout: forrest.properties</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -835,7 +797,7 @@
-<a name="N10112"></a><a name="adding_content"></a>
+<a name="N100F9"></a><a name="adding_content"></a>
<h3>Adding content</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -843,7 +805,7 @@
<span class="codefrag">src/documentation/content/xdocs</span>
</p>
-<a name="N1011E"></a><a name="site.xml"></a>
+<a name="N10105"></a><a name="site.xml"></a>
<h4>site.xml</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -853,7 +815,7 @@
xdocs for an example. More detailed info about site.xml is
provided in <a href="linking.html">Menus and Linking</a>.
</p>
</div>
-<a name="N1012F"></a><a name="tabs.xml"></a>
+<a name="N10116"></a><a name="tabs.xml"></a>
<h4>tabs.xml</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -869,7 +831,7 @@
example.
</p>
</div>
-<a name="N10147"></a><a name="images"></a>
+<a name="N1012E"></a><a name="images"></a>
<h4>Images</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -883,7 +845,7 @@
-<a name="N10158"></a><a name="sitemap.xmap"></a>
+<a name="N1013F"></a><a name="sitemap.xmap"></a>
<h3>Advanced customizations: sitemap.xmap</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -934,7 +896,7 @@
<strong>sitemap.xmap</strong>, which delegates to others. See the
<a href="sitemap-ref.html">Sitemap Reference</a> for a tour of the
default sitemap.
</p>
-<a name="N101B1"></a><a name="adding_new_content_type"></a>
+<a name="N10198"></a><a name="adding_new_content_type"></a>
<h4>Example: Adding a new content type</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -1073,7 +1035,7 @@
</li>
</ol>
-<a name="N10209"></a><a name="new_dtd"></a>
+<a name="N101F0"></a><a name="new_dtd"></a>
<h5>Registering a new DTD</h5>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -1107,7 +1069,7 @@
</p>
</div>
</div>
-<a name="N10232"></a><a name="integrating_rss"></a>
+<a name="N10219"></a><a name="integrating_rss"></a>
<h4>Example: integrating external RSS content</h4>
<div style="margin-left: 0 ; border: 2px">
<p>Similar to the previous example, we can integrate RSS into our
@@ -1141,7 +1103,7 @@
</div>
-<a name="N10255"></a><a name="skins"></a>
+<a name="N1023C"></a><a name="skins"></a>
<h3>Forrest skins</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -1157,7 +1119,7 @@
<pre class="code">
project.skin=forrest-site
</pre>
-<a name="N1026E"></a><a name="new_skin"></a>
+<a name="N10255"></a><a name="new_skin"></a>
<h4>Defining a new skin</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -1223,7 +1185,7 @@
</div>
-<a name="N102B1"></a><a name="webapp"></a>
+<a name="N10298"></a><a name="webapp"></a>
<h3>Interactive Forrest: developing docs faster</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -1235,7 +1197,7 @@
a "live" Forrest webapp instance, Forrest-based doc development can
be
faster and easier than comparable tools.
</p>
-<a name="N102C2"></a><a name="forrest_run"></a>
+<a name="N102A9"></a><a name="forrest_run"></a>
<h4>Running as a webapp</h4>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -1248,7 +1210,7 @@
servlet container, type <span class="codefrag">forrest
webapp</span> to build an open
webapp in <span class="codefrag">build/webapp/</span>.
</p>
-<a name="N102DB"></a><a name="using_webapp"></a>
+<a name="N102C2"></a><a name="using_webapp"></a>
<h5>Using the webapp</h5>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -1278,7 +1240,7 @@
</div>
</div>
-<a name="N10303"></a><a name="invoking_from_ant"></a>
+<a name="N102EA"></a><a name="invoking_from_ant"></a>
<h3>Invoking Forrest from Ant</h3>
<div style="margin-left: 0 ; border: 2px">
<p>
@@ -1382,7 +1344,7 @@
</div>
<div class="attribution">by Jeff Turner; <span class="version">
- version 1.31</span>
+ version 1.32</span>
</div>
</div>
</td><td width="10"><img width="10" height="1" alt=""
src="skin/images/spacer.gif" class="spacer"></td>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
