On 20 Aug 2000, Grant Bowman wrote:
> I haven't looked at it yet. see http://ohs.sourceforge.net/a2h.tar.gz
> 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
-- +=== Eugene Eric Kim ===== eekim@eekim.com ===== http://www.eekim.com/ ===+ | "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