Index of /archives/text/CTAN/support/rtf2latex2e

Icon  Name                         Last modified      Size  Description
[PARENTDIR] Parent Directory                                  -   
[   ] rtf2latex2e-2-0-1.zip        2011-02-05 18:23  1.2M  
[   ] rtf2latex2e-2-0-1-Win.zip    2011-02-05 18:23  660K  
[TXT] README                       2011-02-05 18:24  5.0K  

This is rtf2latex2e version 2.0 that

 1. detects text style: bold, italic, color, big, small,...
 2. reads embedded figures: PICT, EMF, GIF, TIFF, WMF, PNG, JPEG
 3. reads tables: simple to semi-complex
 4. equations: converts embedded MathType equations
 5. symbols: converts most greek and math symbols
 6. reads footnotes (not in tables yet)
 7. translates hyperlinks using the hyperref package
 8. converted latex file uses utf8
 9. supports codepages 1250, 1251, 1252, 1254, mac, NeXt
10. converts RTFD (rtf directories)
11. extended preferences
12. internal document page references
13. save all converted files in a separate directory

The package rtf2latex2e-2-0-1.zip contains the source code, the data files,
the documentation and some rtf files for testing.

The package rtf2latex2e-2-0-1-Win.zip contains the compiled executable 
for Windows (latex2rtf.exe), the data files, and the documentation.

WHAT YOU WILL GET:
=============
rtf2latex converts an RTF file to LaTeX and saves any image
files found inside.  Using pdflatex on the resulting latex
file will require that these images be converted by you to 
some image format supported by pdflatex. 

If you expect a WYSIWYG reproduction of your RTF file, you may be 
disappointed. My main concerns have been translating the essential 
features of the RTF file such as characters, figures, tables, and 
equations (as pictures).  I have largely ignored visual formatting 
such as ruler positions, tabs, paragraph indentations, and other fluff.  
Expect the output LaTeX file to require manual editing to put the finishing 
touches.  I just want to make that task a little easier.  In my opinion, 
expecting a WYSIWYG reproduction is not practical and misses the point 
entirely.

The user has some control over how good the visual fidelity is.  For
example

prompt> rtf2latex -t 0 -p 0 test/test.rtf

will produce a file 'test/test.tex' that has no paragraph formatting
or text formatting.  Two other useful variants are

prompt> rtf2latex -n test/test.rtf

which makes a file with reasonable latex mark-up.  Fussy details about
paragraph indenting and spacing are left to latex and some work will be
needed to identify paragraphs that should not be indented, etc.,  Finally

prompt> rtf2latex -b test/test.rtf

will try all sorts of things to get the formatting correct.  This comes
at the expense of extensive formatting ``noise.'' 

Typeset the rtf2LaTeXDoc.tex for more information, or print out the 
rtf2LaTeXDoc.pdf file. They are in the documentation directory.

The file Release-notes.txt usually has more up-to-date info.

INSTALLATION AND USE:
=====================
rtf2latex2e was developed on under Mac OS X but should compile
under any Unix variant.  Windows users should compile under something
like MinGW or download the rtf2latex2e-2-0-1-Win.zip package.

To build rtf2latex2e, 
change to the Unix directory, type:

make
make test
make install (optional, as root)

MacOS X users should remove '#' on the Makefile lines before building
to get automatic translation of .pict files to .pdf files.

#CFLAGS  :=$(CFLAGS) -m32 -DPICT2PDF
#LDFLAGS :=$(LDFLAGS) -m32 -framework ApplicationServices

By default the executable is installed as /usr/local/bin/rtf2latex2e.
Support files will installed in /usr/local/share/rtf2latex2e

You can change the directory into which rtf2latex2e is installed by editing the 
variable PREFIX in the Makefile. You may need to become 
super-user to install into that directory. If you do not have super-user 
privileges, you can change the PREFIX to somewhere in your home directory, 
say $(HOME)/rtf2latex2e. 

WINDOWS:
--------
Windows users get a pre-compiled binary of rtf2latex2e to be run 
from the command prompt. 


THE r2l-pref PREFERENCE FILE:
=============================
rtf2latex2e reads a preference file r2l-pref that allows one to specify 
many settings.  Read the comments in the preference file for details.

THE r2l-head file:
==================
Allows you to insert text directly into the preamble of the converted
doument.  

THE r2l-map file:
==================
Allows some direct mapping of paragraph styles to latex commands.  There
are only three styles defined at the moment.  These convert the style
'heading 1' to \section

LEGAL STUFF:
============
(c) Ujwal S. Sathyam and Scott A. Prahl, 1999, 
(c) Scott A. Prahl, 2011

The author provides this software as is and does not take any responsibility 
for the consequences of running it (unless it is good, of course...). This is 
beta software, so treat it as such.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

The writer and driver parts of the code are copyright Ujwal Sathyam.
The reader part of the code was written by Paul DuBois of the Univ. of 
Wisconsin Primate Center.