fo:bidi-override

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

Kategorie: 6.6 Inline-level Formatting Objects

Beschreibung

Dieses Element lässt Einstellungen über die gewünschte Schreibrichtung zu, falls der vorgegebene Unicode-Algorithmus für Bidirektionalität nicht angewandt werden kann.

XSL-FO Version: 1.0

Elternelemente

<fo:basic-link> , <fo:bidi-override> , <fo:block> , <fo:folio-prefix> , <fo:folio-suffix> , <fo:index-page-citation-list-separator> , <fo:index-page-citation-range-separator> , <fo:index-page-number-prefix> , <fo:index-page-number-suffix> , <fo:inline> , <fo:leader> , <fo:marker> , <fo:multi-case> , <fo:multi-toggle> , <fo:title> und <fo:wrapper>

Kindelemente

<fo:basic-link> Dieses Element erzeugt einen Link im Dokument, der entweder auf interne oder externe Referenzen verweist.
<fo:bidi-override> Dieses Element lässt Einstellungen über die gewünschte Schreibrichtung zu, falls der vorgegebene Unicode-Algorithmus für Bidirektionalität nicht angewandt werden kann.
<fo:block> Dieses Element erzeugt einen rechteckigen Bereich, innerhalb dessen eine Vielzahl von Elementen (z. B. Tabellen, Listen, Grafiken) erlaubt sind. Mithilfe von Attributen können diverse Einstellungen zur Gestaltung vorgenommen werden. Blöcke können beliebig ineinandergeschachtelt werden. Informationen aus übergeordneten Blöcken werden übernommen, falls für den untergeordneten Block keine anderen Einstellungen gemacht werden (Vererbung).
<fo:block-container> Innerhalb von Block-Containern lassen sich beliebig viele Blöcke zusammenfassen. Für den Container können durch Attribute Einstellungen für die gewünschte Positionierung im Dokument vorgenommen werden.
<fo:change-bar-begin> Dieses Element stellt den Anfang eines "Änderungsbereichs" dar, der durch sein passendes fo:change-bar-end beendet wird. Der Änderungsbereich ist mit einem Änderungsbalken ausgestattet, der entweder am Anfang oder am Ende der Spaltenkante entlang verläuft. Das Aussehen des Änderungsbalkens wird durch den Wert einiger entsprechender Eigenschaften bestimmt.
<fo:change-bar-end> Dieses Element stellt das Ende eines "Änderungsbereichs" dar, der durch sein passendes fo:change-bar-begin gestartet wird.
<fo:character> Dieses Element erzeugt die gesonderte Darstellung einzelner Zeichen.
<fo:external-graphic> Dieses Element fügt externe Grafiken in das Dokument ein. Über Attribute lassen sich zahlreiche Einstellungen vornehmen.
<fo:float> Dieses Element ermöglicht die Platzierung von Inhalten in Relation zu einem Anzeigenblock (Anwendungsbeispiele: Text, der Grafiken umfließen soll; Erzeugung von Marginalien).
<fo:footnote> Dieses Element erzeugt einen Verweis auf eine Fußnote.
<fo:index-page-citation-list> Dieses Element gruppiert die Sammlungen von "Seitenreferenzen" (cited page items), die von seinen fo:index-key-reference-Kindelementen generiert wurden. Im Endeffekt wird fo:index-page-citation-list dazu genutzt, eine formatierte Liste von Seitenzahlen und Seitenbereichen zu erzeugen (eine Seitenzahlreferenzliste).
<fo:index-range-begin> Dieses Element stellt den Anfang eines "indexierten Bereichs" dar, der mit einem Index-Schlüssel verbunden ist. Dieser Index-Bereich wird durch ein entsprechendes fo:index-­range-end abgeschlossen.
<fo:index-range-end> Dieses Element stellt das Ende eines "indexierten Bereichs" dar, der durch sein entsprechendes fo:index-range-begin gestartet wird.
<fo:inline> Mit diesem Element wird ein inzeiliger Bereich erzeugt, in dem bestimmten Textteilen eines Blocks gesonderte Formatierungseigenschaften zugesprochen werden (Anwendungsbeispiel: Hervorheben einzelner Passagen durch Kursivschrift).
<fo:inline-container> Dieses Element erzeugt einen Container, in dem für mehrere inzeilige Bereiche gemeinsame Einstellungen vorgenommen werden können.
<fo:instream-foreign-object> Dieses Element erlaubt das Einfügen inzeiliger Grafiken oder anderer inzeiliger Objekte in das Dokument.
<fo:leader> Dieses Element erzeugt eine Zeile sich wiederholender Zeichen (zum Trennen von zwei Textformatierungsobjekten); Anwendungsbeispiel: Trennung von Überschriften und zugehörigen Seitenzahlen im Inhaltsverzeichnis.
<fo:list-block> Dieses Element erzeugt einen Bereich zur Darstellung einer Liste bzw. Aufzählung.
<fo:multi-properties> Mit diesem Element lässt sich zwischen verschiedenen Eigenschaftsmengen hin und her wechseln.
<fo:multi-switch> Mit diesem Element kann man zwischen verschiedenen Teilbäumen von Formatierungsobjekten hin und her wechseln.
<fo:multi-toggle> Dieses Element ermöglicht durch die Anwendung innerhalb eines <fo:multi-case>-Elements den Zugriff auf andere <fo:multi-case>-Elemente.
<fo:page-number> Dieses Element erzeugt die Darstellung der aktuellen Seitenzahl im Dokument.
<fo:page-number-citation> Dieses Element verweist auf die Seitenzahl der Seite, die ein bestimmtes Formatierungsobjekt enthält (Anwendungsbeispiel: Darstellung von Seitenzahlen in Inhaltsverzeichnissen entsprechend ihren Überschriften).
<fo:page-number-citation-last> Dieses Element verweist auf die Seitenzahl der letzten Seite, die ein Gebiet enthält, das (a) vom referenzierten Formatierungsobjekt zurückgegeben wird und (b) eine Gebietsklasse (area-class) hat, die mit der festgelegten Seitenverweisstrategie vereinbar ist.
<fo:retrieve-marker> Dieses Element ruft den in <fo:marker> markierten Bereich auf (Anwendungsbeispiel: Kolumnentitel).
<fo:retrieve-table-marker> Das Element erlaubt es, in Zusammenarbeit mit <fo:marker> Wiederholungen von Bereichen in Tabellen zu erzielen.
<fo:scaling-value-citation> Dieses Element ruft den Skalierungsfaktor des referenzierten fo:external-graphic ab.
<fo:table> Dieses Element erzeugt eine Tabelle.
<fo:table-and-caption> Dieses Element erzeugt eine Tabelle samt Tabellenüber- oder -unterschrift.
<fo:wrapper> Für eine Gruppe von Formatierungsobjekten können in <fo:multi-properties> Eigenschaften angegeben werden.

