[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

MHonArc ATOM 1.0 rcfile example

Hello All,

I recently implemented Jeff Breidenbach's RDF feed rcfile that many of
us are using to create news feeds from MHonArc.  I noticed though, that
Internet Explorer 7 (IE7) cannot seem to read this older format as a
valid feed when found via autodiscovery, so I wrote two new rcfiles
which seem to work well -- this one is is for ATOM 1.0, and my next post
is for RSS 2.0.  In testing, they both work just fine with IE7.
Admittedly, I'm not much of a coder, so if anyone would like to chime in
and refine these scripts, please feel free.  Good comments and input
help the whole MHonArc user community.

Please note the following items:

  -You will need to change "www.example.org", "YourArchiveName", "Your
Title", etc. in the code to be appropriate for your particular needs.

  -You may need to define a MIME type for ".atom" as "text/xml"

  -All times are scripted in GMT.  This should work fine for most feed
readers, including IE7.

  -Hint: To create this additional index (feed), look at the
documentation for the OTHERINDEXES resource.

  -It is possible (and IMHO preferable) to continue to generate your
existing RDF file (if applicable) to support any readers who currently
subscribe to that feed. You may call multiple additional indexes/feeds
with the OTHERINDEXES resource.  Alternatively, you could create a
manual RDF file announcing the replacement feed and point users to the
new feed URL.

  -Hint: You will need to run MHonArc via the "MHA-PREVIEW.PL" command
in order to generate the previews/summaries of the messages needed by
this rcfile.

  -Feeds may fail validation at http://feedvalidator.org based on the
output of $X-MSG-PREVIEW$ in the <entry>|<summary> field. If the first
character of the output is a space or other unacceptable character, the
validator may point this out as an error. In my experience, this does
not affect many (if any) feed readers.

  -To add the "autodiscovery" of the feed by browsers, add the following
code to the <IdxPgBegin> and <TIdxPgBegin> (and optionally, the
<MSGPGBEGIN>) sections of your -MAIN- rcfile, placed within the <HEAD>
code:  <link rel="alternate" type="application/atom+xml" title="Atom
1.0" href="http://www.example.org/YourArchiveName/maillist.atom"/>

  -Chances are that you are finding this script in a MHonArc Users
archive. Current revisions and bug fixes to this rcfile may be found at
the following permanent URL:

I hope these files will be as useful to others as the RDF rcfiles by
both Jeff and David have been to me.


-Dave Stragand

* - * - * - * - * - * - * - * - * - * - *









<!-- This is a MHonArc rcfile, which is designed to
     generate ATOM 1.0 output. 

     Written by Dave Stragand, dave(_dot_)stragand(_at_)
     forwardlook(_dot_)net, 2007-04-10, v. 1.0.  Based
     upon the original RDF MHonArc rcfile created by
     Jeff Breidenbach, jeff(_at_)jab(_dot_)org, Aug 26, 1999,
     v. 1.0 and David Gibbs' midrange.com mailing list archives
     RDF RC file example posted at 

     Current versions of this rcfile may be found at

<!-- ------------------------------------ -->
<!-- Section 0: Configuration adjustments -->
<!-- ------------------------------------ -->

<!-- How many messages do we want on the ATOM index? -->

<!-- What file shall we write the ATOM 1.0 index to? -->

<!-- ------------------------------ -->
<!-- Section 1: Specify ATOM markup -->
<!-- ------------------------------ -->

<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom";>

    <title>Your Title</title>
    <subtitle type="text">Your Subtitle</subtitle>
    <link href="http://www.example.org/YourArchiveName"/>
    <link rel="self"
      <name>Feed Provider Name</name>

    <title type="html">$SUBJECTNA$</title>
    <link href="http://www.example.org/YourArchiveName/$MSG$"/>
    <summary type="html">$X-MSG-PREVIEW$</summary>


<!-- ----------------------------------------------------- -->
<!-- Section 2: Remove any HTML left from default settings -->
<!-- ----------------------------------------------------- -->





<!-- --- -->
<!-- End -->
<!-- --- -->

[Index of Archives]     [Bugtraq]     [Yosemite News]     [Mhonarc Home]