New Format for HTMLized FAQ -- Comments?

---------

William L. Goffe (bgoffe@whale.st.usm.edu)
Thu, 15 Jan 1998 20:32:39 -0600 (CST)


I do the FAQ for sci.econ.research. In the past, I've used LaTeX2HTML,
but am now on the road to a home grown tool. With the great help of a
Perl programmer I've hired, Colin Kuskie <colink@latticesemi.com> I'm
working on the new format.

See <http://wueconb.wustl.edu/~goffe/EconFAQ/EconFAQ.html> for the latest.
Not everything has been added at this point (the HTML is awful plain, for
one thing), but it is usable. I'd be quite interested in any comments (way
below my sig I've got several thoughts, but won't mention it here before
you take a look -- want to see what people think after you've tried out
the example). Please note that at this point, most of the new features are
in the "U.S. Macro and Regional Data" section. Plus, at this point, I'm
much more interested in form than substance, so some of the descriptions
are kinda off.

For a bit of background, the FAQ source is now marked up with home-grown
tags, and then a series of scripts process it. While I did the first
page by hand (the scripts generate one too, but without columns or the
header stuff), they take less than 10 seconds to execute to generate all
the HTML. It is a HUGE advantage over what LaTeX2HTML and all the post
processing I did to meet my needs requires.

We hope to have it finalized in about a month.

Bill

--
  .---.   Bill Goffe                                      Bill.Goffe@usm.edu
 (    |   Dept. of Econ. and International Business   office: (601) 266-4484
  )__*|   University of Southern Mississippi             fax: (601) 266-4920
    (_|   Southern Station, Box 5072
          Hattiesburg, MS 39406-5072                   

Here's one navigation thing I'd like to add:

If you were in, say, <http://wueconb.wustl.edu/~goffe/EconFAQ/USMacro/Fed/FRB_Atlanta.html>, at the top of page there would be the path:

| Title Page | U.S. Macro and Regional Data | Federal Reserve | and the ToC

with each clickable. The first would move you to <http://wueconb.wustl.edu/~goffe/EconFAQ/EconFAQ.html>, the second to <http://wueconb.wustl.edu/~goffe/EconFAQ/USMacro/index.html>, and the third to <http://wueconb.wustl.edu/~goffe/EconFAQ/USMacro/Fed/index.html>, and the ToC (will write out as "Table of Contents" -- short on space above) to <http://wueconb.wustl.edu/~goffe/EconFAQ/sc.html> (note how this is both the old "shortcut" page and the old table of contents).

Also, I think that the index pages should be done in tables -- they are a bit too crowded now. On the LHS would be the title, and on the RHS, what I call the short description (you get to the long description with [more]).

Finally, if anyone has a better idea for [more] I'm all ears. It needs to be short and clear -- maybe a gif of some sort, but what? Plus, this should probably be explained at the top of every index page.