Konfiguration: zusammengesetzte Seiten

#Seitenvorlagen

Eine zusammengesetzte Seite ist eine Seite, deren Form aus einer Seitenvorlage der Konfiguration stammt und deren Inhalt aus dem Markdown eines Blocks ::::page{template="…"}. Die Vorlage benennt Rechtecke, die Rahmen heißen; das Markdown schickt jedes Inhaltsstück über seinen Namen (seinen Slot) an einen Rahmen. Geometrie steht nie im Markdown, und Inhaltstext steht nie in der Vorlage. Die Eigenschaft pageTemplates enthält die Vorlagen des Buchs:

const config: PostextConfig = {
  calloutStyles: [{ id: 'caja-azul' }, { id: 'tab-titulo' }],
  pageTemplates: [
    {
      id: 'tema-cajas',
      decoration: {
        elements: [
          { kind: 'image', id: 'fondo', resourceId: '{attr.fondo}', decorative: true,
            placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { width: 'fill', height: 'fill' } } },
        ],
      },
      frames: [
        { name: 'titulo', takes: 'h1', style: 'tab-titulo' },
        { name: 'texto', flow: true },
        { name: 'dinero', style: 'caja-azul', padding: { right: { value: 62, unit: 'mm' } } },
        { name: 'dinero-fotos', layer: 2, width: { value: 60, unit: 'mm' },
          placement: { anchor: { to: '#dinero', edge: 'top-right' } } },
      ],
      groups: [
        { name: 'pagina', kind: 'stack', gap: { value: 6, unit: 'mm' }, frames: ['titulo', 'texto', 'dinero'] },
      ],
    },
  ],
};

Eine Vorlage, die nur ihre id und einen Rahmen festlegt, ist eine ganze Seite, deren Satzspiegel dieser Rahmen füllt. Alle anderen Felder sind optional:

#Rahmen

Ein Rahmen ist ein benanntes Rechteck, das gesetzten Inhalt aufnimmt. Sein name ist der Slot, den das Markdown anfordert, und er ist in seiner Vorlage eindeutig (auch eine Gruppe kann nicht den Namen eines Rahmens tragen, da Anker beide auf dieselbe Weise benennen).

Ein Rahmen wird über seine Zelle grid platziert, wenn die Vorlage ein Raster hat, sonst über sein placement, das wie das eines Gestaltungselements funktioniert: ein Anker ('container' ist der Bereich, 'page', 'bleed' oder '#name' für einen anderen Rahmen oder eine Gruppe), eine Kante, ein Versatz und eine Größe. Ein Rahmen, der an einem anderen verankert ist, bewegt sich mit ihm. Ohne beides nimmt der Rahmen den ganzen Bereich ein.

#Gruppen

Eine Gruppe ist ein Stapel (von oben nach unten) oder eine Reihe (vom Anfang zum Ende) von Rahmen, die sich Platz teilen und sich gemeinsam bewegen. Innerhalb einer Gruppe wird die eigene Position der Rahmen in Richtung der Gruppe ignoriert: Die Gruppe ordnet sie der Reihe nach an, mit gap dazwischen. Wenn der Text eines Rahmens wächst, rücken die Rahmen danach weiter. Eine Gruppe ist ein Kasten, an dem Rahmen und Dekoration verankert werden können ('#pagina').

#Vererbung und Varianten

Eine Vorlage mit extends geht von der Vorlage aus, die sie nennt (und die selbst eine andere erweitern kann), und ändert nur, was sie schreibt:

• Ein Feld wie area, header oder overflowTemplate ersetzt das der Elternvorlage. grid wird Schlüssel für Schlüssel zusammengeführt. Auch spread, gutter und role werden geerbt; id, name und extends gehören der Vorlage selbst.
• frames und groups werden nach Namen zusammengeführt: Ein Eintrag mit dem Namen eines geerbten ändert die Felder, die er schreibt, und behält die übrigen (fit, overflow und padding werden Schlüssel für Schlüssel zusammengeführt; placement wird als Ganzes ersetzt); remove: true entfernt ihn; ein neuer Name wird nach den geerbten angefügt.
• Dekorationselemente werden auf dieselbe Weise nach id zusammengeführt; ein Element mit neuer ID oder ohne ID wird angefügt.

