latexdiff - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

latexdiff – Unterschiede zwischen zwei Latexdateien ermitteln und markieren

ZUSAMMENFASSUNG

Latexdiff [ OPTIONAL ] alt.tex neu.tex > diff.tex

BESCHREIBUNG

Kurz, Latexdiff ist ein Hilfsprogramm zur Unterstützung bei der Verwaltung von Latexrevisionen
Unterlagen. Es vergleicht zwei gültige Latexdateien, hier „old.tex“ und „new.tex“ genannt, und findet sie
erhebliche Unterschiede zwischen ihnen (d. h. das Ignorieren der Anzahl der Leerzeichen und
Position von Zeilenumbrüchen) und fügt spezielle Befehle hinzu, um die Unterschiede hervorzuheben. Wo
Eine visuelle Hervorhebung ist nicht möglich, z. B. bei Änderungen in der Formatierung, den Unterschieden
sind in der Quelle dennoch gekennzeichnet.

Das Programm behandelt die Präambel anders als das Hauptdokument. Unterschiede zwischen
Die Präambeln werden mittels zeilenbasierter Differenzierung gefunden (ähnlich dem Unix-Befehl diff,
aber Leerzeichen werden ignoriert). An jede hinzugefügte Zeile wird ein Kommentar „“%DIF >““ angehängt, also a
Zeile in „new.tex“ vorhanden, aber nicht in „old.tex“. Verworfene Zeilen
werden durch das Voranstellen von „%DIF <“ deaktiviert. Geänderte Blöcke werden durch Kommentarzeilen vorangestellt
Angabe von Zeilennummern in den Originaldateien. Wo sind sie
Bei unbedeutenden Unterschieden ähnelt die resultierende Datei „diff.tex“ der „new.tex“. Bei
Am Ende der Präambel sind die Definitionen für Latexdiff Markup-Befehle werden eingefügt. In
Differenzierung des Hauptteils des Textes, Latexdiff versucht Folgendes zu erfüllen
Richtlinien (in der Reihenfolge ihrer Priorität):

1. Wenn sowohl „old.tex“ als auch „new.tex“ gültiges LaTeX sind, sollte das resultierende „diff.tex“ gültig sein
auch LateX gültig sein. (Hinweis: Wenn ein paar einfache TeX-Befehle in „old.tex“ verwendet werden oder
„new.tex“ und dann „diff.tex“ funktionieren nicht garantiert, normalerweise aber).

2. Signifikante Unterschiede werden auf der Ebene einzelner Wörter festgestellt. Alle
Wesentliche Unterschiede, einschließlich Unterschiede zwischen Kommentaren, sollten deutlich sein
im resultierenden Quellcode mit „diff.tex“ gekennzeichnet.

3. Wenn eine geänderte Passage Text oder texterzeugende Befehle enthält, dann wird „diff.tex“ ausgeführt.
über LateX sollte eine Ausgabe erzeugen, in der hinzugefügte und verworfene Passagen hervorgehoben sind.

4. Bei unwesentlichen Unterschieden, z. B. in der Positionierung von Zeilenumbrüchen,
„diff.tex“ sollte der Formatierung von „new.tex“ folgen.

Zur Differenzierung der gleiche Algorithmus wie diff wird verwendet, aber Wörter statt Zeilen
verglichen. Dabei wird versucht, völlig veränderte Blöcke zu erkennen
Sie können als Einheit markiert werden. Kommentare werden Zeile für Zeile unterschieden, aber die Anzahl der
Leerzeichen innerhalb von Kommentaren werden ignoriert. Befehle einschließlich aller ihrer Argumente sind im Allgemeinen
als eine Einheit verglichen, dh es wird kein Markup in die Argumente von Befehlen eingefügt.
Allerdings gilt für eine ausgewählte Anzahl von Befehlen (zum Beispiel „\caption“ und alle Abschnitte
Befehle) ist das letzte Argument bekanntermaßen Text. Dieser Text ist in Wörter und unterteilt
unterscheidet sich genauso wie gewöhnlicher Text (verwenden Sie Optionen, um die Textliste anzuzeigen und zu ändern).
Befehle, siehe unten). Da der Algorithmus keine detaillierten Kenntnisse von LaTeX hat, geht er von allen aus
Paare von geschweiften Klammern, die unmittelbar auf einen Befehl (z. B. eine Buchstabenfolge) folgen
beginnend mit einem Backslash) sind Argumente für diesen Befehl. Als Einschränkung der Bedingung
1 oben ist es daher notwendig, alle Argumente in geschweifte Klammern zu setzen und dies nicht zu tun
Fügen Sie überflüssige Leerzeichen ein. Schreiben Sie zum Beispiel

\section{\textem{Dies ist ein hervorgehobener Abschnittstitel}}

