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.
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.
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.
Die Javadoc-Dokumentation der API ist online verfügbar: http://www.pdfunit.com/api/javadoc/index.html.
PDFUnit gibt es für Perl, Java .NET, und als XML-Implementierung. Für jede Sprache existiert eine eigene Dokumentation.
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.
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.
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.
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.
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.
Jegliche Art von Feedback ist willkommen, schreiben Sie einfach an info[at]pdfunit.com.