ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gintautas Grigelionis <g.grigelio...@gmail.com>
Subject Re: Ant documentation
Date Thu, 01 Mar 2018 21:31:21 GMT
2018-03-01 10:43 GMT+01:00 Jan Matèrne (jhm) <apache@materne.de>:

> > > I made an attempt to convert the manual to HTML 5, the rationale
> > being
> > > that HTML 5 deprecates tt tag and recommends to replace it with tags
> > > like code, kbd, samp and var, which could be used in a more
> > consistent
> > > way to achieve something closer to a semantic markup.
> > >
> > > I tried then to use the replacement tags as consistently as possible
> > > in such a large body of text, but I realised that we perhaps need a
> > > kind of a style guide. Would you like to discuss it? Where would it
> > > best fit in the source code tree?
> > >
> >
> > Isn't the HTML manual generated? Sure it's checked-in, but I thought
> > there was a generation process.
> > If that's the case (I may have dreamed it) then it's likely the
> > generator that needs fixing, not the build product. --DD
>
> No. There were some experiments and maybe some pages were generated during
> that experiment.
> But the manual is a manual work. (double manual ;)
> https://svn.apache.org/repos/asf/ant/sandbox/historical/xdocs/
>

One may use xdoc and generate html with Doxia by calling its CLI. However,
Ant sorely lacks a site generator on par with Maven site plugin.

Gintas

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message