tex2lyx - En ligne dans le Cloud

PROGRAMME:

Nom

tex2lyx - traduire du LaTeX bien élevé en LyX

SYNOPSIS

La façon la plus simple d'utiliser tex2lyx est via l'élément de menu Fichier->Importer->LaTeX (plain) dans LyX.
Ça court tex2lyx sur le fichier donné et charge le fichier résultant dans LyX. Tu devrais essayer
cela d'abord, et appelez-le à partir de la ligne de commande uniquement si vous avez besoin d'utiliser plus compliqué
options.

tex2lyx [ -réputilisateur rép_utilisateur ] [ -répsystème répertoire système ] [ -f ] [ -n ] [ -c classe de texte ] [ -e
codage ] [ -fixedenc codage ] [ -m module 1[,module 2...]] [ -s sfile1[,sfile2...]] [
-sauter les enfants ] [ -aller-retour ] [ -copier les fichiers ] fichier d'entrée [ fichier de sortie ]

OPTIONS

-c Classer. Par défaut, quand tex2lyx voit une commande \documentclass{foo}, elle crée un
fichier de textclass "foo" et lit le fichier de mise en page LyX pour cette classe (quelque chose
comme /usr/local/share/lyx/layouts/foo.layout OU ACCUEIL/.lyx/layouts/foo.layout). Utilisation
-c pour déclarer une classe de texte différente (et lire un fichier de mise en page différent).

Cette option est nécessaire si le fichier d'entrée est un fragment LaTeX, sans préambule
Matter ou la commande \begin{document}. Fichiers LyX créés par tex2lyx à partir de fichiers partiels
peut être inclus dans un fichier LyX existant à l'aide de la commande « Inclure le fichier LyX » de
Le menu Insertion de LyX.

-m Module. Chargez les modules donnés. Ceci est utile si tex2lyx ne fait pas automatiquement
détecter un module donné, mais vous connaissez les modules qui fournissent des commandes ou
environnements qui sont utilisés dans le fichier importé. Les modules sont chargés dans le
ordre donné. Si un module foo dépend d'un module barre, barre doit être donné avant foo.

-f Obliger. tex2lyx ne fonctionnera pas si le fichier .lyx qu'il générerait existe déjà. Utilisation
le -f option (soigneusement) pour écraser tous les fichiers existants.

-e Spécifiez l'encodage par défaut à l'aide du nom LaTeX tel que défini dans le fichier d'encodages.
tex2lyx utilisera cet encodage, mais changera s'il trouve un changement d'encodage
commandes en entrée.

-fixedenc
Spécifiez l'encodage à l'aide du nom LaTeX tel que défini dans le fichier d'encodages.
tex2lyx ignorera toute commande de changement d'encodage dans l'entrée.

-n Pas de web. Traduisez un fichier noweb (c'est-à-dire la programmation littéraire). Cela devrait être (presque ?)
équivaut à exécuter « noweb2lyx foo.tex foo.lyx ». Cette option nécessite la -c
option.

-sauter les enfants
Ne traduisez pas les documents enfants inclus via \include et \input. Cette option est
utile si les documents enfants sont des fichiers générés et/ou contiennent de nombreuses commandes qui
tex2lyx ne comprend pas encore.

-s Fichiers de syntaxe. Fichiers de syntaxe d'entrée (un ou plusieurs guillemets séparés par des virgules) à lire
en plus de la valeur par défaut. (voir la section sur Syntaxe Fichiers pour plus de détails).

-répertoire système
Spécifiez un répertoire système. Normalement, vous ne devriez pas en avoir besoin. Votre système LyX
répertoire est choisi. Cf. la section FICHIERS pour plus de détails.

-réputilisateur
Spécifiez un répertoire utilisateur. Normalement, vous ne devriez pas en avoir besoin. Votre utilisateur LyX
répertoire est choisi. Cf. la section FICHIERS pour plus de détails.

-aller-retour
Appelez LyX pour réexporter le fichier de sortie créé vers LaTeX. Si le nom du fichier de sortie est
pas donné, il est déterminé automatiquement pour éviter d'écraser le fichier d'entrée par
accident : si le fichier d'entrée est nommé foo.tex le fichier de sortie sera nommé
foo.lyx.lyx, et le fichier réexporté sera nommé foo.lyx.tex.

-copier les fichiers
Copiez tous les fichiers inclus tex2lyx est au courant du répertoire de sortie si la sortie
se trouve dans un répertoire différent de celui du fichier d'entrée. Ceci est utile si vous
veulent s'assurer qu'aucun fichier inclus n'est écrasé (que ce soit en mode aller-retour ou par
une exportation ultérieure de LyX). Veuillez noter que le document résultant peut être
non compilable. Cela se produit s'il a besoin de fichiers qui tex2lyx ne connaît pas et
ne copie donc pas dans le répertoire de sortie.

