Dirk Kraemer wrote:
I have written a small and incomplete ;^) docbook guide for a project of mine... that uses DbForms for the backoffice interface ;^)Then I'd like to propose (in the long term) docbook or a similar standard, to obtain docs + a documentation sistem that: - uses a markup structure - can be handled by a simple text editor ;^) and a CVS system - can produce html files subdivided by chaptersI would agree to all that, if we really have someone more or less responsible for integrating new docs. There might be contributors who don't want to learn docbook. They must be helped then. Even if there will be a way to use OpenOffice to edit Docbook documents, someone should be there an help. We needed a page explaining what to do to write new docs. Some links, examples etc...
http://prdownloads.sourceforge.net/pow2acl/pow2acl-guide.20020113.zip?download
The sgml directory contains a simple document that IMHO can be used to learn
a bit of docbook elements.
pow2acl.sgml is the main file that contains the references to other chapters.
The main directory contains the rendered html files (book1.htm is the index page)
At the time, to render the document I used the "old docbook skool":
SGML instead of XML and the SGML parser/processor OpenJade instead of XSL stylesheets, because the provided XSL stylesheets didn't work well.
I think docbook people where converting dsssl stylesheets into xsl.
Anyway, the new school uses XML and XSLT, and I think it's a lot better (newer XSLT stylesheets should work now, I hope), because it's possible to use Java packages like xerces, xalan and ant to get a multi platform docbook environment
The problem with the "old skool" is - in my opinion - the complex setup for win32 systems. While Linux / *nix users can install a "Linux Documentation Project package" to obtain a full-working docbook environment, win32 users can't use this "easy way" ;^)
Some links:
http://www.docbook.org/
http://www.oasis-open.org/committees/docbook/
That sounds easy. Does it use GhostScript internally?pdfcreator http://sector7g.wurzel6-webdesign.de/pdfcreator/index_en.htm
yes, it should. There is a gsdll32.dll (3.405 kb) into the distribuition.
And is there a usable (= clickable)mmmh... i tried to convert a MS word document with a clickable table of contents
table of contents within the resulting pdf document?
into a PDF file (using settings for AcroReader5) but I didn't have got clickable links.
Regards Dirk
Regards, Luca ------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ DbForms Mailing List http://www.wap-force.net/dbforms
