Hi all; I'm working on a large application and will need to generate some
documentation. Specifically I need to create a manual and would like that to
be in both HTML and PDF format when I'm done. There might also be a few
articles as well and keeping them in the same format would be convenient but
not required.
I've done some research and it SEEMS that Docbook + FOP is a good way to do
this. Before I really dig in though I wanted to make sure I wasn't heading
down the wrong path. I've reached the point where I can create a PDF file
via this command:
fop -xsl docbook5-xsl-1.72.0\fo\docbook.xsl -xml manual.xml -pdf manual.pdf
and all seems to work (even hyphenation). Where I run into problems is when
I start trying to do anything beyond the basics. For instance, bookmarks.
I've found a lot of documentation on using various techniques for bookmarks
but they all seem to involve editing the XSL or generated FO files. Sadly,
I'm way over my head with the massive XSL used to get this working. Isn't
there a way to just put that in my manual.xml file? That seems to make the
most sense to me.
Should I even be using Docbook at all? What do others use to generate
manuals? To be honest, this seems very cumbersome thus far and I'm thinking
there has to be a way to make it cleaner. Any advice would be appreciated.
Thanks!
Mike
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