-Aide Aider. Imprimez les informations d'utilisation et quittez.

-version
Imprimez le numéro de version et les informations de build et quittez.

DESCRIPTION

Introduction
tex2lyx créera un fichier LyX avec le nom spécifié (ou rép/foo.lyx si aucun nom n'était
donné) à partir du fichier LaTeX rép/foo.tex.

Les suffixes .tex, .ltx et .latex sont pris en charge. Si fichier d'entrée n'existe pas et ne
avoir l'un de ces suffixes, tex2lyx va essayer de traduire fichier d'entrée.tex. (C'est similaire
au comportement de LaTeX.)

À notre humble avis, tex2lyx est de traduire bien élevé LaTeX2e dans LyX. Si votre fichier LaTeX
ne compile pas --- ou si vous faites des choses étranges, comme redéfinir les commandes LaTeX standard --- il
peut s'étouffer. LaTeX209 sera souvent traduit correctement, mais ce n'est pas garanti.

tex2lyx manque quelques fonctionnalités. Cependant, ses principaux objectifs sont :

· Passer à travers un fichier LaTeX2e bien comporté sans planter

· Traduisez une grande partie de ce fichier.

· Localiser les parties qui ne peuvent pas être traduites et les copier en mode TeX

Il atteint assez bien ces objectifs principaux sur la plupart des fichiers.

Utilisation
Voici une description plus longue de ce que vous devez faire pour traduire un document LaTeX en
LyX.

· Courir tex2lyx.

tex2lyx vous informera de ses progrès et donnera tous les avertissements à stderr, donc si vous
ne voulez aucune sortie du tout, essayez (en csh) `tex2lyx foo.tex >& /dev/null'. Vous devriez
PAS rediriger la sortie standard vers foo.lyx.

· Exécutez LyX (version 2.1 ou ultérieure) sur le fichier .lyx résultant.

En théorie, la plupart du fichier aura été traduit, et tout ce qui est
intraduisible sera transféré au code TeX (ERT en langage LyX). En théorie, LyX sera
pouvoir lire dans le fichier, et créer des documents imprimés à partir de celui-ci, car tout cela
les éléments ERT non traduits seront transmis directement à LaTeX, que LyX utilise comme
arrière-plan. Malheureusement, la réalité ne reflète pas toujours la théorie. Si tex2lyx se bloque, ou
LyX ne peut pas lire le fichier LyX généré, voir la section BOGUES ci-dessous.

· Les éléments de transformation ont été insérés manuellement en tant que code TeX vers les fonctionnalités LyX, si possible.

Comme mentionné ci-dessus, vous devriez pouvoir imprimer le fichier LyX même sans faire
cette. Cependant, changer une commande dans le code TeX en l'objet LyX correspondant
vous permettent de profiter de l'édition WYSIWYM de LyX.

tex2lyx n'est pas garanti de créer un fichier LyX qui génère exactement la même sortie
que le fichier LaTeX, bien que son objectif soit d'y parvenir. tex2lyx se trompera généralement sur
le côté de traduire moins pour s'assurer que les fichiers de sortie résultants sont précis,
même si cela conduit à plus de code TeX et moins de WYSIWYM.

· RELIRE LE DOCUMENT !!

Je suis sûr que vous aviez prévu de le faire de toute façon, mais c'est particulièrement important après
traduire un document LaTeX. tex2lyx est meilleur pour « macrotraduire » (traduire
l'ensemble du document) que de « microtraduire » (traduire chaque petit détail). Pour
exemple, vous pouvez voir des espaces supplémentaires ou des espaces supprimés. La gestion de l'espace s'est améliorée, mais
ce n'est pas parfait.

Quoi tex2lyx Pouvez Handle
tex2lyx comprend de nombreuses commandes LaTeX. Il se traduira :

· texte normal, y compris les mini-commandes comme ~, `', \@, \TeX, ainsi que les accents
des caractères comme \'{a}, et les cas particuliers ?` et !`

