[Gzz] Asko 2002-12-17 (umldoc)

[Asko Soukka]

9 h workday
 - tuning UML-directive and making it work for pegboard
 - visited Saariluoma about master's thesis (probably about GUI for
   manipulating Mind Maps in hyperstructure), need to think about
   guidelines for prototyping (e.g. Linux+Gzz+PDA/Tablet/Digital
   sketchboard) until Jan 5:th.

Mon, 16 Dec 2002, Tuomas Lukka wrote:
> > Some problems occurred:
> >  - Metapost creates foo.1 and foo.log output files into current directory.
> >    These should get somehow into our temporary directory of all generated
> >    uml data. Environment variable TEXMFOUTPUT had no effect.
> Probably cd():ing into the temp directory is best.

Ok. I had problem with this today and currently RSTs are first converted
using jython (although only pegboard works like this for now) and later
diagrams are generated later python. I'll try that os.system() solution
tomorrow. Anyway, this problem was for good. I think I found quite
simple solution for the basic version of new umldoc.

How this should work after tomorrow:

The first pass
   when converting RST into HTML, the UML-directive .. UML:: foo
   writes foo.mp and foo.uml files into tmpdir and <!-- UML:foo -->
   into rst doctree, UML-refer will work alike, but don't foo.mp or foo.uml

The second pass
   reads all generated HTML-files, seeks for <!-- UML:foo --> tags, finds
   foo.pngs and foo.htmls from tmpdir and replaces <!-- ... --> with
   <img> tag and <imagemap>.

And after that:
   implement UML-refer

   implicit bi-directional links (e.g. diagrams into javadoc)
     should this be optional? option could be written into foo.uml (like
     jlinkpackage, generating these will be somewhere within the old
     uml.py code, probably where imagmaps are created

   focus-option, UML-directive could write this into foo-context.uml (like
     jlinkpackage), also comment would have context profix like
     like <!-- UML:foo-context -->, also bare foo.uml/foo.mp are written,
     I don't know yet how UML-refer with focus is handled this way...

     Well.. it could be easier to add "focus" into HTML-comment like
     <!-- UML:foo focused -->, need to think more about this

-- 
Asko Soukka     | Taitoniekantie 9 A 603 | address@hidden
+358-40-8235947 | FIN-40740 JYVÄSKYLÄ    | http://www.iki.fi/asko.soukka/