Tree [r286] /
History



File Date Author Commit
doc 2013-04-15 whennings [r286] (Prahl) some fixes
pref 2012-06-26 whennings [r259] Makefile modification for MS Windows
src 2013-04-15 whennings [r286] (Prahl) some fixes
test 2012-06-16 prahl [r252] fix fonttable, fix v3 eqn
.gitignore 2012-10-30 prahl [r285] adding .gitignore
Makefile 2012-08-16 prahl [r274] build fix for linux, inlucd math library when l...
README 2013-04-15 whennings [r286] (Prahl) some fixes
Readme_Windows.txt 2012-06-28 prahl [r263] add mising files to distribution
ToDo 2012-06-28 prahl [r266] documentation updates
emf2pdf.bat 2012-07-05 whennings [r273] updated emf2pdf.bat to allow blanks in folder n...

Read Me

Release 2-2-2 adds conversion of Word's EQ fields
and fixes the missing -lm flag in the gcc compiler call in Makefile

This is rtf2latex2e version 2.2 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 and EQ fields
 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

WHAT YOU WILL GET:
=============
rtf2latex2e 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> rtf2latex2e -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> rtf2latex2e -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> rtf2latex2e -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.

As of version 2.2.0, rtf2latex2e uses unoconv to convert EMF, WMF, 
and PICT images to PDF files.  unoconv in turn use LibreOffice to
do the actual conversion.  

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

make
make test
make install (optional, as root)

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 rtf2latex2e.exe to be run 
from the MS-DOS 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, 2012

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.