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]
