FAQ Maintainers Mailing List
Re: [faq-maintainers] URL: Header

---------

From: Kent Landfield (kent@faqs.org)
Date: Wed Jan 23 2002 - 17:23:17 CST


# The established practice is clearly to use multiple URL: auxiliary
# headers.
#
# I went to http://www.faqs.org/faqs and used the "headers only" search
# for the word "URL". Bit of a brute force approach, but it worked. There
# are over 1400 postings with a URL header.

:) Smart thinking...

The concern for faqs.org isn't the conversion of the URL in the faq, it is
the index pages I generate here. For example. If you have more than one URL:
auxiliary header you get multiple links generated on the index pages.
Below is an example, a FAQ Home Page: (the first one encountered in the
file) and an Alternate Page: for the other URL: headers discovered.

    de-newusers/dana-manual
    Subject: <2001-04-29> Erlaeuterungen zur Einrichtung neuer Gruppen in de.*
    Maintainer: faqs@roxel.ms.sub.org (Dirk Nimmich)
    FAQ Home Page: http://www.afaik.de/usenet/faq/dana-manual/
    Alternate Page: http://www.kirchwitz.de/~amk/dai/dana-manual
    Last Posted: 16 Jan 2002 23:00:02 -0000
    Last-modified: 2001-04-29
    Posting-Frequency: weekly

# I counted multi-part FAQs as one, since in most cases the same usage
# applied to all parts. Had I counted all parts, the counts would have
# been about 40 to 10. (The one that uses the comma-delimited style is
# the 10-part palmtops/newton FAQ. And it does not start the continuation
# lines with whitespace, as would be required for real headers.)

The way the software works on faqs.org, a URL: header with comma separated
references will work but will be listed as

FAQ Home Page: http://ref1, http://ref2, ...

AS LONG AS IT IS ON ONE LINE. Continuation lines are not supported at
present. i.e.

URL: http://www.geocities.com/newtonresurrection/indexqa.html,
 http://www.chuma.org/newton/faq/,
 http://www.cat2.com/newton/Newton-FAQ/,
 http://www.thisoldnewt.com/html/FAQ/,
 http://www.guns-media.com/mirrors/newton/faq/,
 http://www.splorp.com/newton/faq/

will produce a header of

    FAQ Home Page: http://www.geocities.com/newtonresurrection/indexqa.html,

and nothing else on the index page.

# As far as Kent's scripts on faqs.org, it doesn't seem to matter. The
# scripts find anything that looks like a URL in the posting, be it
# header, auxiliary header, or text. In all cases that I examined, the
# URLs had been properly converted to links.

Inside the faqs it will not matter. Only on the index pages I generate
locally. And then it is not really a big deal. If you get it "wrong"
(such as a multi-line URL: header) you are sill assured of at least a
single reference listed.

If it's a concern, I can add multi-line URL support. Currently the only
definition of the line is in the news.answers guidelines posting and
it seems to indicate a single URL reference on each URL: header line.
Whatever is decided is fine with me...

-- 
Kent Landfield                        Phone: 1-817-545-2502
Email: kent@landfield.com             http://www.landfield.com/
Search the Usenet FAQ Archive at http://www.faqs.org/faqs/
Search the RFC/FYI/STD/BCP Archive at http://www.faqs.org/rfcs/

************************************************************* To unsubscribe send a message to majordomo@faqs.org as

unsubscribe faq-maintainers fill-in-your-email-address-here *************************************************************



[ FAQ Archive | Search FAQ Mail Archive | Authors | Usenet References ]
[ 1993 | 1994 | 1995 | 1996 | 1997 | 1998 | 1999 | 2000
]

---------

faq-admin@faqs.org

© Copyright The Internet FAQ Consortium, 1997-2000
All rights reserved