Kapitel 1. Über diese Dokumentation

Wer sollte sie lesen

Die vorliegende Dokumentation richtet sich in erster Linie an Perl-Programmierer, deren Aufgabe es ist, dafür zu sorgen, dass technisch erzeugte PDF-Dokumente richtig sind.

Es wird davon ausgegangen, dass Sie Grundkenntnisse in der Perl-Programmierung besitzen. Ebenfalls ist ein Grundverständnis über Testautomatisierung hilfreich, aber keine Voraussetzung.

Code-Beispiele

Die in den nachfolgenden Kapiteln abgebildeten Code-Beispiele verwenden das Modul Test::More. PDF::PDFUnit (PDFUnit-Perl) kann aber auch in Verbindung mit jedem anderen Testmodul verwendet werden. Im Modul PDF::PDFUnit sind einige Beispiele enthalten.

Referenzen zur Java-Dokumentation

Die hier vorliegende Dokumentation enthält (nur) so viele Beispiele, dass die Benutzung von PDFUnit-Perl klar wird. Weil sich die Syntax und die Bedeutung einer Testmethode nicht von der Java-API unterscheidet, wird in dieser Dokumentation nicht jede Testfunktion beschrieben. Ziehen Sie die separate Dokumentation von PDFUnit-Java hinzu, um jede Funktion detailiert kennenzulernen. Sie ist online (http://www.pdfunit.com/de/documentation/java/index.html) verfügbar.

API für PDFUnit-Java

Die Javadoc-Dokumentation der API ist online verfügbar: http://www.pdfunit.com/api/javadoc/index.html.

Andere Programmiersprachen

PDFUnit gibt es für Perl, Java .NET, und als XML-Implementierung. Für jede Sprache existiert eine eigene Dokumentation.

Wenn es Probleme gibt

Haben Sie Schwierigkeiten, ein PDF zu testen? Recherchieren Sie zuerst im Internet, vielleicht ist dort ein ähnliches Problem schon beschrieben, eventuell mit einer Lösung. Sie können die Problembeschreibung auch per Mail an info[at]pdfunit.com schicken.

Neue Testfunktionen gewünscht?

Hätten Sie gerne neue Testfunktionen, wenden Sie sich per Mail an info[at]pdfunit.com. Das Produkt befindet sich permanent in der Weiterentwicklung, die Sie durch Ihre Wünsche gerne beeinflussen dürfen.

Verantwortlichkeit

Manche Code-Beispiele in diesem Buch verwenden PDF-Dokumente aus dem Internet. Aus rechtlichen Gründen stelle ich klar, dass ich mich von den Inhalten distanziere, zumal ich sie z.B. für die chinesischen Dokumente gar nicht beurteilen kann. Aufgrund ihrer Eigenschaften unterstützen diese Dokumente Tests, für die ich keine eigenen Testdokumente erstellen konnte - z.B. für chinesische Texte.

Danksagung

Axel Miesen hat die Perl-Schnittstelle für PDFUnit entwickelt und in dieser Zeit viele Fragen zur Java-Version gestellt, die sich auf die Entwicklung von PDFUnit-Java vorteilhaft auswirkten. Herzlichen Dank, Axel.

Bei meinem Kollegen John Boyd-Rainey möchte ich mich für die kritischen Fragen zur Dokumentation bedanken. Seine Anmerkungen haben mich dazu bewogen, manchen Sachverhalt anders zu formulieren. John hat außerdem die englische Fassung dieser Dokumentation Korrektur gelesen. Die Menge der aufgedeckten Komma- und anderer Fehler muss eine Tortur für ihn gewesen sein. Herzlichen Dank, John, für Deine Ausdauer und Gründlichkeit. Die Verantwortung für noch vorhandene Fehler liegt natürlich ausschließlich bei mir.

Herstellung dieser Dokumentation

Die vorliegende Dokumentation wurde mit DocBook-XML erstellt. Die PDF- und die HTML-Version stammen aus einer einzigen Textquelle und sind somit inhaltlich identisch. In beiden Zielformaten ist das Layout noch verbesserungswürdig, wie beispielsweise die Seitenumbrüche im PDF-Format. Die Verbesserung des Layouts steht schon auf der Aufgabenliste, jedoch gibt es noch andere Aufgaben mit höherer Priorität.

Feedback

Jegliche Art von Feedback ist willkommen, schreiben Sie einfach an info[at]pdfunit.com.