fo:simple-page-master

(Auszug aus "XSL-FO ― Die Referenz" von Manuel Montero Pineda & Steffen Herkert, 2016, dpunkt.verlag)

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

Recommendationnummer: 6.4.13

Kategorie: 6.4 Declarations and Pagination and Layout Formatting Objects

Beschreibung

In diesem Element können einzelne Seiten eingerichtet werden. Den fünf verschiedenen Bereichen einer Seite können gewünschte Werte zugeteilt werden.

XSL-FO Version: 1.0

Elternelemente

<fo:layout-master-set> In diesem Element werden alle Vorlagen für die zu verwendenden Seiten(-folgen) erstellt.

Kindelemente

<fo:region-after> In diesem Element können Einstellungen zu dem Bereich vorgenommen werden, der unterhalb des fo:region-body-Bereichs ist (also zum Fußbereich einer Seite).
<fo:region-before> In diesem Element können Einstellungen zu dem Bereich vorgenommen werden, der oberhalb des fo:region-body-Bereichs liegt (also zum Kopfbereich einer Seite).
<fo:region-body> Dieses Element benennt den Bereich, der sich in der Mitte befindet (Hauptbereich der Seite). Hier wird der hauptsächliche Inhalt eines Dokuments angezeigt.
<fo:region-end> Der Bereich, der sich bei Links-nach-rechts-Schreibweise rechts des <fo:region-body>-Bereichs befindet.
<fo:region-start> Der Bereich, der sich bei Links-nach-rechts-Schreibweise links des <fo:region-body>-Bereichs befindet.

Attribute

