1.6. When running <code>./build.sh</code> in cygwin, I get an error: <code>cygpath.exe: *** can't create title mutex, Win32 error 6</code>.

Uncomment that and set it to the specific page that - you want. Forest will build that page, then of course + you want. Forrest 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. @@ -598,15 +598,21 @@

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. + has built your pages of interest.

- Forrest can also be instructed to not process certain URIs - if you need to temporarily exclude then. Use the - Cocoon cli.xconf file. + Cocoon can be instructed via the + Cocoon cli.xconf file to not + follow links (see its "follow-links" parameter). So this will + build only the document that was specified. Be careful, if you + also usually build PDF pages, then they will not be built. +

+ Cocoon can also be instructed to not process certain URIs + if you need to temporarily exclude then.

1.6. When running ./build.sh in cygwin, I get an error: cygpath.exe: *** can't create title mutex, Win32 error 6.

1.7. How can I specify the amount of memory to be used by Java?

1.8. How can I start forrest in debug mode?

2. Content Creation

2.1. What tools can be used to edit the content?

2.2. How to use the site.xml configuration file for menus and linking.

2.3. Where are examples of documents and site.xml and tabs.xml files?

2.4. How can I generate one pdf-file out of the whole site or selected pages of the site?

2.5. How do I insert page breaks into documents?

2.6. How can I generate html-pages to show a 'clickable' email-address (of the author-element)?

2.7. How do I link to raw files such as config.txt and brochure.pdf?

2.8. Images don't display in PDFs. How do I fix this?

2.9. The tab link in my site incorrectly assumes that 'index.html' is present in the linked-to directory. How do I fix this?

2.10. I need help with the interaction between tabs.xml and site.xml

2.11. 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/ ?

2.12. How can I use a start-up-page other than index.html?

2.13. How to use special characters in the labels of the site.xml file?

2.14. Does Forrest handle accents for non-English languages?

2.15. How to use XML entities, for example string replacement?

2.16. How to make Forrest clean up the project build directories?

2.17. How can I internationalise (i18n) my content?

2.18. How can I include HTML content that is not to be skinned by Forrest?

2.19. How to include additional Javascript and CSS files?

3. Technical

3.1. I'm behind a proxy and it's preventing Plugins from being downloaded, what should I do?

3.2. How can I generate html-pages to show the revision tag of cvs?

3.3. How to control the processing of URIs by Cocoon, e.g. exclude certain URIs, include other additional ones.

3.4. How do I stop Forrest breaking on links to external files that may not exist, like javadocs?

3.5. Some of my files are not being processed because they use common filenames.

3.6. What do the symbols and numbers mean when Forrest lists each document that it has built?

3.7. 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.

3.8. The project logo that is generated from SVG is truncating my project name.

3.9. How do i configure my favourite XML editor or parser to find the local Forrest DTDs?

3.10. How to make the site look better and change its skin?

3.11. How do I enable XSP processing?

3.12. How do breadcrumbs work? Why don't they work locally?

3.13. How do I make forrest run listen on a different port?

3.14. Can I run Forrest with Java debugging turned on?

4. Older version: 0.6

4.1. Some of my files are not being processed because they use common filenames.

5. General

5.1. What is the relationship between site.xml and book.xml?

5.2. How do I use DocBook as the XML documentation format?

5.3. How to report which version of Forrest is being used and the properties that are set?

5.4. Where are the log files to find more infomation about errors?

5.5. How to help?

5.6. How to contribute a patch?

^ Modified: forrest/site/docs_0_80/faq.pdf URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/faq.pdf?rev=359698&r1=359697&r2=359698&view=diff ============================================================================== Binary files - no diff available. Modified: forrest/site/docs_0_80/faq.xml URL: http://svn.apache.org/viewcvs/forrest/site/docs_0_80/faq.xml?rev=359698&r1=359697&r2=359698&view=diff ============================================================================== --- forrest/site/docs_0_80/faq.xml (original) +++ forrest/site/docs_0_80/faq.xml Wed Dec 28 19:23:21 2005 @@ -45,7 +45,7 @@

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. + has built your pages of interest.

+ +

+ Cocoon can also be instructed to not process certain URIs + if you need to temporarily exclude then.

1.6. When running <code>./build.sh</code> in cygwin, I get an error: <code>cygpath.exe: *** can't create title mutex, Win32 error 6</code>.