Saltar al contingut principal
Recepta número 8

Receptari · Capítol 12 · Llibres de text

Requadres de llibre de text amb codi de colors

Sis tipus de requadre en tres colors, que es distingeixen per una franja amb icona, un distintiu, una pestanya numerada, pictogrames o una marca lateral.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0

pp. 28–29 · 2–3 de 3

  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 280 mm
  • 2 columnes, espai entre columnes de 8 mm
  • Noto Serif 9,4/13,4
  • Barlow Semi Condensed
  • Lexend
  • 3 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 66 ms
  • 179 línies de codi

En poques paraules

Un capítol d'un llibre de biologia amb sis tipus de requadres, com avisos o notes de laboratori. Cada tipus té el seu color i el seu símbol, perquè l'alumne els distingeixi d'un cop d'ull.

Què compondràs

El capítol 2 de Materia viva, llibre de biologia de batxillerat en pàgina de 210 × 280 mm, s'obre sota una cèl·lula que surt per la cantonada superior de la pàgina, amb el número del capítol a dins. Segueixen sis tipus de requadre en tres colors, cadascun amb un element gràfic propi, perquè l'alumne distingeixi un objectiu d'un advertiment abans de llegir-los. En magenta van els objectius, sobre una franja amb una diana, i l'autoavaluació, amb una casella marcada fora del marc. En verd, el «Para recordar», al costat d'un filet fi rematat per una bombeta, i la pràctica, amb tres pictogrames de seguretat. L'advertiment és ambre i porta un distintiu d'alerta a la cantonada exterior. El RECUADRO 2.1 és lavanda, sota una pestanya negra i un matràs. Les negretes prenen el color del requadre, magenta al RECUADRO 2.1.

Aquesta recepta respon a

  • Com faig requadres de nota, consell o advertiment amb icona, franja de color i cantonades arrodonides?
  • Com afegeixo una pestanya numerada («REQUADRE 1-1»), una icona de cantonada o una icona al marge amb un filet?
  • Com dono color als termes clau (en negreta o cursiva) en el text o dins dels requadres?

La resposta curta

script.js · línies 41–62al codi complet
// box(id, hue, device) is the shared base: the hue colours the title, bullets and key terms.
const TAB = 5, BADGE = 7.4; // in mm: the tab's height (and offset), the warning badge's size
const calloutStyles = [
  // The first style is also the one a missing or misspelt type falls back to.
  box('objectives', 'band', { title: t({ en: 'In this chapter', es: 'En este capítulo' }),
    background: col('tintBand'), stripe: { enabled: true, width: mm(7.5), color: col('band') },
    icon: icon('target', 5) }), // on a side stripe (left by default) the icon is centred on it
  box('feature', 'band', { background: col('mist'),
    titleStyle: { fontFamily: 'Lexend', fontSize: pt(10.5), color: col('ink'), gap: mm(1.6) },
    // Printed only where the fence has label="…": the tab, the flask beside it, a rule to them.
    label: { fontFamily: LABEL, fontSize: pt(8), color: col('paper'), background: col('ink'),
      position: 'top-left', // this verso's outer corner, above the badge ('top-right' by default)
      height: mm(TAB), offset: mm(TAB), paddingX: mm(2.3), // offset = height: on the top edge
      icon: { resourceId: 'flask', width: mm(4.4), gap: mm(1.2) },
      rule: { enabled: true, color: col('ink'), width: pt(1.2) } } }),
  box('warning', 'warnInk', { background: col('tintWarn'), borderRadius: mm(1.4),
    border: { enabled: true, color: col('warn'), width: pt(0.75) },
    // The badge hangs half past the outer corner: sides of half badge + GAP align the title.
    padding: { top: mm(2.8), right: mm(BADGE / 2 + GAP), bottom: mm(3.2),
      left: mm(BADGE / 2 + GAP) },
    icon: icon('caution', BADGE, { position: 'corner', cornerSide: 'outer' }) }),
]; // straight into config(), followed by the 'more' styles

Ingredients

Tipografia
Noto Serif, Lexend, Barlow Semi Condensed (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Dona un color a cada tipus de requadre

script.js · línies 14–22al codi complet
const palette = { ink: '#1f2430', paper: '#ffffff', // text; type on stripes and tabs
  band: '#ab2e78', tintBand: '#fae3ef', // the chapter's magenta: opener, objectives, self-check
  tip: '#25734a', tintTip: '#e2f0e7', // study tips and lab work
  warn: '#e39422', tintWarn: '#fcefd8', warnInk: '#94540a', // frame and badge; tint; its type
  mist: '#e8e3f0', rule: '#dccfd8', muted: '#675e66' }; // feature box; lines in drawings; heads
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at the band, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.band })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

