Saltar al contenido principal
Receta número 21

Recetario · Capítulo 6 · Recuadros y notas

Recuadros que se parten, flotan y se fijan

Una hoja de prácticas en la que el procedimiento se parte entre dos columnas, la hoja de datos encabeza la página siguiente y una insignia va fija al pie.

pp. 42–43 · 2–3 de 4

  • Formato 195 × 255 mm
  • 2 columnas, medianil de 7 mm
  • Host Grotesk 9,4/13,6
  • Commit Mono
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 101 ms
  • 222 líneas de código

En pocas palabras

Una ficha escolar de ciencias para construir un reloj de sol. Muestra recuadros que se parten entre dos columnas, pasan a la página siguiente o se quedan fijos al pie.

Lo que vas a componer

Cuatro páginas de Taller de ciencias, un cuaderno de prácticas escolar: la Práctica 4, «Construye un reloj de sol». En la página 42, el aviso de seguridad queda entero, y el procedimiento de catorce pasos, con fondo amarillo y un compás en la esquina, empieza al pie de la columna izquierda y continúa en la cabeza de la derecha, a la misma medida y sin título. La hoja de datos de Madrid sale del flujo en esa página y encabeza la 43, sobre el texto. Al pie de la última página va fija una insignia antracita, «Autoevaluación · 10 min», con una mano que la señala desde el margen. En la apertura, la banda amarillo sol lleva las sombras de una varilla entre el mediodía y las cinco de la tarde, calculadas para la latitud de Madrid, y un panel a todo el ancho reparte los materiales en tres columnas.

Esta receta responde a

  • ¿Cómo dejo que un recuadro largo se parta entre columnas y páginas, o mantengo uno corto entero?
  • ¿Cómo llevo un recuadro a la cabeza o al pie de la página sin que el texto deje de llenarla?
  • ¿Cómo fijo una insignia o una pegatina en una posición concreta de la página?
  • ¿Cómo pongo un recuadro que cruce las dos columnas a media página, como un panel de cifras en tres bloques?

La respuesta corta

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

Ingredientes

Tipografía
Host Grotesk, Commit Mono (SIL OFL 1.1)
Recursos
  • El gráfico de sombras, el reloj de perfil y los iconos, dibujados en código con la paleta de la página (Ignacio Ferro, CC BY 4.0)

Elaboración

#1 · Una base común para todos los recuadros

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

Todos los estilos parten de box(): el título en monoespaciada, un cuerpo de 8,8 pt (el texto va a 9,4) y el relleno interior. Después, cada uno añade un solo rasgo propio: el aviso, una franja antracita; el procedimiento, un fondo amarillo; la hoja de datos, un fondo crema; el resumen, un filete superior, y la insignia, una píldora antracita. Así, el alumno distingue cada recuadro antes de leer su título. En el procedimiento, el fondo marca además la continuación: la parte que sigue en la cabeza de la columna derecha no lleva título, y solo el amarillo la une a los pasos 1 a 4, al pie de la izquierda.

#2 · Entero, partido, flotante y fijo

El código es la respuesta corta de arriba. El procedimiento mide 192 mm y en una columna caben 211, así que, si se mantuviera entero, saltaría a la cabeza de la columna derecha y dejaría 43 mm vacíos al pie de la izquierda. Con keepTogether: false empieza donde cae y sigue en la columna siguiente, o en la página siguiente, como muestra la segunda variante (el contenedor :::callout). La continuación pierde el título y el icono. Un icono en línea quitaría a los pasos una columna propia en las dos partes; por eso el compás va en la esquina exterior del recuadro, donde no resta anchura. La línea de apertura de la hoja de datos lleva placement="top", así que el recuadro sale del flujo en la página 42 y encabeza la siguiente. La insignia es fixed, y un offset.x negativo lleva la mano y su filete al margen exterior para que el borde de la insignia quede alineado con el texto.

#3 · Cruza la página con un panel de tres columnas

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

Con span: 'page', el recuadro de materiales ocupa las dos columnas. La introducción queda cortada a la misma altura por encima y el texto sigue a dos columnas por debajo (página 41). Dentro del bloque, :::columns{count=3 breaks="5,9"} fija dónde empieza cada columna en lugar de equilibrarlas: breaks cuenta bloques hijos, y cada elemento de lista es uno, así que la segunda y la tercera columna empiezan en el quinto y el noveno, las etiquetas en negrita. columnGap usa el medianil de 7 mm de la página, y las columnas del panel quedan tan separadas como las del texto.

