Saltar al contingut principal
Recepta número 22

Receptari · Capítol 6 · Requadres i notes

Fitxa amb caixes de resposta i banc de paraules

Una fitxa de ciències de quatre pàgines: caixes de resposta blanques en targetes verd clar, a 2 mm de cada pregunta, i xips per a bancs de paraules i buits.

En aquesta pàgina
  • Mostra en castellà: encara no hi ha edició en català
  • Format 200 × 260 mm
  • 1 columna
  • Andika 12/17
  • Baloo 2
  • Fredoka
  • 4 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 52 ms
  • 185 línies de codi

En poques paraules

Una fitxa de ciències per a nens de vuit anys sobre les parts d'una planta. Cada pregunta té a sota un requadre per a la resposta, i algunes frases tenen buits que s'omplen amb una llista de paraules.

Què compondràs

La fitxa 3A de Semillero Ciencias, una col·lecció inventada per a 3r de Primària, en quatre pàgines de 200 × 260 mm. La banda verda porta la unitat en una etiqueta groga, el títol i dos camps blancs per al nom i la data; al costat, una planta de pèsol en aquarel·la, dins d'un disc blanc, té les seves sis parts numerades en groc. L'aquarel·la es va generar amb models de difusió i arriba ja retallada en el seu disc, en dos JPEG que s'uneixen a la vora de la banda: el de dalt porta a les cantonades el verd de la banda, i el del peu, blanc; els números i les línies de referència continuen en codi, sobre la imatge. Cada activitat és un títol numerat sobre una targeta verd clar. Les targetes porten caixes de resposta blanques amb una petita indicació grisa, bancs de paraules en xips grocs, buits amb contorn a les frases, una taula per unir aliments amb parts de la planta i cercles per acolorir. Cada caixa queda 2 mm sota la seva pregunta i 5 mm sobre el que la segueix, i cada targeta, 9 mm sobre el que vingui després. El text es compon en Andika, que SIL va dissenyar per a nens que aprenen a llegir.

Aquesta recepta respon a

  • Com niuo requadres, com una fitxa d'exercicis amb caixes de resposta, amb un espaiat exacte?
  • Com faig una fitxa d'exercicis: línies per omplir, caixes de resposta, bancs de paraules, llistes de comprovació?
  • Com faig xips en línia: tecles, etiquetes, bancs de paraules per a exercicis?
  • Com poso imatges o icones dins de les cel·les d'una taula?

La resposta curta

script.js · línies 25–57al codi complet
// 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].

Ingredients

Tipografia
Andika, Baloo 2, Fredoka (SIL OFL 1.1)
Recursos
  • plant-1092.jpg
  • plant-foot-1092.jpg
  • The pea plant on the opener, a watercolour (top of the disc) (Generated With Diffusion Models, original)
  • The pea plant’s roots, the foot of the same watercolour below the band (Generated With Diffusion Models, original)
  • The plant's leader lines, the six food icons and the star, drawn in code in the page’s palette (Ignacio Ferro, MIT)

Elaboració

#1 · Treu també els títols de la retícula

script.js · línies 162–170al codi complet
  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 },
    ] },

A la resposta curta, els marges de cada caixa es fonen amb els de les veïnes i compta només el més gran. Els 5 mm d'un banc de paraules s'imposen als 2 mm que la llista porta a sobre, i els 5 mm de l'última caixa de resposta cauen dins dels 5 mm d'emplenament inferior de la targeta, sense sumar-s'hi. Si els títols continuen a la retícula, el que ve darrere de cadascun torna a la línia següent de 17 pt, i un títol de nivell 2 reserva entre 10,8 i 14,1 mm en lloc dels 8,6 mm del seu disc; headings.snapToGrid: false deixa la reserva en 8,6 mm. Posar snapToGrid als estils niats no canvia res, perquè només la targeta exterior pot sortir de la retícula (requadres niats). L'equilibratge de columnes està desactivat perquè afegeix espai sobre els títols per omplir la pàgina; a la pàgina 2 posaria 33 mm sobre l'activitat 3 en lloc de 9.

#2 · Fes de cada buit un xip

script.js · línies 61–75al codi complet
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 xip és una caixa indivisible en línia; el seu emplenament es pinta per fora de la línia sense fer-la més alta. Un banc de paraules és una fila de xips dins d'un requadre niat bank. Els buits, els punts per unir i els cercles per acolorir també són xips, i s'escriuen :chip[ ]: un xip amb un espai és una caixa buida, feta de farciment i contorn (xips en línia). L'amplada la fixa paddingX: un buit fa 34 mm dins d'una frase i 38 mm quan va sol a la seva columna, i un cercle porta a cada costat la meitat de la seva alçada d'1,25 em. A la llista de comprovació, el cercle ocupa el lloc del pic (bulletChar: ''). Amb 19,6 pt d'alçada, un buit és més alt que la línia de 17 pt, i per això cadascun va en el seu propi element de llista, a 24 pt del següent.

#3 · Numera les activitats amb un disseny de títol

