[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: How to use classsynopsis and friends
maxwell <maxwell@umiacs.umd.edu> writes: > It's too late now, I'm sure, but as a user of DocBook for purposes > other than software documentation (we use it for grammars), DocBook > seems bloated with all these tags for software (the aforementioned > <classsynopsis> being a perfect example). Yes. Well. Fair enough, but "DocBook is a schema (available in several languages including RELAX NG, SGML and XML DTDs, and W3C XML Schema) maintained by the DocBook Technical Committee of OASIS. It is particularly well suited to books and papers about computer hardware and software (though it is by no means limited to these applications)." > In our customization, we > remove all those tags, and add in the ones we need for literate > programming and for linguistics, using a namespace prefix for our > tags. That's absolutely perfect. It's exactly what users should do with DocBook. You're free to put your linguistic elements in the DocBook namespace too, if you'd like. See: http://docbook.org/tdg51/en/html/ch01.html#nsusage and http://docbook.org/tdg51/en/html/ch05.html#s-notdocbook > It always seemed to me like DocBook could have had a much simpler > model, by putting the software- and hardware-specific tags into a > separate namespace. That would make it easier for other potential > users to wade through the remaining elements and decide which of them > they really need. Obviously that couldn't have happened until DB5, and > it's probably too late now. I suppose the next best thing would be to > compile a list of tags that are core DB (meaning about text in > general), and/or a list of software- and hardware-specific tags, which > would make it easier for potential users. You could start with Simplified DocBook as a base. Be seeing you, norm -- Norman Walsh <ndw@nwalsh.com> | Hanging is too good for a man who http://www.oasis-open.org/docbook/ | makes puns; he should be drawn and Chair, DocBook Technical Committee | quoted.--Fred Allen
Attachment:
signature.asc
Description: PGP signature
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]