OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-tc message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: DocBook Publishers documentation

Here's a second peek at an attempt to build a version of TDG for
DocBook 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,

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

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]