Hi,
i am trying to create product documentation with Apache Forrest. This is my first contact and i just decided to use Forrest instead of docbook for documentation creation.
As allways, some things are pretty easy and some not. I created my first testproject and i was able to create the html and PDFs for my site. I have also tested the OpenOffice writer and its amazing that you can put your .swx files in there and it gets transformed to HTML and PDF, really nice.
But as stated, i have a few beginner questions:
1.
--
I want to create product documentation and i need 3 versions: "PDF", "HTML One-Page", "HTML links-per-chapter/topic". An example of such an approach can be seen here: http://www.solarmetric.com/jdo/Documentation/ (docbook generated ;-)) How to structure the XML documents for this?
Do i need XML linking capabilites? Because i want one XML file per topic, several topics are a chapter and several chapters are the book. Now i want forrest to produce one BIG html page covering the book, one TOC based html with different links to the various topics or chapters and a PDF with the complete material. PDF for various chapters wont hurt either. Tapestry has done it nearly the same way with forrest, so it should be doable. (perhaps i should check out tapestry CVS to see whats going on there)
2.
--
How can i control the PDF generation? The footer is pretty big and i want to shorten it but how?
3.
--
When transforming the OO documents to PDF, we get the Object descriptions for tables and images below them. Is this the way it should be?
-- regards Marc Logemann http://www.logemann.org http://www.logentis.de
