Re: UML tool (was: Re: [Gzz] Asko 2002-12-04/05 (OvalBgVob))

[Tuomas Lukka]

> Ok. Since javadoc is fully generated we could put png-files there (in
> javadoc-dirs), but even RSTs and generated HTMLs are in the same
> directories we don't want more generated data there...
> 
> We could have one directory for all documl-generated files, but then
> <img>-paths may look like "../../../../umltmp/foo-context.png".

That would probably not be a problem.

> > >   - if there is content for a new diagram, but the name specified by
> > >     argument is already used, the directive will refer the diagram
> > >     that already exists and outputs error about name conflict
> > Hmm... I think I'd prefer to have UML and UMLREF to make the distinction
> > absolutely clear.
> 
> Ok. But after the new diagram defined in UML-directive is created, it will
> be linked into the generated HTML-dokument like any other diagram is
> linked using UMLREF-directive.

Yes, absolutely.

> Now I wonder, how should the original context of
> some diagram be marked as Benja suggested?

Might be a good idea. Or that it would simply be the first in the top line.

> > I don't like the overriding business: having the same name twice should
> > be a fatal error.
> 
> But unique names are ok?

For UML diagrams? Yes.

> > >     + write <object>-tag into the document tree, <object> tag
> > >       will refer to a HTML-file in some specified directory,
> > >       the file could be named e.g. rstname-diagramname.html
> > And in the second pass, undo the <object> tag?
> 
> Rethinking this:
> - in the first pass we can add correct image-element and an empty
>   imagemap-element into the document tree of parsed RST
> - in the second pass we search the empty imagemap-tag according to its
>   name (or id in XHTML) and create the imagemap within it

> > > Some open questions for this approach:
> > >  - unambiquous naming for the output files
> > just pick a long enough random string.
> 
> I don't like the idea of fully random filenames.
> Maybe diagramname-randomstring.png, but no more :)

That's fine. Or if the diagram names are unique, ...

        Tuomas