Wir nutzen den Pandoc-Converter von Oscar Levin: github.com/oscarlevin/pandoc-pretext

Dieser ist theoretisch dazu in der Lage, auch lange Dokumente auf einmal zu konvertieren. Wir geben hier eine Anleitung für eine stückweise Konversion, um die Nachbearbeitung zu erleichtern.

Die Verwendung wird im Repository beschrieben, hier aber nochmal für unseren bestimmten Fall:

1. Pandoc (pandoc.org/installing.html) installieren
2. Die Dateien pretext.lua, pretext-environments.lua und pretext-latex-reader.lua herunterladen und im custom-Ordner des Pandoc user data directory ablegen. Den Pfad des Directory findet man unter pandoc --version. Der Ordner muss ggf. noch angelegt werden.
3. Das zu konvertierende LaTeX-Dokument öffnen.
4. Die gesamte Preamble in ein neues Dokument kopieren.
5. Ein neues PreTeXt-Projekt erstellen, hier kann man der Anleitung im PreTeXt Guide folgen: pretextbook.org/doc/guide/html/tutorial-first-document.html und ein Beispielbuch oder einen Beispielartikel erstellen.
6. Die LaTeX-Datei in handliche Stücke zerteilen (macht die Fehlerkorrektur leichter, und man vermeidet, dass der Konverter Fehler mit der Dokumentenstruktur macht). Es empfehlen sich etwa die kleinsten Teile des LaTeX-Dokuments (z. B. Subsections).
7. Die Struktur im PreTeXt-Ordner widerspiegeln (also ch-… Dateien für alle Kapitel, sec-… für Sektionen usw.) und die untergeordneten Teile jeweils in ihren Elternteilen mit <xi:include href="./DATEINAME.ptx" /> einbinden. Dieser Schritt dient nur der Übersichtlichkeit. Es bietet sich an, nicht alles auf einmal anzulegen, sondern nur nach und nach, wenn man auch schon die Inhalte für die entsprechenden Kapitel oder Sektionen hat.
8. Jetzt iterativ:
   1. Einen Unterabschnitt auswählen und aus dem LaTeX-Dokument herauskopieren.
   2. In die vorbereitete LaTeX-Datei, die nur die Preamble enthält, einfügen. Bei uns heißt diese Datei main.tex.
   3. Für Windows: Die Eingabeaufforderung öffnen (Command Prompt). Mit „cd“ und „dir“ zum Ordner navigieren, in dem die beiden Dateien liegen. Wer sich gar nicht auskennt, dem hilft ein Crashkurs wie dieser.
   4. Den folgenden Command ausführen (eingeben und Enter drücken):

      pandoc main.tex -t pretext.lua -o main.ptx

   5. Das Innenleben von main.ptx (alles innerhalb von <article> … </article>) herauskopieren und in die vorbereitete PreTeXt-Datei im Repo einfügen.
   6. Bekannte Fehler nach Auflistung korrigieren (siehe Konverter-Nachbearbeitungen).