Runtex.rb: (La)TeX aufrufenODP English


Sie sind hier: RubyRuntex


Vorwort

Das Skript prüft, wie oft eine LaTeX-Datei übersetzt werden muss um alle Indizes, Literaturverweise etc. korrekt sind. Alle Bildschirmnachrichten werden unterdrückt, am Programmende wird eine Übersicht ausgegeben.

Ähnliche Programme für das selbe Problem sind:

Ich schrieb dieses Skript als unterstützendes Tool für mein Ruby-Script docgenerator. Ziele waren insbesonders:

Benutzerschnittstelle

Aufruf

    runtex.rb [Schalter] Quelldatei[.tex]

Danach übernimmt runtex die Kontrolle und startet:

  1. (pdf)LaTeX
  2. Falls notwendig:
    1. makeindex (mehrmals falls mehrere Aufrufe notwendig (splitindex, glossaries…))
    2. BibTeX (ebenfalls mehrmals falls nötig)
    3. rail falls nötig
  3. Falls notwendig: Ein erneuter Durchlauf

Optionen

-h
Eine Hilfe Ausgeben
-a
Die Aktion, definiert das TeX-Format (pdflatex, latex, xelatex...
-o
Grenze für Warnmeldung von "overfull boxe" 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.)

Unterstützte Programme und Pakete

Unterstützte Programme

Folgende Programme sind unterstützt:

Die Programme werden gerufen, sofern die TeX-Datei es erfordert.

Unterstützung von Paketen

Manche TeX-Styles erfordern mehrfache Aufrufe der Programme.

Die folgenden Pakete werden unterstützt:

splitindex.sty

gloss.sty: Glossare

Gloss.sty ist unterstützt, für jeden Glossar wird bibtex gerufen.

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.


Die folgenden Pakete sind zwar (noch) unterstütz, ich rate aber von deren Verwendung ab.

index.sty: Verschiedene Indizes

index.sty selbst ist nicht unterstützt. Ich habe eine korrigierte Version erstellt, die unterstützt wird. Die Änderungen sind:

Tipp: Statt index.sty empfehle ich splitindex.

Bisher noch nicht unterstützt

Bisher noch nicht unterstützt werden:

Source und Programm

Das Skript liegt als Ruby-gem und für Windows-Nutzer, die kein Ruby installieren wollen (ihr verpasst was!) als exe-Datei vor.

Verfügbar ist das ganze bei

Weitere Planung

Verworfene Ideen: