Author : Hctor Santos, Santronics Software
Title  : Wildcat! RSS News Syndicator
Date   : 01/08/2006
Updated: 05/01/2006
Version: 2.1

o Files:

   wct-rss.wcx             RSS module
   rsslib.wcx              RSS RDF news parser
   rss\rssheadlines.htm    RSS HTML Template
   http\public\news.wct    example news page
   webget.exe              Utility to fetch web pages (RSS/XML feeds)
   getrss.cmd              Batch file to get RDF files
   wcrsssrc12.zip          wcBASIC source code
   wcxml.dll               XML Parser

o History:

   v0.0   - Original version without wcxml.dll xml parser

   v1.1   - First version with wcxml.dll xml parser.

   v2.1   - Cleaned up version of wcxml.dll xml parser.
            New option "A".  See the INTPAD options.

o How it works:

WCT-RSS.WCX is a wcBASIC module that you can run from any wildcat! html
page (extension WCT).  To run it, add a macro

   @MODULE RSS filename [options]@

where

   filename is the name of the RSS/RDF XML file.

   options  is various options described below.

Note, the WCT command MODULE is the same as RUNWCX but MODULE always add
the prefix "WCT-" to run the WCX. So using MODULE will run WCT-RSS.WCX.
You can also use the RUNWCX module directly:

   @RUNWCX WCT-RSS filename [options]@

Either will work.

The filename most be stored in the directory RSS\ off the Wildcat! root
directory.

The options can be one or more of the following:

  I       Show Provider Image, if any
  N       Show Provider Name, if any
  T       Show Provider Title, if any
  P       Show Provider Date, if any
  A       Show Item Date, if any  (new in v2.1)
  D       Show Item Description, if any

The default is ALL of them (INTPAD).

So typing:

   @MODULE RSS cnet_downloads.rdf@

is the same as:

   @MODULE RSS cnet_downloads.rdf INTPAD@


If you want shorter output and just show the provider Image, Name and
Title, you can use:

   @MODULE RSS cnet_downloads.rdf INT@

If you don't want the image, remove the I from the options.


How to get RDF files:

WEBGET.EXE is a utility to get RSS/RDF files from news sites who provide
them.  Here is an example for CNET reviews listing:

  webget reviews.cnet.com  /4924-5_7-0.xml  > rss\cnet_reviews.rdf

Note how we redirect the output into RSS\cnet_reviews.rdf.  When you
use the MODULE command, only use the file name:

    @MODULE RSS cnet_reviews.rdf@

You can put all your news files in a batch. The GETRSS.CMD has an
example listing of WEBGET.EXE commands for various sites. Note: Some of
feeds may be old.

See the example page NEWS.WCT for an example news page using various
news sites.

Have fun!
