Actually Bob, the ant build file for the documentation is completely
separate so when Tony provides a new ant build file (or some other build
script for that matter), we can throw out the old one completely.
The only argouml-specific magic is in the copying of the figure files to
reduce the size of the html published copy, and some special fixes to
improve the fop output for tables. If the tools are upgraded to Docbook 5,
the fop fixes won't be needed (others might be). The copying of the figure
files is probably best replaced by restructuring of the documentation having
the Cookbook figure files in the Cookbook directory, the User Manual files
in the User Manual directory and removing all files that are no longer used.
/Linus
2007/11/30, Bob Tarling <[EMAIL PROTECTED]>:
>
> I suspect if you could supply a separate ant build file specifically
> for building docbook then either someone else can merge this or we can
> keep this separate and call your ant script from our main build.
>
> Regards
>
> Bob.
>
>
> On 30/11/2007, Tony Rogers <[EMAIL PROTECTED]> wrote:
> >
> > I've got the following as valid DocBook v5:
> >
> >
> > cookbook
> > manual
> > quickstart guide
> > faq However, although building the documentation now succeeds for me,
> the
> > existing buildfile/stylesheets don't output most of the documentation
> they
> > are supposed to. This is due to a combination of the different lexicon
> of
> > DocBook 5, and to the XSL not understanding things like XInclude.
> >
> > I've solved the XInclude problem before on a personal project, so I
> went to
> > look at the XSL…and was absolutely overwhelmed by the complexity and the
> > number of XSL files.
> >
> > Then I went to the Ant buildfile to see if I could make some sense of
> > things, and the buildfile is equally intimidating. (And on top of that,
> > although I love the spirit of Ant and in my admittedly very, very
> limited
> > experience with build tools, I hate Ant's use of XML. It runs very
> > counter-intuitive to a great deal that I've learned about markup in the
> > past.)
> >
> > I could start by writing an HTML XSL from scratch, which is not a
> terribly
> > big deal for me. But I don't know if it would start to exceed my
> boundaries
> > as a newcomer to begin tinkering with the Ant buildfile or much more.
> >
> > I think it's starting to sink in that this is probably the most complex
> > project I've ever worked on, so I'm feeling a little out of my element.
> > Does anybody have some advice?
> >
> > -- Tony | "Zearin"
> >
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>