Sis tipus de requadre es reparteixen tres tons: magenta per als objectius i l'autoavaluació, verd per al «Para recordar» i la pràctica, i ambre per a l'advertiment. El RECUADRO 2.1 té fons lavanda i fa servir el magenta en els termes clau. Cada to té un tint clar per als fons, i tots els paràmetres de color enllacen amb una entrada de la paleta, així que per canviar un to n'hi ha prou d'editar un valor. Amb un cos tan petit, el text necessita un contrast de 4,5:1. El magenta sobre el lavanda arriba a 4,9:1, però l'ambre sobre el fons de l'advertiment es queda en 2,2:1; per això l'advertiment reserva l'ambre per al marc i el distintiu, i compon el títol i els termes clau en warnInk, un ambre més fosc que arriba a 5,2:1.

#2 · Comparteix tota la resta

script.js · línies 28–37al codi complet
const box = (id, hue, device) => ({ id, marginTop: pt(LEAD), marginBottom: pt(LEAD / 2),
  padding: { top: mm(2.8), right: mm(3.4), bottom: mm(3.2), left: mm(3.4) },
  titleStyle: { fontFamily: LABEL, fontSize: pt(8.5), color: col(hue), // bold by default
    textTransform: 'uppercase', letterSpacing: pt(1.4), gap: mm(GAP) },
  body: { fontFamily: LABEL, fontSize: pt(9.6), lineHeight: pt(12.6), color: col('ink'),
    boldColor: col(hue), textAlign: 'left', firstLineIndent: pt(0), paragraphSpacing: true },
  lists: { color: col(hue), gap: mm(2.2), itemSpacing: pt(2.4) }, // bullets and numbers
  ...device }); // the kind's title, fill and device: its spread wins over the base
// An SVG or bitmap resource, fitted into a square of that size (width × size with `width`).
const icon = (id, size, more) => ({ kind: 'resource', resourceId: id, size: mm(size), ...more });

