RE: [Firebird-docs] Docs, create, I can

[Nigel W. <ni...@e-...>]

> But did you also write the part that does the actual PDF rendering?

Ah heck no, that's "htmldoc", a tool for turning all sorts of docs into all
sorts of other docs

> DocBook elements (there are hundreds, of which we
> actively use a few dozens) are all about structure and semantics,
> never about layout or makeup. This makes it ideal for storing
> technical documentary content. The makeup of the rendered documents
> is controlled through stylesheets.

Groovy!
 
> Your system will certainly be easier to use, but it doesn't have the
> richness of DocBook, _and_ it includes makeup codes. Please don't take
> this as criticism: like I said, I thought the output looked great.
> 
> DocBook is not really hard to learn, but for some people it could be
> an obstacle just high enough to keep them from contributing at all.
> For these people your setup could be a godsend.

Well, it's there if people want to have a go. Just register, create,
preview, and submit to a section for moderation...;-)

 
> The Docwriting
> Howto will include all you need to know to get started, and I think
> you can master the DocBook part in less than an hour - not to learn it
> by heart, but to read and understand it, and to get started with the
> docwriting. But maybe that's overoptimistic; I'm really interested to
> know what people think of it once they read it.

I shall peruse it when it's available! ;-)

> Can you have more than one pocketbook at your site? I sure hope so
> because to cram all the docs together in one giant PDF is not exactly
> ideal...

I would imagine so. The P133 has 40MB ram, so it should do it just fine.
I could quickly break out each section into it's own pocketbook - rough, but
a start.

Have a good night's sleep!

N.