ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Bill Burton <>
Subject Re: CSS-styled version of docs [was: ant xdocs! it ran!]
Date Tue, 18 Feb 2003 07:21:16 GMT
Hello Stefan,

Stefan Moebius wrote:
> Ok, here we go. Check out
> I've overhauled the file Bill sent and I think the gain in file size
> alone (17kb + 2kb css vs. 33kb) was worth it :-)
> A few notes:
> - The file currently contains the css. This should of course be moved
> into a seperate file.


> - All headings now really *are* headings (<h1>/<h2>).


> - The list of nested elements is a definition list (<dl>). I'm not
> entirely sure if that's appropriate. What are the
> <description>/<short-description> blocks supposed to provide?

They shouldn't be there.  Must be a problem with the task.dvsl stylesheet.

> - The file validates as HTML 4.01 Transitional (except for those
> description tags)


> I've tested it with Mozilla, IE5.5, Opera 6.05 and 7 and it basically
> looks equally good in all of them. The only problem is NS4.x: Among
> others, I don't know a way to trick NS4 into treating <hX> as block
> level element or otherwise extending it across the whole width.
> Personally I think it looks better in NS4 without any styles at all. To
> try it, just switch of the style sheet support. 
> Well, have a look and let me know what you think.

This is great!  I'll look at integrating it into the task.dvsl stylesheet 
  but it will probably be a few days anyways as I'm snowbound through 
tomorrow and will need time to catch up on other work.

> Stefan


> --- Bill Burton <> wrote:
>>Stefan Moebius wrote:
>>>--- Bill Burton <> wrote:
>>>>Navigation could easily be generated for each page.  The layout
>>>>really be done with CSS instead of tables.  This would provide more
>>>>flexibility such as hiding the navigation when the page is printed.
>>>I totally agree. And this way, the index could even be made sticky.
>>>you need any help regarding HTML/CSS, let me know.
>>Yes, that would be greatly appreciated as I'm not yet well versed in 
>>using CSS for layout.  If you or someone would like to refactor the 
>>attached HTML file to use CSS, that would be a big help.  Then these 
>>changes could then be applied to the proposal/xdocs/dvsl/task.dvsl 
>>Some work has already been done in this area for Ant's site pages. 
>>Attached is the DVSL transformed XML for the <javac> task.  It's in
>>format to keep from (hopefully) being stripped from the message.  For
>>some reason, gump is not pulling in the associated javac.xml file so 
>>that version has the javadoc alone without the content merged XML
> =====
> Stefan Moebius       <> 
>   Wurzener Str. 43        +49 351 8475827
>   01127 Dresden           +49 172 8739617

View raw message