Re: a2h Java Source Code Available

From: Eugene Eric Kim (
Date: Mon Aug 21 2000 - 00:26:43 PDT

On 20 Aug 2000, Grant Bowman wrote:

> I haven't looked at it yet. see
> and download it directly. More soon.

Great first effort, guys! Thanks to Shinya and Grant for pushing forward
on this.

I did a quick skim through the code, compiled it, and ran it on some of
the test files. Some comments:

  * The code was pretty clear, but we definitely need to translate those
    Japanese comments into English. :-)

  * The resulting HTML needs some work. This is definitely a very minor
    thing, and I wouldn't spend a lot of time modifying the code to do
    this, because the actual process we want is Augment->XML->HTML. This
    means modifying the code to produce XML, and then writing another
    translator that generates HTML from the XML. Ideally, this middle
    layer will use XSLT to do the translation.

    Nevertheless, I'll point out a few things that need fixing. First,
    every paragraph should have opening <p> and </p> tags surrounding
    them. Second, you shouldn't be using <ul> tags for indentation. I
    would recommend defining an approrpriate style class, and then using
    <div> tags for indented sections. I can show you how to do this if
    you'd like. For that matter, <font> information should also be in a
    stylesheet rather than embedded in the HTML. Finally, as a first step
    for XHTML conformance, tags should be lower-case, and attributes
    should be delimited by quotation marks.

  * It looks like there's some metadata near the top of the file that
    wasn't properly parsed. We can probably just ignore it; it looks
    like it's just typesetting information.

  * I noticed your sample Augment documents don't have SID and optional
    labels. We need to get you an updated sampling of documents, so that
    those can be incorporated as well. Grant, could you do this?

This is a great step in the right direction. We can use this immediately
to start dumping old Augment documentation and Doug's design notes onto
the web, and as the code gets tweaked, we can regenerate the HTML
documents. Nice work, Shinya!


+=== Eugene Eric Kim ===== ===== ===+
|       "Writer's block is a fancy term made up by whiners so they        |
+=====  can have an excuse to drink alcohol."  --Steve Martin  ===========+

This archive was generated by hypermail 2.0.0 : Tue Aug 21 2001 - 17:57:52 PDT