Can one use RelaxNG Compact notation? It is so much simple and easy to understand.
That could be a very good selling point. Jose Alberto > -----Original Message----- > From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED] > Sent: 12 January 2006 23:52 > To: dev@ant.apache.org > Subject: Re: sandbox gendoc > > >> Yes, DocBook, also a standard, is indeed very verbose and doesn't seem > >> to have the favor among commiters. > > > > I think think docbook is interesting but something that should be hidden > > from users by a docbook editor, not handwritten. Also its too low-level; > > I want to mark something as a <task>, not as a bit of code. > > Agree 100%. I went through exactly this thought process myself. > > I wanted to reuse Docbook as much as possible, but wanted a custom schema > to > represent things like Design Patterns, Business Letters, Resumes, etc. > > I found the answer: use Docbook 5.0 (currently in beta). Docbook5 uses > RelaxNG schemas and namespaces rather than DTDs. > I use Jing for validation, though libxml and Sun MSV work fine, too. > > Each schema (pattern, letter, resume, ant task...) is implemented using a > small relaxng file that customizes docbook.rng and a small XSLT that > customizes docbook.xsl. The customizations are usually less than 100 LOC! > > Here is a cut-down example, for a letter: > > <grammar> > <include href="docbook.rng"> > <start> > <element name="l:letter"> > <a:documentation>A business letter</a:documentation> > <element name="l:salutation"><text/></element> > <element name="l:body"> > <a:documentation>The main body of the letter</a:documentation> > <oneOrMore><ref name="db.all.blocks"/></oneOrMore> > </element> > </element> > </start> > </include> > </grammar> > > This may be drifting off-topic. The main point I wanted to make is > that it is possible to have your custom schema but reuse Docbook as well, > via namespaces and relaxng with relatively little effort. > > --Craeg > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
