ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jose Alberto Fernandez" <jalbe...@cellectivity.com>
Subject RE: sandbox gendoc
Date Fri, 13 Jan 2006 11:55:14 GMT
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: cstrong@arielpartners.com [mailto:cstrong@arielpartners.com]
> 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: dev-unsubscribe@ant.apache.org
> For additional commands, e-mail: dev-help@ant.apache.org


---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org


Mime
View raw message