En pocas palabras
Una ficha de ciencias para niños de ocho años sobre las partes de una planta. Cada pregunta tiene debajo un recuadro para la respuesta, y algunas frases tienen huecos que se rellenan con una lista de palabras.
Lo que vas a componer
La ficha 3A de Semillero Ciencias, una colección inventada para 3.º de Primaria, en cuatro páginas de 200 × 260 mm. La banda verde lleva la unidad en una etiqueta amarilla, el título y dos campos blancos para el nombre y la fecha; al lado, una planta de guisante en acuarela, dentro de un disco blanco, tiene sus seis partes numeradas en amarillo. La acuarela se generó con modelos de difusión y llega ya recortada en su disco, en dos JPEG que se unen en el borde de la banda: el de arriba lleva en las esquinas el verde de la banda, y el del pie, blanco; los números y las líneas de referencia siguen en código, sobre la imagen. Cada actividad es un título numerado sobre una tarjeta verde claro. Las tarjetas llevan cajas de respuesta blancas con una pequeña indicación gris, bancos de palabras en chips amarillos, huecos con contorno en las frases, una tabla para unir alimentos con partes de la planta y círculos para colorear. Cada caja queda 2 mm bajo su pregunta y 5 mm sobre lo que la sigue, y cada tarjeta, 9 mm sobre lo que venga después. El texto se compone en Andika, que SIL diseñó para niños que aprenden a leer.
Esta receta responde a
- ¿Cómo anido recuadros, como una ficha de ejercicios con cajas de respuesta, con un espaciado exacto?
- ¿Cómo hago una ficha de ejercicios: líneas para rellenar, cajas de respuesta, bancos de palabras, listas de comprobación?
- ¿Cómo hago chips en línea: teclas, etiquetas, bancos de palabras para ejercicios?
- ¿Cómo pongo imágenes o iconos dentro de las celdas de una tabla?
La respuesta corta
// In the Markdown a box inside a box is a fence inside a fence (each ::: closes one):
// :::callout{type="card"}
// What is inside the pea pods?
// :::callout{type="answer"}
// Write here ← the prompt first: a :::space that opens a box is dropped
// :::space{lines=3} (gotcha: space-dropped-box-top)
// :::
// :::
const [ASK, AFTER, HEAD, NEXT] = [2, 5, 3, 9]; // mm: question→box, box→next, heading→card
const card = {
id: 'card', background: col('tint'), borderRadius: mm(4),
padding: { top: mm(4), right: mm(5), bottom: mm(5), left: mm(5) },
marginTop: mm(HEAD), marginBottom: mm(NEXT), // NEXT: under a card, to whatever follows
// Off the grid, or what follows a card drops to the next grid line. Only the outer card can
// set it: a nested box ignores snapToGrid, span and placement (gotcha: nested-callout-limits).
snapToGrid: false,
body: { paragraphSpacing: false }, // the boxes' margins do all the spacing
lists: { bulletChar: '', // no bullet: in the checklist a circle chip opens each item
gap: mm(2), itemSpacing: pt(7) }, columnGap: mm(6),
};
// A nested box's margins collapse with its neighbours', the larger winning (ASK, AFTER); the
// last box's marginBottom falls inside the card's padding instead of adding to it.
const nested = (id, look) => ({ id, background: col('paper'), borderRadius: mm(2.5),
marginTop: mm(ASK), marginBottom: mm(AFTER), ...look });
const answer = nested('answer', { border: { enabled: true, color: col('rule'), width: pt(0.75) },
padding: { top: mm(1.6), right: mm(3), bottom: mm(2), left: mm(3) },
// A small grey prompt on a full 17 pt line; :::space counts in these body lines.
body: { fontFamily: LABEL, fontSize: pt(8), color: col('muted') } });
const bank = nested('bank', { title: t({ en: 'Word bank', es: 'Banco de palabras' }),
padding: { top: mm(2.2), right: mm(3), bottom: mm(2.4), left: mm(3) },
titleStyle: { fontFamily: LABEL, fontSize: pt(7.5), fontWeight: 600, color: col('leaf'),
textTransform: 'uppercase', letterSpacing: pt(1.3), gap: mm(1.6) } });
// config() plugs in all three: calloutStyles: [card, answer, bank].
Ingredientes
- Funciones
- Recuadros anidadosSalir de la rejilla a propósitoChips en líneaRecuadrosColumnas en un recuadro o en el textoEspacio vertical explícitoEstilos de títuloTítulos numeradosCapítulos sin númeroAperturas diseñadasTextos, filetes y cajas en los diseños de páginaImágenes en los diseños de páginaAtributos de títuloSaltos de línea en los títulosEstilos de tabla con nombreImágenes en las celdasTipos de recurso propiosFiguras justo aquíListas de viñetas y de comprobaciónListas numeradas
- También usa
- Equilibrado de columnasBanda de capítulo a todo el anchoEstilos de párrafoFiguras y tablas como recursos
- Tipografía
- Andika, Baloo 2, Fredoka (SIL OFL 1.1)
- Recursos
plant-1092.jpgplant-foot-1092.jpg- La planta de guisante de la apertura, una acuarela (parte alta del disco) (Generated With Diffusion Models, original)
- Las raíces de la planta de guisante, el pie de la misma acuarela bajo la banda (Generated With Diffusion Models, original)
- Las líneas de referencia de la planta, los seis iconos de alimentos y la estrella, dibujados en código con la paleta de la página (Ignacio Ferro, MIT)
Elaboración
#1 · Saca también los títulos de la rejilla
headings: { fontFamily: DISPLAY, snapToGrid: false, // or what follows snaps back to the grid
balancing: { enabled: false }, // no extra space above headings to fill out a page
levels: [
// parity 'any': a sheet opens the next page, on either side.
{ level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' },
marginTop: pt(0), marginBottom: pt(0), advancedDesign: opener() },
{ level: 2, numberingTemplate: '{2}', marginTop: mm(0), marginBottom: mm(0),
advancedDesign: activity },
] },
En la respuesta corta, los márgenes de cada caja se funden con los de sus vecinas y cuenta solo el mayor. Los 5 mm de un banco de palabras se imponen a los 2 mm que la lista lleva encima, y los 5 mm de la última caja de respuesta caen dentro de los 5 mm de relleno inferior de la tarjeta, sin sumarse a ellos. Si los títulos siguen en la rejilla, lo que viene detrás de cada uno vuelve a la siguiente línea de 17 pt, y un encabezado de nivel 2 reserva entre 10,8 y 14,1 mm en lugar de los 8,6 mm de su disco; headings.snapToGrid: false deja la reserva en 8,6 mm. Poner snapToGrid en los estilos anidados no cambia nada, porque solo la tarjeta exterior puede salir de la rejilla (recuadros anidados). El equilibrado de columnas está desactivado porque añade espacio sobre los títulos para rellenar la página; en la página 2 pondría 33 mm sobre la actividad 3 en lugar de 9.
#2 · Haz de cada hueco un chip
const chip = (id, fill, look) => ({ id, fontFamily: LABEL, background: col(fill),
borderWidth: pt(0), borderColor: col('leaf'), borderRadius: em(1), ...look });
// An empty chip, :chip[ ], is a box of padding and outline alone. It is a band 1.25 em tall,
// so paddingX ROUND makes it a circle.
const [ROUND, OUTLINE] = [em(0.625), pt(0.9)];
// A blank is all padding, 2 × paddingX wide and 19.6 pt tall: taller than the 17 pt line, so
// the card's itemSpacing sets its items 24 pt apart (gotcha: chip-overlap).
const blank = (id, width) => chip(id, 'paper', { borderWidth: OUTLINE, borderRadius: mm(1.4),
paddingX: mm(width / 2), paddingY: em(0.12), fontSize: em(1.15) });
const chipStyles = [
chip('word', 'sun', { bold: true, paddingX: em(0.6), paddingY: em(0.08), gap: em(0.45) }),
blank('blank', 34), blank('wide', 38), // mm: in a sentence; alone in a column
chip('dot', 'leaf', { paddingX: ROUND, fontSize: em(0.6) }),
chip('tick', 'paper', { borderWidth: OUTLINE, paddingX: ROUND, fontSize: em(1.1), gap: em(0.5) }),
];
Un chip es una caja indivisible dentro de la línea; su relleno se pinta por fuera de la línea sin hacerla más alta. Un banco de palabras es una fila de chips dentro de un recuadro anidado bank. Los huecos, los puntos para unir y los círculos para colorear también son chips, y se escriben :chip[ ]: un chip con un espacio es una caja vacía, hecha de relleno y contorno (chips en línea). La anchura la fija paddingX: un hueco mide 34 mm dentro de una frase y 38 mm cuando va solo en su columna, y un círculo lleva a cada lado la mitad de su altura de 1,25 em. En la lista de comprobación, el círculo ocupa el sitio de la viñeta (bulletChar: ''). Con 19,6 pt de alto, un hueco es más alto que la línea de 17 pt, y por eso cada uno va en su propio elemento de lista, a 24 pt del siguiente.
#3 · Numera las actividades con un diseño de título
const DISC_H2 = 8.6; // mm: the disc and the title are this tall, so the heading reserves this
const numberDisc = { kind: 'text', id: 'num', content: '{number}', // numberingTemplate '{2}'
fontFamily: DISPLAY, fontSize: pt(15), fontWeight: 800, color: col('paper'),
box: { backgroundColor: col('leaf'), borderRadius: mm(DISC_H2 / 2) }, // centred both ways
placement: { anchor: { to: 'container', edge: 'top-left' },
size: { width: mm(DISC_H2), height: mm(DISC_H2) } } };
const activityTitle = { kind: 'text', id: 'title', content: '{titleText}',
fontFamily: DISPLAY, fontSize: pt(17), fontWeight: 700, color: col('ink'), align: 'left',
overflow: 'wrap', placement: { anchor: { to: '#num', edge: 'right-of' },
offset: { x: mm(3) }, size: { width: mm(140), height: mm(DISC_H2) } } };
const activity = { enabled: true, slot: { elements: [numberDisc, activityTitle] } };
// ## How did I do? {style="review"} is not an activity: it has no number and a star for a disc.
const review = { id: 'review', numbered: false, advancedDesign: { ...activity, slot: {
elements: [{ kind: 'image', id: 'num', resourceId: 'star', placement: numberDisc.placement },
activityTitle] } } };
Un encabezado de nivel 2 con advancedDesign conserva su sitio en la columna, y en lugar de su texto se dibuja el diseño: un disco con {number}, que imprime el numberingTemplate del nivel, y {titleText} a su derecha (apertura a toda página y diseño avanzado). El disco y el título miden 8,6 mm de alto, y fuera de la rejilla el título reserva justo esa altura, de modo que el diseño no necesita minHeight. Como los números salen del contador del nivel 2, si intercalas una actividad en el Markdown, las siguientes cambian de número. La autoevaluación usa un estilo de encabezado con numbered: false, que la deja fuera de la cuenta, y en el sitio del disco lleva una estrella dibujada en SVG.
#4 · Pon los dibujos en las celdas de la tabla
const tableStyles = [{ id: 'match', borderRadius: mm(3), // no header row, so no header fill
headerBackgroundEnabled: false, bodyBackgroundEnabled: true, bodyBackground: col('paper'),
bodyFontFamily: LABEL, bodyFontSize: pt(13), bodyColor: col('ink'), cellPadding: mm(1.4),
rules: 'none' }]; // the white panel is the body fill alone
const cell = (content, extra) => ({ content, verticalAlign: 'middle', ...extra });
const dotCell = () => cell(':chip[ ]{style="dot"}', { align: 'center' });
const matchRow = (icon, food, part) => [cell('', { image: { resourceId: icon, width: 0.76 },
align: 'center' }), cell(food), dotCell(), cell(''), dotCell(),
cell(`:chip[${part}]{style="word"}`)];
const sheetType = { id: 'sheet', name: 'Worksheet item', shortLabel: '', captionPrefix: '',
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal' }; // no caption, no number
// Set 'here' in its card, built once FOODS exist. A box keeps a line of its text, 6 mm, over
// an embedded table; with that off (see layout), a :::space{lines=0.33} sets ASK instead.
const foods = () => ({ id: 'foods', typeId: 'sheet', kind: 'table', createdAt: 0, updatedAt: 0,
placement: { position: 'here' }, table: { styleId: 'match', model: {
columnWidths: [0.14, 0.25, 0.06, 0.31, 0.06, 0.18], // the widest gap: room to draw a line
rows: FOODS.map((name, r) => matchRow(ICONS[r], name, PARTS[r])) } } });
TableCell.image dibuja un recurso dentro de su celda, aquí al 76 % del ancho de la celda, y la fila crece para que quepa. verticalAlign: 'middle' centra respecto al dibujo el nombre del alimento, los puntos y el chip. La columna más ancha, el 31 % de la tabla, queda vacía para que el alumno trace la línea. El estilo con nombre redondea el marco de la tabla y recorta a esa forma el relleno blanco del cuerpo. No dibuja filetes, así que el panel es solo el relleno blanco (estilos de tabla con nombre). Su tipo de recurso tiene el captionPrefix vacío y la tabla no lleva texto de pie, así que no se imprime ningún pie. placement: { position: 'here' } coloca la tabla donde está su línea ::resource, dentro de la tarjeta. Un recuadro deja sobre una tabla así una línea de su propio texto, 6 mm aquí; layout.inlineResourceGapInBoxes: false lo desactiva, y un :::space{lines=0.33} antes de la línea ::resource pone los 2 mm que las cajas de respuesta guardan bajo su pregunta.
La receta completa
// ═══ Postext Cookbook · Nº 022 · Worksheet with answer boxes and a word bank ══════
// https://postext.dev/en/cookbook/worksheet-answer-boxes
// Code: MIT · Text: original (CC BY 4.0) · Plant: diffusion models · Icons: drawn in code
// Fonts: Andika, Baloo 2, Fredoka (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 = 'worksheet-answer-boxes';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { ink: '#243040', muted: '#5d6975', paper: '#ffffff', // type; prompts; boxes
leaf: '#2f7d4a', sun: '#f4b43a', soil: '#8a5a36', // the accent; words to pick; drawings
tint: '#e5f1e7', rule: '#a9c9b1' }; // the activity cards; answer-box outlines
// Each colour names its palette entry and carries its hex.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults link to 'main-color': point it at the leaf, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.leaf })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, LABEL] = ['Andika', 'Baloo 2', 'Fredoka']; // Andika: for early readers
const [TOP, SIDE] = [18, 16]; // mm; a sheet printed one-sided, so the margins do not mirror
// #region answer: cards that hold white answer boxes, stacked exactly, off the grid
// In the Markdown a box inside a box is a fence inside a fence (each ::: closes one):
// :::callout{type="card"}
// What is inside the pea pods?
// :::callout{type="answer"}
// Write here ← the prompt first: a :::space that opens a box is dropped
// :::space{lines=3} (gotcha: space-dropped-box-top)
// :::
// :::
const [ASK, AFTER, HEAD, NEXT] = [2, 5, 3, 9]; // mm: question→box, box→next, heading→card
const card = {
id: 'card', background: col('tint'), borderRadius: mm(4),
padding: { top: mm(4), right: mm(5), bottom: mm(5), left: mm(5) },
marginTop: mm(HEAD), marginBottom: mm(NEXT), // NEXT: under a card, to whatever follows
// Off the grid, or what follows a card drops to the next grid line. Only the outer card can
// set it: a nested box ignores snapToGrid, span and placement (gotcha: nested-callout-limits).
snapToGrid: false,
body: { paragraphSpacing: false }, // the boxes' margins do all the spacing
lists: { bulletChar: '', // no bullet: in the checklist a circle chip opens each item
gap: mm(2), itemSpacing: pt(7) }, columnGap: mm(6),
};
// A nested box's margins collapse with its neighbours', the larger winning (ASK, AFTER); the
// last box's marginBottom falls inside the card's padding instead of adding to it.
const nested = (id, look) => ({ id, background: col('paper'), borderRadius: mm(2.5),
marginTop: mm(ASK), marginBottom: mm(AFTER), ...look });
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
#Devuelve las tarjetas a la rejilla
Con el valor por defecto, snapToGrid: true, lo que sigue a una tarjeta baja a la siguiente línea de la rejilla de 17 pt, y los 9 mm que quedaban bajo cada tarjeta pasan a ser 14,5 mm bajo la actividad 2, 13,2 mm bajo la actividad 4 y 11,2 mm bajo la actividad 6.
- snapToGrid: false,
+ snapToGrid: true,#Deja más sitio para una respuesta
:::space cuenta en líneas de 17 pt de la propia caja de respuesta, y cada línea que añades le da al alumno 6 mm más para escribir.
Escribe aquí
-:::space{lines=4}
+:::space{lines=6}Errores frecuentes
Error frecuente
:::space se descarta al principio de un recuadro o columna
:::space se descarta al principio de una columna, de un grupo :::columns, de un recuadro sin título que tiene más contenido y de la continuación de un recuadro partido. Desde postext 1.5 un recuadro hecho solo de :::space mide lo que pide el espacio (una caja de respuesta, sitio para escribir), y el espacio que va justo bajo el título de un recuadro baja el cuerpo esa misma altura. Para abrir con espacio un recuadro sin título, dale un título o una primera línea y añade después el espacio. Espacio vertical explícito →
Error frecuente
Un recuadro anidado ignora span, placement y snapToGrid
Un recuadro anidado en otro ignora su span, placement, snapToGrid y floatBarrier: siempre se compone dentro del recuadro que lo contiene, con el ancho interior de este. Recuadros anidados →
Error frecuente
Los chips más altos que el interlineado tocan la línea siguiente
Un chip cuya caja es más alta que el interlineado toca los chips de la línea siguiente (el aviso chipOverlap). Reduce su relleno vertical, su borde o su cuerpo, o abre el interlineado. Chips en línea →
Comprobación del Sandbox · chipOverlap
Los chips tocan la línea siguiente
Por qué. La caja de un estilo de chip es más alta que el interlineado, así que los chips de líneas seguidas se tocan.
Solución. Reduce el relleno vertical, el contorno o el cuerpo del chip, o aumenta el interlineado. Documentación →
- Un recuadro no puede pautar sus propias líneas de escritura, porque los estilos de recuadro no tienen fondo pautado. Las cajas de respuesta quedan en blanco y toman su altura de
:::space, y las líneas cortas para rellenar son chips con contorno. - Un estilo de encabezado con
numbered: falsesigue dibujando el diseño de su nivel, pero con{number}vacío. Sin un diseño propio, la autoevaluación empezaría con un disco verde sin nada dentro; por esoreviewcopia el diseño de las actividades y pone la estrella donde iba el disco.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imágenes
- La planta de guisante de la apertura, una acuarela (parte alta del disco) · Generated With Diffusion Models · original
- Las raíces de la planta de guisante, el pie de la misma acuarela bajo la banda · Generated With Diffusion Models · original
- Las líneas de referencia de la planta, los seis iconos de alimentos y la estrella, dibujados en código con la paleta de la página · Ignacio Ferro · MIT
- Fuentes
- Andika (SIL OFL 1.1) · Baloo 2 (SIL OFL 1.1) · Fredoka (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


