crossley 2004/01/11 05:11:20
Modified: targets/forrest faq.html faq.pdf
Log:
Add new entry for system requirements.
Revision Changes Path
1.38 +59 -38 xml-site/targets/forrest/faq.html
Index: faq.html
===================================================================
RCS file: /home/cvs/xml-site/targets/forrest/faq.html,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- faq.html 24 Dec 2003 04:46:53 -0000 1.37
+++ faq.html 11 Jan 2004 13:11:20 -0000 1.38
@@ -356,6 +356,11 @@
</a>
</li>
<li>
+<a name="requirements-menu"></a><a href="#requirements">
+ What are the system requirements for Forrest?
+ </a>
+</li>
+<li>
<a name="cvs-menu"></a><a href="#cvs">
I would rather use CVS so that i can keep up-to-date. How?
</a>
@@ -387,11 +392,11 @@
the whole site or selected pages of the site?</a>
</li>
<li>
-<a name="clickable-email-adress-menu"></a><a
href="#clickable-email-adress">How can I generate html-pages show a
+<a name="clickable-email-adress-menu"></a><a
href="#clickable-email-adress">How can I generate html-pages to show a
'clickable' email-address (of the author-element)?</a>
</li>
<li>
-<a name="CVS_revison_tags-menu"></a><a href="#CVS_revison_tags">How can I
generate html-pages show the
+<a name="CVS_revison_tags-menu"></a><a href="#CVS_revison_tags">How can I
generate html-pages to show the
revision tag of cvs?</a>
</li>
<li>
@@ -490,13 +495,13 @@
</li>
</ol>
</div>
-<a name="N100B8"></a><a name="Answers"></a>
+<a name="N100BD"></a><a name="Answers"></a>
<h3>Answers</h3>
<div style="margin-left: 0 ; border: 2px">
-<a name="N100BC"></a><a name="getting_started"></a>
+<a name="N100C1"></a><a name="getting_started"></a>
<h4>1. Getting Started and Building Forrest</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N100C0"></a><a name="overview"></a>
+<a name="N100C5"></a><a name="overview"></a>
<h5>1.1.
Where can i read an overview about how to work with Forrest?
<span style="float: right"><a href="#overview-menu">^</a></span>
@@ -506,8 +511,22 @@
See the <a href="your-project.html">Using Forrest</a> guide.
</p>
</div>
-<a name="N100CC"></a><a name="cvs"></a>
+<a name="N100D1"></a><a name="requirements"></a>
<h5>1.2.
+ What are the system requirements for Forrest?
+ <span style="float: right"><a href="#requirements-menu">^</a></span>
+</h5>
+<div style="margin-left: 15 ; border: 2px">
+<p>
+ Forrest includes everything necessary to build and run, except
+ of course for Java. In addition to all the Cocoon JARs, Forrest
+ includes and uses its own version of Ant. The
+ <a
href="http://cocoon.apache.org/2.1/installing/requirements.html";>Cocoon
requirements</a>
+ indicate that Java 1.3+ is required.
+ </p>
+</div>
+<a name="N100DD"></a><a name="cvs"></a>
+<h5>1.3.
I would rather use CVS so that i can keep up-to-date. How?
<span style="float: right"><a href="#cvs-menu">^</a></span>
</h5>
@@ -517,8 +536,8 @@
<a href="build.html">Building Forrest</a> notes.
</p>
</div>
-<a name="N100D8"></a><a name="checked_out_now_what"></a>
-<h5>1.3.
+<a name="N100E9"></a><a name="checked_out_now_what"></a>
+<h5>1.4.
I have checked out a working copy of xml-forrest CVS, now what?
<span style="float: right"><a
href="#checked_out_now_what-menu">^</a></span>
</h5>
@@ -532,8 +551,8 @@
further step-by-step assistance in getting started with Forrest
for your project.
</p>
</div>
-<a name="N100EE"></a><a name="cygwin_mutex_error"></a>
-<h5>1.4.
+<a name="N100FF"></a><a name="cygwin_mutex_error"></a>
+<h5>1.5.
When running ./build.sh in cygwin, I get an error:
cygpath.exe: *** can't create title mutex, Win32 error 6.
<span style="float: right"><a
href="#cygwin_mutex_error-menu">^</a></span>
@@ -544,8 +563,8 @@
to be a bug in cygwin</a>. Please use the .bat script instead.
</p>
</div>
-<a name="N10100"></a><a name="maxmemory"></a>
-<h5>1.5.
+<a name="N10111"></a><a name="maxmemory"></a>
+<h5>1.6.
How can i specify the amount of memory to be used by Java?
<span style="float: right"><a href="#maxmemory-menu">^</a></span>
</h5>
@@ -559,10 +578,10 @@
</p>
</div>
</div>
-<a name="N10111"></a><a name="technical"></a>
+<a name="N10122"></a><a name="technical"></a>
<h4>2. Technical</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N10115"></a><a name="PDF-output"></a>
+<a name="N10126"></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>
@@ -583,8 +602,8 @@
structure and navigation, rather than the old book.xml method.
</p>
</div>
-<a name="N10124"></a><a name="clickable-email-adress"></a>
-<h5>2.2. How can I generate html-pages show a
+<a name="N10135"></a><a name="clickable-email-adress"></a>
+<h5>2.2. How can I generate html-pages to show a
'clickable' email-address (of the author-element)?<span style="float:
right"><a href="#clickable-email-adress-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -593,8 +612,8 @@
and edit the "headers/authors" template.
</p>
</div>
-<a name="N1012F"></a><a name="CVS_revison_tags"></a>
-<h5>2.3. How can I generate html-pages show the
+<a name="N10140"></a><a name="CVS_revison_tags"></a>
+<h5>2.3. How can I generate html-pages to show the
revision tag of cvs?<span style="float: right"><a
href="#CVS_revison_tags-menu">^</a></span>
</h5>
<div style="margin-left: 15 ; border: 2px">
@@ -604,8 +623,10 @@
example the bottom of <a
href="http://xml.apache.org/forrest/your-project.html";>
http://xml.apache.org/forrest/your-project.html</a>
</p>
+<p>This technique could also be used for a modification date with
+ $Date$</p>
</div>
-<a name="N1013D"></a><a name="ignoring_javadocs"></a>
+<a name="N10151"></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?
@@ -645,7 +666,7 @@
</div>
</div>
</div>
-<a name="N1016E"></a><a name="link_raw"></a>
+<a name="N10182"></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>
@@ -658,7 +679,7 @@
project for a demonstration of this ability.
</p>
</div>
-<a name="N10179"></a><a name="build_msg_a"></a>
+<a name="N1018D"></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>
@@ -681,7 +702,7 @@
Column 4 is the page size.
</p>
</div>
-<a name="N10186"></a><a name="pdf_images"></a>
+<a name="N1019A"></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">
@@ -721,7 +742,7 @@
Forrest</div>
</div>
</div>
-<a name="N101B8"></a><a name="index.html"></a>
+<a name="N101CC"></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?
@@ -746,7 +767,7 @@
</map:match>
</pre>
</div>
-<a name="N101D6"></a><a name="headless_operation"></a>
+<a name="N101EA"></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>
@@ -763,12 +784,12 @@
<a
href="http://cocoon.apache.org/2.1/faq/faq-configure-environment.html";>Cocoon
FAQ</a>.
</p>
</div>
-<a name="N101F3"></a><a name="xsp"></a>
+<a name="N10207"></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">
-<p>First consider whether your needs would be better met by Cocoon itself,
rather than Forrest. Forrest was
- designed primarily with static sites in mind, and is not a
general-purpose Cocoon distribution.</p>
+<p>First consider whether your needs would be better met by Cocoon itself,
rather than Forrest.
+ </p>
<p>That said, there are valid reasons for wanting programmatically generated
content, so here is how to enable
XSP:</p>
<ol>
@@ -807,10 +828,10 @@
<p>See also the <a
href="http://wiki.cocoondev.org/Wiki.jsp?page=AddingXSPToForrest";>AddingXSPToForrest</a>
Wiki page.</p>
</div>
</div>
-<a name="N1022A"></a><a name="old_faqs"></a>
+<a name="N1023E"></a><a name="old_faqs"></a>
<h4>3. Older versions</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1022E"></a><a name="unresolved_project.home"></a>
+<a name="N10242"></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.
@@ -830,7 +851,7 @@
<classpath refid="forrest-classpath"/>
<jvmarg value="-Dforrest.home=${forrest.home}"/></pre>
</div>
-<a name="N10244"></a><a name="odd_html"></a>
+<a name="N10258"></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?
@@ -850,7 +871,7 @@
<doctype-system>http://www.w3.org/TR/html4/loose.dtd</doctype-system>
</pre>
</div>
-<a name="N10257"></a><a name="validation_error-doctype_root_null"></a>
+<a name="N1026B"></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"..
@@ -871,7 +892,7 @@
listed to prevent an attempt at DTD-based validation.
</p>
</div>
-<a name="N10274"></a><a name="building_error-custom_sitemap"></a>
+<a name="N10288"></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)
@@ -886,10 +907,10 @@
</p>
</div>
</div>
-<a name="N10289"></a><a name="general"></a>
+<a name="N1029D"></a><a name="general"></a>
<h4>4. General</h4>
<div style="margin-left: 0 ; border: 2px">
-<a name="N1028D"></a><a name="generating_menus"></a>
+<a name="N102A1"></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>
@@ -906,7 +927,7 @@
See <a href="linking.html">Menus and Linking</a>.
</p>
</div>
-<a name="N102A8"></a><a name="docbook"></a>
+<a name="N102BC"></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>
@@ -951,7 +972,7 @@
for configuration guidance.
</p>
</div>
-<a name="N102C6"></a><a name="version"></a>
+<a name="N102DA"></a><a name="version"></a>
<h5>4.3.
How to report which version of Forrest is being used and the
properties that are set?
@@ -968,7 +989,7 @@
Doing <span class="codefrag">'forrest -v'</span> will provide
verbose build messages.
</p>
</div>
-<a name="N102DA"></a><a name="how_can_I_help"></a>
+<a name="N102EE"></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>
@@ -1006,7 +1027,7 @@
</tr>
<tr>
<td colspan="2" bgcolor="#CFDCED" class="copyright" align="center"><font
size="2" face="Arial, Helvetica, Sans-Serif">Copyright ©
- 2002-2003 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
+ 2002-2004 The Apache Software Foundation. All rights
reserved.<script type="text/javascript" language="JavaScript"><!--
document.write(" - "+"Last Published: " +
document.lastModified);
// --></script></font></td>
</tr>
1.30 +619 -553 xml-site/targets/forrest/faq.pdf
<<Binary file>>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
