rtf2html - a RTF to HTML conversion program
===========================================

This is a re-release (now under GPL, see COPYING) of Chuck Shotton's old
program from 1993. As stated by Chuck, it does not understand everything in
the RTF format, but is still useful.

Among the public tools I found on the net, it was simple, compiled 
immediately on my Linux, and was easy to understand. - After 2 hours I had the 
first patch in place.

It did not produce a ready-to-use file (and still does not), but for a MS Word
document with no graphics or tables, it produces a HTML file that requires only
a little editing. (I do that anyway to insert background graphics, links etc.)

I normally pipe the RTF file through d2u to convert line breaks first:

 bash$ d2u /dos_c/something.rtf | rtf2html > something.html

The patches included are:

 - Escaped national chars (e.g. "\'e5") passed to HTML file as single char's.
   (Could be replaced by "&"-entities, but I use another tool for that.)
 - Hyphenation codes are ignored. (Caused text to be lost.)
 - "&"-entities fixed (";" added).
 - "random" line breaks in RTF text are ignored, and line breaks are added to 
   some tags to restore a reasonable formatting. (Caused random split of the 
   word hit by some buffer limit in Word's RTF write routine.)

So, here it is. Use it if you like!


Mogens Dybaek Christensen (mdc@pip.dknet.dk)
Software engineer
Ishoej, Denmark, Feb 09, 1999

---------------------------------------------------------------------------

Original ReadMe by Chuck Shotton:
=================================

This is the first cut at a RTF to HTML converter. It has several limitations
that users should be aware of. First, unless you want to make some changes
to tables within the source, you need to use the style sheet that is
defined in Sample.rtf to format your Word documents. It's easiest to just
start with Sample.rtf as your basic document and cut out what you don't
need.

rtf2html is dependent on the style numbers in the style sheet matching those
in the conversion table in the code. This is an UGLY hack, but I really 
didn't want to parse the style sheet. Hey, it's free.

To build the code, type "make". This code should build on anything with a
C compiler. It was written on a Mac using Think C and moved to Unix with
no changes.

Please send any comments or suggestions to cshotton@oac.hsc.uth.tmc.edu.

Chuck Shotton
Ass't Director, Academic Computing
U. of Texas Houston Health Science Center