end-indent Dieses Attribut legt für einen Bereich eine rechtsbündige Einrückung fest. Der end-Bereich orientiert sich an der vorherrschenden Schreibrichtung. Bezogen auf die westliche Schreibrichtung (oben nach unten, links nach rechts) ist dies rechts. Falls eine andere Schreibrichtung (z. B. Arabisch) vorliegt, kann dies auch links sein.
margin Dieses Attribut wird zum gleichzeitigen Setzen des oberen, rechten, unteren und linken Randes bzw. Abstands eines Bereichs zu seinem direkt übergeordneten Blockbereich verwendet. Wird nur ein Wert angegeben, so gilt der Abstand sowohl für den linken (margin-left), den rechten (margin-right), den oberen (margin-top) als auch den unteren (margin-bottom) Abstand. Werden zwei Werte angegeben, so gilt der erste für den Abstand oben und unten (margin-top und margin-bottom) und der zweite für den Abstand links und rechts (margin-left und margin-right). Werden drei Werte angegeben, so gilt der erste für den Abstand oben (margin-top), der zweite für den Abstand links und rechts (margin-left und margin-right) und der dritte für den Abstand unten (margin-bottom). Werden alle vier Werte angegeben, so gilt die übliche Reihenfolge: Abstand oben (margin-top), Abstand rechts (margin-right), Abstand unten (margin-bottom) und Abstand links (margin-left).
margin-bottom Dieses Attribut wird zum Setzen eines unteren Abstands verwendet, den ein Bereich im Verhältnis zu seinem direkt übergeordneten Bereich einnehmen soll. Die anderen Abstände werden mit margin-top (Abstand oben), margin-right (Abstand rechts) und margin-left (Abstand links) angegeben. Wird hier ein Wert angegeben, überschreibt dieser den entsprechenden Wert, der eventuell in margin angegeben wurde.
margin-left Dieses Attribut wird zum Setzen eines linken Abstands verwendet, den ein Bereich im Verhältnis zu seinem direkt übergeordneten Bereich einnehmen soll. Die anderen Abstände werden mit margin-top (Abstand oben), margin-right (Abstand rechts) und margin-bottom (Abstand unten) angegeben. Wird hier ein Wert angegeben, überschreibt dieser den entsprechenden Wert, der eventuell in margin angegeben wurde.
margin-right Dieses Attribut wird zum Setzen eines rechten Abstands verwendet, den ein Bereich im Verhältnis zu seinem direkt übergeordneten Bereich einnehmen soll. Die anderen Abstände werden mit margin-top (Abstand oben), margin-left (Abstand links) und margin-bottom (Abstand unten) angegeben. Wird hier ein Wert angegeben, überschreibt dieser den entsprechenden Wert, der eventuell in margin angegeben wurde.
margin-top Dieses Attribut wird zum Setzen eines oberen Abstands verwendet, den ein Bereich im Verhältnis zu seinem direkt übergeordneten Bereich einnehmen soll. Die anderen Abstände werden mit margin-right (Abstand rechts), margin-left (Abstand links) und margin-bottom (Abstand unten) angegeben. Wird hier ein Wert angegeben, überschreibt dieser den entsprechenden Wert, der eventuell in margin angegeben wurde.
master-name Dieses Attribut wird zur eindeutigen Kennzeichnung von Seitenvorlagen (fo:simple-page-master) und Seitenfolgevorlagen (fo:page-sequence-master) verwendet. Referenziert werden die so gekennzeichneten Seitenvorlagen bzw. Seitenfolgevorlagen in den gewählten Seitenfolgen (fo:page-sequence) mit dem Attribut master-reference. Gibt es eine Seitenvorlage, die das gleiche master-name-Attribut wie eine Seitenfolgevorlage hat, wird eine entsprechende Referenz mit dem Attribut master-reference immer auf die Seitenfolgevorlage verweisen.
page-height Das Seitenformat für eine Seitenvorlage wird im Element fo:simple-page-master mit den Attributen page-width und page-height angegeben. Das page-width-Attribut ist für die Seitenbreite und das page-height-Attribut für die Seitenhöhe verantwortlich.
page-width Das Seitenformat für eine Seitenvorlage wird im Element fo:simple-page-master mit den Attributen page-width und page-height angegeben. Das page-width-Attribut ist für die Seitenbreite und das page-height-Attribut für die Seitenhöhe verantwortlich.
reference-orientation Ein Objekt kann mit diesem Attribut gedreht werden. Die Rotierung ist nur in 90°-Schritten möglich (0°, 90°, 180°, 270°).
size Gibt die Orientierung und Größe einer Seite an. Kann neben den drei vordefinierten Werten auch eine Höhen- und Breitenangabe der Seite enthalten.
space-after Dieses Attribut legt einen Abstand zum direkt folgenden Bereich fest. Dieser Abstand wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Wird die Seite nach diesem Bereich umbrochen, so wird der Abstand auf der Folgeseite ignoriert. Es handelt sich um ein Attribut, das mehrere Abstandswerte zusammenfassen kann.
space-after.conditionality Dieses Attribut legt fest, inwiefern der Abstand zum direkt folgenden Bereich, der in space-after angegeben wird, angewandt werden soll, wenn der Bereich durch einen Umbruch in zwei Teilbereiche geteilt wird. Der umbrochene Bereich kann weiterhin als ein Bereich angesehen werden, und dementsprechend wird der Umbruch bzw. werden die Umbrüche ignoriert und nur der Abstand zum direkt folgenden Bereich wird angezeigt. Die einzelnen Teilbereiche können auch als eigenständige Bereiche angesehen werden. So wird jeweils vor einem Umbruch ebenfalls ein solcher Abstand eingefügt.
space-after.maximum Dieses Attribut legt einen maximal erlaubten Abstand zum direkt folgenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, können so Grenzen gesetzt werden. Der Abstand zum direkt folgenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-after.minimum Dieses Attribut legt einen minimal erlaubten Abstand zum direkt folgenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, können so Grenzen gesetzt werden. Der Abstand zum direkt folgenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-after.optimum Dieses Attribut legt einen optimalen Abstand zum direkt folgenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, wird möglichst versucht, diesen Abstand zu erhalten. Der Abstand zum direkt folgenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-after.precedence Wird für einen Bereich eine space-after-Angabe gemacht und für den direkt folgenden Bereich eine space-before-Angabe, bestimmt nur eine der beiden Angaben den Abstand zwischen den beiden Bereichen. Welche der beiden Angaben höhere Priorität hat, wird aus den entsprechenden space-after.precedence- bzw. space-before.precedence-Attributen berechnet. Haben beide Attribute den gleichen Wert, wird immer die space-after-Angabe bevorzugt.
space-before Dieses Attribut legt einen Abstand zum direkt vorangegangenen Bereich fest. Dieser Abstand wird nur gesetzt, wenn auch ein Bereich auf der Following-Sibling-Achse (im FO-Dokument) definiert wird. Wird die Seite nach diesem Bereich umbrochen, so wird der Abstand auf der Folgeseite ignoriert. Es handelt sich um ein Attribut, das mehrere Abstandswerte zusammenfassen kann.
space-before.conditionality Dieses Attribut legt fest, inwiefern der Abstand zum direkt vorstehenden Bereich, der in space-before angegeben wird, angewandt werden soll, wenn der Bereich durch einen Umbruch in zwei Teilbereiche geteilt wird. Der umbrochene Bereich kann weiterhin als ein Bereich angesehen werden, und dementsprechend wird der Umbruch bzw. werden die Umbrüche ignoriert und nur der Abstand zum direkt vorstehenden Bereich wird angezeigt. Die einzelnen Teilbereiche können auch als eigenständige Bereiche angesehen werden. So wird jeweils nach einem Umbruch ebenfalls ein solcher Abstand eingefügt.
space-before.maximum Dieses Attribut legt einen maximal erlaubten Abstand zum direkt vorstehenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, können so Grenzen gesetzt werden. Der Abstand zum direkt vorstehenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-before.minimum Dieses Attribut legt einen minimal erlaubten Abstand zum direkt vorstehenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, können so Grenzen gesetzt werden. Der Abstand zum direkt vorstehenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-before.optimum Dieses Attribut legt einen optimalen Abstand zum direkt vorstehenden Bereich fest. Berechnet der Prozessor die Verteilung der Bereiche auf einer Seite/Spalte automatisch, wird möglichst versucht, diesen Abstand zu erhalten. Der Abstand zum direkt vorstehenden Bereich wird nur gesetzt, wenn auch ein Bereich auf der Preceding-Sibling-Achse (im FO-Dokument) definiert wird. Hierbei unterscheidet sich das Attribut von den margin-Attributen.
space-before.precedence Wird für einen Bereich eine space-before-Angabe gemacht und für den direkt vorstehenden Bereich eine space-after-Angabe, bestimmt nur eine der beiden Angaben den Abstand zwischen den beiden Bereichen. Welche der beiden Angaben höhere Priorität hat, wird aus den entsprechenden space-after.precedence- bzw. space-before.precedence-Attributen berechnet. Haben beide Attribute den gleichen Wert, wird immer die space-after-Angabe bevorzugt.
start-indent Dieses Attribut legt für einen Bereich eine Einrückung am Anfang jeder Zeile fest.
writing-mode Dieses Attribut wird zum Festlegen der Schreibrichtung verwendet. Angewandt auf Seitenvorlagen (fo:simple-page-master), beeinflusst writing-mode die Platzierung der Bereiche fo-region-body, fo-region-before, fo-region-after, fo-region-start bzw. fo-region-end. Angewandt auf Tabellen, bewirkt writing-mode die horizontale Ausrichtung von Tabellenspalten oder -zellen bzw. die vertikale Ausrichtung bei Zeilen. So können Tabllen beispielsweise im Landscape-Format dargestellt werden.

