texdoc / texfot / Ghostscript / dvisvgm

Neben dem Kompilieren bringt eine TeX-Installation kleine Werkzeuge mit, die den Alltag erleichtern: texdoc öffnet Paketdokumentationen, texfot reduziert die Compiler-Ausgabe auf das Wesentliche, Ghostscript erzeugt oder verkleinert PDFs, und dvisvgm macht aus Ausgaben webtaugliches SVG. Diese Seite ist eine Kurzreferenz für diese vier Werkzeuge.

Die vier Werkzeuge in den Schreibablauf einordnen

Ziel dieses Kapitels ist nicht, vier Befehle auswendig zu lernen, sondern zu wissen, welches Werkzeug in welcher Phase des Schreibens passt. Bevor Sie ein Paket hinzufügen, lesen Sie dessen Handbuch mit texdoc. Wenn die Build-Ausgabe laut wird, lassen Sie mit texfot die Warnungen hervortreten. Ist ein Abgabe-PDF zu groß, komprimieren Sie es mit Ghostscript und prüfen danach Links und eingebettete Schriften. Für Formeln oder Diagramme im Web exportieren Sie mit dvisvgm SVG und kontrollieren die Darstellung im Browser bei starker Vergrößerung. In dieser Reihenfolge werden Recherche, Schreiben, Fertigstellen und Veröffentlichen zu einem Ablauf.

texdoc — ein Pakethandbuch öffnen

Die meisten CTAN-Pakete bringen ein ausführliches Handbuch (PDF) mit, und nach der Installation liegt es bereits auf Ihrem Rechner. Mit texdoc PACKAGE wird dieses Handbuch gesucht und in einem Viewer geöffnet, offline und passend zu der Version, die tatsächlich installiert ist. Das Werkzeug gehört zu TeX Live (ursprünglich von Manuel Pégourié-Gonnard); dieselbe Datenbank ist auch unter texdoc.org durchsuchbar.

texdoc booktabs      # booktabs の説明書を開く / open booktabs’ manual
texdoc -l siunitx    # 候補を一覧表示（開かない）/ list matches instead of opening

Standardmäßig öffnet es den besten Treffer. Mit -l (--list) zeigt es stattdessen eine Kandidatenliste an, aus der Sie wählen können. -s (--showall) erweitert die Treffer um niedriger bewertete Ergebnisse. Wenn Sie einem Bericht oder einem Kapitel einer Abschlussarbeit ein Paket hinzufügen, ermitteln Sie zuerst mit texdoc PACKAGE den Ladebefehl, das kanonische Beispiel und die relevanten Optionen; kopieren Sie dann nur das nötige Minimum in die Präambel. So wuchert die Einrichtung nicht aus.

texfot — nur die wichtigen Meldungen

Ein TeX-Lauf erzeugt eine Flut von Meldungen, und die Warnungen oder Fehler, die Sie wirklich brauchen, rauschen leicht vorbei. texfot (ein gemeinfreies Perl-Skript von Karl Berry) startet die Engine und filtert das Protokoll auf die „interessanten“ Zeilen: Fehler, Warnungen, overfull/underfull boxes und Ähnliches. Den Exit-Code gibt es unverändert weiter, sodass die Erfolgserkennung eines Build-Werkzeugs intakt bleibt.

texfot pdflatex document.tex     # 出力を要約しつつコンパイル / compile with a quiet, filtered log

Um es mit latexmk zu kombinieren, umhüllen Sie den Engine-Aufruf in Ihrer Konfigurationsdatei mit texfot:

# .latexmkrc
$pdflatex = 'texfot pdflatex %O %S';

Ghostscript — PDFs erzeugen und verkleinern

gs (Ghostscript) ist der PostScript/PDF-Interpreter und steckt auch unter ps2pdf. Mit -sDEVICE=pdfwrite schreibt er PDF; damit können Sie PS nach PDF konvertieren, mehrere PDFs zusammenführen und ein übergroßes PDF komprimieren (durch Herunterskalieren der Bilder). Die Qualität wählen Sie über ein -dPDFSETTINGS-Preset wie /screen (Bildschirmprüfung), /ebook (mittel), /printer (druckorientiert) oder /prepress (druckvorstufenorientiert). Diese Presets bauen das PDF neu auf und können die Eingabe verändern. Für Abgabe oder Drucklieferung prüfen Sie nach der Komprimierung immer Bildlesbarkeit, eingebettete Schriften, Links und Seitengröße.

gs -sDEVICE=pdfwrite -dPDFSETTINGS=/ebook -dNOPAUSE -dBATCH \
   -sOutputFile=small.pdf big.pdf

dvisvgm — DVI nach SVG

dvisvgm (von Martin Gieseking) konvertiert DVI nach SVG (Vektorgrafik). Es akzeptiert auch EPS und mit --pdf PDF-Eingaben. Es ist ideal, wenn Formeln oder Diagramme im Web bei jeder Zoomstufe scharf bleiben sollen. Schriften werden standardmäßig als SVG eingebettet, mit --font-format=woff2 (oder woff, ttf) können Sie aber Webfont-Formate wählen. Bei PDF-Eingabe kann Text je nach Verarbeitungsweg zu Pfaden statt eingebetteten Schriften werden; entscheiden Sie daher, ob Sie von DVI oder PDF konvertieren, und prüfen Sie anschließend die tatsächliche Browserdarstellung. Mit -p (--page) wählen Sie Seiten aus.

latex equation.tex                       # → equation.dvi
dvisvgm --font-format=woff2 equation.dvi # → equation.svg
dvisvgm --pdf figure.pdf                 # PDF を入力にする / convert a PDF

Häufige Fehler eingrenzen

• Wenn texdoc das falsche Handbuch öffnet, führen Sie texdoc -l PACKAGE aus, prüfen die Kandidaten und wählen das gewünschte PDF nach Nummer.
• Wenn texfot nichts zeigt, das PDF aber trotzdem falsch aussieht, entfernen Sie texfot vorübergehend und lesen Sie das rohe Log, um zu prüfen, ob nützlicher Kontext herausgefiltert wurde.
• Wenn Links oder Lesezeichen nach der Komprimierung mit Ghostscript verschwinden, hat der PDF-Neuaufbau möglicherweise nicht sichtbare Informationen verworfen. Vergleichen Sie vor der Abgabe das Original-PDF und das komprimierte PDF.
• Wenn dvisvgm --pdf Text in Pfade umwandelt, behält das SVG keinen suchbaren oder austauschbaren Text. Für bearbeitbare Web-Abbildungen versuchen Sie zuerst die Konvertierung aus DVI.

Wann welches Werkzeug passt

• Nachschlagen, wie ein Paket funktioniert → texdoc PACKAGE.
• Ein lautes Log beruhigen → texfot (mit latexmk).
• Ein PDF ist zu groß / PS nach PDF konvertieren → Ghostscript (-dPDFSETTINGS).
• Formeln oder Abbildungen als SVG ins Web stellen → dvisvgm.