Latexdiff - 云端在线

程序：

您的姓名

Latexdiff - 确定和标记两个 Latex 文件之间的差异

概要

乳胶差异 [ 配置 ] 旧的.tex 新的.tex > 差异纺织

商品描述

简而言之， 乳胶差异 是一个帮助管理乳胶修订版的实用程序
文件。 它比较了两个有效的乳胶文件，这里称为“old.tex”和“new.tex”，发现
它们之间的显着差异（即，忽略空格的数量和
换行符的位置），并添加特殊命令以突出显示差异。 在哪里
视觉突出显示是不可能的，例如格式的变化，差异
尽管如此，还是在源代码中进行了标记。

该程序对序言的处理方式与主文档不同。 之间的差异
使用基于行的差分（类似于 Unix diff 命令，
但忽略空格）。 注释 ""%DIF >"" 附加到每个添加的行，即
行存在于“new.tex”中，但不存在于“old.tex”中。 废弃线路
通过在前面加上 ""%DIF <"" 来停用。 更改的块前面有注释行
提供有关原始文件中行号的信息。 哪里有
差异不大，生成的文件“diff.tex”将类似于“new.tex”。 在
序言的结尾，定义 乳胶差异 插入标记命令。 在
区分文本的主体， 乳胶差异 试图满足以下
指导方针（按优先顺序）：

1. 如果 "old.tex" 和 "new.tex" 都是有效的 LaTeX，那么生成的 "diff.tex" 应该
也是有效的 LateX 。 （注意，如果在“old.tex”或
“new.tex”然后“diff.tex”不能保证工作，但通常会）。

2. 显着性差异是在单个词的水平上确定的。 全部
重大差异，包括评论之间的差异应明确
在生成的源代码中标记为“diff.tex”。

3. 如果更改的段落包含文本或文本生成命令，则运行“diff.tex”
通过 LateX 应该产生输出，其中突出显示添加和丢弃的段落。

4. 在没有显着差异的地方，例如在换行符的位置上，
“diff.tex”应该遵循“new.tex”的格式

对于差分相同的算法 差异 使用了单词而不是线条
比较的。 尝试识别完全改变的块，使得
它们可以被标记为一个单元。 注释逐行不同，但数量
注释中的空格被忽略。 包括所有参数的命令通常是
作为一个单元进行比较，即没有在命令的参数中插入任何标记。
但是，对于选定数量的命令（例如，“\caption”和所有分节
命令）最后一个参数已知是文本。 这段文字被拆分成单词和
区别于普通文本（使用选项来显示和更改文本列表
命令，见下文）。 由于该算法没有 LaTeX 的详细知识，它假设所有
紧跟在命令之后的一对大括号（即字母序列
以反斜杠开头）是该命令的参数。 作为条件限制
因此，上面的 1 有必要用大括号将所有参数括起来，而不是
插入多余的空格。 例如，写

\section{\textem{这是一个强调的部分标题}}

并不是

\section {\textem{这是一个强调的部分标题}}

or

\section\textem{这是一个强调的部分标题}

即使所有品种都与 LaTeX 相同（但请参阅 --允许空格 选项
允许第二个品种）。

对于内容不符合标准 LaTeX 或图形化的环境
标记没有意义所有标记命令都可以通过设置 PICTUREENV 来删除
配置变量，默认设置为“picture”和“DIFnomarkup”环境； 看
--配置 选项）。 后一种环境（“DIFnomarkup”）可用于保护部分
标记导致非法标记的乳胶文件。 你必须包围
"\begin{DIFnomarkup}" 和
“\end{DIFnomarkup}”。 您必须在新旧的序言中定义环境
文件。 我更喜欢将其定义为空环境，

"\newenvironment{DIFnomarkup}{}{}"

但选择权在你。 环境中的任何标记都将被删除，并且通常
环境中的所有内容都将从新文件中获取。

也可以区分没有前导码的文件。
在这种情况下，文件是在主文档模式下处理的，但是
不插入标记命令。

插入的所有标记命令 乳胶差异 以 ""\DIF"" 开头。 添加的块包含
在“new.tex”中但不在“old.tex”中的单词、命令或注释被标记为
"\DIFaddbegin" 和 "\DIFaddend"。 被丢弃的块用“\DIFdelbegin”和
“\DIFdelend”。 在添加的块中，所有文本都用“\DIFadd”突出显示，如下所示：
"\DIFadd{Added text block}" 这些文本块中可以包含选定的“安全”命令
以及（使用选项来显示和更改安全命令列表，见下​​文）。 所有其他
命令以及大括号“{”和“}”永远不会放在“\DIFadd”的范围内。 添加
注释由前缀“”%DIF > “”标记。

在已删除的块中，文本以“\DIFdel”突出显示。 已删除的评论标记为
前置“”%DIF <“”。 已删除块中的非安全命令和大括号是
用 ""%DIFDELCMD < "" 注释掉。

配置

前言
以下选项通过添加适当的命令来确定视觉标记样式
序言的定义。 有关可用的说明，请参阅本节末尾
样式。

--type=标记样式 or -t 标记样式
将代码添加到所选标记样式的序言中。 该选项定义了“\DIFadd”和
"\DIFdel" 命令。 可用款式：

"下划线 CTRADITIONAL TRADITIONAL CFONT FONTSTRIKE Invisible CHANGEBAR CCHANGEBAR
CULINECHBAR CFONTCBHBAR BOLD"

[默认值：“下划线”]

--subtype=标记样式 or -s 标记样式
将代码添加到用于括号命令的选定样式的序言中（例如标记更改
在保证金）。 该选项定义了“\DIFaddbegin”、“\DIFaddend”、“\DIFdelbegin”和
"\DIFdelend" 命令。 可用款式：“SAFE MARGIN COLOR DVIPSCOL ZLABEL
ONLYCHANGEDPAGE（标签）*”

[默认值：“SAFE”] * 不推荐使用子类型“LABEL”

--floattype=标记样式 or -f 标记样式
将代码添加到所选样式的序言中，以替换标准标记和标记
浮点数内的命令（例如，边际注释会导致浮点数内的错误，因此
因此可以禁用边缘标记）。 此选项定义所有“\DIF...FL”命令。
可用样式：“FLOATSAFE TRADITIONALSAFE IDENTICAL”

[默认值：“FLOATSAFE”]

--编码=enc or -e ENC
指定 old.tex 和 new.tex 的编码。 典型的编码是“ascii”、“utf8”、
“拉丁1”，“拉丁9”。 可以通过执行获得可用编码列表

"perl -MEncode -e 'print join ("\n",Encode-"encodings(":all")) ;' >

[默认编码为 utf8，除非前导码的前几行包含
调用 "\usepackage[..]{inputenc}" 在这种情况下，由此选择的编码
命令被假定。 请注意，ASCII（标准乳胶）是 utf8 的子集]

--preamble=文件 or -p 文件
在前导码的末尾插入文件而不是生成前导码。 序言必须
定义以下命令 "\DIFaddbegin, \DIFaddend, \DIFadd{..},
\DIFdelbegin,\DIFdelend,\DIFdel{..}," 以及在浮点数中使用的变体
"\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL,
\DIFdelFL{..}"（如果设置了这个选项 -t, -s及 -f 选项被忽略。）

--packages=pkg1,pkg2,..
告诉 latexdiff 处理 .tex 文件并加载列表中的包。 这是
如果 .tex 文件包含序言，通常不需要，因为序言是
自动扫描“\usepackage”命令。 使用 --包 选项
禁用自动扫描，因此如果出于任何原因需要进行特定于包的解析
关闭，使用 --packages=无. 以下包触发特殊行为：

“数学”
配置变量 MATHARRREPL 设置为“align*”（默认值：“eqnarray*”）。
（请注意，许多 amsmath 数组环境已被识别
默认如此）

“尾浮”
确保 "\begin{figure}" 和 "\end{figure}" 始终单独出现在
一条线。

“超级引用”
将 "\DIFadd" 和 "\DIFdel" 命令的名称更改为 "\DIFaddtex" 和
"\DIFdeltex" 并定义新的 "\DIFadd" 和 "\DIFdel" 命令，它们提供了一个
这些命令的包装器，将它们用于文本而不是链接
定义命令（任何标记都会导致错误）。