und nicht

\section {\textem{Dies ist ein hervorgehobener Abschnittstitel}}

or

\section\textem{Dies ist ein hervorgehobener Abschnittstitel}

obwohl alle Varianten für LaTeX gleich sind (aber siehe --allow-spaces Option, die
erlaubt die zweite Variante).

Für Umgebungen, deren Inhalt nicht dem Standard-LaTeX entspricht oder in denen es grafisch ist
Markup macht keinen Sinn. Alle Markup-Befehle können durch Festlegen von PICTUREENV entfernt werden
Konfigurationsvariable, standardmäßig auf „picture“- und „DIFnomarkup“-Umgebungen eingestellt; sehen
--config Möglichkeit). Die letztgenannte Umgebung („DIFnomarkup“) kann zum Schutz von Teilen verwendet werden
die Latexdatei, in der das Markup zu einem illegalen Markup führt. Du musst das umgeben
beleidigende Passage sowohl in der alten als auch in der neuen Datei durch „\begin{DIFnomarkup}“ und
„\end{DIFnomarkup}“. Sie müssen die Umgebung sowohl in den Präambeln des Alten als auch des Neuen definieren
Unterlagen. Ich bevorzuge es, es als Nullumgebung zu definieren.

„\newenvironment{DIFnomarkup}{}{}“

aber die Wahl liegt bei Ihnen. Jegliches Markup innerhalb der Umgebung wird im Allgemeinen entfernt
Alles in der Umgebung wird einfach aus der neuen Datei übernommen.

Es ist auch möglich, Dateien zu unterscheiden, die keine Präambel haben.
In diesem Fall wird die Datei im Hauptdokumentmodus verarbeitet, die Definitionen der
Markup-Befehle werden nicht eingefügt.

Alle von eingefügten Markup-Befehle Latexdiff Beginnen Sie mit „\DIF“. Blöcke hinzugefügt, die enthalten
Wörter, Befehle oder Kommentare, die in „new.tex“, aber nicht in „old.tex“ enthalten sind, werden mit gekennzeichnet
„\DIFaddbegin“ und „\DIFaddend“. Verworfene Blöcke werden mit „\DIFdelbegin“ und gekennzeichnet
„\DIFdelend“. Innerhalb hinzugefügter Blöcke wird der gesamte Text mit „\DIFadd“ hervorgehoben, etwa so:
„\DIFadd{Hinzugefügter Textblock}“ Ausgewählte „sichere“ Befehle können in diesen Textblöcken enthalten sein
auch (verwenden Sie Optionen, um die Liste der sicheren Befehle anzuzeigen und zu ändern, siehe unten). Alle anderen
Befehle sowie geschweifte Klammern „{“ und „}“ werden niemals in den Gültigkeitsbereich von „\DIFadd“ eingefügt. Hinzugefügt
Kommentare werden durch das Voranstellen von „%DIF > „“ gekennzeichnet.

Innerhalb gelöschter Blöcke wird Text mit „\DIFdel“ hervorgehoben. Gelöschte Kommentare sind mit gekennzeichnet
mit dem Präfix „%DIF <“ Nicht sichere Befehle und geschweifte Klammern innerhalb gelöschter Blöcke sind
auskommentiert mit „%DIFDELCMD < „“.

OPTIONAL

Präambel
Die folgenden Optionen bestimmen den visuellen Markup-Stil durch Hinzufügen des entsprechenden Befehls
Definitionen zur Präambel. Eine Beschreibung der verfügbaren Optionen finden Sie am Ende dieses Abschnitts
Stile.

--type=Markupstyle or -t Markupstil
Fügen Sie Code zur Präambel für den ausgewählten Markup-Stil hinzu. Diese Option definiert „\DIFadd“ und
„\DIFdel“-Befehle. Verfügbare Stile:

„UNDERLINE CTRADITIONAL TRADITIONAL CFONT FONTSTRIKE INVISIBLE CHANGEBAR CCHANGEBAR
CULINECHBAR CFONTCBHBAR BOLD"

[Standard: „UNDERLINE“ ]

--subtype=markstyle or -s markstyle
Fügen Sie Code zur Präambel für den ausgewählten Stil für Klammerungsbefehle hinzu (z. B. um Änderungen zu markieren).
am Rand). Diese Option definiert „\DIFaddbegin“, „\DIFaddend“, „\DIFdelbegin“ und
„\DIFdelend“-Befehle. Verfügbare Stile: „SAFE MARGIN COLOR DVIPSCOL ZLABEL
NURCHANGEDPAGE (LABEL)*"

[Standard: „SAFE“] * Der Subtyp „LABEL“ ist veraltet

