1
0
Fork 0
doc/main/convert/latex/man-latex2tm.en.tm

58 lines
2.8 KiB
Tcl

<TeXmacs|1.0.5.10>
<style|tmdoc>
<\body>
<tmdoc-title|Conversion from <LaTeX> to <TeXmacs>>
In order to import a <LaTeX> document into <TeXmacs>, you may use
<menu|File|Import|Latex>. Don't forget to save the file under a new name
with the <verbatim|.tm> extension, if you want to edit it.
As explained in the introduction, the conversion of <LaTeX> documents into
<TeXmacs> is more problematic than conversions the other way around. As
long as you restrict yourself to using the most common <LaTeX> commands,
the conversion process should not give rise to any major difficulties.
However, as soon as your documents contain ``weird macro definitions'',
then the converter may get confused. We also notice that <TeXmacs> is
currently unable to convert <LaTeX> style files and no plans exist to
enhance the converter in this direction.
There are two major reasons for <LaTeX> documents to get imported in an
inappropriate way, and which can easily be corrected by the user. First of
all, the parser may get confused because of some exotic syntactic
construct. This typically happens in presence of catcodes or uncommon
styles of macro definitions. Sometimes, the parser may also be mistaken
about the current mode, in which case text gets parsed as a mathematical
formula or <em|vice cersa>. In both cases, the imported document usually
becomes ``weird'' at a certain point. In order to solve the problem, we
suggest you to identify the corresponding point in the <LaTeX> source file
and to make an appropriate change which avoids the parser of getting
confused.
A second common error is that certain <LaTeX> macros are not recognized by
the converter, in which case they will appear in red. This typically
happens if you use one of the hundreds additional <LaTeX> packages or if
you defined some additional macros in another document. In the case when
the troublesome macro occurs only a few times, then we suggest you to
manually expand the macro in the <LaTeX> source file before importation.
Otherwise, you may try to put the definitions of the missing macros in the
preamble of the <LaTeX> document. Alternatively, you may create a small
style package with <TeXmacs> counterparts for the macros which were not
recognized.
<tmdoc-copyright|1998--2005|Joris van der Hoeven>
<tmdoc-license|Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License, Version 1.1
or any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
Texts. A copy of the license is included in the section entitled "GNU Free
Documentation License".>
</body>
<\initial>
<\collection>
<associate|language|english>
</collection>
</initial>