Re: [Firebird-docs] Re: Docs on the go

[Lester C. <le...@ls...>]

Paul Vinkenoog wrote:

>>From the DocBook XML sources we already produce HTML for the web and
> PDFs to package (and download). Of course this isn't an online editing
> system - but it's both versatile and *very* powerful. I do hope that
> more people will take a sniff at DocBook (see
> http://www.firebirdsql.org/manual/docwritehowto.html or
> http://www.firebirdsql.org/pdfmanual/Firebird-Docwriters-Info.pdf) and
> start contributing...

I've had a couple of goes at trying to use it, but I simply can't get on 
with it.
I need to be able to manage pages and small documents in isolation, and 
DocBooks is just too cumbersome for that.
The wiki approach allows updates to be dropped in from anywhere, but is 
not the answer either - but I can modify the internal tags to produce 
XML ones when I do an extract from the database.
I produce all of my on-line documentation as linked html, rather than 
linear documents, and I think that is what breaks DocBook?
That said it is probably me that is broken ;)

-- 
Lester Caine
-----------------------------
L.S.Caine Electronic Services