--floattype=markstyle or -f markstyle
Fügen Sie Code zur Präambel für den ausgewählten Stil hinzu, der die Standardmarkierung und das Markup ersetzt
Befehle innerhalb von Floats (z. B. Randbemerkungen verursachen einen Fehler innerhalb von Floats).
(Randmarkierung kann somit deaktiviert werden). Diese Option definiert alle „\DIF...FL“-Befehle.
Verfügbare Stile: „FLOATSAFE TRADITIONALSAFE IDENTICAL“

[Standard: „FLOATSAFE“]

--encoding=enc or -e enc
Geben Sie die Kodierung von old.tex und new.tex an. Typische Kodierungen sind „ascii“, „utf8“,
„latin1“, „latin9“. Eine Liste der verfügbaren Kodierungen kann durch Ausführen abgerufen werden

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

[Die Standardkodierung ist utf8, es sei denn, die ersten paar Zeilen der Präambel enthalten ein
Aufruf „\usepackage[..]{inputenc}“, wobei in diesem Fall die dadurch gewählte Kodierung verwendet wird
Befehl übernommen wird. Beachten Sie, dass ASCII (Standardlatex) eine Teilmenge von utf8 ist]

--preamble=Datei or -p Datei
Fügen Sie die Datei am Ende der Präambel ein, anstatt eine Präambel zu erstellen. Die Präambel muss
Definieren Sie die folgenden Befehle: „\DIFaddbegin, \DIFaddend, \DIFadd{..},
\DIFdelbegin,\DIFdelend,\DIFdel{..}“ und Varianten zur Verwendung in Floats
"\DIFaddbeginFL, \DIFaddendFL, \DIFaddFL{..}, \DIFdelbeginFL, \DIFdelendFL,
\DIFdelFL{..}" (Wenn diese Option gesetzt ist -t, -s und -f Optionen werden ignoriert.)

--packages=pkg1,pkg2,..
Teilen Sie latexdiff mit, dass die .tex-Datei mit den geladenen Paketen in der Liste verarbeitet wird. Das ist
Normalerweise nicht erforderlich, wenn die .tex-Datei die Präambel enthält, wie es bei der Präambel der Fall ist
automatisch nach „\usepackage“-Befehlen durchsucht. Nutzung der --Pakete zu erhalten
Deaktiviert das automatische Scannen, falls aus irgendeinem Grund eine paketspezifische Analyse erforderlich ist
ausgeschaltet, verwenden --packages=none. Die folgenden Pakete lösen besonderes Verhalten aus:

„amsmath“
Die Konfigurationsvariable MATHARRREPL ist auf „align*“ gesetzt (Standard: „eqnarray*“).
(Beachten Sie, dass viele der amsmath-Array-Umgebungen bereits von erkannt werden
Standard als solcher)

„Endfloat“
Stellen Sie sicher, dass „\begin{figure}“ und „\end{figure}“ immer einzeln auftauchen
eine Linie.

„Hyperreferenz“
Ändern Sie den Namen der Befehle „\DIFadd“ und „\DIFdel“ in „\DIFaddtex“ und
„\DIFdeltex“ und definieren Sie neue „\DIFadd“- und „\DIFdel“-Befehle, die Folgendes bereitstellen:
Wrapper für diese Befehle und verwendet sie für den Text, aber nicht für den Link
Definieren des Befehls (wobei jedes Markup Fehler verursachen würde).

„Apazit“
Definieren Sie die als Zitierbefehle erkannten Befehle neu.