variants.recto und variants.verso werden wie eine Vorlage geschrieben und auf dieselbe Weise zusammengeführt, auf einer rechten oder einer linken Seite. Sie gelten nach der ganzen extends-Kette, die Variante der Wurzel zuerst. Eine Doppelseite hat beide Seiten, daher gilt für sie keine Variante.

pageTemplates: [
  { id: 'tema', frames: [{ name: 'texto', flow: true }, { name: 'margen', width: { value: 30, unit: 'mm' },
      placement: { anchor: { to: 'container', edge: 'top-left' } } }],
    variants: { recto: { frames: [{ name: 'margen', placement: { anchor: { to: 'container', edge: 'top-right' } } }] } } },
  { id: 'tema-sin-margen', extends: 'tema', frames: [{ name: 'margen', remove: true }] },
]

Ein Wert, der einem Standardwert gleicht, wird beim Speichern einer Vorlage in der Sandbox nie verworfen: In einer Vorlage, die eine andere erweitert, oder in einer Variante überschreibt er den Wert der Elternvorlage.

Im Code liefert resolvePageTemplate(config, id, { parity }) eine Vorlage mit zusammengeführter Kette, angewandter Variante der jeweiligen Seite, allen eingesetzten Standardwerten und jedem Verweis so aufgelöst, wie es die Warnungen unten beschreiben; validatePageTemplates(config) liefert die Warnungen.

#Beschriftungsstile

Die Eigenschaft labelStyles benennt das Aussehen der Beschriftungen auf einem Bild: die Meere und Städte einer Karte, die Teile eines Schemas. Eine Beschriftung steht an einem Anker des Bilds (einem Punkt, der mit der Ressource gespeichert ist, wie die Sprecher in Comics) und übernimmt den Stil, den der Anker oder die Beschriftung nennt.

labelStyles: [
  { id: 'mar', fontStyle: 'italic', textTransform: 'uppercase', letterSpacing: 0.12,
    color: { hex: '#2b6ca3', model: 'hex' } },
  { id: 'ciudad', fontWeight: 600, halo: { color: { hex: '#ffffff', model: 'hex' }, width: { value: 0.6, unit: 'pt' } } },
]

#Beschriftungsfelder eines Ankers

Die Anker eines Bilds (Resource.anchors, die Punkte, die Comics für Sprecher verwenden) nehmen einige optionale Felder für Beschriftungen auf. Es sind Bruchteile des Bilds, daher gelten sie in jeder Sprache und bei jedem Zuschnitt des Bilds. Comics ignorieren sie.

#Warnungen zu Seitenvorlagen

Anderswo ignoriert die Engine einen Schlüssel, den sie nicht kennt. Seitenvorlagen und Beschriftungsstile werden dagegen geprüft, und jedes Problem ist eine Konfigurationswarnung in postext check und im Bedienfeld Prüfungen der Sandbox. Der path dieser Warnungen ist ein JSON-Pointer auf das fehlerhafte Feld: /pageTemplates/3/frames/2/style, /pageTemplates/0/variants/recto/frames/1/next, /resources/4/anchors/0/style. Wurde das Feld geerbt, nennt der Pointer die Vorlage, die es geschrieben hat. Eine Warnung, die eine nicht vorhandene ID oder einen nicht vorhandenen Namen nennt, schlägt außerdem den nächstliegenden vorhandenen vor.

Ein falsch geschriebener Schlüssel einer Vorlage, eines Rahmens, einer Gruppe, eines Rasters, von fit, von overflow, einer Variante oder eines Beschriftungsstils ist ein unknownConfigKey; ein Wort außerhalb der Auswahl einer Einstellung (area, verticalAlign, exclude, takes, kind, align, writingMode, direction, fontStyle, textTransform) ist ein unknownConfigValue, und die Einstellung behält ihren Standardwert. Eine Vorlage ohne id oder ein Rahmen oder eine Gruppe ohne name wird mit einem unknownConfigValue an diesem Feld ignoriert.

Die Konfigurationsversion ist seit den Seitenvorlagen 15 (vorher geschriebene Bundles laden weiterhin unverändert: Nichts, was eine ältere Konfiguration sagt, ändert seine Bedeutung).