Attribute

bottom Mit diesem Attribut wird der Abstand festgelegt, den ein positioniertes Objekt (fo:block-container) gemessen vom unteren Rand seines unmittelbar übergeordneten Blockbereichs einnehmen soll.
color Dieses Attribut legt die Farbe des Anzeigetexts fest. Der angegebene Farbwert dient auch als Vorgabewert für die Farbe der Rahmenelemente des Bereichs, falls diese überhaupt erzeugt werden und nicht anderweitig definiert worden sind.
direction Mit diesem Attribut lässt sich für einen Bereich eine (abweichende) Schreibrichtung festlegen.
font Dieses Attribut stellt eine zusammenfassende Eigenschaft für Schrift dar, in der die einzelnen Werte für die Einzelattribute font-style, font-variant, font-weight, font-size, line-height und font-family gemeinsam angegeben werden können. Für font-size und font-family müssen Werte angegeben werden. Wertangaben für die übrigen Eigenschaften sind optional. Dabei gilt, dass die einzelnen Werte mit Leerstelle voneinander zu trennen sind. Lediglich wenn ein Wert für line-height angegeben werden soll, muss dieser direkt nach dem angegebenen Wert von font-size folgen. Dieser ist dann auch nicht durch eine Leerstelle, sondern durch einen Schrägstrich (/) vom vorangegangenen Wert von font-size zu trennen. Alternativ besteht auch die Möglichkeit, anstatt die Eigenschaften einzeln zusammenzustellen, systemeigene Schriften zu verwenden, wenn diese vorhanden sind. Diese haben dann bereits festgeschriebene Ausprägungen. Der Name dieser systemimmanenten Schriften erschließt sich aus dem Kontext, in dem sie verwendet werden.
font-family Mit diesem Attribut wird eine Schriftart angegeben, die verwendet werden soll. Es können auch mehrere Schriftarten angegeben werden. Diese würden entsprechend der festgelegten Reihenfolge verwendet werden. Dies ist beispielsweise hilfreich, um sicherzustellen, dass Zeichen, die nicht in einer Schriftart vorhanden sind, aus einem anderen Font entliehen werden können. Die Schriften müssen, falls sich in ihrer Bezeichnung Leerstellen befinden (sie also aus mehreren Wörtern bestehen, z. B. Times New Roman), in Anführungszeichen eingeschlossen werden. Werden mehrere Schriften angegeben, müssen diese mit Komma und Leerzeichen voneinander getrennt werden.
font-selection-strategy Dieses Attribut definiert die Kriterien zur Auswahl einer bestimmten Schriftart.
font-size Dieses Attribut wird zum Angeben der Schriftgröße verwendet. Diese kann relativ zum umgebenden Bereich, relativ zu den Einstellungen des Ausgabemediums oder mit einer absoluten Maßzahl (length) angegeben werden. Die absoluten Größenkonstanten xx-small, x-small, small, medium, large, x-large und xx-large sind gleichzusetzen mit fest definierten Faktoren, um die die voreingestellte Schriftgröße des Ausgabemediums skaliert werden würde. Die relativen Größenkonstanten larger und smaller sind ebenfalls vordefinierte Faktoren, die auf die Schriftgröße des umgebenden Bereichs angewandt werden. Mit einer absoluten Maßzahl wird die maximale Ausprägung angegeben, die die Schrift einnehmen kann, definiert als Abstand zwischen p-Linie und k-Linie (http://de.wikipedia.org/wiki/Schriftgrad).
font-size-adjust Mit diesem Attribut kann die Mittellänge (Größe des kleinen x) einer Schrift in Relation zur Schriftgröße angegeben werden. Dies dient der Anpassung und Vereinheitlichung des Schriftbildes, da unterschiedliche Schriften underschiedliche Mittellängen haben können.
font-stretch Dieses Attribut wird für die Angabe alternativer Schriftschnitte mit spezifischer Laufweite verwendet. So können Schriftschnitte mit geringerer oder größerer Laufweite gewählt werden. Es können relative und absolute Schlüsselwörter angegeben werden. Absolute Schlüsselwörter erweitern bzw. verringern die Laufweite mit dem Wert normal um einen festen Faktor (in Schritten 1,2, 1,2², 1,2³, usw.). Relative Schlüsselwörter erweitern bzw. verringern die Laufweite, die im umgebenden Bereich verwendet wird, um den Faktor 1,2. Formatierer können auch eine Prozentangabe für die Laufweite unterstützen.
font-style Mit diesem Attribut kann ein Schriftstil angegeben werden. Gegebenenfalls muss hierzu für die verwendete Schrift der entsprechende Schriftschnitt angelegt sein.
font-variant Dieses Attribut wird zur Darstellung von Kapitälchen verwendet. Für das lateinische Alphabet vorgesehen, werden Kleinbuchstaben als Großbuchstaben dargestellt, allerdings – um die Unterscheidung zu tatsächlichen Großbuchstaben zu wahren – in der Höhe eines Kleinbuchstabens.
font-weight Mit diesem Attribut wird über die Strichstärke (Dicke) der zu verwendende Schriftschnitt festgelegt. Es können relative und absolute Schlüsselwörter sowie bestimmte Zahlenwerte angegeben werden. Absolute Schlüsselwörter stehen für spezielle feste Zahlenwerte. Relative Schlüsselwörter erhöhen bzw. verringern die Strichstärke, die im umgebenden Bereich verwendet wird, um einen Wert von 200 auf der Zahlenwertskala. Die Zahlenwertskala verläuft in 100er-Schritten von 100 bis 900, wobei der Normalwert bei 400 liegt. Zu beachten ist, dass nur für wenige Schriften für jeden Schritt auf der Skala ein eigener Schriftschnitt angelegt ist. Ist kein entsprechender Schriftschnitt angelegt, wird der nächstgelegene vorhandene Schnitt verwendet.
id Dieses Attribut dient der eindeutigen Kennzeichnung eines Objekts, auf das dann von anderen Objekten aus verwiesen werden kann.
index-class Mit diesem Attribut lässt sich eine Indexklasse für einzelne Indexeinträge (index-key) oder für einen ganzen Bereich definieren. Alle Indexeinträge in dem entsprechenden Bereich gehören dann dieser Indexklasse an. Wird nun auf Indexeinträge referenziert (fo:index-key-reference), die verschiedenen Klassen angehören, werden die entsprechenden Seitenzahlen getrennt voneinander aufgeführt, selbst wenn sie auf aufeinanderfolgenden Seiten stehen. Beispielsweise wird "1-8" durch "1-4,5-8" ersetzt, wenn die Einträge auf den Seiten 1-4 alle derselben Klasse angehören und die Seiten 5-8 einer anderen Klasse. Dies kann zur Anwendung kommen, wenn Seiten in unterschiedliche Bereiche mit unterschiedlichen Nummerierungen gegliedert werden. Eine Nummerierung wie "I-14" kann so vermieden und durch "I-V,1-14" ersetzt werden.
index-key Mit diesem Attribut lässt sich ein Indexeintrag definieren. Der übergebene Wert wird als Bezeichner des Indexeintrags verwendet. Über eine Referenz eines Indexeintrags (fo:index-key-reference) kann auf alle Einträge mit diesem Bezeichner referenziert und deren Seitenzahlen können so einer Liste von Seitenzahlreferenzen (fo:index-page-citation-list) hinzugefügt werden.
left Dieses Attribut kann einen Bereich am linken Rand in Bezug auf den übergeordneten Bereich beschränken bzw. erweitern. Die Angabe kommt nur zur Wirkung, wenn im Attribut position nicht static angegeben wird. Die anderen Werte von position bestimmen, auf welchen Bereich sich das Attribut left bezieht. Ohne Angabe (0mm) ist der linke Rand gleich dem linken Rand des übergeordneten Bereichs. Bei einer positiven Angabe wird der Bereich entsprechend am linken Rand verringert, bei einer negativen Angabe entsprechend erweitert.
letter-spacing Dieses Attribut bestimmt den Abstand zwischen den einzelnen Textzeichen. Der Abstand ist fest vorgegeben. Für eine flexible Angabe können die Attribute letter-spacing.minimum, letter-spacing.maximum und letter-spacing.optimum verwendet werden.
line-height Dieses Attribut wird zum Festlegen der Höhe von Textzeilen verwendet. Für Blockbereiche wird der angegebene Wert als minimal einzunehmende Höhe gewertet; für inzeilige Bereiche wird der angegeben Wert als exakte Maßangabe übernommen. Zusätzlich können durch das Anhängen der Komponenten .minimum, .maximum, .optimum, .conditionality und .precedence an die Attributnamen relative Bedingungen geschaffen bzw. Prioritäten festgelegt werden für den Fall, dass unterschiedliche Aussagen miteinander kollidieren und durch Vererbung erhaltene Vorgaben generell übernommen bzw. verworfen werden.
position Dieses Attribut gibt die Art der Positionierung bzw. den Positionierungsbezug des ausgezeichneten Bereichs auf der jeweiligen Seite an. In Kombination mit den Attributen top, right, bottom und left kann eine Positionierung in Relation zu der durch den Textfluss bestimmten Position, zum umschließenden Bereich oder zu der vom Textfluss bestimmenden Seite angegeben werden.
relative-position Dieses Attribut gibt die Art der Positionierung des ausgezeichneten Bereichs auf der jeweiligen Seite an. Jedoch kann im Gegensatz zu position nur angegeben werden, ob der Bereich statisch eingefügt werden soll oder relativ zum Textfluss positioniert wird. In Kombination mit den Attributen top, right, bottom und left kann eine Positionierung in Relation zu der durch den Textfluss bestimmten Position angegeben werden.
right Mit diesem Attribut kann ein Bereich am rechten Rand in Bezug auf den übergeordneten Bereich beschränkt bzw. erweitert werden. Die Angabe kommt nur zur Wirkung, wenn im Attribut position nicht static angegeben wird. Die anderen Werte von position bestimmen, auf welchen Bereich sich das Attribut right bezieht. Ohne Angabe (0mm) ist der rechte Rand gleich dem rechten Rand des übergeordneten Bereichs. Bei einer positiven Angabe wird der Bereich entsprechend am rechten Rand verringert, bei einer negativen Angabe entsprechend erweitert.
score-spaces Findet eine Inline-Auszeichnung mit dem Attribut text-decoration statt, kann hier angegeben werden, ob der ausgezeichnete Weißraum "dekoriert" oder "undekoriert" dargestellt werden soll.
top Mit diesem Attribut wird der Abstand festgelegt, den ein positioniertes Objekt (fo:block-container) gemessen vom oberen Rand seines unmittelbar übergeordneten Blockbereichs einnehmen soll.
unicode-bidi Dieses Attribut wird zum Festlegen einer alternativen Schreibrichtung zu der ansonsten im Dokument verwendeten Schreibrichtung verwendet (z. B. arabische Passagen in deutschen Texten).
word-spacing Dieses Attribut wird zum individuellen Festlegen des Abstands, der zwischen Wörtern eingehalten werden soll, verwendet.

Unterstützung:

Conformance Level Antenna House FOP RenderX XEP Altsoft XML2PDF Compart DocBridge
Extended J J J J N

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">

»Was ist mit mir geschehen?«, dachte er. Es war kein Traum. Sein Zimmer, ein richtiges, nur etwas zu kleines Menschenzimmer, lag ruhig zwischen den vier wohlbekannten Wänden.

</fo:flow>

</fo:root>

Download der Beispiele

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: