antillesXML: XSL-FO

Transformationen mit XSL-FO

Registerkarte: Single

Registerkarte: Folder

Registerkarte: Properties

Hintergrund:

In diesem Bereich haben Sie die Möglichkeit, einzeln sowie ordnerweise PDF-Dokumente mittels XSL-FO-Operationen zu generieren. Hierfür können diverse Formatierer eingesetzt werden.
data2type: XML-Technologien → XSL-FO → Formatierer-Vergleich

Modifikationen des Transformationsprozesses

Sie können diverse Einstellungen am zugrunde liegenden Saxon-XSLT-Prozessor vornehmen.

Ein Beschreibung dieser Möglichkeiten finden Sie im folgenden Abschnitt:
data2type: antillesXML-Help → Settings

Registerkarte: Single

Transformationen von Einzeldateien

So generieren Sie mittels XSL-FO aus einzelnen Dateien PDF-Dokumente.

Aufrufen des Fensters XSL-FO
  1. Wählen Sie im Menü XSL den Eintrag XSL-FO.
    → Das Fenster XSL-FO erscheint.
  2. → Die Registerkarte Single ist standardmäßig beim ersten Aufruf bereits ausgewählt.
    Sollte dies nicht der Fall sein, wählen Sie jetzt die Registerkarte Single.

    Fenster XSL-FO mit aktiver Registerkarte Single

Auswahl des Eingangsdokuments

Sie benötigen eine Datei als Eingangsdokument, dessen Elemente und Daten transformiert werden sollen.

Abhängig von dem Anwendungszweck und dem verwendeten XSL-Stylesheet, kann es sich bei dieser Datei um verschiedene Formen von verarbeitbaren Daten handeln.
I. d. R. wird es sich hierbei bereits um eine XML-Datei handeln.

  1. Klicken Sie auf die Schaltfläche Schaltfläche zum Öffnen des Eingangsdokuments

    → Der Öffnen-Dialog erscheint.

  2. Wählen Sie den Pfad zu dem Eingangsdokument in Ihrem Dateisystem.
  3. Klicken Sie auf Öffnen.
Angabe der Stylesheet-Datei

Sie benötigen eine XSLT-Datei als Stylesheet, die das Eingangsdokument in das neue Ausgabeformat transformiert.
Bei diesen XSLT-Dateien muss es sich um FO-Stylesheets handeln.

Die einzelnen Templates betten die extrahierten Elemente und Daten aus dem Eingangsdokument in ein Master-Layout.
data2type: XML-Technologien → XSL-FO → XSL-FO-Referenz

  1. Klicken Sie auf die Schaltfläche Schaltfläche zum Öffnen eines Stylesheets

    → Der Öffnen-Dialog erscheint.

  2. Wählen Sie den Pfad zu dem Stylesheet in Ihrem Dateisystem.
  3. Klicken Sie auf Öffnen.
Auswahl des Ausgangsdokuments

Sie benötigen eine Datei als Ausgangsdokument, in das die Transformation hineingeschrieben werden kann.

  1. Klicken Sie auf die Schaltfläche Schaltfläche zum Auswählen eines Ausgangsdokuments

    → Der Speichern unter-Dialog erscheint.

  2. Wählen Sie den Pfad zu dem Ausgangsordner in Ihrem Dateisystem.
  3. Vergeben Sie einen eindeutigen Namen für das Ausgangsdokument unter Dateiname.
  4. Klicken Sie auf Speichern.
Ausführen der Transformation

Klicken Sie auf die Schaltfläche Schaltfläche zum Ausführen der Transformation

→ Das Ausgangsdokument wurde an die von Ihnen gewählte Stelle geschrieben.

Das Resultat der Transformation wird zusätzlich im Fenster Statistics in der Registerkarte Results angezeigt.
Eventuelle Fehlermeldungen im Rahmen der Transformation werden im Fenster Statistics in der Registerkarte Log angezeigt.

Registerkarte: Folder

Transformationen von ganzen Ordnern

So generieren Sie mittels XSL-FO aus ganzen Verzeichnissen PDF-Dokumente.
I. d. R. wird es sich hierbei bereits um XML-Dateien handeln.

Aufrufen des Fensters XSL-FO
  1. Wählen Sie im Menü XSL den Eintrag XSL-FO.
    → Das Fenster XSL-FO erscheint.
  2. Wählen Sie die Registerkarte Folder.

Fenster XSL-FO mit aktiver Registerkarte Folder

Auswahl des Eingangsordners

Sie benötigen einen Ordner als Eingangsordner, dessen Dateien transformiert werden sollen.
Abhängig von dem Anwendungszweck und dem verwendeten XSL-Stylesheet, kann es sich in dem Ordner um verschiedene Formen von verarbeitbaren Dateien handeln.

  1. Klicken Sie auf die Schaltfläche Schaltfläche zur Auswahl des Eingangsordners

    → Der Ordner suchen-Dialog erscheint.

  2. Wählen Sie den Pfad zu dem Eingangsverzeichnis in Ihrem Dateisystem.
  3. Klicken Sie auf OK.
Angabe der Stylesheet-Datei

Sie benötigen eine XSLT-Datei als Stylesheet, die die Eingangsdokumente in das neue Ausgabeformat transformiert.
Bei diesen XSLT-Dateien muss es sich um FO-Stylesheets handeln.
Die einzelnen Templates betten die extrahierten Elemente und Daten aus dem Eingangsdokument in ein Master-Layout.
data2type: XML-Technologien → XSL-FO → XSL-FO-Referenz

  1. Klicken Sie auf die Schaltfläche Schaltfläche zum Öffnen eines Stylesheets

    → Der Öffnen-Dialog erscheint.

  2. Wählen Sie den Pfad zu dem Stylesheet in Ihrem Dateisystem.
  3. Klicken Sie auf Öffnen.
Auswahl des Ausgangsordners

Sie benötigen einen Ordner als Ausgangsordner, in dem die Ausgangsdokumente abgelegt werden.

  1. Klicken Sie auf die Schaltfläche Schaltfläche zur Auswahl des Ausgangsordners

    → Der Ordner suchen-Dialog erscheint.

  2. Wählen Sie den Pfad zu dem Ausgangsordner in Ihrem Dateisystem.
  3. Klicken Sie auf OK.
Ausführen der Transformation

Klicken Sie auf die Schaltfläche Schaltfläche zum Ausführen der Transformation

→ Die Ausgangsdokumente wurden an die von Ihnen gewählte Stelle geschrieben.

Das Resultat der Transformation wird zusätzlich im Fenster Statistics in der Registerkarte Results angezeigt.
Eventuelle Fehlermeldungen im Rahmen der Transformation werden im Fenster Statistics in der Registerkarte Log angezeigt.

Registerkarte: Properties

Transformationen mit diversen FO-Formatierern

Für den Rendering-Prozess kann unter drei verschiedenen FO-Formatierern ausgewählt werden.
Standardmäßig ist dies der mitgelieferte Apache FOP. Weitere FO-Formatierer können jedoch eingebunden werden.

Weiterführende Links zum Thema Formatierer:
data2type: XML-Technologien → XSL-FO → Formatierer-Vergleich

Aufrufen des Fensters XSL-FO
  1. Wählen Sie im Menü XSL den Eintrag XSL-FO.
    → Das Fenster XSL-FO erscheint.
  2. Wählen Sie die Registerkarte Properties.

Fenster XSL-FO mit aktiver Registerkarte Properties

Optionen der Registerkarte Properties
Auswahl des Formatierers
  • PDF-Generierung mit dem Apache FOP

    Dieser FO-Formatierer ist im Umfang von antillesXML bereits enthalten und standardmäßig aktiviert.
    Der Apache FOP deckt weitestgehend den Basic Conformance Level der W3C-Empfehlung für XSL-FO ab.

    Weiterführende Links zum Thema Apache FOP:
    Apache FOP: Introduction
    Apache FOP: Apache FOP Compliance Page

    Wählen Sie im Fensterbereich unter Which Formatter? die Option Apache FOP 1.0.
    → Der FO-Formatierer ist damit aktiviert.

  • PDF-Generierung mit dem Antenna House Formatter

    "Der kommerzielle XSL-Formatter von Antenna House ist das erste und einzige Werkzeug, das auf der Basis des Standards XSL-FO auch sehr komplexe Werke automatisiert verarbeitet und umbricht. Er erfüllt alle print-relevanten Anforderungen des XSL-FO Standards. Darüber hinaus bietet der Formatter eine ganze Reihe zusätzlicher Funktionalitäten, die nicht im XSL-FO Standard enthalten, aber zwingend notwendig sind für profesionelle Satzerstellung."

    Weiterführende Links zum Thema Antenna House Formatter:
    data2type: Software → XSL-Formatter
    Antenna House: Products
    Antenna House: XSL-FO → XSL-FO 1.1 Conformance

    1. Wählen Sie im Fensterbereich unter Which Formatter? die Option Antenna House.
      → Die Schaltfläche Settings erscheint im gleichen Fenster.
    2. Klicken Sie auf die Schaltfläche Settings.
      → Das Dialog-Fenster für die Eingabe der Pfadangabe erscheint.
    3. Klicken Sie auf die Schaltfläche change.
      → Der Ordner suchen-Dialog erscheint.
    4. Wählen Sie den Pfad zu der AHFCmd.exe-Datei im Antenna House-Programmordner.
    5. Klicken Sie auf ok.
      → Der FO-Formatierer ist damit aktiviert.
  • PDF-Generierung mit der RenderX XEP Engine

    Der ebenfalls kommerzielle FO-Formatierer von RenderX deckt große Teile des XSL-FO Standards ab, erreicht hierbei nicht den Umfang des Antenna House Formatter.
    Weiterführende Links zum Thema RenderX XEP Engine:
    RenderX: Products → XEP Engine
    RenderX: XEP User Guide → Appendix A. XSL-FO Conformance

    1. Wählen Sie im Fensterbereich unter Which Formatter? die Option RenderX.
      → Die Schaltfläche Settings erscheint im gleichen Fenster.
    2. Klicken Sie auf die Schaltfläche Settings.
      → Das Dialog-Fenster für die Eingabe der Pfadangabe erscheint.
    3. Klicken Sie auf die Schaltfläche change.
      → Der Ordner suchen-Dialog erscheint.
    4. Wählen Sie den Pfad zu der xep.bat-Datei im RenderX-Programmordner.
    5. Klicken Sie auf ok.
      → Der FO-Formatierer ist damit aktiviert.
Ausgabe einer FO-Datei erzwingen

Standardmäßig wird lediglich ein PDF-Dokument erzeugt.
Während des Transformationsprozesses werden Elemente und Daten aus dem XML-Dokument in das FO-Master-Layout eingebettet, bevor dieses mit dem entsprechenden FO-Formatierer in ein PDF-Dokument umgewandelt wird.
Zwecks Fehleranalyse kann es sinnvoll sein, die FO-Datei näher zu betrachten.

Aktivieren Sie das Kontrollkästchen Create *.fo Files.
→ Es wird nun zusätzlich zum PDF-Dokument die zugehörige FO-Datei generiert.

   

<< zurück vor >>