FAQ maintenance aids

---------

David Alex Lamb (dalamb@qucis.queensu.ca)
Wed, 21 Dec 94 09:18:02 EST


Here's a brief progress report on the "FAQ maintenace aids" WWW page I
mentioned I was starting:

- It's at http://www.qucis.queensu.ca:1999/~dalamb/FAQs/
- It'll be available via FTP and mail server eventually but probably not this
week.
- I recall several FAQ maintainers talking recently about their own FAQ
maintenance aids; I'd appreciate pointers to more information.
- Here's the current contents of the index. There are of course embedded HTML
pointers to other info which doesn't come across in this (which I created by
doing a "Save As" in xmosaic).

FAQ Maintentance Aids
*********************

Tools to help with automatic FAQ posting, including superseding the
previous posting:

o Jonathan Kamens' post_faq.pl PERL script. It generates
appropriate headers to ensure a later posting supersedes an earlier
one, and can thread together a multi-part FAQ.
o Ian Kluft's auto_faq script. Lets you keep the body of the FAQ
in a text file with no headers, and generates all headers from a
configuration file.

HTML FAQs
=========

There are several strategies for making an HTML version of a FAQ
available:

o Keep the information in HTML, and use your browser's Save
As or lynx -dump to generate the flat ASCII.
o Convert your existing ASCII FAQ to HTML. There are several
aids, including:
o The filter Tom Fine uses to maintain the HTML FAQ list.
If you're posting to news.answers, you're using this one
automagically.
o Pamela Greene's makefaq.pl Perl script, used to maintain
the Ferret FAQ
o Keep some yet-more-generic version from which you generate
both ASCII and HTML:
o The Free Software Foundation's texinfo format; you
can generate GNU EMACS info files, ASCII, DVI,
PostScript, HTML, and AmigaGuide formats.
o Matt Welsh' linuxdoc-sgml; keep an sgml-tagged
document and generate ASCII, HTML, or Postscript.
o latex2html sort-of fits into this category. You could use
lametex to convert to ASCII.

Other Information regarding FAQs
================================

o Inclusion of FAQs in the Walnut Creek CDROM



[ 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