Re: [Firebird-docs] A how-to on writing Firebird docs?

[Helen B. <he...@tp...>]

At 02:27 AM 4/06/2004 +0200, you wrote:

>You can generate DocBook with OO 1.1.1 but I personally find it rather
>awkward. Carlos seems to be doing OK with it though :-)
>
>If you want to take the DocBook-with-OO route, read
>
>   http://xml.openoffice.org/xmerge/docbook/UserGuide.html
>
>...and also get that template they link to.

You also need to get the three XSLT files.  Actually, this link is better 
to cover fully what you need to do to activate XML filtering (as I 
discovered yesterday after several frustrating hours trying to make OO.o 
1.1.1 behave as described in the UserGuide.html page).  It's incredible 
that they don't have these two pieces together in one document!!

Start here and use method 1:
http://xml.openoffice.org/xmerge/docbook/

Once you do this bit, the UserGuide instructions work fine and it's really 
easy to write an <article> or <chapter> document.


>If you think you're going to write more technical docs in the future
>(not necessarily for Firebird), learning DocBook may be very
>benificial for you. You can find all you need in the Firebird
>Docwriting Howto (but this will cost you at least an hour to read
>and understand):
>
>   http://www.firebirdsql.org/devel/doc/manual/defaulthtml/docwritehowto.html

Confirmed, Paul's Howto is a good coverage of the absolute basics of DocBook.

Paul, I'm working on the converter for the Framemaker xml and I really 
don't think it will be rocket science to write another one for reprocessing 
the OO docbook output, if it's needed.

NB also the usefulness of ConText (www.fixedsys.com/context) for converting 
your files to UTF-8...unicode...You can, of course, do this with the NT 
version of Notepad, but Context has a proper highlighter for XML.

Helen