ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dominique Devienne" <>
Subject RE: Re: Prototype work on XML+XSL based Ant doc
Date Mon, 28 Mar 2005 15:38:05 GMT
> From: news [] On Behalf Of Jesse Glick
> One minor request - that whatever the format is, it would be nice to
> able to construct JavaHelp output easily (probably with added or
> modified stylesheets). That means
> (1) Ability to have plain HTML output - JavaHelp does not render XHTML
> well, alas. ("<br />" is I think OK as well as "<br>", but the "<?xml
> ...?>" tag does not get handled.)

The current XSL uses output="html", so no XHTML. OTOH, doesn't JavaHelp
use the HTML viewer from the JDK, which is limited to HTML 3.x? Will it
support HTML 4.01 output?

  <xsl:output method="html" encoding="UTF-8" indent="yes"
              doctype-public="-//W3C//DTD HTML 4.01 Transitional//EN" />

> (2) Adequate metadata in every file to construct a table of contents.
> Not anything critical, since it is at worst possible to manually
> a JavaHelp help set from a set of HTML files by hand-editing TOC and
> files.

What kind of TOC? Most tasks/types have the same structure, description
+ attributes + elements + examples. Do we really need to repeat these
for every task/type in a TOC?

I'm a little torn right now between 'too verbose' and 'enough metadata'
in the XML vocab. I'm surprised at the lack of response from many
committers too. I don't think it bodes too well for this work. --DD

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message