Saltar al contingut principal
Recepta número 21

Receptari · Capítol 6 · Requadres i notes

Requadres que es parteixen, floten i es fixen

Un full de pràctiques en què el procediment es parteix entre dues columnes, el full de dades encapçala la pàgina següent i una insígnia va fixa al peu.

pp. 42–43 · 2–3 de 4

  • Mostra en castellà: encara no hi ha edició en català
  • Format 195 × 255 mm
  • 2 columnes, espai entre columnes de 7 mm
  • Host Grotesk 9,4/13,6
  • Commit Mono
  • 4 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 101 ms
  • 222 línies de codi

En poques paraules

Una fitxa escolar de ciències per construir un rellotge de sol. Mostra requadres que es parteixen entre dues columnes, passen a la pàgina següent o es queden fixos al peu.

Què compondràs

Quatre pàgines de Taller de ciències, un quadern de pràctiques escolar: la Pràctica 4, «Construeix un rellotge de sol». A la pàgina 42, l'avís de seguretat queda sencer, i el procediment de catorze passos, amb fons groc i un compàs a la cantonada, comença al peu de la columna esquerra i continua al cap de la dreta, a la mateixa mesura i sense títol. El full de dades de Madrid surt del flux en aquesta pàgina i encapçala la 43, sobre el text. Al peu de l'última pàgina va fixa una insígnia antracita, «Autoavaluació · 10 min», amb una mà que l'assenyala des del marge. A l'obertura, la banda groc sol porta les ombres d'una vareta entre el migdia i les cinc de la tarda, calculades per a la latitud de Madrid, i un tauler a tota l'amplada reparteix els materials en tres columnes.

Aquesta recepta respon a

  • Com deixo que un requadre llarg es parteixi entre columnes i pàgines, o en mantinc un de curt sencer?
  • Com porto un requadre al capdamunt o al peu de la pàgina sense que el text deixi d'omplir-la?
  • Com fixo una insígnia o un adhesiu en una posició concreta de la pàgina?
  • Com poso un requadre que travessi les dues columnes a mitja pàgina, com un tauler de xifres en tres blocs?

La resposta curta

script.js · línies 54–84al codi complet
const HAND = 6, GAP = 2, RULE = 0.75 * PT; // mm: the badge's hand, its gap, the hand's rule
const calloutStyles = [
  // Kept whole: keepTogether defaults to true, so a box that does not fit the rest of a
  // column moves on in one piece; only a box taller than a whole column splits anyway.
  box('seguridad', bar('charcoal', 'aviso')),
  // Split: the procedure fits a column, so it takes keepTogether: false to break where it
  // falls instead of moving on whole: between steps, or inside one (splitMinLines, default
  // 2, keeps at least two lines of the step on each side of the cut). The rest goes on in
  // the next column or page without the title or the icon; a corner icon takes no room
  // from the text, where an inline one would keep its column in both parts.
  box('pasos', { keepTogether: false, background: col('light'),
    icon: icon('compas', 7, { position: 'corner', cornerSide: 'outer' }) }),
  // Floated: its fence adds placement="top", so the box leaves the flow where the fence
  // stands and heads the next page, while the text after it fills this one.
  box('datos', { span: 'page', background: col('tint') }),
  // Pinned: 'fixed' sets the box on the page where its fence falls, at the bottom-left corner
  // of the text block unless fixed.anchor says otherwise, and the column text keeps out of it.
  // width: 'auto' shrink-wraps the title, so an empty fence prints a badge.
  box('autoevaluacion', { placement: 'fixed', width: 'auto',
    // Hang the hand and its rule in the margin (the outer one on this verso), so the badge
    // itself lines up with the text: [hand][rule][GAP][badge].
    fixed: { offset: { x: mm(-(HAND + RULE + GAP)) } },
    marker: { ...icon('mano', HAND), gap: mm(GAP),
      rule: { enabled: true, color: col('charcoal'), width: mm(RULE) } },
    background: col('charcoal'), borderRadius: mm(3.2),
    padding: { top: mm(1.6), right: mm(3.4), bottom: mm(1.6), left: mm(3.4) },
    titleStyle: { ...TITLE, color: col('paper') } }),
  // Across the page, in the flow: the text above it is cut level and resumes under it.
  box('resumen', { span: 'page', backgroundEnabled: false,
    stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('charcoal') } }),
];

Ingredients

Tipografia
Host Grotesk, Commit Mono (SIL OFL 1.1)
Recursos
  • The shadow chart, the dial in profile and the icons, drawn in code in the page's palette (Ignacio Ferro, CC BY 4.0)

Elaboració

#1 · Una base comuna per a tots els requadres

script.js · línies 38–50al codi complet
const TITLE = { fontFamily: LABEL, fontSize: pt(8), color: col('charcoal'),
  textTransform: 'uppercase', letterSpacing: pt(1.2) }; // bold by default
const BOX_TYPE = { fontSize: pt(8.8), lineHeight: pt(12.4) }; // colours inherit bodyText
const box = (id, device) => ({ id, // margins: the defaults, snapped to whole grid lines
  padding: { top: mm(3), right: mm(3.6), bottom: mm(3.4), left: mm(3.6) },
  titleStyle: { ...TITLE, gap: mm(2) }, body: BOX_TYPE,
  lists: { gap: mm(2), itemSpacing: pt(3) }, ...device });
const icon = (id, size, extra) => ({ kind: 'resource', resourceId: id, size: mm(size),
  ...extra });
// A side bar with its icon centred on it, 1.4 mm narrower than the bar.
const bar = (hue, id, width = 5.6) => ({ backgroundEnabled: false,
  stripe: { enabled: true, side: 'left', width: mm(width), color: col(hue) },
  icon: icon(id, width - 1.4) });

Tots els estils parteixen de box(): el títol en monoespaiada, un cos de 8,8 pt (el text va a 9,4) i el farciment interior. Després, cadascun hi afegeix un sol tret propi: l'avís, una franja antracita; el procediment, un fons groc; el full de dades, un fons crema; el resum, un filet superior, i la insígnia, una píndola antracita. Així, l'alumne distingeix cada requadre abans de llegir-ne el títol. Al procediment, el fons marca a més la continuació: la part que segueix al cap de la columna dreta no porta títol, i només el groc la uneix als passos 1 a 4, al peu de l'esquerra.

#2 · Sencer, partit, flotant i fix

El codi és la resposta curta de més amunt. El procediment fa 192 mm i en una columna n'hi caben 211, així que, si es mantingués sencer, saltaria al cap de la columna dreta i deixaria 43 mm buits al peu de l'esquerra. Amb keepTogether: false comença on cau i continua a la columna següent, o a la pàgina següent, com mostra la segona variant (el contenidor :::callout). La continuació perd el títol i la icona. Una icona en línia prendria als passos una columna pròpia a totes dues parts; per això el compàs va a la cantonada exterior del requadre, on no resta amplada. La línia d'obertura del full de dades porta placement="top", així que el requadre surt del flux a la pàgina 42 i encapçala la següent. La insígnia és fixed, i un offset.x negatiu porta la mà i el seu filet al marge exterior perquè la vora de la insígnia quedi alineada amb el text.

#3 · Creua la pàgina amb un tauler de tres columnes

script.js · línies 88–93al codi complet
const materials = box('material', { span: 'page', background: col('sun'),
  marginBottom: pt(LEAD), // one more grid line of air before the text resumes
  padding: { top: mm(3.6), right: mm(4.4), bottom: mm(3.8), left: mm(4.4) },
  columnGap: mm(GUTTER), // the page's gutter: the panel's columns sit as far apart as the text's
  body: { ...BOX_TYPE, paragraphSpacing: false },
  lists: { color: col('ink'), gap: mm(1.8), itemSpacing: pt(1) } });

Amb span: 'page', el requadre de materials ocupa les dues columnes. La introducció queda tallada a la mateixa altura per sobre i el text continua a dues columnes per sota (pàgina 41). Dins del requadre, :::columns{count=3 breaks="5,9"} fixa on comença cada columna en lloc d'equilibrar-les: breaks compta blocs fills, i cada element de llista n'és un, així que la segona i la tercera columna comencen al cinquè i al novè, les etiquetes en negreta. columnGap fa servir l'espai entre columnes de 7 mm de la pàgina, i les columnes del tauler queden tan separades com les del text.

:::callout{type="material" title="Necessitaràs"}
:::columns{count=3 breaks="5,9"}
**Per a l'esfera**
 
- Cartró ploma de 20 × 30 cm
- La plantilla de l'esfera
- Cola i retolador
 
**Per al gnòmon i la base**
…
:::
:::

#4 · Un groc per als camps, un altre de més clar per al requadre llarg

script.js · línies 15–28al codi complet
const palette = {
  ink: '#1b2430', // text
  charcoal: '#2b2d42', // the safety bar, the summary's rule, the table head, the badge, titles
  sun: '#f2b705', // the opener band and the materials panel: fields, never type
  light: '#fad65a', // the procedure
  tint: '#fff6d6', // the data sheet
  rule: '#d7dde3', // hairlines
  muted: '#5d6b78', // running heads, notes
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at charcoal, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.charcoal })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

El groc sol es reserva per als fons grans, la banda i el tauler; sobre ell, l'antracita i la tinta donen un contrast de 7,4:1 i 8,6:1. Com a color de lletra sobre blanc es quedaria en 1,8:1, així que no es fa servir mai per a text. El procediment porta light, un groc més clar: sobre ell la tinta arriba a 11:1, i el tall es continua veient a la miniatura de la galeria. El full de dades porta tint, un crema gairebé blanc, perquè no es confongui amb el procediment, l'altre requadre amb fons de la doble pàgina. main-color apunta a l'antracita, de manera que els valors per defecte que la configuració no canvia surten en antracita i no en el blau del motor.

#5 · Obre la pràctica amb una banda groga

script.js · línies 97–119al codi complet
const BAND = 100; // mm from the trim to the foot of the band
const ART_W = 80; // mm: the width of the band's drawing, at the fore-edge
const AIR = 8; // mm between the band and the first line of text
const [TITLE_W, LEAD_W] = [104, 88]; // mm: the title's and the lead's measure
const onBand = { color: col('charcoal'), align: 'left' }; // a long title or lead wraps
const below = (id, y, width) => ({ anchor: { to: `#${id}`, edge: 'below' },
  offset: { y: mm(y) }, size: { width: mm(width) } });
const opener = { enabled: true, minHeight: mm(BAND - TOP + AIR), slot: { elements: [
  { kind: 'box', id: 'band', style: { backgroundColor: col('sun') },
    placement: { anchor: { to: 'page', edge: 'top-left' }, size: { height: mm(BAND) } } },
  { kind: 'image', id: 'art', resourceId: 'sombras', placement: { anchor: { to: 'page',
    edge: 'top-right' }, size: { width: mm(ART_W), height: mm(BAND) } } },
  { kind: 'text', id: 'kicker', content: '{attr.kicker}', ...onBand, fontFamily: LABEL,
    fontSize: pt(8.5), fontWeight: 700, letterSpacing: pt(1.7), textTransform: 'uppercase',
    placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(4) } } },
  { kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: TEXT,
    fontSize: pt(44), fontWeight: 800, lineHeight: 0.98, placement: below('kicker', 3, TITLE_W) },
  { kind: 'text', id: 'lead', content: '{attr.lead}', ...onBand, fontFamily: TEXT,
    fontSize: pt(10.5), lineHeight: 1.4, placement: below('title', 5, LEAD_W) },
  { kind: 'text', id: 'meta', content: '{attr.meta}', ...onBand, fontFamily: LABEL,
    fontSize: pt(7.4), fontWeight: 700, letterSpacing: pt(1.1), textTransform: 'uppercase',
    placement: below('lead', 4, LEAD_W) },
] } };

La banda és un element de caixa ancorat a la pàgina; el dibuix, un element d'imatge al costat del tall davanter. L'avanttítol, l'entradeta i la línia de sessions surten d'atributs de la línia del títol. Com que la banda està ancorada a la pàgina, l'obertura ja reserva alçada fins al seu peu, i el text començaria 3,6 mm per sota. minHeight: BAND - TOP + AIR demana 8 mm; la reserva s'ajusta a la línia següent de la retícula de base i el text comença 8,4 mm sota la banda.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 021 · Boxes that split, float and pin ══════════════════
// https://postext.dev/en/cookbook/boxes-split-float-pin
// Code: MIT · Text: original (CC BY 4.0) · Drawings: generated in code (CC BY 4.0)
// Fonts: Host Grotesk, Commit Mono (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// Four pages of a school lab workbook in Spanish, and five ways a box can sit on them.
import {
  buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document (this recipe is Spanish only)
const RECIPE = 'boxes-split-float-pin';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: one yellow for fields, paler ones for two boxes, near-blacks for type and bars
const palette = {
  ink: '#1b2430', // text
  charcoal: '#2b2d42', // the safety bar, the summary's rule, the table head, the badge, titles
  sun: '#f2b705', // the opener band and the materials panel: fields, never type
  light: '#fad65a', // the procedure
  tint: '#fff6d6', // the data sheet
  rule: '#d7dde3', // hairlines
  muted: '#5d6b78', // running heads, notes
  paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at charcoal, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.charcoal })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const TEXT = 'Host Grotesk'; // text and display
const LABEL = 'Commit Mono'; // labels: kickers, box titles, step numbers, heads, the table
const LEAD = 13.6; // pt: the body leading, the pitch of the baseline grid
const LINES = 44; // grid lines in a full column
const [TRIM_W, TRIM_H, TOP, INNER, OUTER, GUTTER] = [195, 255, 22, 18, 14, 7]; // mm
const PT = 25.4 / 72; // mm in a point

// #region look: the base of every box (a mono title, smaller type), then one device each
const TITLE = { fontFamily: LABEL, fontSize: pt(8), color: col('charcoal'),
  textTransform: 'uppercase', letterSpacing: pt(1.2) }; // bold by default
