tex2rtf.tex

很牛的GUI源码wxWidgets-2.8.0.zip 可在多种平台下运行.

\documentstyle[a4,makeidx,verbatim,texhelp,fancyhea,mysober,mytitle]{report}%
%\input{psbox.tex}
\newcommand{\commandref}[2]{\helpref{{\tt $\backslash$#1}}{#2}}%
\newcommand{\commandrefn}[2]{\helprefn{{\tt $\backslash$#1}}{#2}\index{#1}}%
\newcommand{\commandpageref}[2]{\latexignore{\helprefn{{\tt $\backslash$#1}}{#2}}\latexonly{{\tt $\backslash$#1} {\it page \pageref{#2}}}\index{#1}}%
\newcommand{\indexit}[1]{#1\index{#1}}%
\newcommand{\inioption}[1]{{\bf {\tt #1}}\index{#1}}%
\parskip=10pt%
\parindent=0pt%
%\backgroundcolour{255;255;255}\textcolour{0;0;0}% Has an effect in HTML only
\winhelpignore{\title{Manual for Tex2RTF 2.0: A \LaTeX\ to RTF and HTML converter}%
\author{Julian Smart}%
\date{November 1999}%
}%
\winhelponly{\title{Manual for Tex2RTF 2.0}%
\author{by Julian Smart\\$$\image{1cm;0cm}{tex2rtf.wmf}$$}%
}%
\makeindex%
\begin{document}%
\maketitle%
\pagestyle{fancyplain}%
\bibliographystyle{plain}%
\pagenumbering{roman}%
\setheader{{\it CONTENTS}}{}{}{}{}{{\it CONTENTS}}%
\setfooter{\thepage}{}{}{}{}{\thepage}%
\tableofcontents%

\chapter*{Copyright notice}%
\setheader{{\it COPYRIGHT}}{}{}{}{}{{\it COPYRIGHT}}%
\setfooter{\thepage}{}{}{}{}{\thepage}%

Copyright (c) 1997 Julian Smart.

Permission to use, copy, modify, and distribute this software and its
documentation for any purpose is hereby granted without fee, provided that the
above copyright notice, author statement and this permission notice appear in
all copies of this software and related documentation.

THE SOFTWARE IS PROVIDED ``AS-IS'' AND WITHOUT WARRANTY OF ANY KIND, EXPRESS,
IMPLIED OR OTHERWISE, INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF
MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.

IN NO EVENT SHALL JULIAN SMART OR THE ARTIFICIAL INTELLIGENCE
APPLICATIONS INSTITUTE OR UNIVERSITY OF EDINBURGH BE LIABLE FOR ANY
SPECIAL, INCIDENTAL, INDIRECT OR CONSEQUENTIAL DAMAGES OF ANY KIND, OR
ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
WHETHER OR NOT ADVISED OF THE POSSIBILITY OF DAMAGE, AND ON ANY THEORY
OF LIABILITY, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
PERFORMANCE OF THIS SOFTWARE.

\chapter{Introduction}%
\pagenumbering{arabic}%
\setheader{{\it CHAPTER \thechapter}}{}{}{}{}{{\it CHAPTER \thechapter}}%
\setfooter{\thepage}{}{}{}{}{\thepage}%

This document describes a utility for converting \popref{\LaTeX}{latexgloss}\ files into
several other formats.

Only a subset of \LaTeX\ can be processed by this utility, especially
since the target document language will never perfectly match \LaTeX.
Whether the quality of the results is good enough will depend upon the
application and your own expectations. {\it This caveat is worth emphasizing}, because
many people assume that any old \LaTeX\ document will go through without modification: it might,
but the chances are you'll need to modify it a bit for Tex2RTF. Tex2RTF was written with
portable document maintenance and generation in mind, with less emphasis on accepting all \LaTeX\ syntax.
You have been warned!

Tex2RTF is heavily biased towards making on-line, hypertext versions of
\rtfsp\LaTeX\ documents, but the \popref{RTF}{rtf} converter can be used to generate linear,
paper-based documents too.

The latest version of Tex2RTF, plus source code, can be accessedfrom:

\begin{verbatim}
http://web.ukonline.co.uk/julian.smart/tex2rtf
ftp://www.remstar.com/pub/wxwin/tex2rtf
\end{verbatim}

It is available in Sun Open Look, Motif, Windows 3.1, Windows 95/NT, and
non-GUI UNIX versions.

Tex2RTF was developed using the free Open Look, Motif and Windows 3.1
C++ class library \popref{wxWidgets}{wxwidgets}.

\section{Status of Tex2RTF}\index{status of Tex2RTF}%

Windows HTML help, and wxWidgets 2 wxHTML help, are now catered for using
the htmlWorkshopFiles setting.

Tex2RTF is very rarely updated these days: it would be nice to
rewrite the parser (and indeed the rest of it) at some point,
to improve error reporting, space handling and ability to
handle more advanced Tex/Latex commands.

\section{Acknowledgements}\index{acknowledgements}%

Thanks are due to the many people in AIAI and on the Internet at large
who have pointed out bugs or shortcomings in Tex2RTF. Michel Lavaud has been
a great help in giving advice for improvements to the manual.

\section{Change log}\index{change log}%

Version 2.0, August 24th 1999

\begin{itemize}\itemsep=0pt
\item Added htmlWorkshopFiles setting, to output .hpp, .hhc
and .hhk (HTML Workshop) files, for generating MS HTML Help or wxHTML Help.
\end{itemize}

Version 1.64, October 20th 1998

\begin{itemize}\itemsep=0pt
\item Added \verb$\insertatlevel$ command.
\end{itemize}

Version 1.63, October 21st 1997

\begin{itemize}\itemsep=0pt
\item Debugged problem with Word bookmarks not being inserted for unnumbered
sections.
\end{itemize}

Version 1.62, August 18th 1997

\begin{itemize}\itemsep=0pt
\item Added contributed changes by Andreas M黱zenmaier to support German
accents by allowing the characters to be placed in input files, and also
converting them back to character codes in the WinHelp {\tt .cnt} file.
\item Now \verb$\helpref$ causes page references to be inserted in linear RTF,
or section references if not on Word mode.
\item WinHelp table caption bug fixed.
\end{itemize}

Version 1.61, June 11th 1997

\begin{itemize}\itemsep=0pt
\item \verb$\fcol$ now works in HTML using the FONT tag.
\item \verb$\twocollist$ works in indented paragraphs, and is now
implemented properly using tables in HTML.
\item New boolean option {\bf combineSubSections} added, which switches off
the generation of separate HTML files below section level. This can reduce the
number of HTML files substantially.
\end{itemize}

Version 1.60, February 18th 1997

\begin{itemize}\itemsep=0pt
\item The index command now allows complex LaTeX instead of inserting the
first argument verbatim.
\end{itemize}

Version 1.59, February 14th 1997

\begin{itemize}\itemsep=0pt
\item Added special processing for a chapter called Popups.
\end{itemize}

Version 1.58, August 1st 1996

\begin{itemize}\itemsep=0pt
\item Added HTML settings: backgroundImage, backgroundColour, textColour,
linkColour, followedLinkColour. 
\item Added \verb$\backgroundimage$, \verb$\backgroundcolour$, \verb$\linkcolour$,
\verb$followedLinkColour$. \verb$\background$ now obsolete (but behaviour is
backward compatible).
\item The default background colour is now white.
\item Debugged HTML \verb$\ss$ (put in wrong place in code).
\end{itemize}

Version 1.57, July 27th 1996

\begin{itemize}\itemsep=0pt
\item Added upperCaseNames setting; now all links in HTML files are in lower
case unless specified otherwise.
\end{itemize}

Version 1.56, May 25th 1996

\begin{itemize}\itemsep=0pt
\item Debugged \verb$\special$ processing for HTML (escaped characters such ampersand).
\item Added contentsDepth for Word RTF contents page.
\item Removed overlapping href in HTML pages.
\end{itemize}

Version 1.55, May 6th 1996

\begin{itemize}\itemsep=0pt
\item \verb$\verb$ support corrected for HTML.
\item Added {\it abstractName} setting.
\item Debugged incorrect centring for HTML buttons.
\end{itemize}

Version 1.54, Feburary 28th 1996

\begin{itemize}\itemsep=0pt
\item Bug fix for 24-bit bitmap inclusion when generating RTF:
caused a floating point error.
\item Added htmlIndex setting, to generate an {\tt .htx} index file of an HTML document for
use in wxHelp version 2 or other programs.
\item Fixed header/footer bug.
\item Change colons to spaces for WinHelp RTF keywords, since the colon has a specific meaning in WinHelp.
\end{itemize}

Version 1.53, January 1995

\begin{itemize}\itemsep=0pt
\item Now stores paths from file inclusions, so that if you include
a file A from a separate directory, which then includes a file B
relative to that directory, Tex2RTF will search in the path
of A to find file B.
\end{itemize}

Version 1.52, December 1995

\begin{itemize}\itemsep=0pt
\item \verb$\helpref$ and related commands now generate italicized instead
of bold `anchor' text for linear formats.
\item Cured bug where Tex2RTF could hang on start up, while reading
the {\tt tex2rtf.ini} file. This occurred when a comment finished with
the end of file.
\item Split the commands reference in two (\LaTeX\ and Tex2RTF commands),
and added a {\it Commands by category} section.
\item Removed a bug that caused HTML output to be garbled on the
second pass.
\end{itemize}

Version 1.51: Windows 95 enhancements.

\begin{itemize}\itemsep=0pt
\item Added settings winHelpContents (for generating {\tt .cnt} file), winHelpVersion (for specifying
target version of WinHelp).
\item Added space to non-scrolling region of topic.
\item If winHelpVersion is 4, makes non-scrolling region grey and the rest yellow.
\item Added \verb$\settransparency$ command for WinHelp 4 transparent bitmaps.
\end{itemize}

Version 1.50:

\begin{itemize}\itemsep=0pt
\item Tidied up HTML generation (headers and bodies in the right places).
\item Eliminated extra space after verbatim in HTML.
\item Added support for simple tables in HTML.
\item Added \verb$\textcolour$, \verb$\background$ for colouring text and background in HTML.
\item Added \verb$\copyright$, \verb$\registered$ symbols in HTML.
\item Added \verb$\imagel$, \verb$\imager$ for left and right aligned images
in HTML.
\item Added \verb$\brclear$ for clearing image alignment in HTML.
\item Added \LaTeX\ font size support in HTML (\verb$\small$, \verb$\large$ etc.) using Netscape font extensions.
\item HTML button-bar change: always shows the same buttons, but may make one or more insensitive. Changing button positions
could be very annoying.
\item Tidied up RTF generation for non-Word viewers ({\it useWord} set to {\it false}). Will now look reasonable using
Windows 95 Quick View and WordPad: WordPad doesn't do tables but does bitmaps, and QuickView does tables but not
bitmaps. Such is life.
\end{itemize}

Version 1.49:

\begin{itemize}\itemsep=0pt
\item Cured some bugs (char used for fgetc instead of int) so now compiles for
WIN32s.
\end{itemize}

Version 1.48:

\begin{itemize}\itemsep=0pt
\item Added some LaTeX2e fonts commands such as \verb$\rmfamily$, \verb$\textrm$, \verb$\emph$.
Most of these are aliases for other commands.
\end{itemize}

Up to version 1.47:

\begin{itemize}\itemsep=0pt
\item Added \verb$\backslashraw$, \verb$\rbraceraw$ and \verb$\lbraceraw$ commands
to help output arbitrary RTF.
\item Added \verb$\sethotspotcolour$, \verb$\sethotspotunderline$ commands for controlling
WinHelp hotspot appearance.
\item Added truncateFilenames option.
\item Improved HTML inline image handling.
\end{itemize}

Up to version 1.46:

\begin{itemize}
\itemsep=0pt
\item Added \verb$\urlref$ command for specifying HTML URLs.
\item Started support for translating .SHG files to HTML .map files
(this works if compiled under Borland, not MS VC++ for some reason!)
\item Fixed nasty memory bug in HTML code (thanks Petr).
\end{itemize}

Version 1.40:

\begin{itemize}
\itemsep=0pt
\item Added {\it generateHPJ} option for generating the .HPJ WinHelp project file
\item Added support for DDE via a small command set
\end{itemize}

Version 1.39:

\begin{itemize}
\itemsep=0pt
\item Option for using Word's INCLUDEPICTURE or IMPORT field, since the method that
works for Works, doesn't work for Word! See {\it bitmapMethod} in the
settings section.
\end{itemize}

Version 1.37-1.38: