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
// 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
- Funcions
- Requadres niatsSortir de la retícula a propòsitChips en líniaRequadresColumnes en un requadre o al textEspai vertical explícitEstils de títolTítols numeratsCapítols sense númeroObertures dissenyadesTextos, filets i caixes als dissenys de pàginaImatges als dissenys de pàginaAtributs de títolSalts de línia als títolsEstils de taula amb nomImatges a les cel·lesTipus de recurs propisFigures just aquíLlistes de pics i de comprovacióLlistes numerades
- També fa servir
- Equilibri de columnesBanda de capítol d'amplada completaEstils de paràgrafFigures i taules com a recursos
- Tipografia
- Andika, Baloo 2, Fredoka (SIL OFL 1.1)
- Recursos
plant-1092.jpgplant-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
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
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
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
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
// ═══ 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: falsecontinua 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òreviewcopia el disseny de les activitats i posa l'estrella on anava el disc.
Crèdits
- Recepta
- Ignacio Ferro
- 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)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


