Saltar al contenido principal
Receta número 22

Recetario · Capítulo 6 · Recuadros y notas

Ficha con cajas de respuesta y banco de palabras

Una ficha de ciencias de cuatro páginas: cajas de respuesta blancas en tarjetas verde claro, a 2 mm de cada pregunta, y chips para bancos de palabras y huecos.

  • Formato 200 × 260 mm
  • 1 columna
  • Andika 12/17
  • Baloo 2
  • Fredoka
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 52 ms
  • 185 líneas de código

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

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

Tipografía
Andika, Baloo 2, Fredoka (SIL OFL 1.1)
Recursos
  • plant-1092.jpg
  • plant-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

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

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

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

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

Sandbox
// ═══ 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: false sigue 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 eso review copia el diseño de las actividades y pone la estrella donde iba el disco.

Créditos

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)
Sandbox