Unterstützung:

Conformance Level Antenna House FOP RenderX XEP Altsoft XML2PDF Compart DocBridge
Basic J P J J J

XSL-FO Beispiel:

<fo:root font-family="Arial" font-size="10pt" line-height="1.2em" xmlns:fo="http://www.w3.org/1999/XSL/Format" xmlns:cpfo="http://www.compart.net/xmlns/cpfo" xmlns:svg="http://www.w3.org/2000/svg" xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions">

Als Gregor Samsa eines Morgens aus unruhigen Träumen erwachte, fand er sich in seinem Bett zu einem ungeheueren Ungeziefer verwandelt. Er lag auf seinem panzerartig harten Rücken und sah, wenn er den Kopf ein wenig hob, seinen gewölbten, braunen, von bogenförmigen Versteifungen geteilten Bauch, auf dessen Höhe sich die Bettdecke, zum gänzlichen Niedergleiten bereit, kaum noch erhalten konnte. Seine vielen, im Vergleich zu seinem sonstigen Umfang kläglich dünnen Beine flimmerten ihm hilflos vor den Augen.

</fo:flow>

</fo:root>

Download der Beispiele

Weitere Informationen online zu

Einführung "Das Seiten-Layout">

Praxisbeispiel "Seiten - und einfache Seitefolgen-Vorlagen">

Praxisbeispiel "Komplexe Seitenfolgen-Vorlagen">

Praxisbeispiel "Mehrspaltige Seiten mit Spaltenlinien">

Darstellung des Elementes in der XSL-FO-Referenz

In der Ausgabe:

Auszug aus der W3C recommendation:

Tipp der data2type-Redaktion:
Zum Thema XSL-FO bieten wir auch folgende Schulungen zur Vertiefung und professionellen Fortbildung an: