Re: FAQ formatting

---------

Jim Taylor (JHTaylor@videodiscovery.com)
Mon, 27 Jan 1997 19:59:00 -0800


On Mon, 27 Jan 1997, Scott Norwood wrote:

> On the other hand, I feel _very_ strongly that if a FAQ must be
available
> in any single format, it _must_ be plain ASCII.

I agree. But I also feel that the HTML version is so much easier to read
(since I have dozens of internal section links, boldface, italics, etc.)

I update my FAQ
<http://www.videodiscovery.com/vdyweb/dvd/dvfaq.html> a few times
a week, so I want the process to be as easy as possible. Since I can
keep the Web version up to date, I keep the FAQ in HTML format (and edit
it with the wonderful BBEdit on the Mac). When it comes time to post it I
simply save as text from Netscape, which wraps the lines, indents the
lists, etc.

I agree with the suggestion of spelling out links for the ASCII version and
putting them in anchor tags for the HTML version:

More info at <A HREF="link.com">&lt;link.com&gt;</A>.

I do this for the most useful links, the others that I have in the HTML
version without explicit text links get stripped out:

see section <A HREF="#1.5">1.5</A>

becomes

see section 1.5.

This all works very well with a minimum of fuss come posting time.

______________________________________________
Jim "The Frog" Taylor, Director of Information Technology
<mailto:jhtaylor@videodiscovery.com>
Videodiscovery, Inc. - Multimedia Education for Science and Math
Seattle, WA, 206-285-5400 <http://www.videodiscovery.com/vdyweb>



[ 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