LaTeX Extra > LaTeX Pakete > Xreview


Das Paket xreview vereinfacht das Überarbeiten von LaTeX-Dokumenten, indem es Änderungen und Kommentare übersichtlich darstellt und später eine bereinigte Version des Dokuments ohne Hervorhebungen erstellt.[1] Dadurch ist es insbesondere für Arbeiten die einen mehrmaligen Überarbeitungsprozess durchlaufen, wie zum Beispiel Abschlussarbeiten und Manuskripte, ein nützliches Paket.

Installation und Hauptmodi

Das Paket wird mit folgendem Befehl geladen:

\usepackage{xreview}

Es gibt zwei Hauptmodi:

Grundlegende Bearbeitungsbefehle: Änderungen im Text hervorheben

Die grundlegenden Befehle von xreview helfen, Hinzufügungen, Löschungen und Änderungen im Text deutlich zu machen. Es gibt drei Hauptbefehle:

  1. Text entfernen mit \removed{...}: Text wird durchgestrichen dargestellt, um zu zeigen, dass er entfernt wurde.
  2. Text hinzufügen mit \added{...}: Der hinzugefügte Text wird farbig (standardmäßig blau) angezeigt.
  3. Text ersetzen mit \changed{alt}{neu}: Der alte Text wird durchgestrichen und in einer anderen Farbe angezeigt, während der neue Text als Ersatz eingefügt wird.

Beispiel:

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{xreview}

\begin{document} 
\showchanges
\textit{xreview} ist ein \removed{tolles} Paket, um \added{\LaTeX} Dokumente zu überarbeiten und \changed{nervige}{wertvolle} Änderungen hervorzuheben.
\end{document}
Beispiel für das Review bzw. überarbeiten eines Textes in LaTeX

Erklärung:

Bereinigte Version: Wenn Sie stattdessen \showclean verwenden, sehen Sie nur den sauberen Text:

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{xreview}

\begin{document} 
\showclean
\textit{xreview} ist ein \removed{tolles} Paket, um \added{\LaTeX} Dokumente zu überarbeiten und \changed{nervige}{wertvolle} Änderungen hervorzuheben.
\end{document}
Beispiel für einen Text nach der Überarbeitung in LaTeX

Bearbeiten von Gleichungen: Spezielle Umgebungen für mathematische Inhalte

Das xreview-Paket bietet spezielle Umgebungen zum Entfernen und Hinzufügen von Gleichungen, was besonders für mathematische Dokumente nützlich ist.

  1. remequation und remequation*: Diese Umgebungen markieren eine Gleichung als entfernt.

    • remequation* unterdrückt die Nummerierung der gelöschten Gleichung.
    • remequation behält eine separate Nummerierung (z. B. mit einem "R"-Präfix), sodass die Gleichung referenziert werden kann.
  2. addequation und addequation*: Diese Umgebungen markieren eine Gleichung als hinzugefügt.

    • Die Nummerierung folgt der normalen Abfolge, damit die bereinigte Version konsistent bleibt.

Beispiel:

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{xreview}

\begin{document} 

\showchanges
\begin{equation}
    a + b = c
\end{equation}
\begin{remequation}
    a + b = d
\end{remequation}
\begin{addequation}
    b + c = d
\end{addequation}

\end{document}
Beispiel für Überarbeitung von Gleichungen in LaTeX

Erklärung:

Bereinigte Version: Mit \showclean wird nur die verbleibende und die neue Gleichung gezeigt, ohne Markierungen:

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{xreview}

\begin{document} 

\showclean
\begin{equation}
    a + b = c
\end{equation}
\begin{remequation}
    a + b = d
\end{remequation}
\begin{addequation}
    b + c = d
\end{addequation}

\end{document}
Beispiel für Gleichungen in LaTeX nach der Überarbeitung von diesen.

Kommentare einfügen: Hinzufügen von Anmerkungen im Text

Kommentare sind hilfreich, um Notizen und Anmerkungen für andere Bearbeiter oder für sich selbst hinzuzufügen. xreview bietet hierfür verschiedene Befehle:

  1. \comment{text}{Kommentar}: Fügt einen Kommentar zum Text hinzu, der in der bereinigten Version ausgeblendet wird.
  2. \resolvedcomment{Kommentar}{Antwort}: Markiert einen Kommentar als „gelöst“, was ihn in einer beruhigenden Farbe (standardmäßig grün) darstellt.
  3. \authoredcomments: Mit diesem Befehl können Sie personalisierte Kommentarbefehle erstellen, zum Beispiel \Alicecomment.

Beispiel:

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{xreview}

\begin{document} 

\showchanges
\comment{Dies ist ein Abschnitt}{Überprüfen Sie die Formulierung.}
\resolvedcomment{Dieser Punkt wurde geklärt.}{Einverstanden.}
\authoredcomments[color=cyan]{Alice}
\Alicecomment{Gute Änderung}{Alice stimmt zu.}

\end{document}
Beispiel für das Einfügen von Kommentaren während der Textüberarbeitung in LaTeX

Erklärung:

Anpassung der Farben und Präfixe

xreview bietet die Möglichkeit, das Aussehen der Änderungen anzupassen, zum Beispiel die Farben und die Präfixe von Kommentaren:

\renewcommand{\addedcolor}{green}
\renewcommand{\removedcolor}{purple}
\renewcommand{\commentprefix}{Note}

Erklärung:

Zusammengefasstes Beispiel: Alle Befehle in einem Dokument

Hier ist ein Beispiel, das alle obigen Funktionen kombiniert und zeigt, wie xreview verwendet werden kann, um Änderungen und Kommentare zu verwalten:

\documentclass[ngerman]{article}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{lmodern}
\usepackage{xreview}
\renewcommand{\addedcolor}{green}
\renewcommand{\removedcolor}{purple}
\renewcommand{\commentprefix}{Note}

\begin{document} 

\showchanges
\textit{xreview} ist ein \removed{tolles} Paket, um \added{\LaTeX} Dokumente zu überarbeiten und \changed{nervige}{wertvolle} Änderungen hervorzuheben.

\comment{Dieser Satz}{Überprüfen Sie die Formulierung.}
\resolvedcomment{Dieser Punkt wurde geklärt.}{Einverstanden.}

\authoredcomments[color=cyan]{Alice}
\Alicecomment{Gute Änderung}{Alice stimmt zu.}

\begin{equation}
    a + b = c
\end{equation}
\begin{remequation}
    a + b = d
\end{remequation}
\begin{addequation}
    b + c = d
\end{addequation}

\end{document}
Ausführliches Beispiel für das Überarbeitung von Texten in LaTeX

Erklärung des gesamten Beispiels:

Ergebnis: Dieses Beispiel zeigt, wie Änderungen, persönliche Kommentare und der Bearbeitungsbericht erstellt werden. Mit \showclean verschwindet der gesamte Änderungsverlauf, und der Text erscheint sauber.

Zusammenfassung

Das xreview-Paket erleichtert die Überarbeitung und Kommentierung von LaTeX-Dokumenten durch eine klare Hervorhebung von Änderungen und die Möglichkeit, eine bereinigte Version ohne Bearbeitungsspuren zu erstellen.

Literatur

[1]
xreview: Reviewing LaTeX documents made easy, Lorenzo Peri: August 29, 2024, v-1.0