rtex.rb: run (La)TeX
Inhaltsverzeichnis
2 Benutzerschnittstelle
2.1 Aufruf
2.2 Optionen
3 Programme und Pakete
3.1 Unterstützte Programme
3.2 Unterstützung von Paketen
3.2.1 Index.sty: Verschiedene Indizes
3.2.2 Gloss.sty: Glossare
3.2.3 Rail.sty: Rail-Diagramme
3.3 Bekannte Probleme
1 Vorwort
Das Skript prüft, wie oft ein T E X -file übersetzt werden muss um alle Indizes, Literaturverweise etc. korrekt sind. Alle Nachrichten werden unterdrückt, am Programmende wird eine Übersicht ausgegeben.
Ähnliche Programme für das selbe Problem sind: the same problem:
Ich schrieb dieses Skript weil:
- Ich ein Programm in Ruby schreibe, das eine T E X -Datei erzeugt. Diese Datei soll mit Ruby-Mitteln übersetzt werden.
- Kein Programm „ rail “ unterstützt.
- Packete wie index.sty oder gloss.sty selten unterstützt sind.
- Ich eine Fehlerübersicht wollte.
2 Benutzerschnittstelle
2.1 Aufruf
rtex.rb [Schalter] Quelldatei[.tex]
2.2 Optionen
- -h
- Eine Hilfe Ausgeben
- -l
-
Die Detailtiefe der Information definieren:
- 0
- Keine Informationen ausgeben
- 1
- Fehler aus Hilfsprogrammen und eine TeX-Übersicht.
- 2
- Ebene 1 + Übersichten der Hilfsprogrammen
- 3
- Ebene 2 + ausgeführte Schritte + Statistiken + Fehler
- 4
- Ebene 3 + Warnungen
- 5
- Ebene 4 + Hinweise von rtex.rb
- 6
- Ebene 5 + detaillierte Hinweise von rtex.rb
- 9
- Alles
Alle Ebenen sind in der Log-Datei hinterlegt.
- -a
-
Die „Aktionskette“ definieren. Eine
Aktionskette definiert alle Schritte die notwendig sind
um von einer Quelle zu einer Zieldatei zu kommen.
Folgende Ketten sind definiert:
- pdfLaTeX
- ruft pdfLaTeX und erzeugt eine PDF-Datei. [Standard]
- LaTeX
- ruft L A T E X und erzeugt eine DVI-Datei.
- LaTeXPS
- ruft L A T E X und erzeugt eine Postscript-Datei (dvips)
- LaTeXPSPDF
- Ruft L A T E X und erzeugt eine PDF-Datei via dvips und ghostscript
- LaTeXPDF
- Ruft L A T E X und erzeugt eine PDF-Datei mittels dvipdfm
- htlatex
- Ruft ht L A T E X und erzeugt eine HTML-Version.
Anmerkung: Jeder Schritt kann eine Ünterkette”definieren. (pdf)LaTeX ruft bibtex, makeindex und rail wenn notwendig.
- -o
- Grenze für Warnmeldung von „overfull boxes“ setzen.
- -u
- Grenze für Warnmeldung von „underfull boxes“ setzen.
- -w
- Warte nach Beendigung des Skripts. (kann helfen, falls das Skript von anderen Programmen gerufen wird.)
3 Programme und Pakete
3.1 Unterstützte Programme
Folgende Programme sind unterstützt:
-
bibTeX
siehe Gloss.sty, Abschnitt 3.2.2
- makeindex siehe Index.sty, Abschnitt 3.2.1
- Rail, siehe Abschnitt 3.2.3
Die Programme werden gerufen, sofern die T E X -Datei es erfordert.
Manche L A T E X -Styles erfordern mehrfache Aufrufe der Programme. Siehe dazu den nächsten Abschnitt.
3.2 Unterstützung von Paketen
Verschiedene Pakete erfordern eine spezielle Behandlung durch rtex.rb. Bisher noch nicht unterstützt werden:
Die folgenden Pakete werden unterstützt.
3.2.1 Index.sty: Verschiedene Indizes
Index.sty selbst ist nicht unterstützt. Ich habe eine korrigierte Version erstellt, die unterstützt wird. Ich hoffe meine Änderungen werden im Original übernommen. Die Änderungen sind:
- index.sty erfordert article oder eine Klasse die \chapter definiert. index2.sty erlaubt die Verwendung aller article- und book-artigen Klassen (z.Bsp. scrartcl.cls)
- Quell und Zieldatei jedes Index werden protokolliert. Somit ist rtex.rb in der Lage makeindex korrekt zu rufen.
3.2.2 Gloss.sty: Glossare
Gloss.sty ist unterstützt, für jeden Glossar wird bibtex gerufen. Im Log sind sie als „bibTeX/-“ aufgeführt, wobei - der Glossarname ist.
3.2.3 Rail.sty: Rail-Diagramme
Rail ist ein Tool zum erzeugen von „Rail“-Diagrammen (eine grafische Darstellung von EBNF). Es erfordert einen Aufruf des Programmes rail.exe.
3.3 Bekannte Probleme
- Bisher nur auf Win2K verwendet.
- Manche Fehler werden doppelt gezählt (aber immer noch besser als gar nicht gezählte Fehler).