script.js · línies 79–93al codi complet
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 títol de nivell 2 amb advancedDesign conserva el seu lloc a la columna, i en lloc del text es dibuixa el disseny: un disc amb {number}, que imprimeix el numberingTemplate del nivell, i {titleText} a la dreta (extensió i disseny avançat). El disc i el títol fan 8,6 mm d'alçada, i fora de la retícula el títol reserva justament aquesta alçada, de manera que el disseny no necessita minHeight. Com que els números surten del comptador del nivell 2, si intercales una activitat al Markdown, les següents canvien de número. L'autoavaluació fa servir un estil d'encapçalament amb numbered: false, que la deixa fora del compte, i al lloc del disc porta una estrella dibuixada en SVG.

#4 · Posa els dibuixos a les cel·les de la taula

script.js · línies 131–147al codi complet
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 dibuixa un recurs dins de la seva cel·la, aquí al 76 % de l'amplada de la cel·la, i la fila creix perquè hi càpiga. verticalAlign: 'middle' centra respecte al dibuix el nom de l'aliment, els punts i el xip. La columna més ampla, el 31 % de la taula, queda buida perquè l'alumne hi traci la línia. L'estil amb nom arrodoneix el marc de la taula i retalla a aquesta forma l'emplenament blanc del cos. No dibuixa filets, així que el tauler és només l'emplenament blanc (estils de taula amb nom). El seu tipus de recurs té el captionPrefix buit i la taula no porta text de peu, així que no s'imprimeix cap peu. placement: { position: 'here' } col·loca la taula on és la seva línia ::resource, dins de la targeta. Un requadre deixa sobre una taula així una línia del seu propi text, 6 mm aquí; layout.inlineResourceGapInBoxes: false ho desactiva, i un :::space{lines=0.33} abans de la línia ::resource posa els 2 mm que les caixes de resposta guarden sota la seva pregunta.

La recepta 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 });

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

#Torna les targetes a la retícula

Amb el valor per defecte, snapToGrid: true, el que segueix una targeta baixa a la línia següent de la retícula de 17 pt, i els 9 mm que quedaven sota cada targeta passen a ser 14,5 mm sota l'activitat 2, 13,2 mm sota l'activitat 4 i 11,2 mm sota l'activitat 6.

-  snapToGrid: false,
+  snapToGrid: true,

#Deixa més lloc per a una resposta

:::space compta en línies de 17 pt de la mateixa caixa de resposta, i cada línia que hi afegeixes dona a l'alumne 6 mm més per escriure.

 Escribe aquí
-:::space{lines=4}
+:::space{lines=6}

Errors freqüents

Error freqüent

:::space es descarta al principi d'un requadre o columna

:::space es descarta al principi d'una columna, d'un grup :::columns, d'un requadre sense títol que té més contingut i de la continuació d'un requadre partit. Des de postext 1.5 un requadre fet només de :::space fa l'alçada que demana l'espai (una caixa de resposta, lloc per escriure), i l'espai que va just sota el títol d'un requadre fa baixar el cos aquesta mateixa alçada. Per obrir amb espai un requadre sense títol, dona-li un títol o una primera línia i afegeix-hi després l'espai. Espai vertical explícit →

Error freqüent

Un requadre imbricat ignora span, placement i snapToGrid

Un requadre imbricat en un altre ignora el seu span, placement, snapToGrid i floatBarrier: sempre es compon dins del requadre que el conté, amb l'amplada interior d'aquest. Requadres niats →

Error freqüent

Els xips més alts que l'interlineat toquen la línia següent

Un xip amb una caixa més alta que l'interlineat toca els xips de la línia següent (l'avís chipOverlap). Redueix-ne el farciment vertical, la vora o el cos, o obre l'interlineat. Chips en línia →

Comprovació del Sandbox · chipOverlap

Els xips toquen la línia següent

Per què. La caixa d'un estil de xip és més alta que l'interlineat, de manera que els xips de línies seguides es toquen.

Solució. Redueix el farciment vertical, el contorn o el cos del xip, o augmenta l'interlineat. Documentació →

  • Un requadre no pot pautar les seves pròpies línies d'escriptura, perquè els estils de requadre no tenen fons pautat. Les caixes de resposta queden en blanc i prenen l'alçada de :::space, i les línies curtes per omplir són xips amb contorn.
  • Un estil d'encapçalament amb numbered: false continua dibuixant el disseny del seu nivell, però amb {number} buit. Sense un disseny propi, l'autoavaluació començaria amb un disc verd sense res a dins; per això review copia el disseny de les activitats i posa l'estrella on anava el disc.

Crèdits

Text
Text original, CC BY 4.0
Imatges
  • The pea plant on the opener, a watercolour (top of the disc) · Generated With Diffusion Models · original
  • The pea plant’s roots, the foot of the same watercolour below the band · Generated With Diffusion Models · original
  • The plant's leader lines, the six food icons and the star, drawn in code in the page’s palette · Ignacio Ferro · MIT
Fonts
Andika (SIL OFL 1.1) · Baloo 2 (SIL OFL 1.1) · Fredoka (SIL OFL 1.1)
Sandbox