· les commandes de titre comme \author, \date, \title, \thanks et l'environnement abstrait

· commandes d'en-tête comme \section y compris les commandes étoilées (\section*)

· Environnements : citation, citation et vers ; centre, flushright et flushleft

· les environnements d'itemize, d'énumération et de description, et leurs commandes \item. Aussi,
listes imbriquées bien éduquées

· commandes de références croisées : \ref, \pageref, \label et \cite

· \footnote et \margin

· commandes de changement de police, y compris \em, \emph, \textit et les commandes correspondantes pour
changer la famille, la taille, la série et la forme

· \input{foo} (ou \input{foo.blah}) et \include{foo}. Plain TeX \input commande "\input
foo.tex » est également pris en charge.

· environnement tabulaire et commandes qui y sont insérées comme \hline, \cline et
\multicolonne (mais voir ci-dessous)

· environnements flottants table et table*, ainsi que les commandes \caption qu'ils contiennent

· les environnements flottants figure et figure*, ainsi que les commandes d'inclusion graphique \epsf,
\epsffile, \epsfbox, \epsfxsize, \epsfig, \psfig et \includegraphics. Les deux
les graphiques et les formes graphicx de \includegraphics sont pris en charge.

· l'environnement bibliography et la commande \bibitem, ainsi que la \bibliography de BibTeX
et commandes \bibliographystyle

· commandes diverses : \hfill, \\, \noindent, \ldots...

· environnements spécifiques à la classe de documents (et certaines commandes) qui peuvent être traduits en LyX
dispositions

· arguments à certaines commandes intraduisibles (par exemple \mbox)

Une partie de ce soutien n'est peut-être pas encore à 100 %. Voir ci-dessous pour les détails

tex2lyx copie les maths (presque) textuellement à partir de votre fichier LaTeX. Heureusement, LyX lit en LaTeX
math, donc (presque) n'importe quel calcul pris en charge par LyX devrait fonctionner correctement.

