Motivation

Ich erstelle halt meine Dokumentation in erster Linie mit LaTeX und der Wechsel zu Ant sollte natürlich so leicht wie möglich gemacht werden... Also ging es daran ein Tool zu suchen, dass LaTeX in Ant einbindet. Es wurde auch eines gefunden: anttex_1.0, nur leider wollte dieses Teil nicht mit *.ltx Dateien zusammenarbeiten und ich werde deswegen nicht alle meine Dateien umstellen... Zum Anderen läuft dieses Tool stur dreimal über die LaTeX-Datei ohne auf die Auflösung der Referenzen zu achten.

Deswegen musste ich eine eigene Lösung entwickeln:

  • Lässt optional BibTeX laufen
  • Lässt optional MakeIndex laufen
  • Lässt optional (jx)GlossTeX laufen
  • Die drei vorgenannten Prozesse sind einmal integriert in einem LaTeX-Lauf oder können als eigene Tasks definiert werden.
  • PDFLaTeX oder LaTeX als Prozessor auswählbar
  • multibib Bibliographien werden unterstützt.
  • Die Packages figbib für kommentierte Abbildungsverzeichnisse oder gloss für ein Glossar mit BibTeX sind durch flexible Konfiguration von BibTeX integriert. .

Entwicklungsgeschichte

[0.0.9_1 (2007-09-25)]
  • Integration in antLib ergänzt und entsprechend beschrieben (Hinweis von Simone Tripodi).
[0.0.9 (2006-11-19)]
  • Dokumentation wegen auxDir, outputDir und \include{EinVerzeichnis/Datei} überarbeitet.
  • Offizielle Version
[0.0.8_2 (2006-09-09)]
  • Neu: fileExtensions ergänzt, damit können jetzt beliebige Dateiendungen für LaTeX-Dateien benutzt werden. Vom normalen Schema sollte dennoch nicht abgewichen werden.
  • Fix: command wurde nicht mehr durchgereicht.
  • Fix: Bei den Zeichenkettenparametern wurde die Variablenauswertung nicht berücksichtigt
  • Fix: Parameter outputDir und auxDir waren falsch beschrieben.
[0.0.8_1 (2006-04-09)]
  • Neu: Verarbeitet jetzt auch *.dtx und *.ins-Dateien und lässt sich somit in die Installationsroutine für LaTeX-Distributionen einbauen!
[0.0.8 (2006-04-01)]
  • Internes Release
[0.0.7 (2006-02-09)]
  • Es können jetzt mehrere BibTeX-Aufrufe im LaTeX-Task eingetragen werden, mit dem Schalter inloop kann gesteuert werden, ob BibTeX in der LaTeX-Schleife aufgerufen werden soll.
[0.0.6_2 (2006-01-12)]
  • path-Attribut für den Pfad zu (PDF)LaTeX darf nicht mit getCanonicalPath() behandelt werden, weil unter Unix einige Programme ihre Funktionalität über den Programmnamen erhalten und dementsprechend verlinkt sind. (Gefunden von Alphonse Bendt)

[0.0.6 (2006-01-09)]
  • path-Attribut für den Pfad zu (PDF)LaTeX ergänzt und damit die Semantik von command geändert.
  • Die Argumente output-directory, aux-directory, job-name für LaTeX umgesetzt und die Subaufrufe von BibTeX, makeindex und GlossTeX angepasst. Die restlichen Argumente können jetzt mit passThruLaTeXParameters getrennt mit Semikolons an LaTeX weitergegeben werden.
  • Mit dem Attribut figbib wird das Package figbib im LaTeX-Lauf berücksichtigt.

[0.0.5_2 (2006-01-06)]
  • replace-Aufruf auf Java 1.4 geändert.
  • Keine LaTeX-Datei gefunden bzw. angegeben führt zu einer vernünftigen Fehlermeldung

[0.0.5 (2005-12-29)]
  • Bei den Tasks LaTeX und LaTeXTask konnte nur eine Datei angegeben werden, jetzt kann auch das Element <fileset> benutzt werden. (Gefunden von Alphonse Bendt)

[0.0.4 (2005-11-26)]
  • Es gab zwar die Möglichkeit mit <fileset> einen Filter für <makeindex> zu setzen, doch dieses Element wurde innerhalb eines <latex> Tasks nicht ausgewertet. (Gefunden von Thomas Reuter)
  • Das XML-basierte jxGlossar wurde mit eingebunden.
  • Das Element <delete> wurde ersetzt durch <deletetempfile>

[0.0.3 (2005-09-23)]
  • Das Attribut if stimmte nicht mit der normalen Semantik von Ant überein, deswegen wurde jetzt das Attribut run zum Ein/Ausschalten des Tasks eingeführt.

[0.0.2 (2005-09-07)]
  • Beim Task LaTeX die Elemente makeindex, bibtex und glosstex zugelassen um die "komplexeren" Attribute durchreichen zukönnen.
  • Mit dem if-Attribut können jetzt die Tasks ein- bzw. ausgeschaltet werden.

[0.0.1 (2005-09-02)]
  • Erste Veröffentlichung

Lizenz

Dieses Programm ist freie Software. Sie können es heraus- und/oder weitergeben. Modifizierung des Programms ist nur dann erlaubt, wenn Sie sich das Einverständnis des Lizenz-Inhabers einholen.

Die Veröffentlichung dieses Programms erfolgt in der Hoffnung, daß es Ihnen von Nutzen sein wird, aber OHNE JEDE GEWÄHRLEISTUNG - sogar ohne die implizite Gewährleistung der MARKTREIFE oder der EIGNUNG FÜR EINEN BESTIMMTEN ZWECK.

Gewährleistung

Da das Programm ohne jegliche Kosten lizenziert wird, besteht keinerlei Gewährleistung für das Programm, soweit dies gesetzlich zulässig ist. Sofern nicht anderweitig schriftlich bestätigt, stellen die Copyright-Inhaber und/oder Dritte das Programm so zur Verfügung, "wie es ist", ohne irgendeine Gewährleistung, weder ausdrücklich noch implizit, einschließlich - aber nicht begrenzt auf - Marktreife oder Verwendbarkeit für einen bestimmten Zweck. Das volle Risiko bezüglich Qualität und Leistungsfähigkeit des Programms liegt bei Ihnen. Sollte sich das Programm als fehlerhaft herausstellen, liegen die Kosten für notwendigen Service, Reparatur oder Korrektur bei Ihnen.

In keinem Fall, außer wenn durch geltendes Recht gefordert oder schriftlich zugesichert, ist irgendein Copyright-Inhaber oder irgendein Dritter, der das Programm wie oben erlaubt modifiziert oder verbreitet hat, Ihnen gegenüber für irgendwelche Schäden haftbar, einschließlich jeglicher allgemeiner oder spezieller Schäden, Schäden durch Seiteneffekte (Nebenwirkungen) oder Folgeschäden, die aus der Benutzung des Programms oder der Unbenutzbarkeit des Programms folgen (einschließlich - aber nicht beschränkt auf - Datenverluste, fehlerhafte Verarbeitung von Daten, Verluste, die von Ihnen oder anderen getragen werden müssen, oder dem Unvermögen des Programms, mit irgendeinem anderen Programm zusammenzuarbeiten), selbst wenn ein Copyright-Inhaber oder Dritter über die Möglichkeit solcher Schäden unterrichtet worden war.

Autor

Jürgen A. Lamers

Download

© 2005-07 DokuTransData, Aachen
Erstellt am 02.September 2005.
Letzte Änderung: 25. September 2007, 20:00 Uhr
Jürgen A. Lamers