Welcome to rss2html version 0.1.1  (Come as You Are)



If you're unfamiliar with what's going on, here's the explination:

PHP can (apparently) autogenerate RDF files, in a format called RSS,
which are a meta file which explain HTML documents.  It's a really nifty 
way for sites to transfer links and such to each other.  However, 
if you want to use the RSS style RDF files and don't want to install 
all kinds of libraries, modules, or the like, it's impossible to 
easily parse these things.

rss2html comes in here by replacing the tags in the file with 
HTML, so you can go ahead and paste it into your website or use 
some script or whatnot to do that all for you.  As it comes, it understands 
the most basic RSS tags, such as <description>, <title>, <link> and the like, 
and also their corresponding closing tags.

Still confused?  There's an example at 
http://www.diablonet.net/~mercadal/common/derpsite.rdf, the output of 
which you can most definitely put on your website.



How Do I Start:

gcc *.c -o rss2html
-or-
cc *.c -o rss2html

That will leave an executable named rss2html in the distribution's 
directory.  Copy that to /usr/local/bin or wherever you want it to 
be.

Now that you've got it installed and you want to parse that darned 
RSS file that you're friend's got on his site, all you need to do 
is download the file and type (for example)

rss2html -i friendsphp.rdf -o friendsphp.html

which would leave you with a snippet of HTML in the output file there.
Maybe I can incorporate part of libcurl or the like in an upcoming 
distribution so rss2html would yank the RDF file off the web for you, 
process, and output it.



User-defined Actions for RDF Tags:

If, for some reason, you don't like the HTML that rss2html puts out 
for a tag, you can set an alternate tag file for your own use (by using 
the -u option)  For example, say every time an RSS <item> tag shows up you want 
rss2html to display an asterisk in the output file rather than 
the default nothing.  Well, then, you could make a new file with the line

item\*

in it, and feed that into rss2html.  Voila, instant asterisks!  Notice, 
the RSS tag has no little greater-than and less-than signs around it, 
whereas if you want to replace an RSS tag with an HTML element 
it must be exactly as you want it in the output file, such as:

item\<b>
/item\</b>

You can replace any input tag, although it's really suggested that 
you _don't_ redefine the actions of <title> and <link>.  If you do, and 
the program goes haywire (which it will), don't say I didn't warn you.  
However, everything else is fair game (yes, including </title> and </link>)

Other than all the tags whose actions you can define (or re-define), you 
can also define two things which you'd never find in any RSS file, these 
are *RDFSTART* and *RDFEND*, which will let you throw whatever HTML you 
want at the begining and at the end.  So, say you wanted to make 
everything some ugly font within the output file, you could add this 
to your user-defined file:

*RDFSTART*\<font face="Chicago,Chitown,Impact">
*RDFEND*\</font>

Included with the distribution is a file named myuser-defined, which 
is a (poor) example of what you can do with rss2html's user defined 
abilities.  As always, though, if you like the plain stuff that rss2html
usually puts out (and have no desire to learn anything about RDF or 
it's RSS subpart), you don't even have to worry about this feature.



Why Did You Choose \ as a Seperator?

Because I wanted something that most likely wouldn't show up in any 
HTML tags anyone wants to embed.  If, for some reason, this actually 
does exist within some HTML (or RSS) tag, well, get in touch with 
me and I'll find a more obscure seperation symbol.



Where's the Manpage?

I've realized that I'm not very good with mdoc files.  I'll write one up 
eventually, though, for now, this file will have to do.



It's Doesn't Work.

Well, if it simply doesn't work on a given RSS file because the tags 
therein are not defined, feel free to re-define them yourself.  However...

If you get Segmentation Faults, Bus Errors, Illegal Instructions, 
gcc: unable to parse errors, kernel panics, an itching, burning sensation, 
or something else that you think rss2html might be causing, feel free 
to e-mail me at charleschuck@mac.com.  Please, if you can, 
paste the error into the mail program, and tell me what system you're running 
it on, as well as anything else you think might help me.



What Can I Expect for the Next Version?

Probably a lot better RSS 1.0 specification support, now that I've found 
something approaching a white paper on this.  Hitherto, I was just testing 
it against whatever RDF output I could snag from friends, so make sure 
to keep you eye out for the latest version.



Changelog (since 0.1):
Revision 0.1.1 (16 February 2002)
	* Optimized file reading in BSD
	* More tag support



What License Is rss2html Under?

It's a BSD sytle license.  I'm no lawyer, if you need to know more, though, 
read LICENSE for the official explination of all your rights, my rights, and 
gosh knows what else.
