Re: FAQ formatting

---------

Jeff Knapp (director@gti.net)
Mon, 27 Jan 1997 18:58:16 -0500


So then, on 27 Jan 97, Amy Sheldon said...

> Well, actually, I *am* managing to maintain a plain ASCII and HTML
> version of my FAQ with just one garden-variety word processor file
> (an old DOS-based version of WordPerfect), and I do the
> conversion each month with only one command. It is definitely
> a "somewhat kludge-y" method, though, and took forever to set
> up properly.

I do the same thing.

I use WordPerfect 5.1 to maintain my FAQ. it also converts indented text
to spaces, so the conversion to ASCII is handled like I want. I don't
concern myself with how many spaces does Browser X use as a tab width,
etc...

I use the autonumbering feature to keep order among the parts and
basic macros ease the renumbering between parts.

For the HTML, I run the ASCII parts through two PERL filters, the first,
TXT2HTML converts all the internal mailto, etc. to HTML. Then I hand edit
each heading with appropriate levels , H1, H2, etc. and run TOCHTML on it,
which creates the Table of Contents at the top.

I *could* leave it at that, but then I hand tune the paragraphs with
various indents, etc. (blockquote is my friend) and other links I like or
that people would find helpful -- i.e., I'll mention an actress, then
link her name to her entry in the Internet Movie Database (or use
their linking service to do it for me...)

But, I also keep the ASCII version at my web site so people can grab that
for easy downloading or printing or whatever they need a text version for.

Jeff
Jeff Knapp
director@gti.net

I was once walking through the forest alone.
A tree fell right in front of me -- and I didn't hear it.



[ Usenet Hypertext FAQ Archive | Search Mail Archive | Authors | Usenet ]
[ 1993 | 1994 | 1995 | 1996 | 1997 ]

---------

faq-admin@landfield.com

© Copyright The Landfield Group, 1997
All rights reserved