:::callout{type="material" title="Necesitarás"}
:::columns{count=3 breaks="5,9"}
**Para la esfera**
 
- Cartón pluma de 20 × 30 cm
- La plantilla de la esfera
- Pegamento y rotulador
 
**Para el gnomon y la base**
…
:::
:::

#4 · Un amarillo para los campos, otro más claro para el recuadro largo

script.js · líneas 15–28en el código completo
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 amarillo sol se reserva para los fondos grandes, la banda y el panel; sobre él, el antracita y la tinta dan un contraste de 7,4:1 y 8,6:1. Como color de letra sobre blanco se quedaría en 1,8:1, así que nunca se usa para texto. El procedimiento lleva light, un amarillo más claro: sobre él la tinta llega a 11:1, y el corte se sigue viendo en la miniatura de la galería. La hoja de datos lleva tint, un crema casi blanco, para que no se confunda con el procedimiento, el otro recuadro con fondo de la doble página. main-color apunta al antracita, de modo que los valores por defecto que la configuración no cambia salen en antracita y no en el azul del motor.

#5 · Abre la práctica con una banda amarilla

script.js · líneas 97–119en el código completo
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 es un elemento de caja anclado a la página; el dibujo, un elemento de imagen junto al corte delantero. El antetítulo, la entradilla y la línea de sesiones salen de atributos de la línea del encabezado. Como la banda está anclada a la página, la apertura ya reserva altura hasta su pie, y el texto empezaría 3,6 mm por debajo. minHeight: BAND - TOP + AIR pide 8 mm; la reserva se ajusta a la siguiente línea de la rejilla base y el texto empieza 8,4 mm bajo la banda.

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

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

#Mantén entero el procedimiento

Sin ese ajuste, el procedimiento, que cabe en una columna, pasa entero a la cabeza de la columna derecha y deja 43 mm vacíos al pie de la izquierda.

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

#Haz flotar la hoja de datos al pie

Con placement="bottom" en content.es.md, la hoja de datos ocupa el pie de la página donde cae su línea de apertura, la 42. El procedimiento, desplazado, empieza en la cabeza de la columna derecha y se parte entre las dos páginas hasta la cabeza 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"}

Errores frecuentes

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 · calloutOverflow

El recuadro desborda su columna

Por qué. Un recuadro que ningún corte puede partir (una figura, una tabla o un recuadro anidado en él más alto que la columna, o un splitMinLines demasiado alto) se colocó desbordada; el motor lo anota en doc.warnings y el Sandbox lo muestra. Un recuadro con span: 'side' más alto que una columna lateral vacía también se coloca desbordado.

Solución. Acorta el recuadro, deja que se parta con keepTogether: false, baja splitMinLines o dale otro span. Documentación →

  • Un recuadro más alto que una columna entera se parte diga lo que diga keepTogether. El ajuste solo decide en los recuadros que caben en una columna, como este procedimiento de 192 mm en una columna de 211.
  • splitMinLines (2 por defecto) es el mínimo de líneas que un corte deja a cada lado, contadas en el paso que corta, así que ningún paso deja una línea sola. El texto anterior al procedimiento está ajustado para que el corte caiga entre los pasos 4 y 5. Un cambio en el texto que precede a un recuadro partido puede mover el corte, así que vuelve a mirar dónde cae después de cada retoque.
  • Un icono en línea ocupa una columna propia, y la continuación la conserva, vacía: los pasos pierden la anchura del icono en las dos partes. Un icono en la esquina, o una franja lateral sobre la que asentarlo, les deja la medida entera.
  • Un recuadro con placement="top" encabeza la página siguiente a aquella en la que cae su línea de apertura, así que el bloque va en la página anterior a la que debe encabezar. Aquí está justo antes del procedimiento, en la 42.

Créditos

Texto
Imágenes
  • El gráfico de sombras, el reloj de perfil y los iconos, dibujados en código con la paleta de la página · Ignacio Ferro · CC BY 4.0
Fuentes
Host Grotesk (SIL OFL 1.1) · Commit Mono (SIL OFL 1.1)
Sandbox