ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dominique Devienne" <DDevie...@lgc.com>
Subject RE: Re: Prototype work on XML+XSL based Ant doc
Date Mon, 28 Mar 2005 15:38:05 GMT
> From: news [mailto:news@sea.gmane.org] On Behalf Of Jesse Glick
> 
> One minor request - that whatever the format is, it would be nice to
be
> able to construct JavaHelp output easily (probably with added or
perhaps
> 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
produce
> a JavaHelp help set from a set of HTML files by hand-editing TOC and
map
> 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: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org


Mime
View raw message