Niclas Hedhman wrote:

> On Tuesday 22 June 2004 05:29, Farr, Aaron wrote:
>
>
>> I think there has been a lot of investment in the current xdoc format
which
>> is has become fairly standard.  
>
>
>
> Problem is that it is NOT a 'fair standard'. And if you think otherwise, 
> please direct me to the authority specification or DTD.


http://jakarta.apache.org/velocity/anakia.html
http://jakarta.apache.org/site/jakarta-site-tags.html

xdoc is based on HTML will only a few changes:
  <document> instead of <html>
  <properties> instead of <head>
  new <section>, <subsection> and <source> tags

everything else passes right through as normal HTML.  There's been requests
for a DTD but I don't think anyone has taken the time to write one.  I don't
think it would be that hard.  Most of it would just be copying the HTML
spec.

I'm not quite sure where the navigation.xml is documented though.  Maven
expanded the use of the navigation.xml to include things like search boxes
and footers.

> Personally I would like to see a transfer to a more 'official' format, 
> whether SimplifiedDocBook, Forrest format or something else, is not as 
> important as the need for a defined standard, and not the current mesh of 
> html++


Either Forrest or SimplifiedDocBook would be fine.  The reason Anakia XDOC
has taken off is because it's so simple.  If someone knows HTML you can
teach them the xdoc format in a matter of minutes.  Forrest and
SimpliedDocBook are a little more complicated.

Personally I like DocBook a lot and use it for just about any large document
authoring I do.

jaaron

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to