Saltar al contenido principal
Receta número 8

Recetario · Capítulo 12 · Libros de texto

Recuadros de libro de texto con código de colores

Seis tipos de recuadro en tres colores, que se distinguen por una franja con icono, un distintivo, una pestaña numerada, pictogramas o una marca lateral.

En esta página

pp. 28–29 · 2–3 de 3

  • Formato 210 × 280 mm
  • 2 columnas, medianil de 8 mm
  • Noto Serif 9,4/13,4
  • Barlow Semi Condensed
  • Lexend
  • 3 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 66 ms
  • 179 líneas de código

En pocas palabras

Un capítulo de un libro de biología con seis tipos de recuadros, como avisos o notas de laboratorio. Cada tipo tiene su color y su símbolo, para que el alumno los distinga de un vistazo.

Lo que vas a componer

El capítulo 2 de Materia viva, libro de biología de bachillerato en página de 210 × 280 mm, se abre bajo una célula que se sale por la esquina superior de la página, con el número del capítulo dentro. Siguen seis tipos de recuadro en tres colores, cada uno con un elemento gráfico propio, para que el alumno distinga un objetivo de una advertencia antes de leerlos. En magenta van los objetivos, sobre una franja con una diana, y la autoevaluación, con una casilla marcada fuera del marco. En verde, el «Para recordar», junto a un filete fino rematado por una bombilla, y la práctica, con tres pictogramas de seguridad. La advertencia es ámbar y lleva un distintivo de alerta en la esquina exterior. El RECUADRO 2.1 es lavanda, bajo una pestaña negra y un matraz. Las negritas toman el color del recuadro, magenta en el RECUADRO 2.1.

Esta receta responde a

  • ¿Cómo hago recuadros de nota, consejo o advertencia con icono, franja de color y esquinas redondeadas?
  • ¿Cómo añado una pestaña numerada («RECUADRO 1-1»), un icono de esquina o un icono al margen con un filete?
  • ¿Cómo doy color a los términos clave (en negrita o cursiva) en el texto o dentro de los recuadros?

La respuesta corta

script.js · líneas 41–62en el código completo
// 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

Ingredientes

Tipografía
Noto Serif, Lexend, Barlow Semi Condensed (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Dale un color a cada tipo de recuadro

script.js · líneas 14–22en el código completo
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' } }));

Seis tipos de recuadro se reparten tres tonos: magenta para los objetivos y la autoevaluación, verde para el «Para recordar» y la práctica, y ámbar para la advertencia. El RECUADRO 2.1 tiene fondo lavanda y usa el magenta en sus términos clave. Cada tono tiene un tinte claro para los fondos, y todos los ajustes de color enlazan con una entrada de la paleta, así que para cambiar un tono basta con editar un valor. Con un cuerpo tan pequeño, el texto necesita un contraste de 4,5:1. El magenta sobre el lavanda llega a 4,9:1, pero el ámbar sobre el fondo de la advertencia se queda en 2,2:1; por eso la advertencia reserva el ámbar para el marco y el distintivo, y compone el título y los términos clave en warnInk, un ámbar más oscuro que llega a 5,2:1.

#2 · Comparte todo lo demás

script.js · líneas 28–37en el código completo
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() reúne los ajustes comunes a todos los recuadros: los márgenes, el relleno, la letra del título y del cuerpo, y el espaciado de las listas. Su argumento hue colorea el título, las viñetas y números y las negritas. body.boldColor pone en magenta el modelo de mosaico fluido de los objetivos y en ocre la pared celular de la advertencia; las negritas del texto corrido siguen en tinta (tipografía dentro de un recuadro). Si declaras calloutStyles, sustituyes el único estilo que trae el motor, un recuadro gris llamado note. Un recuadro cuyo type falta o está mal escrito toma el primer estilo, así que la lista empieza por los objetivos, que aparecen en todos los capítulos.

#3 · Franja, pestaña y distintivo

El código es la respuesta corta de arriba. La franja de los objetivos mide 7,5 mm y su diana 5 mm, así que el icono queda dentro del color con aire a los dos lados. El offset de la pestaña es igual a su altura (height), de modo que la pestaña se apoya en el borde superior del recuadro, sin tocar el título. 'top-left' es la esquina exterior de esta página par; el matraz va a continuación de la pestaña, y el filete recorre el borde superior desde el matraz hasta la esquina opuesta. position: 'corner' cuelga el distintivo de la advertencia con la mitad de su ancho fuera del borde, y cornerSide: 'outer' lo lleva al lado exterior, el izquierdo en esta página par. En ese lado el motor sangra el título para que no choque con el distintivo, salvo que el relleno ya cubra medio distintivo más el espacio del título; por eso la advertencia lleva BADGE / 2 + GAP de relleno a los dos lados, y el título queda alineado con el texto. Solo este recuadro lleva borderRadius: es el único con borde, y un radio de 1,4 mm le suaviza las esquinas. En un recuadro con franja, el radio redondearía también las esquinas exteriores de la franja (estilos de recuadro).

#4 · Tres elementos gráficos más

script.js · líneas 66–79en el código completo
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» mide 2,5 pt, frente a los 6,4 mm de su distintivo, de modo que se ve como un filete fino con la bombilla encima de su extremo superior; un relleno izquierdo de medio distintivo más 2 mm aparta el texto de la bombilla. icon.width encaja la imagen en una caja ancha en vez de en un cuadrado, así que los tres pictogramas de seguridad, dibujados como una sola imagen de 24,5 mm, forman la columna de iconos del recuadro de seguridad, centrada respecto a su texto. La marca de la autoevaluación va fuera del borde, en este orden: marca, filete, hueco y recuadro. Su casilla cuadrada sobre un filete de 0,75 pt la distingue del «Para recordar», que lleva un distintivo redondo. La línea de apertura añade span="page" placement="bottom" para que la autoevaluación flote al pie de la página 29.

#5 · Los iconos también son recursos

script.js · líneas 240–265en el código completo
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' }) }),
];

