Subject:
|
Re: [faq FAQ How do I format an entry in the Lugnet FAQ?]
|
Newsgroups:
|
lugnet.faq
|
Date:
|
Wed, 14 Jul 1999 19:40:40 GMT
|
Reply-To:
|
jsproat@io!saynotospam!.com
|
Viewed:
|
4405 times
|
| |
|
|
Luis Villa wrote:
> This might not be my place to suggest, as I have not yet contributed anything,
But isn't this a contribution? :-,
> but is there some particular reason why we are custom designing out own thing,
> instead of using a standardized format which already has conversion tools, like
> Docbook?
Well, we are and we aren't using standardized formats. BTW, I've never
heard about Docbook; I'd like to hear more.
The FAQ format was chosen as a compromise between using a format many people
are already familiar with, and being able to smoothly integrate the FAQ into
the LUGNET heirarchy. It (the FAQ format) is based on already-existing and
widely-used standards, and is essentially broken into two parts:
...The Header section, which follows basic Internet header protocol,
enabling quick and painless parsing of the file's meta-information.
...And the Body section, which consists of a (soon-to-be) well-defined
subset of HTML. Restricting the type of HTML used in the body will enable a
good-looking and well-formed output in true HTML and text, as well as a
plethora of other output options as they present themselves.
Because of these choices of standards, the FAQ format presents several
benefits for the authors.
> P.S. If you want to check out a useful example of Docbook (well, linuxdoc, but
> same general idea), check out my Mindstorms LegOS HOWTO at:
> http://arthurdent.dorm.duke.edu/HOWTO/HOWTO.html
This link seems to be broken. The server gives me the "file not found"
error.
Cheers,
- jsproat
--
Jeremy H. Sproat <jsproat@io.com>
http://www.io.com/~jsproat
Darth Maul Lives
|
|
Message is in Reply To:
 | | Re: [faq FAQ How do I format an entry in the Lugnet FAQ?]
|
| This might not be my place to suggest, as I have not yet contributed anything, but is there some particular reason why we are custom designing out own thing, instead of using a standardized format which already has conversion tools, like Docbook? (...) (25 years ago, 14-Jul-99, to lugnet.faq)
|
86 Messages in This Thread:
 
 
 
- Entire Thread on One Page:
- Nested:
All | Brief | Compact | Dots
Linear:
All | Brief | Compact
|
|
|
|
