mirror of https://github.com/texmacs/doc.git
58 lines
2.8 KiB
Plaintext
58 lines
2.8 KiB
Plaintext
|
<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>
|