Todos los iconos, el matraz de la pestaña y la célula de la apertura son recursos SVG declarados junto al contenido y registrados por su identificador de archivo. Los estilos los indican por su id de recurso y, como el texto no los cita, ninguno se convierte en una figura numerada. Glifos como ✓ o ☞ serían más cómodos de escribir, pero no están en los archivos latin de Fontsource que cargan las páginas: el canvas los tomaría de una fuente del sistema y un PDF los perdería. Los dibujos tampoco llevan texto: los colores se explican en los pies, así que un mismo dibujo sirve para las dos ediciones.

#6 · Abre el capítulo con una célula

script.js · líneas 83–102en el código completo
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élula es un elemento de imagen anclado a la esquina superior derecha de la página y desplazado más allá de ella, de modo que asoma sobre todo su cuarto inferior izquierdo, con el número dentro. Ambos caben en los 66 mm que minHeight reserva para la apertura. El antetítulo y la entradilla salen de la línea del encabezado, # Células y \\ membranas {unit="La célula" lead="…"}, y el \\ parte el título solo en la apertura.

La receta 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'),

El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)

Variantes

#Extiende un recuadro sobre las dos columnas

span="page" en la línea de apertura extiende cualquier recuadro sobre las dos columnas; el RECUADRO 2.1 anida además un grupo :::columns para poner la figura junto al texto.

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

#Cuelga el distintivo del lado del lomo

'inner' lleva el distintivo al lado del lomo, el izquierdo en la página impar y el derecho en la par; deja sitio en ese lado para la mitad que sobresale del recuadro.

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

#Pon la pestaña en la esquina derecha

'top-right', el valor por defecto, refleja toda la etiqueta: la pestaña pasa a la esquina derecha, el matraz a su izquierda y el filete llega desde la izquierda.

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

Errores frecuentes

Error frecuente

Los archivos de Fontsource cubren letras, no símbolos

El kit incrusta el archivo latin de Fontsource de cada fuente y, cuando el texto los usa, su archivo latin-ext para č, ł, † y su archivo greek para α, χ (en una familia que lo tenga: Lora y Gelasio no), en pantalla y en el PDF. Símbolos como →, ≈, ✓ y ★ no están en ninguno de esos archivos y faltan en el PDF: dibújalos, escríbelos como matemáticas o elige una fuente cuyos archivos los tengan. Fuentes incrustadas en el PDF →

Error frecuente

Un flotante 'top' va a la página siguiente a su cita salvo que pueda encabezar la página que lo cita

Por defecto un flotante nunca va por encima de su propia referencia, así que un flotante 'top' a todo el ancho citado en la página N abre la página N+1. Con placement.citingPage: true en el recurso o en el defaultPlacement de su tipo (o layout.floatsAtCitingPage para todo el libro, desde postext 1.25) encabeza en cambio la página N, y el texto de encima de la referencia baja bajo él, cuando cabe dentro de layout.maxTopFraction y la línea que lo cita sigue en esa página. Nunca encabeza la primera página de un capítulo ni una página tras un salto forzado: allí sigue abriendo la página siguiente, y 'auto' o 'bottom' pueden ocupar el pie de la página que lo cita. Colocación de figuras →

Error frecuente

La página 1 es impar: planifica con números físicos

La página 1 queda a la derecha y la 2 es la primera página par, así que planifica los pliegos con números de página físicos: una apertura en página par queda frente a la impar que la sigue. Saltos de página y de columna →

Aviso de maquetación · unknownCalloutType

Tipo de recuadro desconocido

Por qué. Un :::callout indica un tipo que calloutStyles no define, así que toma sin avisar el primer estilo.

Solución. Define el estilo o corrige el atributo type. Documentación →

  • La pestaña solo se imprime si la línea de apertura tiene el atributo label="RECUADRO 2.1" y el estilo tiene un objeto label. Un estilo sin él ignora el atributo.
  • Postext no numera los recuadros. La etiqueta es el texto literal de la línea de apertura, así que cada número, RECUADRO 2.1, RECUADRO 2.2, se escribe a mano.
  • Un distintivo de esquina sobresale la mitad de su ancho por el lado del recuadro, hacia el margen en el lado exterior de la página. En la otra columna de esa misma página sobresale hacia el medianil, así que deja los recuadros con distintivo en la columna exterior o dales sitio.
  • El lists.color de un recuadro da color por igual a sus viñetas y a los números de sus listas numeradas, así que aquí los pasos y las preguntas numerados salen en el color de su recuadro. Para dar color solo a las viñetas de un recuadro, deja lists.color fuera de su estilo y fija unorderedLists.color para el documento; los números conservan entonces orderedLists.color.

Créditos

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