Debian Codegraph @

thirdparty/rtf2html/README

raw
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