tex2lyx - クラウドでオンライン

プログラム：

NAME

tex2lyx - 行儀の良い LaTeX を LyX に変換します

SYNOPSIS

使用する最も簡単な方法 テクス2リクス LyX の [ファイル] -> [インポート] -> [LaTeX (プレーン)] メニュー項目を使用します。
それは走る テクス2リクス 指定されたファイルに対して実行し、結果のファイルを LyX にロードします。 試してみてください
それを最初に実行し、より複雑な機能を使用する必要がある場合にのみコマンドラインから呼び出します。
オプション。

テクス2リクス [ -userdir ユーザーディレクトリ ] [ -システムディレクトリ システムディレクトリ ] [ -f ] [ -n ] [ -c テキストクラス ] [ -e
エンコーディング ] [ -fixedenc エンコーディング ] [ -m module1[,module2...]] [ -s ファイル1[,ファイル2...]] [
-スキップ子供たち ] [ -往復 ] [ -コピーファイル ] 入力ファイル [ 出力ファイル ]

OPTIONS

-c クラス。 デフォルトでは、 テクス2リクス \documentclass{foo} コマンドを参照すると、
textclass「foo」のファイルを読み込み、そのクラスの LyX レイアウト ファイル (何か
/usr/local/share/lyx/layouts/foo.layout または ホーム/.lyx/layouts/foo.layout)。 使用
-c 別のテキストクラスを宣言します (そして別のレイアウト ファイルを読み取ります)。

このオプションは、入力ファイルがプリアンブルのない LaTeX フラグメントである場合に必要です。
matter または \begin{document} コマンド。 によって作成された LyX ファイル テクス2リクス 部分ファイルから
からの「Include LyX File」コマンドを使用して、既存の LyX ファイルに含めることができます。
LyX の挿入メニュー。

-m モジュール。 指定されたモジュールをロードします。 これは次の場合に便利です テクス2リクス 自動的には行われません
特定のモジュールを検出しますが、いくつかのコマンドを提供するモジュールはわかっています。
インポートされたファイルで使用される環境。 モジュールは次の場所にロードされます。
与えられた命令。 モジュールの場合 foo モジュールに依存する バー, バー 前に与えなければなりません foo.

-f 力。 テクス2リクス 生成される .lyx ファイルがすでに存在する場合は実行されません。 使用
　 -f 既存のファイルを上書きするオプション (慎重に)。

-e エンコーディング ファイルで定義されている LaTeX 名を使用して、デフォルトのエンコーディングを指定します。
テクス2リクス このエンコーディングを使用しますが、エンコーディングの変更が見つかった場合は切り替えます
入力内のコマンド。

-fixedenc
エンコーディング ファイルで定義されている LaTeX 名を使用してエンコーディングを指定します。
テクス2リクス 入力内のエンコーディング変更コマンドは無視されます。

-n ノーウェブ。 noweb (別名リテラシープログラミング) ファイルを翻訳します。 これは（ほぼ？）
「noweb2lyx foo.tex foo.lyx」を実行するのと同等です。 このオプションには、 -c
オプションを選択します。

-スキップ子供たち
\include および \input によって含まれる子ドキュメントを翻訳しないでください。 このオプションは
子ドキュメントが生成されたファイルである場合や、子ドキュメントに多くのコマンドが含まれている場合に便利です。
テクス2リクス まだ理解していません。