tex2lyx copiera toutes les commandes de préambule (c'est-à-dire tout ce qui précède \begin{document}) textuellement.
Les fantaisies que vous avez dans votre préambule doivent donc être conservées dans les documents imprimés,
bien qu'il n'apparaisse bien sûr pas dans la fenêtre LyX. Vérifiez le document->Paramètres->LaTeX
Préambule pour voir le résultat.

Quoi tex2lyx Ne peut pas Handle --- Mais c'est OK
· quelques commandes d'espacement (\hspace, \pagebreak et \linebreak)

· \centrage, \raggedleft, \raggedright

· Environnement \verb et verbatim. tex2lyx prend soin de copier exactement dans ce cas,
y compris les commentaires et les espaces.

· environnements et commandes inconnus (par exemple, définis par l'utilisateur)

tex2lyx copie les commandes inconnues, ainsi que leurs arguments, textuellement dans le fichier LyX.
De plus, s'il voit un \begin{foo} où il ne reconnaît pas l'environnement "foo", il
copie textuellement jusqu'à ce qu'il voie \end{foo} (sauf si vous utilisez le -r option). La plupart de ces
les commandes inconnues ne causeront pas tex2lyx casser; ils vous demanderont simplement de faire quelques
édition une fois que vous avez chargé le fichier dans LyX. Cela devrait être moins pénible que l'édition
soit le fichier .tex ou le fichier .lyx à l'aide d'un éditeur de texte.

Quoi tex2lyx Poignées Mal --- aka BOGUES
Depuis que tex2lyx est relativement nouveau, il a un certain nombre de problèmes. À mesure qu'il mûrit, ces insectes
sera écrasé.

· La copie « exacte » d'environnements et de commandes inconnus n'est pas tout à fait exacte. Cette volonté
produire un LyX moche, mais dans presque tous les cas, le résultat sera le même. Cependant, la plupart
des parties du fichier seront parfaitement copiées, y compris les espaces et les commentaires. Cette
inclut : le préambule LaTeX, les environnements verbatim ainsi que les commandes \verb, et
sauter des blocs.

· tex2lyx traduit uniquement un sous-ensemble des options de classe de document en fonctionnalités natives.
D'autres options sont placées dans le champ « options » dans la fenêtre contextuelle Document->Paramètres.

Plus important, tex2lyx ne traduit pas \newcommands, commandes inconnues \usepackage
et autre code inconnu dans le préambule. Il copie simplement cela dans le préambule LaTeX.
Si vous utilisez des commandes spéciales, par exemple pour spécifier la mise en page du texte d'une manière qui n'est pas
compris par LyX, tex2lyx ne le reconnaîtra pas. Notez que ces paramètres seront
écrasé si vous modifiez la mise en page du texte dans les paramètres de document de LyX. Mieux vaut supprimer
ces options spéciales du préambule LaTeX (Document->Paramètres->Préambule LaTeX) et
utilisez les paramètres de document LyX correspondants, si possible.

· La classe de document d'aluminium a quelques bogues. tex2lyx peut faire des choses étranges avec
arguments facultatifs pour les commandes \foilhead. En outre, il peut gérer \begin{dinglist}
de manière incorrecte (bien que les éléments de l'environnement devraient se traduire normalement).

Tous les bogues connus de tex2lyx Peut être trouvé sur http://www.lyx.org/trac/wiki/BugTrackerHome.

tex2lyx est plutôt robuste. Comme mentionné ci-dessus, il peut ne pas traduire parfaitement votre fichier,
mais le résultat devrait être utilisable et il ne devrait pas planter. Si vous rencontrez des problèmes --- et
le problème n'est pas l'un de ceux mentionnés ci-dessus ou sur
http://www.lyx.org/trac/wiki/BugTrackerHome---veuillez signaler le problème comme décrit dans le
section sur Punaise Rapports.

Quoi Luxe Ne peut pas Handle
LyX lui-même manque quelques fonctionnalités, de sorte que même si tex2lyx traduit les choses
parfaitement, LyX peut encore avoir du mal à le lire. Si vous avez vraiment besoin de ces fonctionnalités, vous
pouvez exporter votre document final au format LaTeX et le remettre en place. Voir BOGUES pour plus de détails
sur ces bogues.

· Pour un certain nombre de commandes (telles que \\), LyX ne prend pas en charge l'argument optionnel.
tex2lyx supprimera automatiquement les arguments facultatifs avec un avertissement à stdout.
LyX ignore également l'argument width pour l'environnement thebibliography.

· La prise en charge de LyX pour les tables n'est pas parfaite. Pour les tableaux compliqués, utilisez un bloc « saut », donc
qu'ils seront copiés en mode TeX.

· LyX permet aux chiffres d'avoir des tailles dans les unités connues de TeX, telles que in, cm, etc. Il
traduit également les pourcentages de \textwidth, \textheight, \columnwidth, mais aucun autre
longueurs (par exemple, si vous vouliez redimensionner une figure à la taille \topmargin pour une raison quelconque).
tex2lyx copiera les chiffres avec des tailles intraduisibles en mode TeX. Encore une fois, vous pourriez être
capable de résoudre ce problème dans LyX.

EXEMPLES

tex2lyx -f -r "myenv" foo.tex

Ce qui précède créera un fichier foo.lyx à partir de foo.tex, en l'écrasant si nécessaire. Quand cela
trouve un bloc \begin{myenv} ... \end{myenv}, il traduira le contenu du bloc,
mais copiez les commandes \begin et \end en mode TeX.

tex2lyx -n -c « article-lettré » foo.tex

Ce qui précède changera un document noweb en un document d'article littéraire LyX. Un utilisateur aurait
faites-le si le document noweb avait un article de classe de document.

NOTES

Punaise Rapports
Les bogues doivent être signalés au traqueur de bogues LyX à l'adresse
http://www.lyx.org/trac/wiki/BugTrackerHome. De plus, vous pouvez envoyer un message au
Liste de diffusion des développeurs LyX. Son adresse est actuellement [email protected]. Si votre
le message rebondit, vous pouvez consulter la page d'accueil de LyX, http://www.lyx.org/. Si vous courez
tex2lyx sur un fichier volumineux, veuillez ne pas envoyer tous les résultats dans votre rapport de bogue. Seulement
inclure les dix ou vingt dernières lignes de sortie, ainsi que le morceau du fichier LaTeX qu'il
s'est écrasé dessus. Ou, mieux encore, joignez un fichier petit mais complet qui provoque le même
problème comme votre fichier d'origine.

Disposition Fichiers
tex2lyx lit un fichier de mise en page LyX pour savoir comment gérer les environnements et les commandes LaTeX
qui sont traduits en mises en page LyX. Ce fichier inclura tous les éléments non mathématiques « normaux »
environnements (c'est-à-dire, y compris quote et itemize, mais pas tabular, minipage, et quelques autres
environnements sophistiqués) et des commandes telles que \section et \title. Si vous voulez tex2lyx une classe
qui n'a pas de fichier de mise en page existant, vous devrez alors créer un fichier de mise en page. Mais
vous devez le faire de toute façon, afin de LyX le fichier, puisque LyX dépend des fichiers de mise en page pour
savoir afficher et traiter ses fichiers. Consultez la documentation LyX pour obtenir de l'aide à ce sujet
tâche (qui peut être difficile ou facile, selon la classe que vous souhaitez créer un fichier de mise en page
pour.) Si votre classe est assez similaire à une classe qui a un fichier de mise en page, alors considérez
utilisant l' -c option.

Syntaxe Fichiers
tex2lyx lit toujours au moins un fichier de syntaxe, appelé fichier de syntaxe par défaut. tex2lyx
lira votre fichier de syntaxe personnel s'il existe ; sinon il lira l'ensemble du système
fichier. tex2lyx lira des fichiers de syntaxe supplémentaires si vous les spécifiez avec le -s option.
(Ces fichiers supplémentaires doivent avoir le même format que le fichier par défaut, mais auront tendance à être
plus court, car ils n'ont qu'à spécifier des commandes supplémentaires non trouvées dans le fichier par défaut.) A
le fichier de syntaxe dit tex2lyx quelques choses.

Tout d'abord, il décrit la syntaxe de chaque commande, c'est-à-dire le nombre d'arguments requis et
combien d'arguments facultatifs la commande prend. Sachant cela, il est plus facile pour tex2lyx à
copier (en mode TeX) des commandes qu'il ne sait pas traduire. Le fichier de syntaxe simplement
a une commande, suivie d'accolades ou de crochets décrivant ses arguments dans le bon
ordre. Par exemple, une entrée de fichier de syntaxe \bibitem[]{} signifie que la commande \bibitem prend
un argument facultatif suivi d'un argument obligatoire, tandis que l'entrée \bf signifie que le \bf
La commande ne prend aucun argument. Lorsque tex2lyx rencontre un jeton qu'il ne connaît pas
comment traduire en LyX, il copiera le jeton --- avec le nombre correct de
arguments --- exactement. Si le jeton n'est pas dans le fichier de syntaxe, alors tex2lyx juste des copies comme
beaucoup d'arguments qu'il trouve. Cela signifie qu'il peut copier trop. Mais puisque l'utilisateur peut
spécifier des fichiers de syntaxe supplémentaires, cela ne devrait pas arriver souvent.

Certaines commandes qui ne peuvent pas être traduites en LyX, comme \mbox, ont comme argument
texte LaTeX normal. Si la chaîne « traduire » est placée dans un argument d'un
commande (intraduisible) dans le fichier de syntaxe, puis tex2lyx traduira cet argument
au lieu de le copier textuellement. Ainsi, par exemple, le fichier de syntaxe par défaut a
\raisebox{}[][]{traduire}. Cela signifie que la commande \raisebox et le premier argument
(et les arguments optionnels s'ils existent) sont copiés en mode TeX, mais le dernier argument
(qui peut contenir des mathématiques, du LaTeX compliqué, d'autres commandes intraduisibles, etc.) sera
traduit en LyX. Vous ne pouvez pas utiliser « translate » sur des arguments facultatifs.

Les fichiers de syntaxe définis par l'utilisateur sont autorisés à définir de nouvelles commandes et leur syntaxe, ou à remplacer
le nombre d'arguments d'une commande donnés dans le fichier de syntaxe par défaut. (Par exemple, si vous êtes
en utilisant un style qui donne un argument supplémentaire à une commande...) Cependant, ce ne sera que
utile pour les commandes copiées en mode TeX. Les commandes qui sont réellement traduites par tex2lyx
(comme \item) ont leur syntaxe d'argument codée en dur. Les commandes codées en dur sont identifiées
dans le fichier de syntaxe par défaut.

Deuxièmement, le fichier de syntaxe décrit tous les « environnements normaux ». Habituellement, un inconnu entier
l'environnement sera copié en mode TeX. Si vous définissez un environnement régulier "foo", cependant,
alors seules les commandes \begin{foo} et \end{foo} seront copiées en mode TeX ; le texte
dans l'environnement sera traité (c'est-à-dire traduit) par tex2lyx comme LaTeX ordinaire,
plutôt que d'être copié en mode TeX. N'essayez pas de déclarer "tabbing" et "picture" comme
environnements normaux, car le texte dans ces environnements confondra tex2lyx; utilisez ceci
capacité pour les nouveaux environnements que vous créez qui ont du texte brut ou des commandes mathématiques ou simples
en eux. Vous ne pouvez pas non plus déclarer des environnements mathématiques inconnus (comme une équation *) comme normaux
environnements, car l'éditeur mathématique LyX ne les comprendra pas. Les noms de
des environnements réguliers apparaissent, séparés par des espaces, entre \begin{tex2lyxre} et
instructions \end{tex2lyxre} dans le fichier de syntaxe. (Si vous avez un environnement régulier qui
vous n'utiliserez pas très souvent, vous pouvez utiliser le -r plutôt que d'écrire un fichier de syntaxe.)

MISES EN GARDE

Conservez toujours une copie de vos fichiers LaTeX originaux sous un nom différent ou dans un
répertoire différent. L'utilisation de LyX peut entraîner l'écrasement de plusieurs manières
le fichier LaTeX d'origine.

Si vous importez foo.tex pour créer foo.lyx, puis modifiez foo.lyx et souhaitez le réexporter, notez
qu'il écrasera le fichier foo.tex d'origine. (LyX vous demandera si vous souhaitez écraser
il.)

ENVIRONNEMENT

LYX_DIR_21x
peut être utilisé pour spécifier le répertoire système à utiliser.

Le répertoire système est déterminé en recherchant le fichier "chkconfig.ltx". Annuaires
sont recherchés dans cet ordre :
1) paramètre de ligne de commande -sysdir
2) Variable d'environnement LYX_DIR_21x
3) Peut-être /TOP_SRCDIR/lib
4) /../partager/ /
5) lyx_dir codé en dur (au moment de la construction : /usr/share/lyx)

LYX_USERDIR_21x
peut être utilisé pour spécifier le répertoire utilisateur à utiliser.

Le répertoire des utilisateurs est, par ordre de priorité :
1) paramètre de ligne de commande -userdir
2) Variable d'environnement LYX_USERDIR_21x
3) $MAISON/. si aucun réglage explicite n'est effectué

Utilisez tex2lyx en ligne en utilisant les services onworks.net