„siunitx“
Behandeln Sie „\SI“ als Äquivalent zu Zitierbefehlen (d. h. schützen Sie es mit „\mbox“, wenn
Der Markup-Stil verwendet das Ulem-Paket.

„cleveref“
Behandeln Sie „\cref,\Cref“ usw. als Äquivalent zu Zitierbefehlen (z. B. schützen Sie mit
„\mbox“, wenn der Markup-Stil das Ulem-Paket verwendet.

„Glossare“
Definieren Sie die meisten Glossarbefehle als sicher und schützen Sie sie mit \mboxes
wo benötigt

„mhchem“
Behandeln Sie „\ce“ als sicheren Befehl, d. h. er wird hervorgehoben (beachten Sie, dass „\cee“
wird in Gleichungen nicht hervorgehoben, da dies zu Verarbeitungsfehlern führt)

„Chemformel“ oder „Chemmakros“
Behandeln Sie „\ch“ als sicheren Befehl außerhalb von Gleichungen, dh er wird hervorgehoben
(Beachten Sie, dass „\ch“ in Gleichungen nicht hervorgehoben wird, da dies dazu führt
Verarbeitungsfehler)

[ Standard: Durchsuchen Sie die Präambel nach „\usepackage“-Befehlen, um dies zu ermitteln
geladene Pakete. ]

--show-preamble
Generierte oder enthaltene Präambelbefehle auf stdout ausgeben.

Konfiguration
--exclude-safecmd=Ausschlussdatei or -A Ausschlussdatei or --exclude-safecmd="cmd1,cmd2,..."
--replace-safecmd=Datei ersetzen
--append-safecmd=Datei anhängen or -a Datei anhängen or --append-safecmd="cmd1,cmd2,..."
Ausschließen, Ersetzen oder Anhängen an die Liste der übereinstimmenden regulären Ausdrücke (RegEx).
Befehle, die im Rahmen eines „\DIFadd“- oder „\DIFdel“-Befehls sicher verwendet werden können.
Die Datei muss ein Perl-RegEx pro Zeile enthalten (Kommentarzeilen, die mit # oder % beginnen).
ignoriert). Beachten Sie, dass der RegEx mit dem gesamten Token übereinstimmen muss, d. h. /^regex$/
impliziert ist und dass der Anfangsbuchstaben „\“ des Befehls nicht enthalten ist. Der
--exclude-safecmd und --append-safecmd Optionen können mit dem kombiniert werden
---replace-safecmd Option und kann wiederholt verwendet werden, um die Listen kumulativ zu ergänzen.
--exclude-safecmd und --append-safecmd kann auch eine durch Kommas getrennte Liste als Eingabe verwenden.
Wenn für einen der regulären Ausdrücke ein Komma erforderlich ist, maskieren Sie es mit „\,“. In den meisten Fällen ist es
Es ist notwendig, die durch Kommas getrennte Liste vor der Shell zu schützen, indem Sie sie einfügen
Anführungszeichen.

--exclude-textcmd=Ausschlussdatei or -X Ausschlussdatei or --exclude-textcmd="cmd1,cmd2,..."
--replace-textcmd=Datei ersetzen
--append-textcmd=Datei anhängen or -x Datei anhängen or --append-textcmd="cmd1,cmd2,..."
Ausschließen, Ersetzen oder Anhängen an die Liste der mit regulären Ausdrücken übereinstimmenden Befehle
dessen letztes Argument Text ist. Siehe Eintrag für --exclude-safecmd direkt oben für
weitere Details.

--replace-context1cmd=Datei ersetzen
--append-context1cmd=Datei anhängen oder =Artikel --append-context1cmd="cmd1,cmd2,..."
Ersetzen Sie die Liste der mit Regex übereinstimmenden Befehle, deren letztes Argument Text ist, oder hängen Sie sie an diese an
die aber einen bestimmten Kontext erfordern, um zu funktionieren, z. B. funktioniert \caption nur innerhalb eines
Figur oder Tisch. Diese Befehle verhalten sich wie Textbefehle, außer wenn sie in vorkommen
ein gelöschter Abschnitt, wenn sie deaktiviert sind, ihr Argument jedoch als gelöscht angezeigt wird
Text.

--replace-context2cmd=Datei ersetzen
--append-context2cmd=Datei anhängen oder =Artikel --append-context2cmd="cmd1,cmd2,..."
Als entsprechende Befehle für context1. Der einzige Unterschied besteht darin, dass context2-Befehle verwendet werden
sind in gelöschten Abschnitten vollständig deaktiviert, einschließlich ihrer Argumente.

--exclude-mboxsafecmd=exclude-file or --exclude-mboxsafecmd="cmd1,cmd2,..."
--append-mboxsafecmd=Datei anhängen or --append-mboxsafecmd="cmd1,cmd2,..."
Definieren Sie sichere Befehle, die zusätzlich durch Kapselung in einem geschützt werden müssen
\\mbox{..}. Dies ist manchmal erforderlich, um Inkompatibilitäten zwischen externen Geräten zu umgehen
Pakete und das ulem-Paket, das zum Hervorheben im Standardstil verwendet wird
UNDERLINE sowie CULINECHBAR CFONTSTRIKE

--config var1=val1,var2=val2,... or -c var1=val1,..
-c Konfigurationsdatei
Konfigurationsvariablen festlegen. Die Option kann wiederholt werden, um verschiedene Variablen festzulegen
(als Alternative zur durch Kommas getrennten Liste). Verfügbare Variablen (siehe unten für
weitere Erläuterungen):

„ARRENV“ (RegEx)

„COUNTERCMD“ (RegEx)

„FLOATENV“ (RegEx)

„ITEMCMD“ (RegEx)

„LISTENV“ (RegEx)

„MATHARRENV“ (RegEx)

„MATHARRREPL“ (Zeichenfolge)

„MATHENV“ (RegEx)

„MATHREPL“ (Zeichenfolge)

„MINWORDSBLOCK“ (Ganzzahl)

„PICTUREENV“ (RegEx)

--show-safecmd
Liste der mit RegEx übereinstimmenden und ausschließenden sicheren Befehle drucken.

--show-textcmd
Liste der passenden und ausschließenden RegEx-Befehle mit Textargument drucken.

--show-config
Werte von Konfigurationsvariablen anzeigen.

--zeige alles
Kombinieren Sie alle --show-Befehle.

Hinweis: Für alle --show-Befehle muss keine Datei „old.tex“ oder „new.tex“ angegeben werden
es findet keine Differenzierung statt.

Andere Konfiguration Optionen:
--allow-spaces
Erlauben Sie Leerzeichen zwischen in Klammern oder Klammern stehenden Argumenten für Befehle. Beachten Sie, dass diese Option
könnte unerwünschte Nebenwirkungen haben (nicht verwandter Bereich könnte mit vorangehendem in einen Topf geworfen werden).
Befehle) und sollten daher nur verwendet werden, wenn die Standardeinstellung fehlerhafte Ergebnisse liefert. (Standard
erfordert, dass Argumente ohne dazwischenliegende Leerzeichen direkt aufeinander folgen.

--math-markup=Ebene
Bestimmen Sie die Granularität des Markups in angezeigten Mathematikumgebungen: Mögliche Werte für
Ebene sind (sowohl numerische als auch Textbeschriftungen sind akzeptabel):

„off“ oder 0: Markup für mathematische Umgebungen unterdrücken. Gelöschte Gleichungen werden nicht angezeigt
in der Diff-Datei. Dieser Modus kann verwendet werden, wenn alle anderen Modi ungültigen Latexcode verursachen.

„ganz“ oder 1: Differenzierung auf der Ebene ganzer Gleichungen. Selbst triviale Änderungen an
Gleichungen führen dazu, dass die gesamte Gleichung als geändert markiert wird. Dieser Modus kann verwendet werden, wenn
Die Verarbeitung im Grob- oder Feinmodus führt zu ungültigem Latexcode.

„grob“ oder 2: Erkennen Sie Änderungen in Gleichungen, die mit einer groben Granularität markiert sind;
Änderungen am Gleichungstyp (z. B. displaymath zu Gleichung) werden als Änderung der angezeigt
vollständige Gleichung. Dieser Modus wird für Situationen empfohlen, in denen Inhalt und Reihenfolge wichtig sind
Einige Gleichungen werden noch geändert. [Standard]

„fein“ oder 3: Kleine Änderungen in Gleichungen erkennen und mit feiner Granularität markieren. Das
Der Modus eignet sich am besten, wenn nur geringfügige Änderungen an Gleichungen zu erwarten sind, z
Korrektur von Tippfehlern.

--disable-citation-markup or --disable-auto-mbox
Unterdrücken Sie Zitat-Markup und Markup anderer anfälliger Befehle in Stilen mit ulem
(UNDERLINE,FONTSTRIKE, CULINECHBAR) (die beiden Optionen sind identisch und einfach
Aliase)

--enable-citation-markup or --enforce-auto-mbox
Schützen Sie Zitierbefehle und andere anfällige Befehle in geänderten Abschnitten mit
„\mbox“-Befehl, d. h. das Standardverhalten des ulem-Pakets wird für andere Pakete verwendet (
zwei Optionen sind identisch und lediglich Aliase)

Weitere Anwendungsbereiche
- ausführlich or -V
Gibt während der Verarbeitung verschiedene Statusinformationen an stderr aus. Standardmäßig soll es funktionieren
schweigend.

--driver=Typ
Wählen Sie den Treiber für das Changebar-Paket (nur relevant für Stile mit
Changebar: CCHANGEBAR CFONTCHBAR CULINECHBAR CHANGEBAR). Mögliche Treiber sind
im Changebar-Handbuch aufgeführt, z. B. pdftex, dvips, dvitops
[Standard: dvips]

--ignore-Warnungen
Unterdrücken Sie Warnungen über Längeninkonsistenzen zwischen eingegebenen und analysierten Zeichenfolgen und
fehlende Zeichen. Diese Warnmeldungen beziehen sich häufig auf nicht standardmäßige Latex- oder Latexprodukte
Latexkonstruktionen mit einer für „latexdiff“ unbekannten Syntax, aber dem daraus resultierenden Unterschied
Argument ist oft ohnehin voll funktionsfähig, insbesondere wenn es sich nur um nicht standardmäßiges Latex handelt
tritt in Teilen des Textes auf, die sich nicht geändert haben.

--label=Label or -L Etikette
Legt die Bezeichnungen fest, die zur Beschreibung der alten und neuen Dateien verwendet werden. Die erste Verwendung dieser Option
legt die Bezeichnung fest, die die alte Datei beschreibt, und die zweite Verwendung der Option legt die Bezeichnung fest
für die neue Datei, also beide Labels so setzen: „-L labelold -L labelnew“. [Standard:
Verwenden Sie den Dateinamen und das Änderungsdatum für das Etikett.]

--no-label
Unterdrücken Sie die Aufnahme alter und neuer Dateinamen als Kommentar in die Ausgabedatei

--visble-label
Fügen Sie alte und neue Dateinamen (oder mit der Option „--label“ festgelegte Beschriftungen) als sichtbare Ausgabe hinzu.

--ebnen
Ersetzen Sie die Befehle „\input“ und „\include“ im Hauptteil durch den Inhalt der Dateien in
ihre Argumentation. Wenn „\includeonly“ in der Präambel vorhanden ist, sind nur diese Dateien vorhanden
in das Dokument erweitert. Allerdings erfolgt keine Rekursion, also „\input“ und
„\include“-Befehle innerhalb eingeschlossener Abschnitte werden nicht erweitert. Die enthaltenen Dateien sind
angenommen
sich in denselben Verzeichnissen befinden wie die alten bzw. neuen Masterdateien.
Dadurch ist es möglich, Dateien in alten und neuen Verzeichnissen zu organisieren. --flatten ist
rekursiv angewendet, sodass eingegebene Dateien weitere „\input“-Anweisungen enthalten können.

Die Verwendung dieser Option kann bei größeren Dokumenten zu übermäßig langen Bearbeitungszeiten führen.
und das resultierende Differenzdokument spiegelt nicht mehr die Struktur der Eingabe wider
Unterlagen.

--help or -h
Hilfetext anzeigen

--Version
Versionsnummer anzeigen

Vordefiniert Stile
Dur Typen
Der Haupttyp bestimmt das Markup von Klartext und einigen ausgewählten Latexbefehlen außerhalb
Floats durch Definition der Markup-Befehle „\DIFadd{...}“ und „\DIFdel{...}“ .

"UNTERSTREICHEN"
Hinzugefügter Text ist wellenförmig unterstrichen und blau, verworfener Text ist durchgestrichen und rot
(Erfordert Farb- und Ulem-Pakete). Überschreiben funktioniert in der Anzeige nicht
mathematische Gleichungen, sodass gelöschte Teile der Gleichung unterstrichen und nicht durchgestrichen werden
out (dies ist ein dem ulem-Paket innewohnender Mangel).

„KTRADITIONAL“
Der hinzugefügte Text ist blau und serifenlos gesetzt, und für jeden wird eine rote Fußnote erstellt
verworfener Text. (Erfordert Farbpaket)

„TRADITIONELL“
Wie „CTRADITIONAL“, jedoch ohne Verwendung von Farbe.

„CFONT“ Hinzugefügter Text ist blau und serifenlos gesetzt, verworfener Text ist rot und sehr
kleine Größe.

„FONTSTRIKE“
Hinzugefügter Text wird serifenlos gesetzt, verworfener Text klein und durchgestrichen

„WECHSELBAR“
Hinzugefügter Text ist blau und verworfener Text ist rot. Außerdem der geänderte Text
ist mit einem Balken am Rand gekennzeichnet (erfordert die Pakete color und changebar).

„CFONTCHBAR“
Wie „CFONT“, aber mit zusätzlichen Änderungsleisten (Farbe und Änderungsleiste erforderlich
Pakete).

"CULINECHBAR"
Wie „UNDERLINE“, aber mit zusätzlichen Änderungsbalken (erfordert Farbe, Ulem und
Changebar-Pakete).

„WECHSELBAR“
Keine Textmarkierung, aber Ränder mit Änderungsleisten markieren (Erfordert Änderungsleiste
Paket).

"UNSICHTBAR"
Kein sichtbares Markup (allerdings werden weiterhin generische Markup-Befehle eingefügt.

„BOLD“ Hinzugefügter Text wird fett dargestellt, verworfener Text wird nicht angezeigt.

Untertypen
Der Untertyp definiert die Befehle, die am Anfang und Ende von „added or“ eingefügt werden
verworfene Blöcke, unabhängig davon, ob diese Blöcke Text oder Befehle enthalten (Definiert
Befehle: „\DIFaddbegin, \DIFaddend, \DIFdelbegin, \DIFdelend“)

„SICHER“ Kein zusätzlicher Aufschlag (empfohlene Wahl)

„RAND“ Markieren Sie Anfang und Ende geänderter Blöcke mit Symbolen am Rand daneben
(mit dem Standardbefehl „\marginpar“ – beachten Sie, dass sich dieser manchmal verschiebt
etwas von der vorgesehenen Position entfernt.

„FARBE“ Eine alternative Möglichkeit, hinzugefügte Passagen blau und gelöschte Passagen rot zu markieren.
(Es wird empfohlen, stattdessen die Haupttypen zu verwenden, um farbige Markierungen zu erzielen.
In einigen Fällen kann die Färbung mit Dvipscol jedoch beispielsweise vollständiger sein
mit Zitierbefehlen).

„DVIPSCOL“
Eine alternative Möglichkeit, hinzugefügte Passagen blau und gelöschte Passagen rot zu markieren.
Beachten Sie, dass „DVIPSCOL“ nur mit dem dvips-Konverter funktioniert, also nicht mit pdflatex.
(Es wird empfohlen, stattdessen die Haupttypen zu verwenden, um farbige Markierungen zu erzielen.
obwohl in manchen Fällen die Färbung mit Dvipscol vollständiger sein kann).

Mit „ZLABEL“ können nur geänderte Seiten hervorgehoben werden, es ist jedoch eine Nachbearbeitung erforderlich. Es ist
Wir empfehlen, diese Option nicht manuell aufzurufen, sondern „latexdiff-vc“ zu verwenden
Option „--only-changes“. Alternativ können Sie das in der Präambel von angegebene Skript verwenden
Diff-Dateien, die mit diesem Stil erstellt wurden.

„NURCHANGEDPAGE“
hebt auch geänderte Seiten hervor, ohne dass eine Nachbearbeitung erforderlich ist, aber möglicherweise
funktionieren bei schwimmendem Material (Abbildungen, Tabellen) nicht zuverlässig.

„LABEL“ ähnelt „ZLABEL“, benötigt jedoch nicht das zref-Paket und funktioniert weniger
zuverlässig (veraltet).

Schwimmer Typen
Einige der im Haupttext verwendeten Markups können bei der Verwendung in Floats zu Problemen führen
(zB Abbildungen oder Tabellen). Aus diesem Grund gibt es alternative Versionen aller Markup-Befehle
Wird in Floats verwendet. Der Float-Typ definiert diese alternativen Befehle.

„FLOATSAFE“
Verwenden Sie für den Text das gleiche Markup wie im Hauptteil, legen Sie jedoch alle Befehlsmarkierungen fest
der Anfang und das Ende geänderter Blöcke in Nullbefehle. Das musst du wählen
Float-Typ, wenn Ihr Subtyp „MARGIN“ ist, da „\marginpar“ nicht ordnungsgemäß funktioniert
innerhalb von Floats.

„TRADITIONELLSICHER“
Markieren Sie Ergänzungen auf die gleiche Weise wie im Haupttext. Gelöschte Umgebungen sind
durch eckige Klammern \[ und \] gekennzeichnet und der gelöschte Text wird in Scriptscript gesetzt
Größe. Dieser Float-Typ sollte immer mit „TRADITIONAL“ und verwendet werden
„CTRADITIONAL“-Markup-Typen, da der Befehl \footnote in nicht richtig funktioniert
schwebende Umgebungen.

"IDENTISCH"
Machen Sie keinen Unterschied zwischen Haupttext und Floats.

Konfiguration Variablen
„ARRENV“ Wenn eine Übereinstimmung mit „ARRENV“ in einer Inline-Mathe-Umgebung innerhalb von a gefunden wird
gelöschter oder hinzugefügter Block, dann wird die eingebundene Mathematik von „\mbox{“…“}“ umgeben.
Dies ist notwendig, da die Unterstreichung innerhalb eines Inline-Arrays nicht funktioniert
Umgebungen.

[ Standard: "ARRENV"="(?:array|[pbvBV]matrix)"

„COUNTERCMD“
Wenn ein Befehl in einem gelöschten Block, der auch in der textcmd-Liste steht, übereinstimmt
„COUNTERCMD“ dann ein zusätzlicher Befehl „\addtocounter{“cntcmd„}{-1}“, wo
cntcmd der passende Befehl ist, wird in der Diff-Datei so angehängt, dass der
Die Nummerierung in der Diff-Datei bleibt mit der Nummerierung in der neuen Datei synchronisiert
Datei.

[ Standard: "COUNTERCMD"="(?:footnote|part|section|subsection" ...

„|subsubsection|paragraph|subparagraph)“ ]

„FLOATENV“
Umgebungen, deren Name mit dem regulären Ausdruck in „FLOATENV“ übereinstimmt, sind
als Floats betrachtet. Innerhalb dieser Umgebungen ist die Latexdiff Markup-Befehle sind
durch ihre FL-Varianten ersetzt.

[ Standard: "(?:figure|table|plate)[\w\d*@]*" ]

„ITEMCMD“ Befehle, die eine neue Artikelzeile mit Listenumgebungen darstellen.

[ Standard: \"item" ]

„LISTENV“ Umgebungen, deren Name mit dem regulären Ausdruck in „LISTENV“ übereinstimmt, werden aufgelistet
Umgebungen.

[ Standard: "(?:itemize|enumerate|description)" ]

„MATHENV“, „MATHREPL“
Wenn sowohl \begin als auch \end für eine mathematische Umgebung (Umgebungsnamensübereinstimmung) gelten
„MATHENV“ oder \[ und \]) sich innerhalb desselben gelöschten Blocks befinden, werden sie durch ersetzt
ein \begin- und \end-Befehl für „MATHREPL“, anstatt auskommentiert zu werden.

[ Standard: "MATHENV"="(?:displaymath|equation)", "MATHREPL"="displaymath" ]

„MATHARRENV“, „MATHARRREPL“
wie „MATHENV“, „MATHREPL“, aber für Gleichungsarrays

[ Standard: "MATHARRENV"="eqnarray\*?" , „MATHREPL“="eqnarray" ]

„MINWORDSBLOCK“
Mindestanzahl an Token, die erforderlich sind, um einen unabhängigen Block zu bilden. Dieser Wert ist
Wird im Algorithmus verwendet, um Änderungen vollständiger Blöcke durch Zusammenführung identischer Blöcke zu erkennen
Textteile mit weniger als „MINWORDSBLOCK“ zum Vorhergehenden hinzugefügt und verworfen
Teile.

[Standard: 3]

„BILDENV“
Innerhalb von Umgebungen, deren Name mit dem regulären Ausdruck in „PICTUREENV“ übereinstimmt
Das gesamte Latexdiff-Markup wird entfernt (in pathologischen Fällen kann dies dazu führen).
inkonsistentes Markup, aber diese Situation sollte selten sein).

[ Standard: "(?:picture|DIFnomarkup)[\w\d*@]*" ]

COMMON PROBLEME UND FAQ

Zitate führen zu überfüllten Kästchen
Es besteht eine Inkompatibilität zwischen dem Paket „ulem“, das von „latexdiff“ verwendet wird
zum Unterstreichen und Durchstreichen im UNDERLINE-Stil, dem Standardstil, und
die Art und Weise, wie Zitate generiert werden. Um Zitate markieren zu können
ordnungsgemäß werden sie in einen „\mbox“-Befehl eingeschlossen. Da Mboxen nicht kaputt gehen können
Zeilenübergreifend führt dieses Verfahren möglicherweise häufig zu überfüllten Boxen
Dadurch wird der Inhalt verdeckt, wenn er über den rechten Rand hinausragt. Das Gleiche geschieht
für einige andere Pakete (z. B. siunitx). Wenn dies ein Problem ist, haben Sie zwei
Möglichkeiten.

1. Markup vom Typ „CFONT“ verwenden (Option „-t CFONT“): Wenn dieses Markup ausgewählt wird, dann
geänderte Zitate werden nicht mehr mit der Wellenlinie (Ergänzungen) oder gekennzeichnet
durchgestrichen (Löschungen), aber weiterhin in der entsprechenden Farbe hervorgehoben, und
Gelöschter Text wird mit einer anderen Schriftart angezeigt. Andere Stile, die das „ulem“ nicht verwenden
Paket wird auch funktionieren.

2. Wählen Sie die Option „--disable-citation-markup“, die die Markierung von ausschaltet
Zitate: Gelöschte Zitate werden nicht mehr angezeigt und hinzugefügte Zitate werden angezeigt
ohne Aufschlag. (Dies war das Standardverhalten von latexdiff in den Versionen 0.6 und
älter)

Für benutzerdefinierte Pakete können Sie die Befehle definieren, die geschützt werden müssen
„\mbox“ mit den Optionen „--append-mboxsafecmd“ und „--excludemboxsafecmd“ (submit
Ihre Befehlslisten als Funktionsanfrage auf der Github-Seite, um die Standardeinstellung festzulegen
Verhalten zukünftiger Versionen, siehe Abschnitt 6)

Änderungen in komplizierten mathematischen Gleichungen führen zu Fehlern bei der Latexverarbeitung
Probieren Sie die Optionen „--math-markup=whole“ aus. Wenn selbst das fehlschlägt, können Sie die Markierung deaktivieren
up für Gleichungen mit „--math-markup=off“.

Wie kann ich nur die Seiten anzeigen, auf denen Änderungen vorgenommen wurden?
Verwenden Sie die Optionen -"-s ZLABEL" (einige Nachbearbeitung erforderlich) oder "-s
ONLYCHANGEDPAGE". „latexdiff-vc --ps|--pdf“ mit der Option „--only-changes“ akzeptiert
kümmert sich um die Nachbearbeitung für Sie (erfordert die Installation des zref-Pakets).

Verwenden Sie Latexdiff online über die Dienste von onworks.net