rtf2LaTeX est un filtre basé sur le lecteur RTF de Paul DuBois qui convertit le format RTF (Rich Text Format de Microsoft) en LaTeX. rtf2LaTeX fait tout son possible pour rendre maintenable et modifiable le document LaTeX généré. Par manque de motivation, un grand nombre de fonctionnalités ne sont pas supportées par rtf2LaTeX ; beaucoup d'entre elles pourraient être ajoutées facilement sans grands changements dans le programme, simplement en ajoutant quelques sections de code.
La première ligne du fichier de conversion doit contenir un commentaire.
Puis les lignes contenant les caractères doivent suivre.
Chaque ligne commence par le code-rtf du caractère (de 128 à 255).
Ensuite vient la commande LaTeX (une chaîne de caractères) après un espace unique.
Un commentaire doit être inséré après la 25ème colonne.
Il n'est pas nécessaire d'inclure tous les codes de 128 à 256.
Les tabulations ne sont pas autorisées.
Vous trouverez des exemples dans les fichiers interna.rtf ou interna.tex.
Pour un exemple de fichier de conversion complet, voir mac.code
Certains styles de WORD seront traduits en commandes LaTeX (par ex. titre 1 en \section, titre 2 en \subsection, ...)
Les autres seront ignorés (si l'option -d n'est pas active), car LaTeX les gère mieux que WORD (par ex. l'appel ou le texte de
note de bas de page) Le fichier de conversion avec l'extension .land indique au filtre comment ils doivent être traduits.
Le fichier de conversion par défaut est english.land, il convient pour les fichiers rtf générés par les versions anglaises de WORD et WINWORD.
(Ce fichier de conversion utilise les styles " heading 1 ", " heading 2 ", ... " footer ", " header ", " footnote text ", ...)
Il faut utiliser le fichier de conversion german.land pour les fichiers rtf générés par les versions allemandes de WORD et WINWORD.
(noms de style : " Gliederung 1 ", " Fu/3zeile ", ...)
On trouve dans ces deux fichiers les styles spéciaux de Word les plus importants.
Si d'autres vous sont nécessaires, il vous sera très facile d'en rajouter.
Vous pouvez créer votre propre fichier de conversion comme ci-dessous :
La première ligne du fichier de conversion doit contenir un commentaire.
Puis les lignes contenant les styles doivent suivre.
Chaque ligne commence par le nom du style. (Obligatoirement une chaîne de 20 caractères)
Il peut y avoir ensuite le début de commande LaTeX (une chaîne de 20 caractères) et la fin de commande LaTeX (20 caractères).
(S'il n'y a pas de commandes LaTeX, alors le style sera ignoré.)
Un commentaire peut être inséré après la 60ème colonne. (Ce commentaire sera écrit dans le fichier de sortie LaTeX)
Les tabulations ne sont pas autorisées.
Vous trouverez des exemples dans les fichiers interna.rtf ou interna.tex
Pour un exemple de fichier de conversion complet, voir english.land.
Si LaTeX vous affiche des erreurs ou des alarmes, essayez ceci :
Parfois vous pouvez tout simplement ignorer une erreur LaTeX ou une alarme. Si cela ne suffit pas, cherchez l'erreur dans la liste ci-dessous :
Commande ... already used
Un style RTF a le même nom qu'une commande LaTeX.
Changez le nom du style RTF dans le fichier RTF ou le nom du nouvel environnement dans le fichier LaTeX.
Ou encore, ajoutez le style dans le fichier english.land ou german.land. (voir l'option -L)
Missing begin{document}
Dans un fichier LaTeX généré par rtf2LaTeX, il ne devrait rester que quelques-unes des lignes suivantes avant \begin{document} ;
\documentstyle{article}
\pagestyle{myheadings}
\newlength{\defaultparindent}
\setlength{\defaultparindent}{\parindent}
les lignes commençant par % (Ces lignes sont ignorées par LaTeX)
et les lignes définissant un nouvel environnement.
Si vous trouvez d'autres lignes, supprimez-les.
Missing $ inserted
Dans la plupart des cas, vous pouvez ignorer cette erreur, car LaTeX a déjà inséré le $ pour vous.
Mais néanmoins, regardez dans le fichier avec l'extension " .code " que vous utilisez. (par ex. mac.code, ansi.code, ...) Certaines commandes LaTeX pour une police particulière requièrent le " mode mathématique ". Cela signifie que les commandes doivent être encadrées par des $ (par ex. $\pounds$, $\ll$, $\gg$, ...)
Ou encore, rtf2LaTeX a positionné des taquets de tabulation au mauvais endroit. Dans ce cas vous pouvez utiliser l'option -s.
Something's wrong--perhaps a missing \item
Essayez l'option -r.
Pour réaliser une indentation à gauche ou à droite, il faut utiliser l'environnement " list " (\begin{list}, \end{list}). Ceci peut engendrer quelques problèmes. L'option -r ignore l'indentation gauche ou droite et ainsi l'environnement " list " n'est plus nécessaire.
There's no line here to end
Essayez d'ignorer cette erreur LaTeX. Si nécessaire, regardez où apparaissent ces alarmes :
Il peut y avoir un problème avec les taquets de tabulation. Utilisez l'option -s ou -t.
Ou encore, il peut y avoir un problème lors de la création d'une nouvelle ligne (mot_de_contrôle_rtf \line). Utilisez l'option -n pour transformer \\ en \hfil\break. \hfil\break fonctionne toujours, mais le centrage du texte à la sortie est mauvais.
Overfull hbox ...
Ceci signifie qu'une ligne est trop longue ou que LaTeX ne peut pas trouver d'endroit correct pour couper une ligne. Regardez où apparaissent ces alarmes :
Dans un tableau : essayez l'option -T pour changer le facteur de réduction de la largeur de cellule. (la valeur par défaut est 0,7)
Dans des lignes soulignées : LaTeX ne coupera pas la ligne si elle est soulignée. Utilisez l'option -u pour transformer le soulignement en italique.
Ailleurs : Utilisez les commandes LaTeX \- ou \hyphenation{...} pour indiquer à LaTeX ou il peut placer les césures.
Underfull hbox ...
Apparaît le plus souvent dans les tableaux. À ignorer !
Overfull vbox ...
Il y a plus de texte dans une page qu'il ne devrait y en avoir.
Ce peut être un tableau trop long : terminez le tableau (avec \end{tabular}) n'importe où en son milieu et commencez un nouveau tableau avec les mêmes caractéristiques (\begin{tabular}{p...}
Utilisez \newpage ou \pagebreak.
Underfull vbox ...
Un tableau trop long a peut-être été déplacé sur la page suivante. Voir Overfull \vbox.