-s 構文ファイル。 読み取る入力構文ファイル (XNUMX つ以上の引用符で囲まれたカンマ区切り)
デフォルトに加えて。 (「 構文 詳細については）。

-sysdir
システムディレクトリを指定します。 通常、これは必要ありません。 LyX システム
ディレクトリが選択されます。 参照。 詳細については「ファイル」セクションを参照してください。

-userdir
ユーザーディレクトリを指定します。 通常、これは必要ありません。 あなたの LyX ユーザー
ディレクトリが選択されます。 参照。 詳細については「ファイル」セクションを参照してください。

-往復
LyX を呼び出して、作成した出力ファイルを LaTeX に再エクスポートします。 出力ファイル名が
指定されていない場合は、入力ファイルの上書きを避けるために自動的に決定されます。
事故: 入力ファイルに名前が付けられている場合 foo.tex 出力ファイルには名前が付けられます
foo.lyx.lyx、再エクスポートされたファイルには次の名前が付けられます。 foo.lyx.tex.

-コピーファイル
含まれているすべてのファイルをコピーする テクス2リクス 出力が出力ディレクトリにあることを認識します。
ファイルは入力ファイルとは別のディレクトリにあります。 これは、次のような場合に役立ちます。
含まれているファイルが (ラウンドトリップ モードまたは
後で LyX からエクスポートします)。 結果として得られる文書は次のようなものになる可能性があることに注意してください。
コンパイル不可能。 これは、次のようなファイルが必要な場合に発生します。 テクス2リクス については知りません、そして
したがって、出力ディレクトリにはコピーされません。

-助けて ヘルプ。 使用状況情報を印刷して終了します。

-バージョン
バージョン番号とビルド情報を出力して終了します。

DESCRIPTION

イントロダクション
テクス2リクス 指定された名前で LyX ファイルを作成します (または ディレクトリ/foo.lyx 名前がなかったら
与えられた）LaTeXファイルから ディレクトリ/foo.tex.

サフィックス .tex、.ltx、および .latex がサポートされています。 もし 入力ファイル 存在しないし、存在しない
これらの接尾辞のいずれかを持ち、 テクス2リクス 翻訳してみます 入力ファイル.tex。 (これも似たようなもんだ
LaTeX の動作に影響します。)

の目的 テクス2リクス 翻訳することです 善行 LaTeX2eをLyXに変換します。 LaTeX ファイルの場合
コンパイルされません --- または、標準の LaTeX コマンドを再定義するなどの奇妙なことをすると ---
窒息する可能性があります。 LaTeX209 は多くの場合正しく翻訳されますが、保証されません。

テクス2リクス いくつかの機能が欠けています。 ただし、その主な目的は次のとおりです。

· 正常に動作する LaTeX2e ファイルをクラッシュせずに処理する

· そのファイルの多くを翻訳します。

・翻訳できない部分をローカライズしてTeXモードでコピーする

ほとんどのファイルでこれらの主な目的をかなりうまく達成できます。

使用法
ここでは、LaTeX 文書を
LyX。

・ 走る テクス2リクス.

テクス2リクス 進行状況を通知し、標準エラー出力に警告を出します。
何も出力したくない場合は、(csh で) `tex2lyx foo.tex >& /dev/null' を試してください。 あなたがすべき
標準出力をにリダイレクトしないでください foo.lyx.

· 生成された .lyx ファイルに対して LyX (バージョン 2.1 以降) を実行します。

理論的には、ファイルの大部分は翻訳されているはずです。
翻訳できないものは TeX コード (LyX 言語の ERT) に転送されます。 理論的には、LyX は
ファイルを読み取って、そこから印刷ドキュメントを作成することができます。
未翻訳の ERT のものは直接 LaTeX に戻され、LyX はこれを
バックエンド。 残念ながら、現実は必ずしも理論を反映するとは限りません。 もし テクス2リクス クラッシュ、または
LyX は、生成された LyX ファイルを読み取ることができません。以下の「バグ」セクションを参照してください。

· 変換するものは、可能であれば LyX 機能に TeX コードとして手動で挿入されています。

上で述べたように、何もしなくても LyX ファイルを印刷できるはずです。
これ。 ただし、TeX コード内のコマンドを対応する LyX オブジェクトに変更すると、
LyX の WYSIWYM 編集を利用できるようになります。

テクス2リクス まったく同じ出力を生成する LyX ファイルを作成することは保証されていません
LaTeX ファイルとして保存されますが、その目的はこれを達成することです。 テクス2リクス 一般的にはエラーになります
結果として得られる出力ファイルが正確であることを保証するために翻訳を減らす側、
たとえこれによって TeX コードが増え、WYSIWYM が減ったとしてもです。

· 文書を校正してください!!

いずれにしてもこれを行う予定だったと思いますが、特に重要なのは、
LaTeX文書を翻訳しています。 テクス2リクス 「マクロ翻訳」が得意です（翻訳
「マイクロ翻訳」（あらゆる細部を翻訳する）よりも、文書全体を翻訳する必要があります。 のために
たとえば、余分なスペースや削除されたスペースが表示される場合があります。 空間処理は改善されましたが、
完璧ではありません。

この試験は テクス2リクス できる Handle
テクス2リクス 多くの LaTeX コマンドを理解します。 翻訳すると次のようになります。

· 通常のテキスト (~、`'、\@、\TeX などのミニコマンドやアクセント付きを含む)
\'{a} などの文字、および特殊なケース ?` および !`

· \author、\date、\title、\ thanks などのタイトル コマンドと抽象環境

· スター付きコマンドを含む \section のような見出しコマンド (\section*)

· 環境: 引用、引用、詩。 中央、右揃え、左揃え

· itemize、enumerate、description 環境とその \item コマンド。 また、
行儀の良いネストされたリスト

· 相互参照コマンド: \ref、\pageref、\label、\cite

· \脚注と\マージン

· \em、\emph、\textit などのフォント変更コマンド、およびそれに対応するコマンド
ファミリ、サイズ、シリーズ、形状を変更する

· \input{foo} (または \input{foo.blah}) および \include{foo}。 Plain TeX \input コマンド "\input
foo.tex」にも対応しています。

· 表形式の環境、およびその中に含まれる \hline、\cline、および
\multicolumn (ただし以下を参照)

· float 環境 table と table*、およびその中の \caption コマンド

· float 環境の Figure および Figure*、グラフィックス組み込みコマンド \epsf、
\epsffile、\epsfbox、\epsfxsize、\epsfig、\psfig、\includegraphics。 どちらも
\includegraphics のグラフィックスおよびグラフィックス形式がサポートされています。

· 書誌環境と \bibitem コマンド、および BibTeX の \bibliography
および \bibliographystyle コマンド

· その他のコマンド: \hfill、\\、\noindent、\ldots...

· LyX に変換できるドキュメントクラス固有の環境 (および一部のコマンド)
レイアウト

· 特定の翻訳不可能なコマンドへの引数 (例: \mbox)

このサポートの一部はまだ 100% ではない可能性があります。 詳細は以下を参照してください

テクス2リクス LaTeX ファイルから数学を (ほぼ) そのままコピーします。 幸いなことに、LyX は LaTeX を読み込みます。
数学なので、LyX でサポートされている (ほぼ) あらゆる数学は問題なく動作するはずです。

テクス2リクス プリアンブルコマンド (つまり、\begin{document} より前のもの) をそのままコピーします。
したがって、前文に盛り込んだ派手な内容は印刷文書に保存する必要があります。
もちろん、LyX ウィンドウには表示されません。 「ドキュメント」->「設定」->「LaTeX」を確認します。
結果を確認するための前文。

この試験は テクス2リクス することはできません Handle --- だけど それはだ OK
· いくつかのスペースコマンド (\hspace、\pagebreak、\linebreak)

· \centering、\raggedleft、\raggedright

· \verb と逐語的環境。 テクス2リクス コピーするのに注意しています 正確に この場合、
コメントや空白も含まれます。

· 未知の (ユーザー定義など) 環境とコマンド

テクス2リクス 不明なコマンドとその引数をそのまま LyX ファイルにコピーします。
また、「foo」環境を認識しない \begin{foo} を見つけた場合、
\end{foo} が表示されるまでそのままコピーします ( -r オプション）。 これらのほとんどは
不明なコマンドは原因になりません テクス2リクス 壊す; 彼らはあなたにいくつかのことを要求するだけです
LyX にファイルをロードしたら編集します。 編集するよりも苦痛は少ないはずです
テキスト エディタを使用して .tex ファイルまたは .lyx ファイルを作成します。

この試験は テクス2リクス ハンドル ひどく --- 別名 バグ
Since テクス2リクス 比較的新しいものですが、多くの問題があります。 成熟するにつれて、これらのバグは
潰されてしまいます。

· 未知の環境やコマンドの「正確な」コピーは、完全に正確ではありません。 この意志
醜い LyX が生成されますが、ほとんどの場合、出力は同じになります。 ただし、ほとんどの
ファイルの一部は空白やコメントも含めて完全にコピーされます。 これ
含まれるもの: LaTeX プリアンブル、逐語的環境、および \verb コマンド、および
ブロックをスキップします。

· テクス2リクス ドキュメント クラス オプションのサブセットのみをネイティブ機能に変換します。
他のオプションは、「ドキュメント」->「設定」ポップアップの「オプション」フィールドに配置されます。

より重要なことに、 テクス2リクス \newcommands、不明な \usepackage コマンドは翻訳されません
およびプリアンブル内のその他の不明なコード。 それを LaTeX プリアンブルにコピーするだけです。
特別なコマンドを使用する場合、たとえば、テキスト レイアウトを指定しない方法で指定する場合。
LyX では理解できますが、tex2lyx では認識されません。 これらの設定は次のようになりますので注意してください。
LyX のドキュメント設定でテキスト レイアウトを変更すると上書きされます。 削除したほうがよい
LaTeX プリアンブルのこれらの特別なオプション ([ドキュメント] -> [設定] -> [LaTeX プリアンブル])
可能であれば、対応する LyX ドキュメント設定を使用してください。

· Foil ドキュメント クラスにはいくつかのバグがあります。 テクス2リクス と奇妙なことをするかもしれない
\foilhead コマンドのオプションの引数。 また、\begin{dinglist} を処理することもできます
間違っています (ただし、環境内の内容は正常に翻訳されるはずです)。

すべての既知のバグ テクス2リクス に見つけることができます http://www.lyx.org/trac/wiki/BugTrackerHome.

テクス2リクス かなり頑丈です。 上で述べたように、ファイルを完全に翻訳できない可能性があります。
ただし、結果は使用可能であり、クラッシュしないはずです。 問題が発生した場合は---そして
問題は上記のいずれかではありません
http://www.lyx.org/trac/wiki/BugTrackerHome---の説明に従って問題を報告してください。
セクション バグ レポート.

この試験は リュクス することはできません Handle
LyX 自体にはいくつかの機能がありません。 テクス2リクス 物事を翻訳します
完全に、LyX はまだそれを読み取るのに問題があるかもしれません。 これらの機能が本当に必要な場合は、
最終的な文書を LaTeX としてエクスポートし、元に戻すことができます。 を参照してください。 バグ 詳細については、
これらのバグについて。

· 多くのコマンド (\\ など) では、LyX はオプションの引数をサポートしません。
テクス2リクス オプションの引数は自動的に破棄され、警告が標準出力に出力されます。
LyX は、書誌環境の幅引数も無視します。

· LyX のテーブルのサポートは完全ではありません。 複雑なテーブルの場合は、「スキップ」ブロックを使用します。
TeX モードでコピーされることを確認します。

· LyX では、TeX で認識されている単位 (in、cm など) で図のサイズを指定できます。
\textwidth、\textheight、\columnwidth のパーセンテージも変換しますが、他のパーセンテージは変換しません
長さ (たとえば、何らかの理由で Figure を \topmargin のサイズに拡大縮小したい場合)。
テクス2リクス TeX モードでは翻訳できないサイズの図をコピーします。 繰り返しますが、あなたはそうかもしれません
LyX内でそれを修正できます。

例

テクス2リクス -f -r 「myenv」foo.tex

上記により、foo.tex からファイル foo.lyx が作成され、必要に応じて上書きされます。 それがいつ
\begin{myenv} ... \end{myenv} ブロックを見つけると、ブロック内の内容を翻訳します。
ただし、 \begin と \end コマンドは TeX モードでコピーします。

テクス2リクス -n -c 「読み書き記事」foo.tex

上記は、noweb ドキュメントを LyX 文芸記事ドキュメントに変更します。 ユーザーなら、
noweb ドキュメントに documentclass アーティクルがある場合にこれを実行します。

注意事項

バグ レポート
バグは LyX バグ トラッカーに報告してください。
http://www.lyx.org/trac/wiki/BugTrackerHome。 さらに、メッセージを投稿することもできます。
LyX 開発者のメーリング リスト。 現在のアドレスは [メール保護]。 もしあなたの
メッセージがバウンスした場合は、LyX ホームページを確認してください。 http://www.lyx.org/。 あなたが走っているなら
テクス2リクス 巨大なファイルの場合は、すべての出力をバグ レポートに含めないでください。 ただ
出力の最後の XNUMX 行または XNUMX 行と、LaTeX ファイルの一部を含めます。
に衝突した。 または、さらに良いのは、同じ問題を引き起こす小さいながらも完全なファイルを添付することです。
問題を元のファイルとして保存します。

レイアウト
テクス2リクス LyX レイアウト ファイルを読み取り、LaTeX 環境とコマンドの処理方法を知る
これは LyX レイアウトに変換されます。 このファイルにはすべての「通常の」非数学が含まれます
環境 (つまり、引用と項目化は含まれますが、表形式、ミニページ、およびその他のものは含まれません)
派手な環境)、および \section や \title などのコマンド。 クラスを tex2lyx したい場合
既存のレイアウト ファイルがない場合は、レイアウト ファイルを作成する必要があります。 しかし
LyX はレイアウト ファイルに依存しているため、ファイルを LyX するにはとにかくこれを行う必要があります。
そのファイルを表示および処理する方法を知っている必要があります。 これに関するヘルプについては、LyX のドキュメントを確認してください。
タスク (レイアウト ファイルを作成するクラスに応じて、難しい場合も簡単な場合もあります)
) クラスがレイアウト ファイルを持つクラスとよく似ている場合は、次のことを検討してください。
-c オプションを選択します。

構文
テクス2リクス は常に、デフォルト構文ファイルと呼ばれる少なくとも XNUMX つの構文ファイルを読み取ります。 テクス2リクス
個人用構文ファイルが存在する場合はそれを読み取ります。 それ以外の場合は、システム全体の
ファイルにソフトウェアを指定する必要があります。 テクス2リクス で指定すると、追加の構文ファイルが読み取られます。 -s オプションを選択します。
(これらの追加ファイルはデフォルト ファイルと同じ形式である必要がありますが、通常は
デフォルトのファイルにない追加のコマンドを指定するだけでよいため、より短くなります。)
構文ファイルは伝えます テクス2リクス いくつかのこと。

まず、各コマンドの構文、つまり必要な引数の数と、
コマンドが取るオプションの引数の数。 これを知ることで、より簡単になります テクス2リクス 〜へ
翻訳方法がわからない (TeX モードの) コマンドをコピーします。 構文ファイルは単純に
コマンドがあり、その後にその引数を正しく説明する中括弧または括弧が続きます
注文。 たとえば、構文ファイルのエントリ \bibitem[]{} は、\bibitem コマンドが
オプションの引数の後に必須の引数が続き、エントリ \bf は \bf を意味します。
コマンドは引数をまったく取りません。 いつ テクス2リクス 未知のトークンに遭遇しました
LyX に変換する方法を指定すると、正しい数のトークンとともにトークンがコピーされます。
引数---その通りです。 トークンが構文ファイルにない場合は、 テクス2リクス としてコピーするだけです
見つかった多くの引数。 これは、コピーが多すぎる可能性があることを意味します。 しかし、ユーザーはできるので、
追加の構文ファイルを指定しますが、これは頻繁に起こるべきではありません。

\mbox など、LyX に変換できない一部のコマンドは、引数の XNUMX つとして を持ちます。
通常の LaTeX テキスト。 文字列「translate」を引数に入れると、
(翻訳不可能な) コマンドを構文ファイルに追加し、 テクス2リクス その議論を翻訳します
そのままコピーするのではなく。 したがって、たとえば、デフォルトの構文ファイルには次のようなものがあります。
\raisebox{}[][]{翻訳}。 これは、 \raisebox コマンドと最初の引数が
(存在する場合はオプションの引数も) TeX モードでコピーされますが、最後の引数は
(数学、複雑な LaTeX、その他の翻訳不可能なコマンドなどが含まれる場合があります)
LyXに翻訳されました。 オプションの引数に「translate」を使用することはできません。

ユーザー定義の構文ファイルは、新しいコマンドとその構文を定義したり、オーバーライドしたりすることができます。
デフォルトの構文ファイルで指定されたコマンドの引数の数。 (たとえば、あなたが
何らかのコマンドに追加の引数を与えるスタイルを使用します...) ただし、これは単に
TeX モードでコピーされたコマンドに便利です。 実際に翻訳されるコマンド テクス2リクス
(\item のように) 引数の構文はハードコーディングされています。 ハードコードされたコマンドが識別される
デフォルトの構文ファイル内。

次に、構文ファイルには「通常の環境」が記述されています。 通常、まったく未知の
環境は TeX モードでコピーされます。 ただし、通常の環境「foo」を定義すると、
この場合、\begin{foo} と \end{foo} コマンドのみが TeX モードでコピーされます。 テキスト
環境内では、次のように処理 (つまり、翻訳) されます。 テクス2リクス 通常の LaTeX と同様に、
TeX モードにコピーされるのではなく。 「タブ」と「画像」を次のように宣言しようとしないでください。
通常の環境。これらの環境内のテキストは混乱を招くため、 テクス2リクス; これを使って
プレーン テキスト、数学、または単純なコマンドを含む新しい環境を作成するための機能
それらの中で。 また、未知の数学環境 (equation* など) を通常のものとして宣言することもできません。
LyX 数学エディターはそれらを理解できないため、環境も同様です。 の名前
通常の環境は、\begin{tex2lyxre} と \begin{texXNUMXlyxre} の間に空白で区切られて表示されます。
構文ファイル内の \end{tex2lyxre} ステートメント。 (通常の環境があれば、
あまり頻繁には使用しませんが、 -r 構文ファイルを作成するのではなく、オプションを使用します。)

警告

元の LaTeX ファイルのコピーを、別の名前または別名で常に保管してください。
異なるディレクトリ。 LyX を使用すると上書きが発生する可能性がある方法がいくつかあります。
オリジナルの LaTeX ファイル。

foo.tex をインポートして foo.lyx を作成し、その後 foo.lyx を編集して再エクスポートする場合は、次の点に注意してください。
元の foo.tex を上書きします。 (LyX は上書きするかどうかを尋ねます
それ。）

ENVIRONMENT

LYX_DIR_21x
を使用して、使用するシステム ディレクトリを指定できます。

システム ディレクトリは、ファイル「chkconfig.ltx」を検索することによって決定されます。 ディレクトリ
次の順序で検索されます。
1) -sysdir コマンドラインパラメータ
2) LYX_DIR_21x 環境変数
3) たぶん/TOP_SRCDIR/lib
4) /../共有/ /
5) ハードコードされた lyx_dir (ビルド時: /usr/share/lyx)

LYX_USERDIR_21x
を使用して、使用するユーザー ディレクトリを指定できます。

ユーザー ディレクトリは、優先順位に従って次のようになります。
1) -userdir コマンドラインパラメータ
2) LYX_USERDIR_21x 環境変数
3) $HOME/。 明示的な設定が行われていない場合

onworks.net サービスを使用してオンラインで tex2lyx を使用する