diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/rtf2latex2e/README |
Initial commit
Diffstat (limited to 'support/rtf2latex2e/README')
-rw-r--r-- | support/rtf2latex2e/README | 134 |
1 files changed, 134 insertions, 0 deletions
diff --git a/support/rtf2latex2e/README b/support/rtf2latex2e/README new file mode 100644 index 0000000000..8eb50b84f8 --- /dev/null +++ b/support/rtf2latex2e/README @@ -0,0 +1,134 @@ +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. |