Kapitel 3.12 · Teil II · Das Handwerk
Konfiguration: Kästen
Benannte Stile für :::callout-Kästen: Kontur, Füllung, Streifen, Titel, Symbol, Marke und Etikett; Kastenformen mit Radien je Ecke, Konturen je Seite und verbundenen Etiketten; nummerierte Aussagen; Typografie im Kasten; Kästen, die über mehrere Seiten geteilt werden; und Gestaltungen im Kasten
Kurz gesagt
Diese Seite behandelt die Kästen, die eine Anmerkung, einen Tipp, eine Warnung oder eine Liste von Lernzielen vom Text absetzen. Sie geben jeder Art von Kasten einen Namen und ein Aussehen: Hintergrund, Kontur, einen farbigen Streifen, einen Titel und ein Symbol. Ein Kasten kann eine Nummer haben, wie ein Lehrsatz oder ein Beispiel in einem Lehrbuch. Sie wählen die Schriften im Kasten. Wenn ein langer Kasten auf der nächsten Seite weitergeht, wählen Sie, was die Trennstelle kennzeichnet.
#Kastenstile
Die Eigenschaft calloutStyles legt die benannten Kastenstile fest, die ein Dokument mit einem Container :::callout{type="…"} anwendet – Anmerkungen, Tipps, Warnungen, Lernziele, jeder Inhalt, der in einem getönten oder umrandeten Kasten vom Fließtext abgesetzt wird. Ein neutraler Stil, note, ist standardmäßig dabei (hellgrauer Hintergrund, keine Kontur, kein Streifen, kein Symbol, kein Titel), sodass :::callout ohne jede Konfiguration funktioniert; wer calloutStyles angibt, ersetzt diese Standardliste.
const config: PostextConfig = {
calloutStyles: [
{ id: 'note', name: 'Note' },
{
id: 'objectives',
name: 'Learning objectives',
title: 'Objectives',
stripe: { enabled: true, side: 'left' },
icon: { kind: 'glyph', glyph: '✓' },
titleStyle: { textTransform: 'uppercase' },
lists: { bulletChar: '–' },
},
{
id: 'warning',
title: 'Warning',
backgroundEnabled: false,
border: { enabled: true, color: { hex: '#AA0000', model: 'hex' }, width: { value: 1, unit: 'pt' } },
borderRadius: { value: 1, unit: 'mm' },
titleStyle: { color: { hex: '#AA0000', model: 'hex' } },
},
],
};:::callout{type="objectives"}
- Describe the parts of the lantern.
- Trim the wick at dusk.
:::
:::callout{type="warning" title="Do not touch the lens"}
The glass stays hot for an hour after the flame is out.
:::| Eigenschaft | Typ | Standard | Beschreibung |
|---|---|---|---|
id | string | — | Bezeichner, den :::callout{type="…"} auswählt. Ein Kasten mit unbekanntem oder fehlendem type verwendet den ersten konfigurierten Stil (die Sandbox meldet unbekannte Typen). |
name | string | id | Lesbarer Name (nur für die Editor-Oberfläche). |
extends | string | — | Die ID eines anderen Stils, auf dem dieser basiert: Jedes Feld, das er offenlässt, kommt von jenem Stil. Siehe Stile, die auf einem anderen basieren. |
title | string | '' | Standardtitel; leer bedeutet kein Titel. Das Attribut title der öffnenden Zeile überschreibt ihn pro Instanz. |
span | 'column' | 'page' | 'side' | 'column' | Waagerechte Ausdehnung: die Spalte, die volle Inhaltsbreite oder die nur für Gleitobjekte bestimmte Seitenspalte eines Layouts mit anderthalb Spalten (layout.) – der Kasten verlässt dann den Fluss und stapelt sich in dieser Spalte neben dem Text, den er unterbricht. Pro Instanz mit dem Attribut span überschreibbar. In mehrspaltigen Layouts wird ein Kasten mit 'page' zu einem seitenbreiten Block: Er teilt die Seite in Spaltenbereiche und steht in einer eigenen Spalte über die volle Breite (siehe den Abschnitt zum Container unten). Ein Seitenkasten, den die Seitenspalte seiner Seite nicht aufnehmen kann, wandert in die Seitenspalte der nächsten Seite; endet das Kapitel (oder das Dokument) vorher, wird jeder noch wartende Kasten in der Reihenfolge, in der die Kästen im Text stehen, in die Seitenspalte einer Seite nach dem Text gesetzt, und der Build meldet das (afterText; bis postext 1.24 entfielen die Kästen nach der ersten solchen Seite). |
columns | number | 1 | Wie viele benachbarte Spalten ein gleitender Kasten (placement 'auto', 'top' oder 'bottom', mit span: 'column') einnimmt, wie es placement.columns bei einer Abbildung tut: der Kasten eines Artikels über drei der fünf Spalten einer Zeitung. So viele Spalten, wie die Seite hat, oder mehr machen ihn zu einem Kasten über die ganze Seitenbreite. Ein im Fluss gesetzter Kasten ('here') bleibt in seiner Spalte. Pro Instanz mit dem Attribut columns überschreibbar. Seit postext 1.18. |
placement | 'here' | 'auto' | 'top' | 'bottom' | 'fixed' | 'here' | Wohin der Kasten kommt. 'here' setzt ihn in den Fluss; 'top' / 'bottom' lassen ihn wie eine Ressource gleiten ('auto' nimmt den Bereich, der zuerst frei ist, Kopf oder Fuß) – er verlässt den Fluss an seiner Stelle und nimmt den ersten freien Bereich an oder nach diesem Punkt (den Fuß der aktuellen Seite oder Kopf / Fuß der nächsten Seite, die der Fluss eröffnet), und der Text danach füllt die Seite um ihn herum; 'fixed' verankert ihn über fixed (siehe unten) an Seitenkoordinaten, außerhalb des Spaltenflusses. Einzelheiten im Abschnitt zum Container. Pro Instanz mit dem Attribut placement überschreibbar. |
sideAtColumnEnd | 'before' | 'after' | 'before' | Wo ein Seitenkasten (span: 'side') steht, wenn der Text nach dem Kasten nicht in derselben Spalte weitergeht: Die Spalte hat keinen Platz mehr dafür, oder die Umbruchregeln verschieben ihn (ein Absatz, den die Regeln für Witwen und Waisen ganz verschieben, eine Überschrift, die bei ihrem Text bleibt). 'before' hält ihn an seiner Stelle im Text, auf dieser Seite, neben dem Text davor, und schiebt ihn vom Fuß der Spalte nach oben, wenn er unterhalb dieser Stelle nicht passt: der Platz für eine Glosse, die nach der erläuterten Stelle geschrieben ist. 'after' setzt ihn auf Höhe der ersten Zeile des Texts nach dem Kasten, in die Seitenspalte der Seite, auf der dieser Text weitergeht: der Platz für eine Zeilennummer oder eine Randüberschrift, die vor ihrer Zeile geschrieben ist. Geht der Text in derselben Spalte weiter, setzen beide den Kasten an seine Stelle im Text. Ein Kasten, dem in seinem Kapitel nichts folgt, bleibt in beiden Fällen beim Text davor, und unmittelbar aufeinanderfolgende Seitenkästen behalten ihre Reihenfolge. Bis postext 1.4 verhielt sich jeder Seitenkasten wie 'before', was der Standard bleibt: Ein Stil für Glossen hält seine Kästen auf der Seite der Stelle, die sie erläutern. |
fixed | { anchor?, offset? } | { anchor: { to: 'container', edge: 'bottom-left' } } | Position eines Kastens mit 'fixed': ein ElementAnchor (to: 'container' = der Inhaltsbereich der Seite, auf geraden Seiten gespiegelt; 'page' = das Endformat; 'bleed' = der Anschnitt; edge: eine der neun Kanten des Containers) plus ein optionales offset (Maße x / y). |
floatBarrier | boolean | false | Den Kasten zu einer Schranke für Gleitobjekte machen: Jede Abbildung oder Tabelle, auf die vor ihm verwiesen wird, wird vor ihm platziert – in den freien Plätzen der Seite, sonst auf Seiten, die vor dem Kasten eröffnet werden –, sodass kein Gleitobjekt an einem abschließenden Kasten eines Kapitels (typischerweise eine Zusammenfassung der „Kernpunkte“) vorbeigerät. Kapitelauftakte, :::part und das Ende des Dokuments sind immer Schranken. |
Ein Kasten mit span: 'page' auf einer mehrspaltigen Seite schneidet den Spaltenbereich unter dem Text ab, dem er folgt; eine Abbildung über die ganze Breite, auf die vor ihm verwiesen wird, nimmt diesen Schnitt zuerst – der Text wird ausgeglichen, die Abbildung steht genau dort, wo er endete, und der Kasten geht darunter weiter (oder auf der nächsten Seite, wenn er nicht mehr passt). Eine Abbildung, die zu hoch ist, um dem ausgeglichenen Text zu folgen, eröffnet stattdessen die nächste Seite, mit dem Kasten danach, und der verlassene Spaltenbereich endet trotzdem ausgeglichen. Ein teilbarer Kasten (keepTogether: false) beginnt unter Text und Abbildung mit so vielen Einträgen, wie passen, und der Rest geht auf der nächsten Seite weiter. | |||
width | 'fill' | 'auto' | 'fill' | 'fill' nimmt die verfügbare Breite ein; 'auto' passt sich eng an den Titel an (als Abzeichen) und ignoriert den Inhalt. |
backgroundEnabled / background | boolean / ColorValue | true / #f4f4f4 | Fläche des Kastens. |
border | { enabled, color, width, sides } | false, #cccccc, 0.5pt | Umrisslinie des Kastens, innerhalb der Kastenkante gezeichnet wie die Kontur eines Kastenelements (siehe Kastenelemente). Seit postext 1.48 gibt sides jeder Seite (top, right, bottom, left) ein eigenes { enabled?, color?, width? } über den Werten der ganzen Kontur: nur eine Linie über dem Kasten, ein kräftigerer Fuß (siehe Ecken, Seiten und verbundene Etiketten). |
borderRadius | Dimension | { topLeft?, topRight?, bottomRight?, bottomLeft? } | 0 | Eckenradius von Hintergrund / Kontur (begrenzt auf die halbe Breite und Höhe des Kastens). Der Streifen folgt ihm: Bei einem abgerundeten Kasten wird der Streifen auf die abgerundete Form beschnitten, so wie CSS ein border-left auf border-radius beschneidet. Das Etikett label behält eckige Ecken, außer es ist mit dem Kasten verbunden. Seit postext 1.48 nimmt es einen Radius je Ecke an; eine Ecke, die im Objekt fehlt, bleibt eckig: ein Kasten, der nur an den beiden oberen Ecken abgerundet ist. |
padding | { top, right, bottom, left } | je 0.75em | Innenabstand zwischen Kastenkante und Inhalt. em-Werte beziehen sich auf die Schriftgröße des Kastentexts. |
stripe | { enabled, side, width, color } | false, 'left', 1.5em, Hauptfarbe | Vollflächiges Band an einer Kante. Ein Streifen 'left' / 'right' verschmälert den Inhalt; ein Streifen 'top' schiebt ihn nach unten. 'left' und 'right' sind Seiten des Textflusses (in einem Buch mit Leserichtung von rechts nach links ist 'left' die rechte Seite des Blatts); 'start' und 'end' folgen der eigenen Richtung des Kastens, sodass ein :::callout{dir=ltr} in einem arabischen Buch einen Streifen 'start' links setzt. Bei einem Kasten mit borderRadius werden seine äußeren Ecken mit denen des Kastens gerundet (bis postext 1.4 blieben sie eckig und ragten über die Rundung hinaus). |
icon | { kind, glyph, resourceId, fontFamily, fontWeight, size, width, color, align, position, cornerSide, shape, strokeWidth, tint } | 'none', Schrift der Überschriften, 400, 1.5em, Hauptfarbe, 'top', 'inline', 'right' | Ein Textzeichen (kind: 'glyph') oder eine Bitmap-/SVG-Ressource (kind: 'resource' + resourceId) neben dem Inhalt. Mit einem seitlichen Streifen wird das Symbol über dem Streifen zentriert; sonst reserviert es eine eigene Spalte (size + titleStyle.gap). align: 'center' zentriert es senkrecht zum Inhalt. Ein Ressourcenbild wird unter Wahrung seines Seitenverhältnisses in das Quadrat eingepasst – oder in ein Rechteck von width × size, wenn width gesetzt ist (ein breiter Streifen von Symbolen); ein Symbol, das höher als der Inhalt ist, vergrößert den Kasten entsprechend (und zentriert mit align: 'center' den Inhalt daran). position: 'corner' hängt das Symbol als Abzeichen an eine obere Ecke, zur Hälfte über die Kontur hinaus, ohne dem Inhalt Raum zu nehmen; ein breites Symbol (width) wird nach der Breite, in der es gezeichnet wird, an der Ecke zentriert, und an der linken Ecke beginnt der Titel hinter seiner inneren Hälfte (bis postext 1.4 wurde es nach seiner Höhe platziert, sodass ein breiter Streifen über den Kasten hinaus und über den Titel hing); cornerSide wählt die Ecke – 'right' / 'left'; 'outer' / 'inner', die bei gespiegelten Rändern der Lage der Seite folgen (außen = rechts auf einer rechten Seite, links auf einer linken); oder 'start' / 'end', die wie beim Streifen der Richtung des Kastens selbst folgen. Seit postext 1.52 zeichnet kind: 'shape' das Symbol selbst: einen shape: 'ring' (Ring, Standard) oder 'dot' (Punkt) mit dem Durchmesser size in color, die Ringlinie strokeWidth stark (standardmäßig ein Achtel von size), ohne Schrift oder Bild und in jeder Ausgabe gleich. tint malt ein Ressourcenbild in einer Farbe: true in color oder in einer eigenen Farbe (eine Palettenfarbe folgt der Palette), sodass ein Ringbild für jede Farbe eines Buchs reicht. Ein Symbol braucht weder Etikett noch Titel: Ein Kasten mit icon und ohne label zeigt es in seiner Spalte oder mit position: 'corner' als Plakette auf seiner Ecke. |
marker | { kind, glyph, resourceId, fontFamily, fontWeight, size, color, align, gap, rule, shape, strokeWidth, tint } | 'none', Schrift der Überschriften, 400, 1.5em, Hauptfarbe, 'center', 0.5em, Linie aus (0.5pt, Hauptfarbe, Länge 0) | Ein zweites Symbol, außerhalb des Kastens in einer Spalte links davon gezeichnet, mit einer optionalen senkrechten Linie rule zwischen ihm und dem Kasten – die „hier tippen“-Hand neben einem Abzeichen zur Selbsteinschätzung. Das Ganze wird zu [marker][rule][gap][box] und so hoch wie das höchste der drei; align zentriert sie zueinander oder richtet sie oben aus. rule.length ist ein Mindestwert: Die Linie reicht immer mindestens über die Höhe des Kastens. Die Markierung nimmt kind: 'shape', shape, strokeWidth und tint wie das Symbol. |
titleStyle | { fontFamily, fontSize, fontWeight, italic, color, textTransform, gap, letterSpacing, indent, lineHeight } | Schrift der Überschriften, Größe des Fließtexts, 700, false, Hauptfarbe, 'none', 0.5em, 0, 0, 1.2em | Typografie des Titels. gap ist der Abstand zwischen dem Titel und dem ersten Kindblock (und der Abstand der Symbolspalte). lineHeight ist der Zeilenabstand der Titelzeilen, wobei em die eigene Größe des Titels zählt; die Grundlinie liegt in jeder Zeile bei 0,8 davon, wie im Fließtext, sodass ein Titel mit dem Zeilenabstand des Fließtexts (lineHeight: 12pt über einem Raster von 12 pt) den Kasten bei einer ganzen Zahl von Zeilen und seinen Titel auf dem Raster hält, während der Standard von 1,2 em jedem Kasten einen Bruchteil einer Zeile hinzufügt. textTransform: 'uppercase' erhält die Länge. letterSpacing sperrt den Titel (Canvas letterSpacing / PDF Tc); indent rückt ihn von der Innenkante des Kastens nach rechts. Ein Eckabzeichen auf der Seite des Titels (der linken Ecke) reserviert zuerst seinen eigenen Raum – die innere Hälfte des Abzeichens plus gap –, sodass der Titel es auf jeder Seite freihält; indent kommt nur darüber hinaus hinzu. Ein negatives letterSpacing setzt den Titel enger, und der Kasten misst ihn so; ein Titel in einer verbundenen Schrift (Arabisch) bleibt ungesperrt. |
body | { fontFamily, fontSize, lineHeight, color, boldColor, italicColor, fontWeight, boldFontWeight, italic, smallCaps, letterSpacing, textAlign, hyphenation, paragraphSpacing, firstLineIndent, hangingIndent, tabStops, tabInterval } | erbt bodyText; italic / smallCaps false | Typografie der Absätze und Listeneinträge im Kasten. Jedes Feld erbt, wenn nicht gesetzt, den Wert des Fließtexts; italicColor setzt die Farbe kursiven Texts (ein kursives Hervorhebungszitat in der Farbe des Kastens). fontWeight / boldFontWeight setzen die Schriftstärken des normalen und des fetten Texts; italic setzt den Kasten kursiv, wobei Text in *…* aufrecht wird; smallCaps setzt ihn in Kapitälchen; tabStops und tabInterval ersetzen im Kasten die des Fließtexts (siehe Tabulatoren). Was der Text des Kastens sonst noch übernimmt, steht unter Typografie im Kasten. Seit postext 1.42 stellt letterSpacing die Laufweite der Absätze und Listeneinträge des Kastens ein. In em zählt der Schriftgrad des Textes, ein negativer Wert rückt die Buchstaben enger zusammen. Der Wert wird in die Zeilen hineingemessen: Ein Kasten, der um einige Prozent enger läuft, bricht dort um, wo auch die Zeilen des Originals umbrechen. Ein Absatz in einem :::paragraphs-Block behält die Laufweite seines eigenen Stils. Ein Rahmen mit diesem Stil übernimmt sie ebenfalls. Seit postext 1.71 setzt hangingIndent die Absätze des Kastens mit hängendem Einzug (siehe Typografie im Kasten): Eine Länge rückt die Folgezeilen so weit ein wie das hangingIndent eines Absatzformats, und true liest firstLineIndent als Einzug jeder Zeile außer der ersten, wie es bodyText.hangingIndent tut. |
lists | { bulletChar, color, indent, gap, itemSpacing, bulletFontSize, bulletFontWeight, bulletFontFamily, marginTop, marginBottom } | erbt unorderedLists | Typografie der Listen im Kasten (color, indent, gap und itemSpacing gelten auch für nummerierte Listen). bulletFontSize / bulletFontWeight setzen das Aufzählungszeichen in der Schrift des Kastentexts in dieser Größe und Schriftstärke (ein kräftiges, farbiges Aufzählungszeichen). bulletFontFamily setzt die Aufzählungszeichen in einer eigenen Schrift, etwa einer Symbolschrift. Ohne Wert behält eine Liste mit eigener Schrift (unorderedLists. oder das fontFamily einer Ebene) diese auch im Kasten für ihre Aufzählungszeichen. marginTop / marginBottom setzen den Abstand vor und nach den Listen des Kastens, auch nummerierten; ohne Wert gelten die Listenabstände des Dokuments. |
label | { fontFamily, fontSize, fontWeight, color, background, position, height, paddingX, offset, inset, icon, rule, joined, fillet, borderRadius, ownBackground } | nicht gesetzt (kein Etikett) | Ein Etikett an der Oberkante des Kastens, das das Attribut label des Kastens zeigt – die Nummer eines nummerierten Kastens („BOX 1-1“). Es schmiegt sich an die Ecke position ('top-right' / 'top-left', oder 'top-start' / 'top-end' in der Richtung des Kastens selbst, wie 'start' / 'end' beim Streifen), um inset eingerückt, ragt offset über die Oberkante des Kastens hinaus (dieser Raum gehört zum Block, zusätzlich zu marginTop, sodass das Etikett ihn auch am Kopf einer Spalte behält), ist height hoch mit paddingX auf jeder Seite des Texts und kann daneben eine Ressource icon haben ({ resourceId, width, gap }, auf der von der Ecke abgewandten Seite) sowie eine Linie rule ({ enabled, color, width }) entlang der Oberkante von der gegenüberliegenden Ecke bis zu ihm. Standardwerte: Schrift der Überschriften, Größe des Fließtexts, 700, Weiß auf der Hauptfarbe, 1.4em hoch, 0.6em Innenabstand, weder angehoben noch eingerückt, ein Bild 1em breit und 0.3em vom Text entfernt. Das Etikett ist eine eigene Form, die auf der Kontur steht, und behält daher eckige Ecken, gleich welchen borderRadius der Kasten hat; mit joined: true (seit postext 1.48) bilden Etikett und Kasten dagegen einen einzigen Umriss, und fillet rundet die inneren Ecken ab, an denen sie sich treffen. Die Positionen bottom-right, bottom-left, bottom-start und bottom-end (seit postext 1.48) hängen das Etikett an den Fuß des Kastens, seine rule entlang des Fußes. Seit postext 1.48 kann das Symbol auch ein Zeichen einer Schrift sein, icon.kind: 'glyph' (siehe Ein Zeichen auf dem Etikett). Seit postext 1.42 setzt icon.placement: 'inside' das Bild in das Etikett, an dessen Anfang vor den Wörtern (am rechten Ende in einem von rechts nach links gesetzten Kasten), im Abstand gap: Das Etikett ist so breit wie Bild, Abstand, Wörter und Innenabstand, und das Bild, eingepasst in icon.width und die Höhe des Etiketts, ist darin zentriert. Das Bild behält seine Farben; ein weißer Ring auf farbigem Etikett und ein farbiger Ring auf weißem sind also zwei Ressourcen, je eine pro Stil. 'beside', der Standard, setzt das Bild außerhalb des Etiketts neben dessen Rand. Seit postext 1.43 zeichnet icon.tint: true das Bild in der color des Etiketts statt in seinen eigenen Farben: Nur die Form des Bildes wird gezeichnet, in der Farbe der Wörter, sodass ein Ring für jede Farbe eines Buches reicht. Ein Bild ohne Transparenz wird zu einem schlichten Rechteck. Im PDF behält ein SVG seine Kanten, eine Bitmap wird dort beschnitten, wo sie halb durchsichtig ist; die Druckvorlage (svg.pdfFileId) wird nicht verwendet, weil sich eine PDF-Seite nicht umfärben lässt. Seit postext 1.52 kann auch das Symbol des Reiters gezeichnet werden, icon: { kind: 'shape', shape: 'ring' } (oder 'dot'), so groß wie eine Glyphe mit scale der Wortgröße, in seiner color (standardmäßig die der Wörter), neben dem Reiter oder darin; und icon.tint nimmt neben true auch eine eigene Farbe, sodass ein farbiger Ring vor schwarzen Wörtern steht. |
columnGap | Dimension | 1.5em | Abstand zwischen den Spalten einer Gruppe :::columns im Kasten (siehe den Abschnitt zum Container unten). |
marginTop / marginBottom | Dimension | 0.75em / 0.75em | Abstand über dem Kasten (fällt mit dem Außenabstand des vorigen Blocks zusammen) und Mindestabstand darunter (der genaue Abstand mit snapToGrid: false). Ein gleitender Kasten (placement: 'top', 'bottom' oder 'auto') behält den Gleitobjektabstand, eine Zeile Fließtext, zwischen seinem Bereich und dem Text; ein größeres marginBottom setzt den Abstand unter einem Kasten am Kopf der Seite, ein größeres marginTop den Abstand über einem Kasten am Fuß, mit dem Bereich auf das Raster aufgerundet. Bis postext 1.4 ignorierte ein gleitender Kasten seine Außenabstände. |
snapToGrid | boolean | true | Mit true rastet der Fluss nach dem Kasten wieder auf das Grundlinienraster ein, der Abstand darunter ist also marginBottom, auf ganze Rasterzeilen aufgerundet. Mit false behält der Kasten sein genaues marginBottom, das mit dem oberen Außenabstand des nächsten Blocks zusammenfällt – zwei aufeinanderfolgende Kästen eines solchen Stils stehen genau max(marginBottom, marginTop) voneinander entfernt –, und der Text danach kann bis zum nächsten Einrastpunkt (einer Überschrift, dem Ende einer Liste) außerhalb des Rasters stehen, wie nach einer Überschrift mit headings.. Gedacht für Dokumente aus gestapelten Kästen (Arbeitsblätter, Formulare). Es gilt für Kästen im Fluss; Kästen über die ganze Seitenbreite in einem mehrspaltigen Layout sowie gleitende, fixierte und Seitenkästen behalten das Raster, da Spaltenbereiche und die Bereiche der Gleitobjekte darauf aufbauen. Die Hebel des Spaltenausgleichs bleiben unverändert: Ein Kasten, der eine Spalte abschließt, wird weiterhin auf die letzte Rasterzeile der Spalte hinabgeschoben. |
snapTopToGrid | boolean | false | Lässt den Kasten auf einer Rasterlinie beginnen: Der Abstand darüber wird bis zur nächsten aufgerundet, wie auch immer der Block davor endete, und der Kasten wird mit diesem Abstand in die Spalte eingepasst. Standardmäßig aus. Es gilt für Kästen im Fluss; schwebende, feste und seitliche Kästen stehen in Bändern, die schon auf dem Raster liegen. Im Sandbox: Auf einer Rasterlinie beginnen. |
keepTogether | boolean | true | Mit true wird der Kasten zusammengehalten: Ein Kasten, der nicht in den verbleibenden Raum passt, wandert ganz in die nächste Spalte oder auf die nächste Seite. Nur ein Kasten, der höher als eine leere, volle Spalte ist – eine ganze Seite bei einem Kasten mit span: 'page' –, lässt sich nicht zusammenhalten: Er wird stattdessen nach den Regeln für false unten geteilt, statt überzulaufen, beginnend an seiner Stelle, und eine Fortsetzung, die in eine Spalte passt, wandert dann ganz weiter; ein so hoher gleitender Kasten (placement: 'top' | 'bottom' | 'auto') gleitet nicht, sondern bleibt an seiner Stelle im Fluss. Mit false darf jeder Kasten zwischen seinen Kindblöcken oder zwischen den Zeilen eines Absatzes oder Listeneintrags umbrechen: Der tiefste passende Schnitt schließt die aktuelle Spalte ab (oder bei einem Kasten mit span: 'page' die Seite, bündig mit dem Fuß der Spalten), und der Rest geht am Kopf der nächsten in einem eigenen Kasten weiter – gleiche Kontur und gleicher Streifen, kein Symbol und kein Titel, sofern repeatTitle ihn nicht wiederholt –, und wird erneut geteilt, wenn er immer noch zu hoch ist. Der Text jedes Fragments behält die Spalte, die ein Inline-Symbol am Kopf einnimmt, leer, sodass der Kasten auf jeder Seite eine Satzbreite hat. Ein Schnitt in einem Listeneintrag lässt dessen Aufzählungszeichen beim Kopf. Der Rahmenblock jedes Fragments teilt contentIndex / containerId des Kastens und vermerkt callout.part / callout.continued. Verwenden Sie es für einen langen abschließenden Kasten mit „Kernpunkten“ zusammen mit headings. oder für einen Anmerkungsstil, dessen Kästen nie eine Abbildung von der Seite drängen dürfen. Ein verschachtelter Kasten (ein :::callout in einem anderen) ist ein Kindblock seines Elternkastens: Ein Schnitt darf davor oder danach fallen und in ihm nur, wenn sein eigener Stil das Teilen erlaubt (keepTogether: false oder höher als eine volle Spalte), nach seinem eigenen splitMinLines. Seit postext 1.39 folgt der Schnitt den Regeln des Fließtexts, wie bei einem Rahmen einer zusammengesetzten Seite: Eine Überschrift steht nie am Ende eines Fragments (headings.keepWithNext), ein Schnitt zwischen den Punkten einer Liste lässt davor und danach mindestens zwei stehen (bodyText. / avoidWidowsInLists; einen, wenn ausgeschaltet), und eine Liste von höchstens bodyText. Punkten unter shortListSplit: 'avoid' wird nicht zwischen ihren Punkten geschnitten. Erlaubt das kein Schnitt, endet das Fragment vor der Überschrift oder der Liste oder innerhalb eines ihrer Punkte. |
splitMinLines | number | 2 | Mindestzahl an Textzeilen, die ein Fragment eines geteilten Kastens (keepTogether: false oder ein zusammenzuhaltender Kasten, der höher als eine volle Spalte ist) auf beiden Seiten des Schnitts behält. Es schützt nur Text: Eine Seite mit mindestens einer Abbildung, Tabelle, abgesetzten Formel oder einem verschachtelten Kasten ist unabhängig von ihrer Zeilenzahl zulässig, sodass ein Kasten mit Bildern ein einzelnes auf einer Seite lassen darf. Ein Schnitt in einem Absatz oder Listeneintrag zählt weiterhin jede Zeile auf beiden Seiten (eine Abbildung oder Formel dort als eine Zeile) und lässt außerdem mindestens layout. Zeilen dieses Absatzes oder Eintrags auf jeder Seite (standardmäßig zwei, oder splitMinLines, wenn das kleiner ist; 1 erlaubt also eine). Mit den Standardwerten wird ein Eintrag von zwei oder drei Zeilen nie geteilt und einer von vier Zeilen nur zwei zu zwei. Mit dem Standard bricht kein Kasten so um, dass eine einzelne Textzeile am Fuß einer Spalte oder am Kopf der nächsten steht; erfüllt kein Schnitt das Minimum, wandert der Kasten ganz. (Vor postext 1.5 prüfte ein Schnitt in einem Absatz nur die Zeilen der ganzen Seite, sodass ein Eintrag von zwei Zeilen eins zu eins geteilt werden konnte, wenn andere Zeilen des Kastens das Minimum auffüllten.) |
repeatTitle | boolean | false | Den Titel am Kopf jeder Fortsetzung eines geteilten Kastens wiederholen, gefolgt von continuedSuffix („Key points (cont.)“). Die Wiederholung übernimmt den Titelstil. Ein Kasten ohne Titel wiederholt nichts. Siehe Vermerke an einem geteilten Kasten. |
continuedSuffix | string | '(cont.)' | Text nach dem wiederholten Titel, in der Sprache des Dokuments (locale, sonst die Sprache der Silbentrennung), wie bei einer geteilten Tabelle, und mit dem Titel verbunden wie bei einer Tabelle. |
continuesMarkerEnabled | boolean | false | continuesMarker unter die letzte Zeile jedes weitergehenden Teils eines geteilten Kastens setzen, innerhalb des Kastens. |
continuesMarker | string | 'Continued' | Text dieses Vermerks (das „(MORE)“ eines Drehbuchs), in Schrift und Größe des Kastentexts. Der Standardwert steht wie bei einer geteilten Tabelle in der Sprache des Dokuments: 'Wird fortgesetzt' auf Deutsch, 'Continúa' auf Spanisch. |
continuesMarkerAlign | 'left' | 'center' | 'right' | 'right' | Wo der Vermerk in der Innenbreite des Kastens steht. |
continuesMarkerItalic | boolean | true | Den Vermerk kursiv setzen. |
numbering | { label, counter, numberingTemplate, resetOn, counterFormat, placement, bold, italic, suffix } | nicht gesetzt | Die Kästen dieses Stils als nummerierte Aussagen zählen: Sätze, Lemmata, Definitionen. Siehe Nummerierte Aussagen und Beweise. |
endMark | string | '' | Ein Zeichen, rechtsbündig ans Ende der letzten Zeile des Kastens gesetzt, wie ein Beweis mit '∎' oder '□' endet: auf der letzten Zeile, wenn es nach einem Leerzeichen passt, sonst auf einer eigenen Zeile. Ein Kasten, der mit einer abgesetzten Formel ohne Nummer endet, nimmt es als Kennzeichen der Formel. Mit eingeschalteter Mathematik werden die Quadrate (∎ □ ■ ▪ ◻ ▫) aus den eigenen Glyphen von TeX gezeichnet, sodass eine Schrift ohne sie (die latin-Dateien von Fontsource) sie trotzdem ausgibt; mit ausgeschalteter Mathematik werden sie in der Schrift des Kastentexts gesetzt. |
design | { enabled, slot, minHeight, setsContent } | nicht gesetzt | Eine Gestaltung in einem Band unter dem Titel des Kastens, über die ganze Innenbreite: die Elemente einer Überschriftengestaltung (Texte, Bilder, Linien, Rahmen), die auch den Inhalt des Kastens selbst drucken können. Siehe Gestaltung im Kasten. |
#Ecken, Seiten und verbundene Etiketten
Ein Kasten muss kein Rechteck mit vier gleichen Ecken und einer einzigen Kontur sein. Seit postext 1.48 kann ein Stil manche Ecken abrunden und andere nicht, seine Kontur nur an einigen Seiten zeichnen und sein Etikett als eine einzige Form aus dem Kasten wachsen lassen: die Karte eines Schulbuchs, deren Titeletikett und Körper ein einziger Umriss sind, gezeichnet vom Stil statt in ein Bild hinter der Seite gemalt.
calloutStyles: [
// Rounded at the top only, a rule over the box and a heavier foot.
{ id: 'ficha', background: { model: 'hex', hex: '#fff4d6' },
borderRadius: { topLeft: { value: 3, unit: 'mm' }, topRight: { value: 3, unit: 'mm' } },
border: { enabled: false, color: { model: 'hex', hex: '#c58b00' }, width: { value: 0.75, unit: 'pt' },
sides: { top: { enabled: true }, bottom: { enabled: true, width: { value: 2, unit: 'pt' } } } } },
// A card whose tab grows out of its top edge.
{ id: 'tarjeta', background: { model: 'hex', hex: '#ffffff' }, borderRadius: { value: 3, unit: 'mm' },
border: { enabled: true, color: { model: 'hex', hex: '#2a6f97' }, width: { value: 1, unit: 'pt' } },
label: { position: 'top-left', inset: { value: 4, unit: 'mm' }, joined: true, fillet: { value: 2, unit: 'mm' },
color: { model: 'hex', hex: '#2a6f97' } } },
]- Ecken.
borderRadiusist eine Länge für alle vier Ecken oder{ topLeft, topRight, bottomRight, bottomLeft }. Eine Ecke, die im Objekt fehlt, ist eckig. Die Ecken sind die des Blatts. Zwei Ecken nehmen nie mehr als die Seite zwischen ihnen; jede gibt anteilig nach. - Seiten.
border.sides.top,right,bottomundleftnehmenenabled,colorundwidthan, und jedes fehlende Feld kommt von der ganzen Kontur. Ein Kasten mit einer Kontur nur oben istborder: { enabled: false, sides: { top: { enabled: true } } }, oderenabled: truemit den drei anderen Seiten ausgeschaltet. Die Innenkante einer Seite folgt ihrer Breite, sodass eine abgerundete Ecke zwischen einer dünnen und einer dicken Seite so geschwungen ist, wie CSS sie zeichnet. - Verbundenes Etikett. Mit
label.joined: truesind Etikett und Kasten ein Umriss, eine Füllung (derbackgrounddes Kastens; der eigenebackgrounddes Etiketts wird nicht gezeichnet) und eine Kontur, die um das Etikett herumläuft. Das Etikett steht auf der Kante, um seine Höhe außerhalb des Kastens: Seinoffsetmuss0sein (ein anderer Wert wird alsunknownConfigValuegemeldet und als0gelesen). Seine äußeren Ecken übernehmen den Radius der Kastenecke, an die es sich schmiegt, und die inneren Ecken, an denen es auf den Kasten trifft, rundetfilletab (Standard: dieser Radius). Ein Etikett, das bündig mit der Seite des Kastens steht (eininsetunter einem halben Pixel), steigt gerade aus dieser Seite auf. Geben Sie den Wörtern eine Farbe, die auf der Füllung des Kastens lesbar ist (label.color), da das Etikett keine eigene Füllung mehr hat. Mitlabel.ownBackground: truewird ein verbundener Reiter im eigenenbackgrounddes Etiketts gemalt, über der Füllung des Kastens und unter dem Rahmen; so kann ein weißer Reiter auf einem getönten Kasten stehen oder ein farbiger auf einem Kasten ohne Füllung. - Ecken des Reiters.
label.borderRadiusgibt dem Reiter eigene Ecken: eine Länge oder{ topLeft, topRight, bottomRight, bottomLeft }auf den Ecken des Blatts, wie dasborderRadiusdes Kastens. Ein Reiter abseits des Kastens bleibt eckig, solange er keine setzt. Ein verbundener Reiter rundet damit seine beiden äußeren Ecken (topLeftundtopRightoben,bottomLeftundbottomRightunten); ohne Wert übernehmen sie den Radius der Kastenecke. Die Hohlkehlen behalten in beiden Fällenfillet. - Etiketten am Fuß.
position: 'bottom-right','bottom-left','bottom-start'oder'bottom-end'hängt das Etikett an den Fuß des Kastens, einfach oder verbunden: Es ist das umgedrehte obere Etikett,offsetunter dem Fuß, dieruleentlang des Fußes. Seitliche Etiketten gibt es nicht: Die Wörter eines Etiketts laufen quer.
Jedes Ausgabeformat zeichnet diese Formen: Canvas und PDF als Vektorumrisse, der HTML-Betrachter und das EPUB mit festem Layout mit CSS je Ecke und je Seite. Das umfließende EPUB schreibt die Ecken und Seiten in sein CSS und setzt ein verbundenes Etikett als einfaches Etikett. Das look.border.color eines Rahmens färbt jede Seite um, und eine Teilpalette färbt jede einzeln um. Ein Stil, dessen Ecken und Seiten alle gleich sind, wird wie bisher gesetzt.
#Ein Zeichen auf dem Etikett
label.icon kann statt eines Bilds ein Zeichen einer Schrift setzen: kind: 'glyph' mit glyph: '◉'. Das Etikett braucht keine Bildressource, und das Zeichen übernimmt die Farbe der Wörter, sofern es keine eigene angibt, sodass ein Stil für jede Farbe eines Buchs reicht. Seit postext 1.48.
label: {
position: 'top-left', background: { model: 'hex', hex: '#0885bf' }, color: { model: 'hex', hex: '#ffffff' },
icon: { kind: 'glyph', glyph: '◉', placement: 'inside', scale: 1.1 },
}| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
kind | 'resource' | 'glyph' | siehe Beschreibung | 'resource', wenn resourceId gesetzt ist, 'glyph', wenn nur glyph gesetzt ist. Ausdrücklich angegeben hat kind Vorrang: kind: 'glyph' setzt das Zeichen, gleich was resourceId angibt. |
glyph | string | keiner | Das Zeichen, das als Symbol gesetzt wird ('◉', '★', '✎'). |
fontFamily, fontWeight | string, number | die des Etiketts | Schrift und Schriftstärke des Zeichens: die des Etiketts, sonst die Schrift der Überschriften und 700. Fehlt der Schrift das Zeichen, greift der Ersatz wie im Browser; das PDF meldet missingGlyph. |
scale | number | 1 | Die Größe des Zeichens als Faktor der Textgröße des Etiketts. Bei 1 teilt es die Grundlinie der Wörter; bei anderen Größen bleibt es auf dem Etikett zentriert. |
color | ColorValue | die color des Etiketts | Die Farbe des Zeichens. Ohne Angabe folgt es den Wörtern, und das look.label.color eines Rahmens färbt beide um. |
placement, gap | 'beside' | 'inside', Dimension | 'beside', 0.3em | Wie bei einem Bild: 'inside' setzt das Zeichen in das Etikett vor die Wörter, und das Etikett wächst um seine Breite und den Abstand; 'beside' setzt es jenseits des Etikettrands. width und tint eines Bilds gelten nicht. |
Das Zeichen ist Dekoration: ein Layout-Artefakt in einem getaggten PDF, im HTML vor assistiven Technologien verborgen und im umfließenden EPUB aus dem Titel des Kastens weggelassen, sodass das Etikett nur über seine Wörter gelesen wird.
#Stile, die auf einem anderen basieren
extends nennt einen anderen Stil aus calloutStyles, und jedes Feld, das der Stil offenlässt, kommt von diesem. Objekte wie padding, border, titleStyle oder fixed werden Schlüssel für Schlüssel zusammengeführt, sodass ein Stil nur eine Seite des Innenabstands oder nur fixed.offset ändern kann; eine Farbe oder eine Länge wird ganz übernommen; id und name werden nie geerbt. Ein Elternstil kann seinerseits auf einem anderen basieren. Ein Buch mit Kästen an vielen Stellen behält einen Stil für ihr Aussehen und je Stelle einen schlanken Stil:
calloutStyles: [
{
id: 'caja',
background: { model: 'hex', hex: '#dff0fa' },
padding: { top: { value: 3, unit: 'mm' }, right: { value: 4, unit: 'mm' }, bottom: { value: 3, unit: 'mm' }, left: { value: 4, unit: 'mm' } },
},
{ id: 'caja-p5', extends: 'caja', placement: 'fixed', fixed: { offset: { x: { value: 12, unit: 'mm' }, y: { value: -40, unit: 'mm' } } } },
{ id: 'caja-p9', extends: 'caja', placement: 'fixed', fixed: { anchor: { to: 'container', edge: 'top-right' } } },
]Ändern Sie das Aussehen von caja, und alle Kästen folgen, jeder an seinem Platz. Ein extends, das auf keinen vorhandenen Stil verweist, löst calloutStyleExtendsUnknown aus (die Warnung schlägt die nächstliegende ID vor, und der Stil steht für sich, mit den eingebauten Werten), und Stile, die im Kreis aufeinander basieren, lösen calloutStyleExtendsCycle aus (sie stehen für sich, bis einer auf einem Stil außerhalb des Kreises basiert). In der Sandbox legt das Feld Basiert auf eines Kastenstils es fest; wer einen Stil löscht, auf dem andere basieren, schreibt dessen Einstellungen in diese, sodass sich ihre Kästen nicht ändern. Im Abschnitt Rahmenstile behält das Zusammenführen mit Nur das Aussehen vergleichen einen Stil, dessen Kästen woanders stehen, als solchen schlanken Stil, wenn Jeden Kasten an seinem Platz lassen an ist (Standard), und kein Kasten bewegt sich. Seit postext 1.39.
#Der Container :::callout
Eine Zeile :::callout{type="<id>"} öffnet den Kasten, eine bloße Zeile ::: schließt ihn. Die öffnende Zeile nimmt fünf Attribute an – type (die ID des Stils), title (überschreibt den Titel des Stils), span, placement und columns (überschreiben die Werte des Stils) –, und der Inhalt dazwischen wird im Kasten gesetzt: ein optionaler Titel, dann die Absätze, Listen, Zitatblöcke, Formeln oder Ressourceneinbettungen, jeweils mit der Typografie body / lists des Stils (Überschriften behalten ihre üblichen Stile). Außenabstände zwischen Kindblöcken fallen wie im Fließtext zusammen; das Innere verlässt das Grundlinienraster, und der Fluss rastet nach dem Kasten mit mindestens marginBottom darunter wieder darauf ein (das Raster hat Vorrang; der Außenabstand ist ein Mindestwert – dieselbe Konvention, der Ressourcen folgen). Ein Stil mit snapToGrid: false behält stattdessen das genaue marginBottom, und der Text nach dem Kasten bleibt bis zur nächsten Überschrift oder zum nächsten Listenende außerhalb des Rasters. Eine Überschrift unmittelbar vor einem Kasten bleibt bei ihm.
Grenzen in dieser Version:
- Ein Kasten wird zusammengehalten, sofern sein Stil nicht
keepTogether: falsesetzt. Passt er nicht in den verbleibenden Spaltenraum, wandert er ganz in die nächste Spalte oder auf die nächste Seite – auch aus einer leeren Spalte, die Gleitobjekte am Kopf oder Fuß oder eine Höhengrenze des Spaltenbereichs verkürzt haben, solange eine volle Spalte ihn fassen würde. Ein Kasten, der höher als eine volle Spalte ist, wird stattdessen geteilt, wie ein teilbarer; nur einer, den kein Schnitt teilen kann (eine Abbildung oder Tabelle, die höher als die Spalte ist, oder einsplitMinLines, das kein Schnitt erfüllt), wird trotzdem platziert und läuft über; das Layout vermerkt dann eine WarnungcalloutOverflow(VDTDocument.warnings), die die Sandbox auflistet. Eine Gruppe:::columnswird wie der Kasten um sie herum geschnitten, zwischen ihren Unterspalten (seit postext 1.25); sie bleibt nur mitlayout.flowColumns: falseoder in einem verschachtelten Kasten ganz und kann dann ebenso überlaufen. Ein teilbarer Kasten lässt den passenden Teil zurück – ganze Kindblöcke oder die Zeilen eines Absatzes bis hinab zusplitMinLinesauf jeder Seite (eine Abbildung, Tabelle oder abgesetzte Formel allein genügt für eine Seite) – und geht in einem Kasten ohne Symbol in der nächsten Spalte oder auf der nächsten Seite weiter, ohne Titel, sofern der Stil ihn nicht wiederholt, und optional mit einem Vermerk unter dem verlassenen Teil (siehe Vermerke an einem geteilten Kasten). - Gleitobjekte weichen einem unteilbaren Kasten. Ist der Block direkt nach dem Verweis auf eine Abbildung ein Kasten mit
keepTogether, wird ein Platz, der dem Kasten keine Spalte des aktuellen Spaltenbereichs ließe, in der er stehen kann (die verweisende Spalte oder eine leere danach, die ihn vor dem Gleitobjekt aufgenommen hat), nicht genommen: Die Abbildung geht zu ihrem nächsten Platz weiter, meist auf der nächsten Seite, und der Kasten bleibt im Fluss – so, wie ein Setzer ihn setzen würde, statt den Kasten von der Seite zu drängen und die Spalte mit der Abbildung allein zu lassen. span: 'page'in einem mehrspaltigen Layout macht den Kasten zu einem seitenbreiten Block: Er wird auf die volle Inhaltsbreite gesetzt und teilt die Seite in Spaltenbereiche – die Textspalten darüber werden an der Schnittlinie geschlossen, der Kasten nimmt eine eigene Spalte über die volle Breite ein, und darunter öffnet sich ein neuer Spaltenbereich mit Textspalten, sodass der Fluss in jeder Spalte unter dem Kasten weitergeht. Wo die Spalten ausgeglichen sind – am Kopf einer Seite, direkt unter einer Auftaktüberschrift mitspan: 'page', direkt unter einem anderen seitenbreiten Block oder direkt unter einem Gleitobjekt am Seitenkopf –, schneidet der Kasten einfach dort. Kommt er mitten auf der Seite an, bei ungleichen Spalten, wird er so gesetzt, wie es ein Setzer täte: Der Text darüber wird über alle Spalten ausgeglichen geschnitten (die Engine wiederholt die Platzierung mit Spalten des Spaltenbereichs, die auf dieselbe Zahl von Rasterzeilen gekürzt sind, sodass der Text natürlich von Spalte zu Spalte überläuft und jede Regel zu Waisen, Witwen und Zusammenhalt mit dem Folgenden weiterhin gilt), der Kasten überspannt die Seite, und die Spalten gehen darunter weiter. Der Schnitt kostet einige zusätzliche Platzierungsdurchgänge; ließe die Schnittlinie keinen Raum für den Kasten plus das Witwenminimum an Fließtextzeilen darunter, oder passt nach einigen Versuchen keine Anordnung, wandert der Kasten an den Kopf der nächsten Seite. Der Text darüber hält sich an den Schnitt: Ein Absatz, der in den wenigen Zeilen, die eine Spalte unter einer Abbildung darüber freihält, nicht beginnen kann, geht in die nächste Spalte (die Abbildung steht dann allein in ihrer Spalte), und würde ein Block dennoch über den Schnitt hinauslaufen, wird der Schnitt eine Zeile tiefer gesetzt, statt dort, wo dieser Block endet. Ein geteilter Kasten, der den Spaltenbereich eröffnet, wird ebenfalls dort geschnitten, sodass sein Rest nie über den Schnitt hinausläuft. Mitheadings.balancing.beforeSpan(dem Standard) wird der verlassene Spaltenbereich hinter ihm ausgeglichen abgeschnitten – wie der letzte Spaltenbereich eines Kapitels –, und wenn der Stil das Teilen erlaubt (keepTogether: false), schließt der Teil des Kastens, der unter die ausgeglichenen Spalten passt, die Seite ab, und der Rest eröffnet die nächste; mitbeforeSpan: falsewird die verlassene Seite einfach wie üblich ausgeglichen, ohne einen Seitenumbruch zu erzwingen. Eine Überschrift direkt vor einem seitenbreiten Block wandert nicht mit ihm. In einspaltigen Layouts istspan: 'page'einfach ein Kasten im Fluss.placement: 'fixed'nimmt den Kasten aus dem Fluss: Er wird gesetzt (width: 'auto'passt sich eng an den Titel an;'fill'nimmt die Breite der Textspalte unter dem Ankerpunkt) und auf der Seite, auf der er im Fluss vorkommt, an der Position fixiert, diefixed.anchor/fixed.offsetbeschreiben – standardmäßig die linke untere Ecke des Inhaltsbereichs. Die Textspalten, die er überdeckt, geben diese Zone frei (von unten abgeschnitten oder von oben, wenn die Spalte noch leer ist), genau wie bei einem Gleitobjekt am Kopf oder Fuß; enthält die Zone bereits Text, ein Gleitobjekt oder einen seitenbreiten Block, wandert der Kasten auf die nächste Seite. Ein fixierter Kasten, der das Kapitel abschließt (der nächste Block ist ein Kapitelauftakt, ein:::part, ein Kasten, der als Schranke wirkt, oder das Ende des Dokuments), gleicht zuerst die Spalten darüber aus (headings.balancing.trailing), sodass eine kurze Schlussseite ausgeglichen über dem Abzeichen darunter endet. Rahmenblock und Kindblöcke stehen inpage.floatsund werden in jeder Ausgabe außerhalb des Spaltenbeschnitts gezeichnet.placement: 'top' | 'bottom'lässt den Kasten wie eine Ressource gleiten: Er verlässt den Fluss an seiner Stelle und nimmt den ersten freien Bereich nach diesem Punkt – den Fuß der aktuellen Seite ('bottom') oder Kopf / Fuß der nächsten Seite, die der Fluss eröffnet – in Spaltenbreite (span: 'column') oder in voller Inhaltsbreite (span: 'page'); der Text danach füllt die verlassene Seite. Rahmenblock und Kindblöcke kommen inpage.floats, wie bei einem fixierten Kasten. Ein gleitender Kasten, der eine neue Seite anführt, wird vor den Abbildungen gesetzt, die auf diese Seite warten, und eine Abbildung, auf die auf einer früheren Seite verwiesen wurde und die dann darunter passt, nimmt den Rest dieser Seite, auch wenn weniger als drei Textzeilen übrig blieben (eine Galerieseite: Kasten plus Abbildung, kein Text dazwischen). Ein Kasten mitspan: 'side'gleitet nie: Er stapelt sich neben dem Text, gleich welche Platzierung er hat. Mitcolumnsüber 1 (im Stil oder als Attribut des Kastens, seit postext 1.18) nimmt ein Kasten mitspan: 'column'so viele benachbarte Spalten ein: den Kopf einer Folge leerer Spalten, die auf gleicher Höhe beginnen, oder den Fuß der aktuellen Spalte und der leeren danach, wie in:::callout{placement="top" columns="2"}.width: 'auto'passt sich nur eng an den Titel an; Kindblöcke werden ignoriert.- Ein in einem anderen Kasten verschachteltes
:::calloutist ein eigener Kasten: Es wird mit seinem eigenen Stil (Hintergrund, Kontur, Radius, Innenabstand, Streifen, Titel, Symbol, Marke, Etikett, Typografie) auf die volle Innenbreite seines Elternkastens gesetzt und stapelt sich als ein Kindblock darin, wobei seinmarginTop/marginBottommit den Nachbarn zusammenfällt. Seinspanundplacement(aus der öffnenden Zeile oder dem Stil) werden ignoriert – ein verschachtelter Kasten fließt immer in seinem Elternkasten –, ebensofloatBarrierundsnapToGrid. Kästen lassen sich beliebig tief verschachteln und können in einer Gruppe:::columnsstehen (jeder ganz, in einer Spalte). Wird der Elternkasten geteilt, fällt der Schnitt vor oder nach einem verschachtelten Kasten oder in ihn, wenn der verschachtelte Stil das Teilen erlaubt; jedes Fragment zeichnet die Konturen der Kästen neu, die es durchschneidet, und ein verschachtelter Kasten, der aus dem vorigen Fragment fortgesetzt wird, verliert Titel und Symbol, wie eine Fortsetzung auf oberster Ebene. - Eine Gruppe
:::columns{count=N}…:::unter den Kindblöcken setzt diese Kindblöcke im Kasten inNgleich breiten Spalten im AbstandcolumnGap: Die Folge wird an den Block- oder Zeilengrenzen geschnitten, die die Spalten am besten ausgleichen (ein mittendrin geschnittener Absatz oder Listeneintrag geht am Kopf der nächsten Spalte ohne sein Aufzählungszeichen weiter), jede Spalte beginnt am Kopf der Gruppe, und die Gruppe ist so hoch wie ihre höchste Spalte; die Kindblöcke danach kehren zur vollen Breite zurück. Ein Kasten, der sich teilt (keepTogether: falseoder höher als eine Spalte), schneidet auch innerhalb einer Gruppe, zwischen ihren Spalten: Eine fortlaufende Gruppe füllt ihre Spalten der Reihe nach und geht im nächsten Fragment weiter, eine parallele (breaks) geht Strang für Strang weiter (seit postext 1.25; siehe Dokumentformat ›:::columns). Eingapin der öffnenden Zeile ersetztcolumnGapfür diese Gruppe, undrulezieht eine Linie durch jeden Spaltenabstand. Verwenden Sie es für eine zweispaltige Zusammenfassung von Kernpunkten oder für nebeneinandergesetzte Tabellen eines breiten Kastens. - Das sechste Attribut der öffnenden Zeile,
label, erscheint auf dem Etikett des Stils (siehelabeloben) –:::callout{type="box" label="BOX 1-1" title="The octet rule"}; hat der Stil keinlabel, wird das Attribut ignoriert.
Im VDT ist der Kasten ein Rahmenblock mit type: 'callout', dessen Gestaltung (Hintergrund, Streifen, Symbol, Titel) in designOverlay liegt, gefolgt von seinen Kindblöcken in derselben Spalte; der Rahmenblock und jeder Kindblock haben die containerId des Kastens. Ein verschachtelter Kasten ist ein eigener Rahmenblock mit type: 'callout' unter den Kindblöcken, gefolgt von seinen Blöcken; sie behalten die containerId des äußersten Kastens (Platzierung und Ausgleich sehen weiterhin eine Einheit) und fügen calloutPath hinzu, die Container-IDs der umgebenden verschachtelten Kästen, der äußerste zuerst (die eigene ID eines verschachtelten Rahmenblocks ist der letzte Eintrag). Das getaggte PDF gibt jedem verschachtelten Kasten ein Div innerhalb des Div seines Elternkastens. Symbolbilder werden wie Ressourcenbilder aufgelöst: über das Bildregister des Canvas, die HTML-Option resourceImageUrl und den Anbieter resourceBytes des PDF. Das umfließende EPUB schreibt das Symbol als Erstes in seinen Kasten, vor assistiven Technologien verborgen, und lässt es dort fließen, wo die Seite es zeichnet: über einem seitlichen Streifen, in einer eigenen Spalte oder an einer oberen Ecke; ein vertikal gesetztes Buch stellt es entlang seiner Zeilen. Ein in einer Farbe gemaltes Bild (tint, eine #rrggbb-Farbe) kommt als Kopie des SVG in dieser Farbe ins Buch; eine Bitmap behält dort ihre eigenen Farben.
const resolved = resolveCalloutStylesConfig(config.calloutStyles, resolvedBodyText, resolvedHeadings, resolvedUnorderedLists, config.locale);
// => every inherited field filled from the resolved sections; the optional
// locale picks the language of the continuation strings
const minimal = stripCalloutStylesDefaults(config.calloutStyles);
// => undefined for the built-in `note` default; static defaults dropped#Nummerierte Aussagen und Beweise
Ein Stil mit numbering zählt seine Kästen, so wie amsthm in LaTeX Theorem-Umgebungen zählt (seit postext 1.19). Jeder Kasten gibt seine Bezeichnung und Nummer aus – „Theorem 2.“ zu Beginn seines ersten Absatzes –, und der title der öffnenden Zeile folgt der Nummer in Klammern: :::callout{type="theorem" title="Bradley–Terry"} beginnt mit „Theorem 2 (Bradley–Terry).“. Ein Kasten, der mit einem Bezeichner eröffnet wird ({#thm:main}), ist ein Ziel von Querverweisen, die „Theorem 2“ ausgeben (:ref{id="thm:main"}), und \ref{thm:main} oder style=number gibt 2 aus.
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
label | string | — | Das Wort vor der Nummer: 'Theorem', 'Lemma', 'Definición'. |
counter | string | false | die id des Stils | Der Zähler, den die Kästen erhöhen. Stile, die denselben Zähler nennen, teilen ihn, wie es \newtheorem{lemma}[theorem] tut: Theorem 1, Lemma 2, Theorem 3. 'equation' zählt mit den bezeichneten Gleichungen. false gibt die Bezeichnung ohne Nummer aus (das „Proof.“ eines Beweises). |
numberingTemplate / resetOn / counterFormat | string / ResourceCounterReset / ResourceCounterFormat | '{n}' / 'never' / 'decimal' | Wie bei einem Ressourcentyp: '{h1}.{n}' mit resetOn: 'h1' nummeriert Theorem 2.1, 2.2 … nach Kapitel; '{h1}.{h2}.{n}' mit 'h2' nach Abschnitt. Ein von mehreren Stilen geteilter Zähler zählt weiter, was auch immer ihre Vorlagen ausgeben. Ein Platzhalter nimmt nach einem Doppelpunkt einen Stil an, wie bei einem Ressourcentyp: '{h1:A}.{n}' ergibt Theorem A.1 in einem mit Buchstaben gezählten Anhang. |
placement | 'runIn' | 'title' | 'runIn' | 'runIn' eröffnet den ersten Absatz des Kastens mit der Bezeichnung (ein Kasten, der mit einer Liste, einer Formel oder einem anderen Kasten beginnt, erhält dafür einen Absatz); 'title' macht die Bezeichnung zum Titel des Kastens, in dessen titleStyle: „Theorem 2 (Bradley–Terry)“. |
bold / italic | boolean | true / false | Der Schnitt der eingebundenen Bezeichnung und ihres Suffixes, unabhängig vom Text des Kastens: Ein kursiver Text (body.italic) lässt eine aufrechte Bezeichnung aufrecht. Der Titel in Klammern wird aufrecht in der normalen Schriftstärke gesetzt. |
suffix | string | '.' | Nach der eingebundenen Bezeichnung und ihrem Titel gesetzt. |
Ein Beweis ist ein Stil mit einer nicht nummerierten Bezeichnung und einem Schlusszeichen:
calloutStyles: [
{ id: 'theorem', numbering: { label: 'Theorem' }, body: { italic: true } },
{ id: 'lemma', numbering: { label: 'Lemma', counter: 'theorem' }, body: { italic: true } },
{ id: 'definition', numbering: { label: 'Definition' } },
{ id: 'proof', backgroundEnabled: false, endMark: '□',
numbering: { label: 'Proof', counter: false, bold: false, italic: true } },
]In einem Buch, das Kapitel für Kapitel gesetzt wird, zählen die Zähler vom vorigen Kapitel aus weiter (LayoutContinuation.statementCounters, das continuationAfter füllt), und die Gliederung des Buchs gibt dem Anker jedes nummerierten Kastens seine Bezeichnung (OutlineEntry.numberLabel), sodass ein Verweis aus einem anderen Kapitel sie ausgibt.
#Typografie im Kasten
Ein Kasten setzt seinen Inhalt mit seiner eigenen Typografie body und lists; alles andere behält die Stile des Dokuments:
- Absätze übernehmen den
bodydes Kastens: Schrift, Größe, Zeilenabstand, Farbe, Auszeichnungsfarben, Schriftstärken,italic,smallCaps, Ausrichtung, Silbentrennung, Einzug und Absatzabstand. Ein nicht gesetztes Feld erbtbodyText. Eine geerbte Auszeichnungsfarbe behält ihre Bindung an die Palette, sodass sich fetter und kursiver Text sowie Bezeichnungen von:refin einem Kasten mitcolorPaletteändern wie außerhalb. (Bis postext 1.4 blieb Fettes in einem Kasten#295AA3, gleich welche Hauptfarbe galt.) - Aufzählungen übernehmen die
listsdes Kastens (Aufzählungszeichen, Farbe, Glyphengröße, -stärke und -schrift, Einzug, Abstand, Eintragsabstand, Listenabstände) überunorderedLists, und ihr Text ist der Text des Kastens. Einlists.bulletCharoderlists.color, das von dem des Dokuments (unorderedLists) abweicht, ersetzt Aufzählungszeichen oder Farbe jeder Ebene; eines, das ihn wiederholt oder nicht gesetzt ist, lässt jeder Ebene ihren eigenen Wert (unorderedLists.levels), sodass verschachtelte Striche im Kasten erhalten bleiben. - Nummerierte Listen übernehmen
lists.indent,gapunditemSpacingsowielists.color, sobald der Stil es setzt – auch wenn es die Farbe der Aufzählungszeichen des Dokuments ist; ein Stil, der es nicht setzt, behält die Nummern inorderedLists.color. (Bis postext 1.4 erreichte die Farbe die Nummern nur, wenn sie vonunorderedLists.colorabwich, sodass es nichts bewirkte, sie auf genau diese Farbe zu setzen.) Die Nummer selbst – Schrift, Größe und Trennzeichen – stammt aus dem globalenorderedLists, dalistsnur Felder für Aufzählungszeichen hat: Gestalten Sie die Nummern eines Kastens dort. :::paragraphsim Kasten verwenden ihr Absatzformat, auch in verschachtelten Kästen. Die Felder, die das Format nicht setzt, erben denbodyTextdes Dokuments, nicht denbodydes Kastens (auch nicht dessen Kursive oder Kapitälchen).- Gruppen
:::columnshaben keinen eigenen Stil: Jede Spalte teilt die Text- und Listentypografie des Kastens, undcolumnGapsetzt den Abstand zwischen ihnen. - Zitatblöcke übernehmen Schrift, Größe und Schriftstärken des Kastentexts (kursiv und grau, wie im Fließtext) sowie seine Kapitälchen. Überschriften behalten die Überschriftenstile, abgesetzte Formeln die Mathematik-Einstellungen.
- Abbildungen und Tabellen behalten die Legenden- und Tabellenstile des Dokuments, in der Innenbreite des Kastens; ihre normalen und fetten Schriftstärken folgen denen des
bodydes Kastens. - Chips behalten ihren Chip-Stil; eine Größe in
emwird an der Schriftgröße des Kastentexts gemessen. :::spacewird in Zeilen des Kastentexts gemessen (siehe:::spacedazu, wo es entfällt).- Ein verschachtelter Kasten übernimmt seinen eigenen Stil vollständig; sein
span,placement,floatBarrierundsnapToGridwerden ignoriert.
Hängende Anmerkungen. Anmerkungen unter einer Tabelle, eine nummerierte Legende oder ein Quellenverzeichnis stellen ihr Zeichen vor den Text: das Zeichen an die Innenkante des Kastens, den Text und alle Folgezeilen etwas weiter eingerückt. body.hangingIndent (seit postext 1.71) setzt so jeden Absatz eines Kastens oder eines Rahmens mit diesem Stil:
- Eine Länge setzt jede Zeile außer der ersten in diesem Abstand zur Innenkante des Kastens, wie das
hangingIndenteines Absatzformats (siehe Absatzformate). Die erste Zeile beginnt an der Kante oder beibody.firstLineIndent, wenn der Stil diesen Wert selbst setzt; ein vonbodyTextgeerbter Erstzeileneinzug entfällt. trueliestbody.firstLineIndentals Einzug jeder Zeile außer der ersten, wiebodyText.hangingIndentim Fließtext;falsesetzt den Kasten ohne hängenden Einzug in einem Buch, dessen Fließtext hängend eingezogen ist. Ohne Wert übernimmt der KastenbodyText.hangingIndent.
Ein Tabulator an derselben Position führt den Text nach dem Zeichen an die Kante der Folgezeilen, wie breit das Zeichen auch ist:
calloutStyles: [{
id: 'notes',
padding: { top: { value: 0, unit: 'mm' }, right: { value: 0, unit: 'mm' }, bottom: { value: 0, unit: 'mm' }, left: { value: 0, unit: 'mm' } },
body: {
fontSize: { value: 7, unit: 'pt' },
hangingIndent: { value: 4.5, unit: 'mm' },
tabStops: [{ position: { value: 4.5, unit: 'mm' } }],
},
}],:::callout{type="notes"}
\* Die Preise enthalten die Lieferung innerhalb der Stadt.
\*\* Mitglieder zahlen die Hälfte; der Nachlass ist nicht mit anderen Angeboten kombinierbar und gilt bis zum Ende der Saison.
:::Jede Anmerkung ist ein eigener Absatz; zwischen Zeichen und Text steht ein Tabulatorzeichen oder :tab. Das Sternchen ist maskiert, weil * mit einem Tabulator am Zeilenanfang einen Listeneintrag eröffnet. Die Zeilen werden so gemessen, daher setzen Canvas, PDF, Display-Liste und EPUB (mit padding-inline-start und negativem text-indent) sie gleich, und ein Word-Export schreibt denselben hängenden Einzug. Listeneinträge behalten ihren eigenen Einzug (lists.indent, lists.gap), ein Absatz in einem :::paragraphs-Block den seines Stils. Ein negativer firstLineIndent zählt weiterhin als 0: Die erste Zeile kann nicht im Innenabstand des Kastens beginnen. Ein Zitatblock im Kasten hängt mit dem Kasten, wenn hangingIndent true ist; bei einer Länge hängen nur die eigenen Absätze des Kastens.
#Vermerke an einem geteilten Kasten
Teilt sich ein Kasten über Spalten oder Seiten (keepTogether: false oder ein Kasten, der höher als eine Spalte ist), beginnt jeder Teil nach dem ersten ohne Titel und Symbol, und standardmäßig sagt nichts dem Leser, dass der Kasten weitergeht. Zwei Optionen fügen die Vermerke hinzu, die ein Buch oder ein Drehbuch verwendet:
repeatTitle: truewiederholt den Titel am Kopf jeder Fortsetzung, gefolgt voncontinuedSuffix– standardmäßig „Key points (cont.)“. Die Wiederholung übernimmt den Titelstil, sodass sie mittextTransform: 'uppercase'das „HAMLET (CONT'D)“ eines Drehbuchs ergibt. Symbol und Etikett bleiben am ersten Teil.continuesMarkerEnabled: truesetztcontinuesMarker– „Continued“ oder „Continúa“ in einem spanischen Dokument – unter die letzte Zeile jedes weitergehenden Teils, innerhalb des Kastens, in Schrift und Größe des Kastentexts: kursiv, soferncontinuesMarkerItalicnichtfalseist, rechtsbündig, soferncontinuesMarkerAlignnicht'left'oder'center'angibt. Der Vermerk nimmt Raum in dem Teil ein, den er abschließt, und der Schnitt wird so gewählt, dass er passt.
calloutStyles: [{
id: 'speech',
keepTogether: false,
titleStyle: { textTransform: 'uppercase' },
repeatTitle: true,
continuedSuffix: "(CONT'D)",
continuesMarkerEnabled: true,
continuesMarker: '(MORE)',
continuesMarkerAlign: 'center',
continuesMarkerItalic: false,
}],:::callout{type="speech" title="Hamlet"}
A speech long enough to run over the foot of the page…
:::Der Teil, der die Seite abschließt, endet mit „(MORE)“, und die nächste Seite beginnt mit „HAMLET (CONT'D)“. Beide gehören nicht zum Text, sondern zur Seitengestaltung: In einem barrierefreien PDF sind es Artefakte, und im HTML sind sie vor assistiven Technologien verborgen, sodass der Titel nur einmal vorgelesen wird. Im VDT sind es Textblöcke in designOverlay mit dem Flag artifact: true.
#Gestaltung im Kasten
design setzt die Elemente einer Überschriftengestaltung (Texte, Bilder, Linien, Rahmen; siehe Seitenbreite und erweiterte Gestaltung) in ein Band unter dem Titel des Kastens, über seine ganze Innenbreite. Der Inhalt des Kastens folgt dem Band, mit dem Abstand des Titels dazwischen. Ein Kasten, der sich über Spalten oder Seiten teilt, zeichnet das Band nur auf seinem ersten Teil. Seit postext 1.45.
| Feld | Typ | Standard | Beschreibung |
|---|---|---|---|
enabled | boolean | true | Eine Gestaltung gilt, sobald sie gesetzt ist; false behält sie im Stil, ohne das Band zu zeichnen. |
slot | DesignSlot | — | Die Elemente, am Band ausgerichtet: anchor.to: 'container' ist das Band, von unter dem Titel über die ganze Innenbreite. Die Anker 'page' und 'bleed' werden in einem Kasten nicht gelesen. |
minHeight | Dimension | nicht gesetzt | Die Mindesthöhe des Bands. Ohne sie ist das Band so hoch, wie seine Elemente reichen; Elemente mit reserve: false und solche, die an der Mitte oder am Fuß des Bands verankert sind, zählen nicht. |
setsContent | boolean | false | Die Gestaltung druckt den Inhalt des Kastens ({boxText}), und der Kasten setzt ihn unter dem Band nicht noch einmal. Ein Kasten, dessen Gestaltung seinen Inhalt druckt, teilt sich nie: Er geht ganz in die nächste Spalte oder auf die nächste Seite. |
Die Texte der Gestaltung lesen diese Platzhalter:
{titleText}: der Titel, den der Kasten druckt, also dastitleder Einfassung oder sonst das des Stils.{boxText}: der Inhalt des Kastens als reiner Text, ein Absatz oder Listenpunkt pro Zeile. Leere werden ausgelassen.{boxText.<n>}: dern-te Absatz oder Listenpunkt, ab 1 gezählt; leer, wenn der Kasten weniger hat.{attr.<key>}: ein Attribut, das auf der Einfassung steht. Jeder Name ist möglich, neben denen, die die Einfassung selbst liest::::callout{type="card" kicker="Hinweis"}gibt{attr.kicker}den WertHinweis. Ein fehlendes Attribut druckt nichts.- die Platzhalter des Dokuments
{title},{subtitle},{author}und{publishDate}.
Das resourceId eines Bilds nimmt dieselben Platzhalter an, sodass jeder Kasten eine eigene Ressource zeichnen kann. Nur eine Kastengestaltung liest {boxText}; eine Überschriftengestaltung druckt dafür nichts.
Mit setsContent: true dient ein einziger Stil allen Kästen derselben Form, jedem mit seinen eigenen Wörtern. In einem Schreibheft ist jede Übungszeile ein Kasten, dessen Inhalt das abzuschreibende Wort ist: Die Gestaltung druckt das Wort in einer Schulschrift und setzt es danach in Punkten zum Nachspuren (dotted), so oft die Zeile es fasst (repeat; siehe Inline-Auszeichnungen und Konturen).
calloutStyles: [{
id: 'practice',
backgroundEnabled: false,
border: { enabled: true, color: { hex: '#9aa6b2', model: 'hex' }, width: { value: 0.5, unit: 'pt' } },
design: {
setsContent: true,
minHeight: { value: 16, unit: 'mm' },
slot: { elements: [
{ kind: 'text', id: 'model', content: '{boxText}', fontFamily: 'Playwrite DE Grundschrift', fontSize: { value: 26, unit: 'pt' },
placement: { anchor: { to: 'container', edge: 'top-left' } } },
{ kind: 'text', id: 'copies', content: '{boxText}', fontFamily: 'Playwrite DE Grundschrift', fontWeight: 100, fontSize: { value: 26, unit: 'pt' },
dotted: {}, repeat: { gap: { value: 8, unit: 'mm' } },
placement: { anchor: { to: '#model', edge: 'right-of' }, offset: { x: { value: 8, unit: 'mm' } } } },
] },
},
}],:::callout{type="practice"}
Haus
:::
:::callout{type="practice"}
Mond
:::Die erste Zeile druckt Haus und danach eine Reihe gepunkteter Kopien von Haus, die zweite ebenso mit Mond, und keines der beiden Wörter wird unter seinem Band noch einmal gesetzt. Wer das Wort im Markdown ändert, ändert die Vorlage und jede Kopie. Bleibt setsContent auf false, liest die Gestaltung {boxText} ebenso, und der Inhalt wird unter dem Band gesetzt.
Im VDT sind die Elemente des Bands Gestaltungsblöcke im designOverlay des Rahmens, neben dem Titel.