“沉稳”
重新定义识别为引用命令的命令。

“siunitx”
将 "\SI" 视为等效于引用命令（即，如果
标记样式使用 ulem 包。

“聪明人”
将 "\cref,\Cref" 等视为等效于引用命令（即保护
"\mbox" 如果标记样式使用 ulem 包。

“词汇表”
将大多数词汇表命令定义为安全的，用 \mbox'es 保护它们
需要的地方

“mhchem”
将 "\ce" 视为安全命令，即它会被高亮显示（注意 "\cee"
不会在方程式中突出显示，因为这会导致处理错误）

“化学式”或“化学宏”
将 "\ch" 视为等式之外的安全命令，即它将突出显示
（请注意，“\ch”不会在等式中突出显示，因为这会导致
处理错误）

[ 默认值：扫描“\usepackage”命令的序言以确定
加载的包。 ]

--show序言
将生成或包含的序言命令打印到标准输出。

配置
--exclude-safecmd=排除文件 or -A 排除文件 or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=替换文件
--append-safecmd=附加文件 or -a 附加文件 or --append-safecmd="cmd1,cmd2,..."
排除、替换或附加到正则表达式 (RegEx) 匹配列表
在“\DIFadd”或“\DIFdel”命令范围内可以安全使用的命令。
该文件每行必须包含一个 Perl-RegEx（以 # 或 % 开头的注释行是
忽略）。 注意RegEx需要匹配整个token，即/^regex$/
是隐含的，并且不包括命令的初始“\”。 这
--排除-safecmd 和 --append-safecmd 选项可以与
---替换-safecmd 选项并且可以重复使用以累积添加到列表中。
--排除-safecmd 和 --append-safecmd 也可以将逗号分隔的列表作为输入。
如果正则表达式之一需要逗号，请将其转义为“\,”。 大多数情况下它
将有必要通过将逗号分隔的列表放入 shell 中来保护逗号分隔的列表
引号。

--exclude-textcmd=排除文件 or -X 排除文件 or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=替换文件
--append-textcmd=附加文件 or -x 附加文件 or --append-textcmd="cmd1,cmd2,..."
排除、替换或附加到匹配命令的正则表达式列表
最后一个参数是文本。 见条目 --排除-safecmd 正上方为
更多详细信息。

--replace-context1cmd=替换文件
--append-context1cmd=附加文件 或 = 项目 --append-context1cmd="cmd1,cmd2,..."
替换或附加到最后一个参数是文本的正则表达式匹配命令列表
但是需要特定的上下文才能工作，例如 \caption 只能在
图或表。 这些命令的行为类似于文本命令，除非它们出现在
已删除的部分，当它们被禁用时，但它们的参数显示为已删除
文本。

--replace-context2cmd=替换文件
--append-context2cmd=附加文件 或 = 项目 --append-context2cmd="cmd1,cmd2,..."
作为 context1 的相应命令。 唯一的区别是 context2 命令
在已删除的部分中完全禁用，包括它们的参数。

--exclude-mboxsafecmd=排除文件 or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=附加文件 or --append-mboxsafecmd="cmd1,cmd2,..."
定义安全命令，这些命令还需要通过封装在
\\mbox{..}. 有时需要这样做来解决外部之间的不兼容性
包和 ulem 包，用于以默认样式突出显示
下划线和 CULINECHBAR CFONTSTRIKE

--配置 var1=val1,var2=val2,... or -c var1=val1,..
-c 配置文件
设置配置变量。 该选项可以重复设置不同的变量
（作为逗号分隔列表的替代方法）。 可用变量（见下文
进一步解释）：

“ARRENV”（正则表达式）

“COUNTERCMD”（正则表达式）

“FLOATENV”（正则表达式）

“ITEMCMD”（正则表达式）

“LISTENV”（正则表达式）

“MATHARRENV”（正则表达式）

“MATHARRREPL”（字符串）

“MATHENV”（正则表达式）

“MATHREPL”（字符串）

“MINWORDSBLOCK”（整数）

“PICTUREENV”（正则表达式）

--show-safecmd
打印匹配和排除安全命令的 RegEx 列表。

--show-textcmd
打印带有文本参数的 RegEx 匹配和排除命令的列表。

--显示配置
显示配置变量的值。

- 显示所有
结合所有 --show 命令。

注意对于所有 --show 命令，不需要指定“old.tex”或“new.tex”文件，并且
没有差异发生。

其他名称 配置 opţiuni:
--允许空格
在命令的括号或括号参数之间允许空格。 注意这个选项
可能会产生不良副作用（不相关的范围可能会与前面的内容混为一谈）
命令）所以应该只在默认产生错误结果时使用。 （默认
需要参数直接相互跟随而无需中间空格）。

--math-markup=级别
确定显示的数学环境中标记的粒度：可能的值
级别是（数字和文本标签都可以接受）：

"off" 或 0：抑制数学环境的标记。 删除的方程不会出现
在差异文件中。 如果所有其他模式导致无效的乳胶代码，则可以使用此模式。

“整体”或 1：整体方程水平上的差异。 即使是微不足道的改变
方程导致整个方程被标记为改变。 可以使用这种模式，如果
以粗略或精细模式处理会导致无效的乳胶代码。

“粗”或 2：检测用粗粒度标记的方程中的变化；
方程类型的变化（例如显示数学到方程）显示为对
完整的方程。 建议在内容和顺序不正确的情况下使用此模式
一些方程仍在改变中。 [默认]

"fine" 或 3：检测方程的微小变化并以细粒度标记。 这个
mode 是最合适的，如果只需要对等式进行微小的更改，例如
更正错别字。

--禁用引用标记 or --禁用自动 mbox
使用 ulem 在样式中抑制引用标记和其他易受攻击命令的标记
(UNDERLINE,FONTSTRIKE, CULINECHBAR)（这两个选项是相同的，只是
别名）

--启用引用标记 or --强制自动 mbox
使用以下命令保护已更改部分中的引文命令和其他易受攻击的命令
“\mbox”命令，即对其他包使用 ulem 包的默认行为（
两个选项是相同的，只是别名）

其他
--详细 or -V
处理过程中输出各种状态信息到stderr。 默认是工作
默默。

--驱动程序=类型
为 changebar 包选择驱动程序（仅与使用的样式相关）
变更栏：CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR）。 可能的驱动因素是
在 changebar 手册中列出，例如 pdftex、dvips、dvitops
[默认：dvips]

--忽略警告
禁止有关输入和解析字符串之间长度不一致的警告，以及
缺少字符。 这些警告信息通常与非标准乳胶或
具有“latexdiff”未知语法但由此产生的差异的乳胶结构
无论如何，论点通常是功能齐全的，特别是如果非标准乳胶
出现在文本中没有改变的部分。

--label=标签 or -L 标签
设置用于描述旧文件和新文件的标签。 第一次使用这个选项
设置描述旧文件的标签，第二次使用该选项设置标签
对于新文件，即设置两个标签，如“-L labelold -L labelnew”。 [默认：
使用标签的文件名和修改日期]

- 无标签
禁止在输出文件中包含旧文件名和新文件名作为注释

--可见标签
包括旧文件名和新文件名（或使用“--label”选项设置的标签）作为可见输出。

--压平
将正文中的“\input”和“\include”命令替换为
他们的论点。 如果“\includeonly”出现在序言中，则只有那些文件
扩展到文档中。 但是，没有进行递归，即 "\input" 和
包含部分中的“\include”命令不展开。 包含的文件是
假设
分别位于与旧主文件和新主文件相同的目录中，
可以将文件组织到旧目录和新目录中。 --flatten 是
递归应用，因此输入的文件可以包含更多的“\input”语句。

使用此选项可能会导致较大文档的处理时间过长，
并且生成的差异文档不再反映输入的结构
文档。

- 帮帮我 or -h
显示帮助文本

- 版
显示版本号

预定义 风格
重大的 类型
主要类型决定了纯文本的标记和一些选定的乳胶命令之外
通过定义标记命令 "\DIFadd{...}" 和 "\DIFdel{...}" 来浮动。

“强调”
添加的文本是波浪形下划线和蓝色，丢弃的文本被删除和红色
（需要颜色和 ulem 包）。 Overstriking 在显示中不起作用
数学方程，这样删除的方程部分会加下划线，而不是划线
out（这是 ulem 包固有的缺点）。

“传统”
添加的文本为蓝色并设置为 sans-serif，并为每个文本创建一个红色脚注
丢弃的一段文字。 （需要彩包）

“传统的”
像“CTRADITIONAL”但不使用颜色。

"CFONT" 添加的文字为蓝色且无衬线字体，丢弃的文字为红色且非常
小尺寸。

“字体罢工”
添加的 tex 设置为 sans-serif，丢弃的文本很小并被删除

“CCHANGEBAR”
添加的文本为蓝色，丢弃的文本为红色。 此外，更改后的文本
在边距中用横条标记（需要 color 和 changebar 包）。

“CFONTBAR”
像“CFONT”，但有额外的变更栏（需要颜色和变更栏
包）。

“CULINECHBAR”
像“UNDERLINE”，但有额外的变化条（需要颜色、ulem 和
更改栏包）。

“换吧”
不标记文本，但用 changebars 标记边距（需要 changebar
包裹）。

“无形的”
没有可见的标记（但仍会插入通用标记命令。

"BOLD" 添加的文本以粗体显示，丢弃的不显示。

亚型
子类型定义了在添加或结束的开头和结尾插入的命令
丢弃的块，无论这些块是否包含文本或命令（定义
命令：“\DIFaddbegin、\DIFaddend、\DIFdelbegin、\DIFdelend”）

“SAFE”无附加标记（推荐选择）

"MARGIN" 在附近的边距中用符号标记更改块的开始和结束
（使用标准的“\marginpar”命令 - 请注意这有时会移动
有点偏离预期的位置。

“颜色” 另一种将添加的段落标记为蓝色，将删除的段落标记为红色的替代方法。
（建议使用主要类型来代替彩色标记，
尽管在某些情况下使用 dvipscol 着色可能更完整，例如
与引用命令）。

“DVIPSCOL”
另一种将添加的段落标记为蓝色，将删除的段落标记为红色的另一种方法。
请注意，“DVIPSCOL”仅适用于 dvips 转换器，例如不适用于 pdflatex。
（建议使用主要类型来代替彩色标记，
尽管在某些情况下，使用 dvipscol 着色会更完整）。

“ZLABEL”可用于仅突出显示更改的页面，但需要后期处理。 这是
建议不要手动调用此选项，而是使用“latexdiff-vc”
“--only-changes”选项。 或者，使用序言中给出的脚本
使用这种风格制作的 diff 文件。

“唯一改变的页面”
还突出显示更改的页面，无需后期处理，但可能
如果有浮动材料（数字、表格），则无法可靠地工作。

“LABEL”与“ZLABEL”类似，但不需要zref包，工作较少
可靠（已弃用）。

浮动 类型
正文中使用的某些标记在浮点数中使用时可能会导致问题
（例如数字或表格）。 出于这个原因，所有标记命令的替代版本是
在浮点数中使用。 float 类型定义了这些替代命令。

“漂浮安全”
使用与正文相同的文本标记，但设置所有命令标记
更改块的开始和结束为空命令。 你必须选择这个
float 类型，如果您的子类型是“MARGIN”，因为“\marginpar”不能正常工作
浮标内。

“传统安全”
以与正文相同的方式标记添加内容。 删除的环境是
用尖括号 \[ 和 \] 标记，删除的文本在 scriptscript 中设置
尺寸。 此浮点类型应始终与“TRADITIONAL”和
“CTRADITIONAL”标记类型作为 \footnote 命令在
浮动环境。

“完全相同的”
正文和浮动内容之间没有区别。

配置 变量
"ARRENV" 如果在一个内联数学环境中找到与 "ARRENV" 匹配的
删除或添加块，则内联数学被 "\mbox{"..."}" 包围。
这是必要的，因为下划线在内联数组中不起作用
环境。

