| 1 |
1. Overview |
| 2 |
|
| 3 |
This is RTF to HTML converter version 0.1.0. |
| 4 |
Copyright (C) 2003 Valentin Lavrinenko, [email protected] |
| 5 |
|
| 6 |
Its primary purpose is using by developers to add rtf to html |
| 7 |
converting functionality to their projects, although, end users |
| 8 |
can also find it useful. |
| 9 |
|
| 10 |
The main effort was made on processing the tables correctly, and it |
| 11 |
seems successful - all other programs I've seen do tables processing |
| 12 |
much worse. Moreover, at the moment, I haven't seen any file that |
| 13 |
displays correctly in MS Word, but crashes this program. |
| 14 |
|
| 15 |
For further information, go to |
| 16 |
http://www.sourceforge.net/projects/rtf2html |
| 17 |
|
| 18 |
|
| 19 |
2. Copying |
| 20 |
|
| 21 |
Distributed under LGPL license - see COPYING.LESSER, it must be |
| 22 |
in the archive. |
| 23 |
|
| 24 |
|
| 25 |
3. Compiling |
| 26 |
|
| 27 |
- Under UNIX: |
| 28 |
Just ./configure && make && make install. The program seems |
| 29 |
to work much (about 2 times) faster when compiled with STLPort |
| 30 |
STL implementation than with the GNU one. So, you may use |
| 31 |
--with-stlport configure option if you have it installed. |
| 32 |
|
| 33 |
- Under MS Windows: |
| 34 |
Use MSYS/MinGW, use it the same way as in UNIX. |
| 35 |
No makefiles for other Win compilers are included yet, so, |
| 36 |
write it yourself, if you want - it isn't that hard. |
| 37 |
BCC is no longer supported! |
| 38 |
|
| 39 |
4. Installation |
| 40 |
|
| 41 |
No binary distribution for Unix/Linux is provided - just |
| 42 |
compile the program from source (see above). You can, however, |
| 43 |
download a binary package for MS Windows from the project page, |
| 44 |
http://www.sf.net/projects/rtf2html. |
| 45 |
|
| 46 |
5. Usage |
| 47 |
|
| 48 |
5.1 Command-line options |
| 49 |
|
| 50 |
rtf2html -v|--version |
| 51 |
|
| 52 |
prints the current version. |
| 53 |
|
| 54 |
rtf2html -h|--help |
| 55 |
|
| 56 |
prints the help. |
| 57 |
|
| 58 |
rtf2html [<rtf file> [<html file>]]. |
| 59 |
|
| 60 |
Converts the file. If either of files is not specified, |
| 61 |
the corresponding std descriptor (stdin or stdout) is used. |
| 62 |
|
| 63 |
5.2 Supported features |
| 64 |
|
| 65 |
This version supports the following: |
| 66 |
- Character formatting: bold, italic, underline, sub- and superscripts. |
| 67 |
NOTE: underlining is displayed only as solid. |
| 68 |
- Paragraph formatting: horizontal alignment, indentation, margins. |
| 69 |
- Table formatting: arbitrary cell spans, cell sizings, borders, |
| 70 |
vertical alignment in cells. |
| 71 |
NOTE: borders are displayed correctly only under IE 5+ and only |
| 72 |
as solid. |
| 73 |
- Page formatting: page width, left margin. |
| 74 |
- Hexadecimal character codes (Cyrillic letters would come out in |
| 75 |
win1251) |
| 76 |
- Font faces and sizes. |
| 77 |
- Foreground and background colors, highlighting. |
| 78 |
|
| 79 |
5.3 Unsupported features |
| 80 |
|
| 81 |
This version DOES NOT support the following: |
| 82 |
- Character sets. |
| 83 |
- Hyperlinks. |
| 84 |
- Images. |
| 85 |
- Different stuff like macros, embedded OLE objects, etc. |
| 86 |
|
| 87 |
|
| 88 |
6. Compiling notes. |
| 89 |
|
| 90 |
The source was compiled with |
| 91 |
- gcc 3.3 under ALT Linux Master 2.4 on i386 |
| 92 |
- gcc 3.4.2 (MinGW) under Win2k |
| 93 |
|