Konvertieren

Andere Dateiformate können mit pandoc in reStructuredText konvertiert werden.

Installation von pandoc

Pandoc ist ein leistungsfähiges Dienstprogramm zur Dokumentumwandlung. Wir verwenden es für einfache Konvertierungen, aber es ist zu viel mehr in der Lage.

Installation

Pandoc könnt ihr für die verschiedenen Plattformen installieren:

$  sudo apt install pandoc

$  brew install pandoc

$  choco install pandoc

Siehe auch

Konvertieren

Navigiert im Terminal zu dem Verzeichnis, das die zu konvertierenden Dokumente enthält. Gebt dann für jede Datei, die ihr konvertieren möchtet, den Befehl pandoc -s --toc -f INPUT_FORMAT -t rst MYDOC.SUFFIX ein:

-s

erzeugt ein eigenständiges Dokument

--toc

erstellt ein Inhaltsverzeichnis (optional)

-t

erzeugt eine reStructuredText-Ausgabe

-f

teilt pandoc das Eingabeformat mit. Einen Überblick über die verfügbaren Eingabeformate erhaltet ihr in General options.

Korrigieren des konvertierten Dokuments

Wie umfangreich die Korrektur für das konvertierte Dokument ausfällt, hängt davon ab, aus welchem Dateiformat ihr konvertiert. Hier sind einige Dinge, auf die ihr achten solltet:

  • Mehrzeilige Titel müssen in einzeilige konvertiert werden

  • Eigenständige **-Zeichen

  • ***FETT*** sollte **FETT** sein

  • Fehlerhafte Tabellen