[ 默认值："ARRENV"="(?:array|[pbvBV]matrix)"

“反命令”
如果在 textcmd 列表中的已删除块中的命令匹配
"COUNTERCMD" 然后是一个附加命令 "\addtocounter{"控制命令“}{-1}”，其中
控制命令 是匹配的命令，附加在 diff 文件中，以便
diff 文件中的编号与新文件中的编号保持同步
文件中。

[ 默认值："COUNTERCMD"="(?:footnote|part|section|subsection" ...

"|subsubsection|段落|子段落)"]

“浮动”
名称与“FLOATENV”中的正则表达式匹配的环境是
被认为是浮动的。 在这些环境中， 乳胶差异 标记命令是
被他们的 FL 变种所取代。

[ 默认值："(?:figure|table|plate)[\w\d*@]*" ]

“ITEMCMD”命令表示具有列表环境的新项目行。

[默认值：\"项目"]

"LISTENV" 名称与 "LISTENV" 中的正则表达式匹配的环境是列表
环境。

[默认值：“(?:itemize|enumerate|description)”]

“MATHENV”、“MATHREPL”
如果 \begin 和 \end 都用于数学环境（环境名称匹配
"MATHENV" 或 \[ 和 \]) 在同一个被删除的块中，它们被替换为
"MATHREPL" 的 \begin 和 \end 命令，而不是被注释掉。

[ 默认值： "MATHENV"="(?:displaymath|equation)" , "MATHREPL"="displaymath" ]

“MATHARRENV”、“MATHARRREPL”
作为 "MATHENV","MATHREPL" 但对于方程数组

[ 默认值："MATHARRENV"="eqnarray\*?" , "MATHREPL"="eqnarray" ]

“MINWORDSBLOCK”
形成独立区块所需的最少代币数。 这个值是
在算法中用于通过合并相同的块来检测完整块的变化
前面添加和丢弃的小于“MINWORDSBLOCK”的文本部分
部件。

[默认值：3]

“图片环境”
在名称与“PICTUREENV”中的正则表达式匹配的环境中
删除所有 Latexdiff 标记（在病理情况下，这可能会导致
标记不一致，但这种情况应该很少见）。

[ 默认值："(?:picture|DIFnomarkup)[\w\d*@]*" ]

COMMON 问题 AND 常见问题

引用导致盒子过满
“latexdiff”使用的“ulem”包之间存在不兼容
用于在 UNDERLINE 样式、默认样式和
引文的产生方式。 为了能够标记引文
正确地，它们包含在“\mbox”命令中。 由于 mboxes 不能被破坏
跨行，此过程经常导致过满的框，可能
当内容超出右边距时遮住内容。 出现同样情况
对于其他一些软件包（例如 siunitx）。 如果这是一个问题，你有两个
可能性。

1. 使用“CFONT”类型的标记（选项“-t CFONT”）：如果选择此标记，则
更改的引文不再用波浪线（添加）或
删除（删除），但仍以适当的颜色突出显示，以及
删除的文本以不同的字体显示。 其他不使用“ulem”的样式
包也可以工作。

2. 选择选项“--disable-citation-markup”，关闭标记
引文：不再显示已删除的引文，并显示添加的引文
没有标记。 （这是 latexdiff 在 0.6 和
年长）

对于自定义包，您可以定义需要受保护的命令
"\mbox" 带有 "--append-mboxsafecmd" 和 "--excludemboxsafecmd" 选项（提交
您的命令列表作为功能请求在 github 页面设置默认值
未来版本的行为，见第 6 节）

复杂数学方程式的变化导致乳胶加工错误
尝试选项“--math-markup=whole”。 如果即使失败，您也可以关闭标记
使用“--math-markup=off”的方程。

我如何只显示已进行更改的页面
使用选项 -"-s ZLABEL"（需要一些后处理）或 "-s
ONLYCHANGEDPAGE”。带有“--only-changes”选项的“latexdiff-vc --ps|--pdf”
为您处理后处理（需要安装 zref 包）。

使用 onworks.net 服务在线使用 latexdiff