CIB format technischer Leitfaden (DE)

4. Ausgabemodule

4.12. CIB format/xslfo

(ab CIB format Version 5.3.226b)

Das CIB format/xslfo (Extensible Stylesheet Language – Formatting Objects) Modul erzeugt aus dem Dokument eine XML-Anwendung, die beschreibt, wie Text, Bilder, Linien und andere grafische Elemente auf einer Seite angeordnet werden. Mit Hilfe von XSL-FO ist es möglich, qualitativ hochwertige Druckerzeugnisse entweder auf Papier oder auf dem Bildschirm zu erzeugen. Die Spezifikation erlaubt sogar, dass XSL-FO-Dokumente beispielsweise über einen Sprachsynthesizer vorgelesen werden können.

XSL-FO ist – neben XSLT und XPath – ein Teil der XSL-Spezifikation des W3C.

Spezielle Properties für die XslFo-Ausgabe

Diese Properties können nicht im RTF über PRINT CIB Befehl gesetzt werden.

Optionsname

Optionswert

Datentyp

OutputFormat

Diese Property kann mit dem Wert "FormatXslFo" belegt werden

Char*

OutputFilename

Name der Ausgabedatei in die XslFo-Daten geschrieben werden sollen.

Ist keine Ausgabedatei angegeben, wird der Name der Eingabedatei verwendet und mit dem Suffix „fo“ versehen.

Char*

InputFilename

Name der Eingabedatei, die in XslFo-Format umgewandelt werden soll.

Char*

HideGraphics

Grafiken, die (auch nur teilweise) innerhalb vorgegebener Rechtecke liegen, werden nicht ins PDF übernommen.

Beispiel:
HideGraphics ="{{1,3-40};{forbidden;2cm;2cm;5cm;4cm}};{{2,5,6};{forbidden;2cm;2cm;5cm;4cm}}“

Zur genauen Syntax siehe Property Checkmask. Als Typ des Rechtecks ist nur „forbidden“ möglich.

Char*

XslEmbedImages

 

Gibt an, wie eingebettete Grafiken bei der Umwandlung in XslFo behandelt werden.

"0" = Die Grafiken werden aus dem Eingabedokument extrahiert und per url mit der Ausgabe verknüpft.
Die Namen der Grafikdateien werden automatisch vergeben, z.B.:
xxx001.jpg, xxx002.jpg, xxx003.gif, usw.

xxx ist der Name der Ausgabedatei aus der Property OutputFilename. Wenn kein OutputFilename gesetzt ist, wird der Name der Eingabedatei (InputFilename) verwendet.

(default)

 

"1" = Die Grafiken werden in die XslFo-Ausgabedatei eingebettet.
(Dieses Feature ist noch nicht implementiert)

Char*

XslAllowHyphens

 

Gibt an, wie Texte bei der Umwandlung in XslFo behandelt werden: Die Silbentrennung kann ein- und ausgeschaltet werden.

"0" = Silbentrennung ist ausgeschaltet
(default).

"1" = Silbentrennung ist eingeschaltet.
In der Ausgabedatei wird ein Kennzeichen gesetzt, welches der nachfolgenden Verarbeitung erlaubt, eine Silbentrennung durchzuführen. Nach welchen Regeln getrennt wird, entscheidet das Nachfolgeprogramm.
(Dieses Feature ist noch nicht implementiert)

Char*

XslLayoutMode

(ab CIB format Version 5.3.226s)

 

Durch diese Property kann auf Fließtext-Ausgabe umgeschaltet werden. CIB format fügt keine Zeilen- oder Seitenwechsel mehr ein, außer bei Änderung des Seitenformats. Die Ausgabe wird fortlaufend aneinander gehängt. Ausgeführt werden nur explizit im Dokument vorgegebene Seiten- oder Abschnittswechsel.

„Fixed“  Die Ausgabe wird formatiert,
                        d.h. Zeilen- und Seitenwechsel
                        eingefügt (default)

„Flowing“         Fließtext-Ausgabe

Char*

XslZipOutput

(ab CIB format Version 5.3.233)

 

Die Ausgabe aller erzeugten Dateien (FO, Grafiken) erfolgt gezippt.

TRUE: Ausgabe gezippt

FALSE: keine gezippte Ausgabe

Default: FALSE

Char*

 

Beispiel für einen Runshell-Aufruf:

Es wird das Rtf „in.rtf“ in XslFo umgewandelt, das Rtf enthält eine jpg- und eine gif Grafik.

Cibrsh.exe –xfo in.rtf

Liefert den Output: in.fo, in001.jpg, in002.gif

Cibrsh.exe –xfo in.rtf out.fo

Liefert den Output: out.fo, out001.jpg, out002.gif