Author: crossley
Date: Tue Dec 6 18:01:26 2005
New Revision: 354654
URL: http://svn.apache.org/viewcvs?rev=354654&view=rev
Log:
Enhance the explanation of using "project.start-uri" to control
which files to process.
Modified:
forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
Modified: forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml
URL:
http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml?rev=354654&r1=354653&r2=354654&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml (original)
+++ forrest/trunk/site-author/content/xdocs/docs_0_80/faq.xml Tue Dec 6
18:01:26 2005
@@ -59,9 +59,35 @@
<faq id="single-document">
<question> What is the best way to generate "standalone documents" using
Forrest? </question>
<answer>
- <p> forrest site -Dproject.start-uri=myfile.pdf </p>
- <p> The <link href="site:v0.80//your-project">Using Forrest</link>
guide provides further
- step-by-step assistance in getting started with Forrest for your
project. </p>
+ <p>
+ There is a trick that can cut down your turnaround time
+ with building. In forrest.properties ...
+ </p>
+
+ <source>
+# The URL to start crawling from
+#project.start-uri=linkmap.html
+ </source>
+
+ <p>
+ Uncomment that and set it to the specific page that
+ you want. Forest will build that page, then of course
+ it will keep crawling links from there. It might be
+ confined to a sub-directory, but depending on links
+ could end up generating the whole site.
+ </p>
+
+ <p>
+ The main thing is that your page of interest is built first.
+ You can terminate forrest with 'kill' or Ctrl-C after it
+ has built your page of interest.
+ </p>
+
+ <p>
+ Forrest can also be instructed to not process certain URIs
+ if you need to temporarily exclude then. Use the
+ <link href="#cli-xconf">Cocoon cli.xconf</a> file.
+ </p>
</answer>
</faq>
<faq id="cygwin_mutex_error">
