fo:conditional-page-master-reference

(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.12

Kategorie: 6.4 Declarations and Pagination and Layout Formatting Objects

Beschreibung

Dieses Element benennt ein Seitenvorlagen-Objekt, das verwendet wird, wenn die dafür erforderlichen Bedingungen eintreten.

XSL-FO Version: 1.0

Elternelemente

<fo:repeatable-page-master-alternatives> Dieses Element legt fest, wie verschiedene Seitenvorlagen wiederholt dargestellt werden sollen (z. B. Wechsel zwischen links- und rechtsbündigen Seitenvorlagen).

Attribute

blank-or-not-blank Im Element fo:conditional-page-master-reference kann mit dieser Eigenschaft eine Bedingung aufgestellt werden, ob eine ausgewählte Seitenvorlage an einem bestimmten Punkt in der Seitenfolge ausgewählt werden soll oder nicht.
master-reference Dieses Attribut wird zur Referenzierung einzelner Seitenvorlagen (fo:simple-page-master) oder ganzer Seitenfolgevorlagen (fo:page-sequence-master) verwendet. Diese erhalten in einem master-name-Attribut einen Namen, der im Attribut master-reference angegeben werden muss. Der Name muss mindestens in einem master-name-Attribut verwendet worden sein. Gibt es eine Seitenvorlage und eine Seitenfolgevorlage, denen beide der gleiche Name zugewiesen wurde, wird immer die Seitenfolgevorlage referenziert, es sei denn, die Referenzierung findet innerhalb eines fo:simple-page-master-Elements statt. Gibt es zwei Seitenvorlagen mit dem gleichen master-name, wird die zuerst definierte referenziert.
odd-or-even Mit dem Element fo:conditional-page-master-reference wird eine Seitenvorlage für eine Seitenfolge (fo:repeatable-page-master-alternatives) referenziert. Enthält eine Seitenfolge nur ein fo:conditional-page-master-reference-Element, wird für jede Seite die gleiche Seitenvorlage verwendet. Für viele Publikationen — vor allem Bücher — ist es notwendig, dass die Seiten zwei verschiedene Seitenvorlagen abwechselnd verwenden. So wird bei einem Buch ein Unterschied zwischen rechter und linker Seite geschaffen (Abstand zum Bund und zum äußeren Rand, Position der Seitenzahl, Postion und Inhalt der Kopfzeile etc.). Hierzu werden bei einer Seitenfolge mehrere Seitenvorlagen referenziert. Um zu bestimmen, ob die referenzierte Seitenvorlage nur für Seiten mit einer geraden bzw. ungeraden Seitenzahl festgelegt ist, kann für das jeweilige fo:conditional-page-master-reference-Element das Attribut odd-or-even angegeben werden.
page-position Mit fo:conditional-page-master-reference-Elementen wird im fo:repeatable-page-master-alternatives-Element eine Seitenfolge beschrieben. Das fo:conditional-page-master-reference-Element bezieht sich auf eine Seitenvorlage. Mit dem Attribut page-position lässt sich hier angeben, an welcher Position im zu erzeugenden Dokument die bezügliche Seitenvorlage verwendet werden darf. Es kann angegeben werden, dass sie nur für die erste Seite, nur für die letzte Seite, nur für die übrigen Seiten oder für alle Seiten verwendet wird. In Kombination mit dem Attribut odd-or-even können mehrere Seitenvorlagen mit dem gleichen Wert für page-position im Element fo:repeatable-page-master-alternatives auftreten.

Unterstützung:

Conformance Level Antenna House FOP RenderX XEP Altsoft XML2PDF Compart DocBridge
Extended J J J P 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">

Seitenvorlage

erste Seite

; page-position="

first

"

Seitenvorlage:

übrige Seiten

; page-position="

rest

"

Seitenvorlage:

letzte Seite

; page-position="

last

"

Inhalt Seitenfolge

Inhalt Seitenfolge

Inhalt Seitenfolge

Inhalt Seitenfolge

</fo:flow>

</fo:root>

Download der Beispiele

Weitere Informationen online zu

Einführung "Das Seiten-Layout">

Praxisbeispiel "Komplexe Seitenfolgen-Vorlagen">

Praxisbeispiel "Mehrspaltige Seiten mit Spaltenlinien">

Darstellung des Elementes in der XSL-FO-Referenz

In der Ausgabe:

Seite 2

Seite 3

Seite 4

Auszug aus der W3C recommendation:

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