box() aplega els paràmetres comuns a tots els requadres: els marges, el farciment, la lletra del títol i del cos, i l'espaiat de les llistes. El seu argument hue acoloreix el títol, els pics i els números i les negretes. body.boldColor posa en magenta el model de mosaic fluid dels objectius i en ocre la paret cel·lular de l'advertiment; les negretes del text corrent continuen en tinta (tipografia dins d'un requadre). Si declares calloutStyles, substitueixes l'únic estil que porta el motor, un requadre gris anomenat note. Un requadre que no té type o el té mal escrit fa servir el primer estil, així que la llista comença pels objectius, que apareixen a tots els capítols.

#3 · Franja, pestanya i distintiu

El codi és la resposta curta de més amunt. La franja dels objectius fa 7,5 mm i la diana 5 mm, així que la icona queda dins del color amb aire a tots dos costats. L'offset de la pestanya és igual a la seva alçada (height), de manera que la pestanya es recolza a la vora superior del requadre, sense tocar el títol. 'top-left' és la cantonada exterior d'aquesta pàgina parella; el matràs va a continuació de la pestanya, i el filet recorre la vora superior des del matràs fins a la cantonada oposada. position: 'corner' penja el distintiu de l'advertiment amb la meitat de l'amplada fora de la vora, i cornerSide: 'outer' el porta al costat exterior, l'esquerre en aquesta pàgina parella. En aquest costat el motor sagna el títol perquè no topi amb el distintiu, tret que el farciment ja cobreixi mig distintiu més l'espai del títol; per això l'advertiment porta BADGE / 2 + GAP de farciment a tots dos costats, i el títol queda alineat amb el text. Només aquest requadre porta borderRadius: és l'únic amb marc, i un radi d'1,4 mm li suavitza les cantonades. En un requadre amb franja, el radi arrodoniria també les cantonades exteriors de la franja (estils de requadre).

#4 · Tres elements gràfics més

script.js · línies 66–79al codi complet
const BULB = 6.4; // the study tip's badge in mm: the text clears it
const moreStyles = [
  box('tip', 'tip', { title: t({ en: 'Study tip', es: 'Para recordar' }),
    backgroundEnabled: false, stripe: { enabled: true, width: pt(2.5), color: col('tip') },
    // A stripe narrower than its icon: the badge sits on it at the top and hides it there.
    padding: { top: mm(0.6), right: mm(0), bottom: mm(0.6), left: mm(BULB / 2 + 2) },
    icon: icon('bulb', BULB) }),
  box('safety', 'tip', { background: col('tintTip'), marginTop: pt(4), // under its heading
    icon: icon('safety', 7, { width: mm(24.5), align: 'center' }) }), // 3 pictograms, 1 image
  box('check', 'band', { background: col('tintBand'),
    // Outside the frame: [marker][rule][gap][box], the rule as tall as the box.
    marker: { kind: 'resource', resourceId: 'check', size: mm(7), align: 'top', gap: mm(3),
      rule: { enabled: true, color: col('band'), width: pt(0.75) } } }),
];

La franja del «Para recordar» fa 2,5 pt, enfront dels 6,4 mm del distintiu, de manera que es veu com un filet fi amb la bombeta damunt de l'extrem superior; un farciment esquerre de mig distintiu més 2 mm aparta el text de la bombeta. icon.width encaixa la imatge en una caixa ampla en lloc d'un quadrat, així que els tres pictogrames de seguretat, dibuixats com una sola imatge de 24,5 mm, formen la columna d'icones del requadre de seguretat, centrada respecte al text. La marca de l'autoavaluació va fora del marc, en aquest ordre: marca, filet, espai i caixa. La casella quadrada sobre un filet de 0,75 pt la distingeix del «Para recordar», que porta un distintiu rodó. La línia d'obertura hi afegeix span="page" placement="bottom" perquè l'autoavaluació floti al peu de la pàgina 29.

#5 · Les icones també són recursos

script.js · línies 240–265al codi complet
const svgResource = (id, width, height, extra) => ({ id, typeId: 'figure', kind: 'svg',
  svg: { fileId: `${id}.svg`, width, height }, createdAt: 0, updatedAt: 0, ...extra });
const pageTop = { position: 'top', span: 'page' }; // a 'top' float opens the page after its :ref
const resources = [
  // Uncited, so never placed as figures: the box styles and the opener use them by id.
  ...['target', 'bulb', 'caution', 'check'].map((id) => svgResource(id, 240, 240)),
  svgResource('flask', 200, 240), svgResource('safety', 760, 240), svgResource('cell', 2000, 2000),
  svgResource('mosaic', 3480, 1240, { placement: pageTop, caption: t({
    en: 'The fluid mosaic: magenta phospholipids, green proteins, an amber carrier with its '
      + 'glucose, grey cholesterol, amber sugars.', // one line: the page is wide
    es: 'El mosaico fluido: fosfolípidos magenta, proteínas verdes, transportadora ámbar con su '
      + 'glucosa, colesterol gris, azúcares ámbar.' }),
    altText: t({ en: 'A cell membrane in section', es: 'Una membrana celular en sección' }) }),
  svgResource('fusion', 1800, 500, { placement: { position: 'here' }, caption: t({
    en: 'Mouse proteins in green, human proteins in magenta (the red dye): the two cells, the '
      + 'hybrid just after fusion and the same hybrid 40 minutes later.',
    es: 'En verde, las proteínas de ratón; en magenta, las humanas (el colorante rojo): las dos '
      + 'células, el híbrido recién fusionado y el mismo híbrido 40 minutos después.' }),
    altText: t({ en: 'Two cells fusing into a hybrid', es: 'Dos células que se fusionan' }) }),
  svgResource('osmosis', 3480, 860, { placement: pageTop, caption: t({
    en: 'Red blood cells in a hypertonic, an isotonic and a hypotonic solution. Arrows show the '
      + 'net flow of water.',
    es: 'Glóbulos rojos en una disolución hipertónica, una isotónica y una hipotónica. Las flechas '
      + 'indican el flujo neto de agua.' }),
    altText: t({ en: 'Blood cells in three solutions', es: 'Glóbulos rojos en tres medios' }) }),
];

Totes les icones, el matràs de la pestanya i la cèl·lula de l'obertura són recursos SVG declarats al costat del contingut i registrats pel seu identificador de fitxer. Els estils hi fan referència pel seu id de recurs i, com que el text no els cita, cap no es converteix en una figura numerada. Glifs com ✓ o ☞ serien més còmodes d'escriure, però no són als fitxers latin de Fontsource que carreguen les pàgines: el canvas els prendria d'una font del sistema i un PDF els perdria. Els dibuixos tampoc no porten text: els colors s'anomenen als peus, de manera que un mateix dibuix serveix per a les dues edicions.

#6 · Obre el capítol amb una cèl·lula

script.js · línies 83–102al codi complet
const text = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
  content, fontFamily: family, fontSize: pt(size), color: col(color), placement,
  align: 'left', ...extra }); // an opener's texts wrap by default
const below = (id, y, width) => ({ anchor: { to: `#${id}`, edge: 'below' },
  offset: { y: mm(y) }, size: { width: mm(width) } });
const chapter = t({ en: 'Chapter {chapterNumber}', es: 'Capítulo {chapterNumber}' });
const opener = { enabled: true, minHeight: mm(66), slot: { elements: [
  { kind: 'image', id: 'cell', resourceId: 'cell', placement: { anchor: { to: 'page',
    edge: 'top-right' }, offset: { x: mm(58), y: mm(-71) }, size: { width: mm(150) } } },
  text('numeral', '{chapterNumber}', 'Lexend', 118, 'paper', { anchor: { to: 'page',
    edge: 'top-right' }, offset: { x: mm(-OUTER), y: mm(14) } },
    { fontWeight: 800, lineHeight: 1, align: 'right' }),
  text('kicker', `${chapter} · {attr.unit}`, LABEL, 9, 'band', { anchor: { to: 'container',
    edge: 'top-left' }, offset: { y: mm(3) } },
    { fontWeight: 700, letterSpacing: pt(1.8), textTransform: 'uppercase' }),
  text('title', '{titleText}', 'Lexend', 34, 'ink', below('kicker', 2.5, 112),
    { fontWeight: 700, lineHeight: 1.04 }),
  text('lead', '{attr.lead}', 'Noto Serif', 10.5, 'ink', below('title', 5, 98),
    { italic: true, lineHeight: 1.42 }),
] } };

La cèl·lula és un element d'imatge ancorat a la cantonada superior dreta de la pàgina i desplaçat més enllà, de manera que en sobresurt sobretot el quart inferior esquerre, amb el número a dins. Tots dos caben en els 66 mm que minHeight reserva per a l'obertura. L'avanttítol i l'entradeta surten de la línia del títol, # Células y \\ membranas {unit="La célula" lead="…"}, i el \\ parteix el títol només a l'obertura.

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 008 · A family of textbook boxes ═══════════════════════
// https://postext.dev/en/cookbook/textbook-box-family
// Code: MIT · Text: original (CC BY 4.0) · Drawings and icons: generated in code (CC BY 4.0)
// Fonts: Noto Serif, Lexend, Barlow Semi Condensed (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'textbook-box-family';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: three hues for six kinds of box; everything links to an entry
const palette = { ink: '#1f2430', paper: '#ffffff', // text; type on stripes and tabs
  band: '#ab2e78', tintBand: '#fae3ef', // the chapter's magenta: opener, objectives, self-check
  tip: '#25734a', tintTip: '#e2f0e7', // study tips and lab work
  warn: '#e39422', tintWarn: '#fcefd8', warnInk: '#94540a', // frame and badge; tint; its type
  mist: '#e8e3f0', rule: '#dccfd8', muted: '#675e66' }; // feature box; lines in drawings; heads
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at the band, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.band })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
// Label face (box text and titles, tabs, captions, heads); leading in pt; outer margin in mm
const LABEL = 'Barlow Semi Condensed', LEAD = 13.4, OUTER = 16, GAP = 1.5; // GAP: title gap, mm

// #region base: what every box shares; each kind brings its colour and its one device
const box = (id, hue, device) => ({ id, marginTop: pt(LEAD), marginBottom: pt(LEAD / 2),
  padding: { top: mm(2.8), right: mm(3.4), bottom: mm(3.2), left: mm(3.4) },
  titleStyle: { fontFamily: LABEL, fontSize: pt(8.5), color: col(hue), // bold by default
    textTransform: 'uppercase', letterSpacing: pt(1.4), gap: mm(GAP) },
  body: { fontFamily: LABEL, fontSize: pt(9.6), lineHeight: pt(12.6), color: col('ink'),
    boldColor: col(hue), textAlign: 'left', firstLineIndent: pt(0), paragraphSpacing: true },
  lists: { color: col(hue), gap: mm(2.2), itemSpacing: pt(2.4) }, // bullets and numbers
  ...device }); // the kind's title, fill and device: its spread wins over the base