const BOX_TYPE = { fontSize: pt(8.8), lineHeight: pt(12.4) }; // colours inherit bodyText
const box = (id, device) => ({ id, // margins: the defaults, snapped to whole grid lines
  padding: { top: mm(3), right: mm(3.6), bottom: mm(3.4), left: mm(3.6) },
  titleStyle: { ...TITLE, gap: mm(2) }, body: BOX_TYPE,
  lists: { gap: mm(2), itemSpacing: pt(3) }, ...device });
const icon = (id, size, extra) => ({ kind: 'resource', resourceId: id, size: mm(size),
  ...extra });
// A side bar with its icon centred on it, 1.4 mm narrower than the bar.
const bar = (hue, id, width = 5.6) => ({ backgroundEnabled: false,

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Mantén sencer el procediment

Sense aquest paràmetre, el procediment, que cap en una columna, passa sencer al cap de la columna dreta i deixa 43 mm buits al peu de l'esquerra.

-  box('pasos', { keepTogether: false, background: col('light'),
+  box('pasos', { background: col('light'),

#Fes flotar el full de dades al peu

Amb placement="bottom" a content.es.md, el full de dades ocupa el peu de la pàgina on cau la seva tanca, la 42. El procediment, desplaçat, comença al cap de la columna dreta i es parteix entre les dues pàgines fins al cap de la 43.

-:::callout{type="datos" placement="top" title="Hoja de datos · Madrid, 40,4° N · 3,7° O"}
+:::callout{type="datos" placement="bottom" title="Hoja de datos · Madrid, 40,4° N · 3,7° O"}

Errors freqüents

Error freqüent

Un flotant 'top' va a la pàgina següent a la seva cita tret que pugui encapçalar la pàgina que el cita

Per defecte un flotant no va mai per sobre de la seva pròpia referència, així que un flotant 'top' a tota l'amplada citat a la pàgina N obre la pàgina N+1. Amb placement.citingPage: true al recurs o al defaultPlacement del seu tipus (o layout.floatsAtCitingPage per a tot el llibre, des de postext 1.25) encapçala en canvi la pàgina N, i el text de damunt de la referència baixa sota seu, quan hi cap dins de layout.maxTopFraction i la línia que el cita continua en aquesta pàgina. No encapçala mai la primera pàgina d'un capítol ni una pàgina després d'un salt forçat: allà continua obrint la pàgina següent, i 'auto' o 'bottom' poden ocupar el peu de la pàgina que el cita. Col·locació de figures →

Error freqüent

La pàgina 1 és senar: planifica amb números físics

La pàgina 1 queda a la dreta i la 2 és la primera pàgina parella, així que planifica els plecs amb números de pàgina físics: una obertura en pàgina parella queda davant de la senar que la segueix. Salts de pàgina i de columna →

Avís de maquetació · calloutOverflow

El requadre desborda la seva columna

Per què. Un requadre que cap tall no pot partir (perquè conté una figura, una taula o un requadre niat més alts que la columna, o un splitMinLines massa alt) s'ha col·locat desbordat; el motor ho anota a doc.warnings i el Sandbox ho mostra. Un requadre amb span: 'side' més alt que una columna lateral buida també es col·loca desbordat.

Solució. Escurça el requadre, deixa que es parteixi amb keepTogether: false, abaixa splitMinLines o dona-li un altre span. Documentació →

  • Un requadre més alt que una columna sencera es parteix digui el que digui keepTogether. El paràmetre només decideix en els requadres que caben en una columna, com aquest procediment de 192 mm en una columna de 211.
  • splitMinLines (2 per defecte) és el mínim de línies que un tall deixa a cada costat, comptades en el pas que talla, així que cap pas no deixa una línia sola. El text anterior al procediment està ajustat perquè el tall caigui entre els passos 4 i 5. Un canvi en el text que precedeix un requadre partit pot moure el tall, així que torna a mirar on cau després de cada retoc.
  • Una icona en línia ocupa una columna pròpia, i la continuació la conserva, buida: els passos perden l'amplada de la icona a totes dues parts. Una icona a la cantonada, o una franja lateral on assentar-la, els deixa la mesura sencera.
  • Un requadre amb placement="top" encapçala la pàgina següent a aquella on s'obre, així que la línia d'obertura va a la pàgina anterior a la que ha d'encapçalar. Aquí és just abans del procediment, a la 42.

Crèdits

Text
Imatges
  • The shadow chart, the dial in profile and the icons, drawn in code in the page's palette · Ignacio Ferro · CC BY 4.0
Fonts
Host Grotesk (SIL OFL 1.1) · Commit Mono (SIL OFL 1.1)
Sandbox