Re: DocBook Publishers documentation

[Norman Walsh <ndw@nwalsh.com>]

Here's a second peek at an attempt to build a version of TDG for
DocBook Publishers.

http://nwalsh.com/scratch/publishers/

> It's going to be a bit of a headache to get the text right. All
> references to elements that aren't in Publishers will have to be
> profiled out.
>
> I'm tempted to invent a new profiling system for that:
>
>   <phrase condition="in-schema">This is some text that
>   mentions <tag>programlisting</tag>. It only appears if
>   the schema being documented includes the programlisting
>   element.</phrase>

I implemented this and started using it. Even harder: the examples
that use markup that's not in Publishers need to be updated.

> I'm not sure what the chapters should be for this book. Probably just
> an introduction and maybe "what's different".

I cut-and-pasted a few bits of the spec.

                                        Be seeing you,
                                          norm

-- 
Norman Walsh <ndw@nwalsh.com>      | A man may fulfill the object of
http://www.oasis-open.org/docbook/ | his existence by asking a question
Chair, DocBook Technical Committee | he cannot answer, and attempting a
                                   | task he cannot achieve.--Oliver
                                   | Wendell Holmes

PGP signature