// An SVG or bitmap resource, fitted into a square of that size (width × size with `width`).
const icon = (id, size, more) => ({ kind: 'resource', resourceId: id, size: mm(size), ...more });
// #endregion

// #region answer: three devices: an icon on a wide stripe, a numbered tab, an outer badge
// box(id, hue, device) is the shared base: the hue colours the title, bullets and key terms.
const TAB = 5, BADGE = 7.4; // in mm: the tab's height (and offset), the warning badge's size
const calloutStyles = [
  // The first style is also the one a missing or misspelt type falls back to.
  box('objectives', 'band', { title: t({ en: 'In this chapter', es: 'En este capítulo' }),
    background: col('tintBand'), stripe: { enabled: true, width: mm(7.5), color: col('band') },
    icon: icon('target', 5) }), // on a side stripe (left by default) the icon is centred on it
  box('feature', 'band', { background: col('mist'),

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

#Estén un requadre sobre les dues columnes

span="page" a la línia d'obertura estén qualsevol requadre sobre les dues columnes; el RECUADRO 2.1, a més, hi niua un grup :::columns per posar la figura al costat del text.

-:::callout{type="warning" title="¿Membrana o pared?"}
+:::callout{type="warning" title="¿Membrana o pared?" span="page"}

#Penja el distintiu del costat del llom

'inner' porta el distintiu al costat del llom, l'esquerre a la pàgina senar i el dret a la parella; deixa lloc en aquell costat per a la meitat que sobresurt del requadre.

-    icon: icon('caution', BADGE, { position: 'corner', cornerSide: 'outer' }) }),
+    icon: icon('caution', BADGE, { position: 'corner', cornerSide: 'inner' }) }),

#Posa la pestanya a la cantonada dreta

'top-right', el valor per defecte, emmiralla tota la pestanya: la pestanya passa a la cantonada dreta, el matràs a la seva esquerra i el filet arriba des de l'esquerra.

-      position: 'top-left', // this verso's outer corner, above the badge ('top-right' by default)
+      position: 'top-right',

Errors freqüents

Error freqüent

Els fitxers de Fontsource cobreixen lletres, no símbols

El kit incrusta el fitxer latin de Fontsource de cada font i, quan el text els fa servir, el seu fitxer latin-ext per a č, ł, † i el seu fitxer greek per a α, χ (en una família que en tingui: Lora i Gelasio no), a la pantalla i al PDF. Símbols com →, ≈, ✓ i ★ no són a cap d'aquests fitxers i falten al PDF: dibuixa'ls, escriu-los com a matemàtiques o tria una font els fitxers de la qual els tinguin. Fonts incrustades al PDF →

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ó · unknownCalloutType

Tipus de requadre desconegut

Per què. Un :::callout indica un tipus que calloutStyles no defineix, de manera que fa servir el primer estil sense cap avís.

Solució. Defineix l'estil o corregeix l'atribut type. Documentació →

  • La pestanya només s'imprimeix si la línia d'obertura porta l'atribut label="RECUADRO 2.1" i l'estil té un objecte label. Un estil sense aquest objecte ignora l'atribut.
  • Postext no numera els requadres. El text de la pestanya és el text literal de la línia d'obertura, així que cada número, RECUADRO 2.1, RECUADRO 2.2, s'escriu a mà.
  • Un distintiu de cantonada sobresurt la meitat de la seva amplada pel costat del requadre, cap al marge al costat exterior de la pàgina. A l'altra columna d'aquella mateixa pàgina sobresurt cap a l'espai entre columnes, així que deixa els requadres amb distintiu a la columna exterior o fes-los lloc.
  • El lists.color d'un requadre acoloreix igual els pics i els números de les llistes numerades, així que aquí els passos i les preguntes numerats surten en el color del seu requadre. Per acolorir només els pics d'un requadre, deixa lists.color fora del seu estil i fixa unorderedLists.color per al document; els números conserven llavors orderedLists.color.

Crèdits

Text
Text original, CC BY 4.0
Fonts
Noto Serif (SIL OFL 1.1) · Lexend (SIL OFL 1.1) · Barlow Semi Condensed (SIL OFL 1.1)
Sandbox