这是 tex2lyx 命令,可以使用我们的多个免费在线工作站之一在 OnWorks 免费托管服务提供商中运行,例如 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器
程序:
您的姓名
tex2lyx - 将表现良好的 LaTeX 翻译成 LyX
概要
最简单的使用方法 tex2lyx 是通过 LyX 中的 File->Import->LaTeX (plain) 菜单项。
那运行 tex2lyx 在给定的文件上并将结果文件加载到 LyX。 你应该试试
首先,只有在需要使用更复杂的时候才从命令行调用它
选项。
tex2lyx [ -用户目录 用户目录 [ -系统目录 系统目录 [ -f [ -n [ -c 文本类 [ -e
编码 [ -固定 编码 [ -m module1[,module2...]] [ -s 文件1[,文件2...]] [
-跳过孩子 [ -往返 [ -复制文件 ] 输入文件 [ 输出文件 ]
配置
-c 班级。 默认情况下,当 tex2lyx 看到一个 \documentclass{foo} 命令,它创建一个
文本类“foo”的文件并读取该类的 LyX 布局文件(某些东西
像 /usr/local/share/lyx/layouts/foo.layout 或 主页/.lyx/layouts/foo.layout)。 用
-c 声明不同的文本类(并读取不同的布局文件)。
如果输入文件是 LaTeX 片段,没有前导码,则需要此选项
问题或 \begin{document} 命令。 LyX 文件由 tex2lyx 从部分文件
可以使用“Include LyX File”命令包含在现有的 LyX 文件中
LyX 的插入菜单。
-m 模块。 加载给定的模块。 这很有用,如果 tex2lyx 不会自动
检测给定的模块,但您知道提供某些命令的模块或
导入文件中使用的环境。 模块加载在
给定的命令。 如果一个模块 FOO 依赖于一个模块 酒吧, 酒吧 必须在之前给出 FOO.
-f 力量。 tex2lyx 如果它生成的 .lyx 文件已经存在,则不会运行。 用
这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。 -f 选项(小心地)破坏任何现有文件。
-e 使用编码文件中定义的 LaTeX 名称指定默认编码。
tex2lyx 将使用此编码,但如果发现任何编码更改,则切换
输入中的命令。
-固定
使用编码文件中定义的 LaTeX 名称指定编码。
tex2lyx 将忽略输入中的任何编码更改命令。
-n 无网。 翻译 noweb(又名文学编程)文件。 这应该是(几乎?)
相当于运行“noweb2lyx foo.tex foo.lyx”。 此选项需要 -c
选项。
-跳过孩子
不要翻译通过 \include 和 \input 包含的子文档。 这个选项是
如果子文档是生成的文件和/或包含许多命令
tex2lyx 还不明白。
-s 语法文件。 要读入的输入(一个或多个带引号的、逗号分隔的)语法文件
除了默认值。 (见有关部分 句法 档 了解详细信息)。
-系统目录
指定系统目录。 通常,你不应该需要这个。 你的 LyX 系统
目录被选中。 参见有关详细信息,请参阅文件部分。
-用户目录
指定用户目录。 通常,你不应该需要这个。 您的 LyX 用户
目录被选中。 参见有关详细信息,请参阅文件部分。
-往返
调用 LyX 将创建的输出文件重新导出到 LaTeX。 如果输出文件名是
没有给出它是自动确定的,以避免覆盖输入文件
事故:如果输入文件被命名 文本文件 输出文件将被命名
foo.lyx.lyx, 重新导出的文件将被命名为 foo.lyx.tex 文件.
-复制文件
复制所有包含的文件 tex2lyx 知道输出目录,如果输出
文件位于与输入文件不同的目录中。 这很有用,如果你
想要确保没有包含的文件被覆盖(在往返模式下或通过
稍后从 LyX 导出)。 请注意,生成的文件可能是
无法编译。 如果它需要文件,就会发生这种情况 tex2lyx 不知道和
因此不会复制到输出目录。
-救命 帮助。 打印使用信息并退出。
-版
打印出版本号和构建信息并退出。
商品描述
介绍
tex2lyx 将创建一个具有指定名称的 LyX 文件(或 目录/foo.lyx 如果没有名字
给定)来自 LaTeX 文件 目录/foo.tex.
支持后缀 .tex、.ltx 和 .latex。 如果 输入文件 不存在也不
有这些后缀之一, tex2lyx 将尝试翻译 输入文件.tex. (这个类似
到 LaTeX 的行为。)
在我们看来, tex2lyx 是翻译 举止得体 LaTeX2e 到 LyX。 如果你的 LaTeX 文件
不编译---或者如果你做了奇怪的事情,比如重新定义标准的 LaTeX 命令---它
可能会窒息。 LaTeX209 通常会被正确翻译,但不能保证。
tex2lyx 缺少一些功能。 但是,其主要目标是:
· 通过一个表现良好的 LaTeX2e 文件而不会崩溃
· 翻译了很多那个文件。
· 将无法翻译的部分本地化并以TeX模式复制
它在大多数文件上都很好地实现了这些主要目标。
用法
这是将 LaTeX 文档翻译为
莱克斯。
· 跑 tex2lyx.
tex2lyx 将通知您其进度并向 stderr 发出任何警告,因此如果您
根本不需要任何输出,尝试(在 csh 中)`tex2lyx foo.tex >& /dev/null'。 你应该
不将标准输出重定向到 foo.lyx.
· 在生成的 .lyx 文件上运行 LyX(2.1 版或更高版本)。
理论上,大部分文件都会被翻译,任何
无法翻译的将被转换为 TeX 代码(在 LyX 中为 ERT)。 理论上,LyX 会
能够读取文件,并从中创建打印文档,因为所有这些
未翻译的 ERT 内容将直接传递回 LaTeX,LyX 将其用作
后端。 不幸的是,现实并不总是反映理论。 如果 tex2lyx 崩溃,或
LyX 无法读取生成的 LyX 文件,请参阅下面的 BUGS 部分。
· 如果可能,将已作为 TeX 代码插入的内容手动转换为 LyX 功能。
如上所述,即使不执行任何操作,您也应该能够打印出 LyX 文件
这个。 但是,将 TeX 代码中的命令更改为相应的 LyX 对象将
允许您利用 LyX 的 WYSIWYM 编辑。
tex2lyx 不能保证创建一个生成完全相同输出的 LyX 文件
作为 LaTeX 文件,尽管它的目标是实现这一点。 tex2lyx 通常会出错
少翻译的一面,以确保生成的输出文件准确无误,
即使这会导致更多的 TeX 代码和更少的 WYSIWYM。
· 校对文件!!
我敢肯定你无论如何都打算这样做,但它在之后尤为重要
翻译 LaTeX 文档。 tex2lyx 更擅长“宏观翻译”(翻译
整个文档)而不是“微翻译”(翻译每一个小细节)。 为了
例如,您可能会看到多余的空格或删除的空格。 空间处理有所改善,但
它并不完美。
什么是 tex2lyx 能够 手柄
tex2lyx 理解许多 LaTeX 命令。 它会翻译:
· 常规文本,包括像 ~、`'、\@、\TeX 这样的小命令,以及重音
像 \'{a} 这样的字符,以及特殊情况 ?` 和 !`
· 标题命令,如 \author、\date、\title、\thanks 和抽象环境
· 像 \section 这样的标题命令,包括带星号的命令 (\section*)
· 环境:引用、引用和诗句; 居中、右对齐和左对齐
· 逐项列出、枚举和描述环境,以及它们的\item 命令。 还,
表现良好的嵌套列表
· 交叉引用命令:\ref、\pageref、\label 和 \cite
· \footnote 和 \margin
· 字体改变命令包括\em、\emph、\textit,以及相应的命令
更改系列、大小、系列和形状
· \input{foo}(或\input{foo.blah})和\include{foo}。 普通 TeX \input 命令“\input
foo.tex”也受支持。
· 表格环境,以及进入其中的命令,如 \hline、\cline 和
\multicolumn(但见下文)
· 浮动环境表和表*,以及其中的 \caption 命令
· 浮动环境图形和图形*,以及图形包含命令\epsf,
\epsffile、\epsfbox、\epsfxsize、\epsfig、\psfig 和 \includegraphics。 这俩
支持 \includegraphics 的 graphics 和 graphicsx 形式。
· thebibliography 环境和 \bibitem 命令,以及 BibTeX 的 \bibliography
和 \bibliographystyle 命令
· 其他命令:\hfill、\\、\noindent、\ldots...
· 可以转换为 LyX 的特定于文档类的环境(和一些命令)
布局
· 某些不可翻译命令的参数(例如\mbox)
其中一些支持可能还不是 100%。 详情请见下文
tex2lyx 从您的 LaTeX 文件中逐字复制数学(几乎)。 幸运的是,LyX 在 LaTeX 中读取
数学,因此(几乎)任何由 LyX 支持的数学都应该可以正常工作。
tex2lyx 将逐字复制任何序言命令(即 \begin{document} 之前的任何内容)。
因此,您在序言中的花哨内容应该保存在印刷文件中,
尽管它当然不会出现在 LyX 窗口中。 检查文档->设置->LaTeX
序言以查看结果。
什么是 tex2lyx 不能 手柄 --- 但是, 它的 OK
· 一些间距命令(\hspace、\pagebreak 和\linebreak)
· \居中、\raggedleft、\raggedright
· \动词和逐字环境。 tex2lyx 小心抄袭 究竟 在这种情况下,
包括注释和空格。
· 未知(例如,用户定义的)环境和命令
tex2lyx 将未知命令及其参数逐字复制到 LyX 文件中。
此外,如果它看到一个 \begin{foo} 无法识别“foo”环境,它会
逐字复制直到看到 \end{foo} (除非你使用 -r 选项)。 其中大部分
未知命令不会导致 tex2lyx 打破; 他们只会要求你做一些
在 LyX 中加载文件后进行编辑。 这应该比编辑更痛苦
使用文本编辑器的 .tex 或 .lyx 文件。
什么是 tex2lyx 手柄 惨 --- 又名 BUGS
建立 tex2lyx 比较新,有很多问题。 随着它的成熟,这些错误
会被压扁。
· 未知环境和命令的“精确”复制不是很精确。 这会
产生丑陋的 LyX,但在几乎所有情况下,输出都是相同的。 然而,大多数
文件的某些部分将被完美复制,包括空格和注释。 这个
包括:LaTeX 前言、逐字环境以及 \verb 命令,以及
跳过块。
· tex2lyx 仅将文档类选项的一个子集转换为本机功能。
其他选项放置在“文档”->“设置”弹出窗口的“选项”字段中。
更重要的是, tex2lyx 不翻译 \newcommands,未知 \usepackage 命令
和序言中的其他未知代码。 它只是将其复制到 LaTeX 序言中。
如果您使用特殊命令,例如以一种不符合要求的方式指定文本布局
LyX 理解,tex2lyx 不会识别它。 请注意,这些设置将
如果您在 LyX 的文档设置中修改文本布局,则会被覆盖。 最好删除
LaTeX 序言中的这些特殊选项 (Document->Settings->LaTeX Preamble) 和
如果可能,请使用相应的 LyX 文档设置。
· 箔文档类有几个错误。 tex2lyx 可能会做奇怪的事情
\foilhead 命令的可选参数。 此外,它可以处理 \begin{dinglist}
不正确(尽管环境中的东西应该正常翻译)。
所有已知的错误 tex2lyx 可以找到 http://www.lyx.org/trac/wiki/BugTrackerHome.
tex2lyx 比较稳健。 如上所述,它可能无法完美地翻译您的文件,
但结果应该是可用的,它不应该崩溃。 如果您遇到问题---并且
问题不是上面提到的问题之一
http://www.lyx.org/trac/wiki/BugTrackerHome---请报告问题中的描述
进行了 问题 报表.
什么是 莱克斯 不能 手柄
LyX 本身缺少一些功能,因此即使 tex2lyx 翻译东西
完美,LyX 可能仍然无法阅读它。 如果你真的需要这些功能,你
可以将您的最终文档导出为 LaTeX,然后将它们放回去。参见 BUGS 更多细节
关于这些错误。
· 对于一些命令(如\\),LyX 不支持可选参数。
tex2lyx 将自动丢弃可选参数并警告 stdout。
LyX 还忽略了 thebibliography 环境的 width 参数。
· LyX 对表的支持并不完美。 对于复杂的表,使用“skip”块,所以
它们将以 TeX 模式复制。
· LyX 允许图形的大小以 TeX 已知的单位表示,例如 in、cm 等。
也翻译 \textwidth、\textheight、\columnwidth 的百分比,但没有其他
长度(例如,如果您出于某种原因想将图形缩放到 \topmargin 的大小)。
tex2lyx 将在 TeX 模式下复制具有不可翻译大小的数字。 再一次,你可能是
能够在 LyX 中解决这个问题。
示例
tex2lyx -f -r “myenv”foo.tex
以上将从 foo.tex 创建一个文件 foo.lyx,如有必要会覆盖。 当它
找到一个 \begin{myenv} ... \end{myenv} 块,它将翻译块中的内容,
但是在 TeX 模式下复制 \begin 和 \end 命令。
tex2lyx -n -c “文学文章” foo.tex
以上将把一个 noweb 文档变成一个 LyX literate-article 文档。 一个用户会
如果 noweb 文档具有文档类文章,请执行此操作。
附注
问题 报表
错误应报告给 LyX 错误跟踪器,地址为
http://www.lyx.org/trac/wiki/BugTrackerHome. 此外,您可以将消息发送到
LyX 开发人员的邮件列表。 它的地址目前是 [email protected]。 如果您的
消息反弹,你可以查看LyX主页, http://www.lyx.org/。 如果你在跑
tex2lyx 在一个巨大的文件上,请不要发送错误报告中的所有输出。 只是
包括最后十或二十行输出,连同它的 LaTeX 文件
撞上了。 或者,更好的是,附上一个小而完整的文件,这会导致相同的
问题作为您的原始文件。
布局 档
tex2lyx 读取 LyX 布局文件以了解如何处理 LaTeX 环境和命令
被翻译成 LyX 布局。 该文件将包括所有“正常”非数学
环境(即,包括引用和分项,但不包括表格、小页面和其他一些
花哨的环境),以及像 \section 和 \title 这样的命令。 如果你想 tex2lyx 一个类
如果没有现有的布局文件,那么您必须创建一个布局文件。 但
无论如何你必须这样做,以便对文件进行 LyX,因为 LyX 依赖于布局文件
知道如何显示和处理其文件。 查看 LyX 文档以获得这方面的帮助
任务(这可能很难也可能很容易,这取决于您要创建布局文件的类
for.) 如果您的类与具有布局文件的类非常相似,请考虑
使用 -c 选项。
句法 档
tex2lyx 总是至少读取一个语法文件,称为默认语法文件。 tex2lyx
将读取您的个人语法文件(如果存在); 否则它将读取系统范围内的
文件中。 tex2lyx 将读取额外的语法文件,如果你用 -s 选项。
(这些额外的文件应该与默认文件具有相同的格式,但往往是
更短,因为他们只需要指定默认文件中没有的额外命令。)A
语法文件告诉 tex2lyx 一些东西。
首先,它描述了每个命令的语法,即需要多少个参数和
命令需要多少个可选参数。 知道这一点,更容易 tex2lyx 至
复制(在 TeX 模式下)它不知道如何翻译的命令。 简单的语法文件
有一个命令,后跟大括号或方括号,以正确的方式描述其参数
命令。 例如,语法文件条目 \bibitem[]{} 意味着 \bibitem 命令采用
一个可选参数后跟一个必需参数,而条目 \bf 表示 \bf
命令根本不接受任何参数。 什么时候 tex2lyx 遇到一个它不知道的令牌
如何翻译成 LyX,它会复制令牌---连同正确的数量
争论——正是。 如果令牌不在语法文件中,则 tex2lyx 只是复制为
它发现的许多论点。 这意味着它可能会复制太多。 但由于用户可以
指定额外的语法文件,这不应该经常发生。
一些无法转换为 LyX 的命令,例如 \mbox,将其作为参数之一
常规 LaTeX 文本。 如果将字符串“translate”放入一个
(不可翻译的)命令在语法文件中,然后 tex2lyx 将翻译那个论点
而不是逐字复制。 因此,例如,默认语法文件具有
\raisebox{}[][]{translate}。 这意味着 \raisebox 命令和第一个参数
(和可选参数,如果存在)在 TeX 模式下复制,但最后一个参数
(可能包含数学、复杂的 LaTeX、其他不可翻译的命令等)将是
翻译成 LyX。 您不能对可选参数使用“翻译”。
允许用户定义的语法文件定义新命令及其语法,或覆盖
默认语法文件中给出的命令的参数数量。 (例如,如果你
使用为某些命令提供额外参数的样式......)但是,这只会
对以 TeX 模式复制的命令很有用。 实际翻译的命令 tex2lyx
(如 \item)有他们的参数语法硬编码。 硬编码命令被识别
在默认语法文件中。
其次,语法文件描述了任何“常规环境”。 通常,一个完全未知的
环境将以 TeX 模式复制。 但是,如果您定义一个常规环境“foo”,
那么只有 \begin{foo} 和 \end{foo} 命令将在 TeX 模式下被复制; 文本
在环境中将被处理(即,翻译) tex2lyx 作为普通的 LaTeX,
而不是被复制到 TeX 模式。 不要试图将“tabbing”和“picture”声明为
常规环境,因为这些环境中的文本会混淆 tex2lyx; 用这个
您创建的具有纯文本或数学或简单命令的新环境的功能
在他们之中。 您也不能将未知的数学环境(如 equation*)声明为常规
环境,因为 LyX 数学编辑器不会理解它们。 的名字
在 \begin{tex2lyxre} 和
\end{tex2lyxre} 语句在语法文件中。 (如果您有一个常规环境
你不会经常使用,你可以使用 -r 选项而不是编写语法文件。)
警告
始终保留一份原始 LaTeX 文件的副本,使用不同的名称或
不同的目录。 使用 LyX 可能会导致覆盖的几种方式
原始的 LaTeX 文件。
如果你导入 foo.tex 创建 foo.lyx,然后编辑 foo.lyx 并想重新导出它,注意
它将覆盖原来的 foo.tex。 (LyX 会问你是否要覆盖
它。)
环境
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