En poques paraules
Un examen d'història de quatre pàgines amb portada, bombolles per marcar i ratlles per escriure. Ensenya a numerar preguntes i apartats i a mostrar la puntuació de cadascun.
Què compondràs
La prova 2 d'un simulacre d'examen d'història sobre la guerra de Secessió, en un quadernet de quatre pàgines en mida carta. La portada obre amb una banda carmesí i l'any 1863 dibuixat en contorn; a sota hi van les caselles de l'alumne, les instruccions a dues columnes i la plantilla de bombolles de la part A. A la pàgina 2 hi ha deu preguntes tipus test, cadascuna amb les seves quatre opcions a sota, i cada opció comença per una bombolla amb la seva lletra, com les de la plantilla. La pàgina 3 recull el discurs de Gettysburg com a font A i, després, les preguntes numerades 11, a), i), amb la puntuació de cada apartat en un xip al marge dret. La pàgina 4 és per a les respostes: una ratlla cada dues línies de text, en grups que comencen pel número del seu apartat. Després de la portada, cada pàgina porta foli i un marge per al corrector, i l'única senar d'aquestes diu «Gira el full».
Aquesta recepta respon a
- Com faig una fitxa d'exercicis: línies per omplir, caixes de resposta, bancs de paraules, llistes de comprovació?
- Com personalitzo les llistes: pics per nivell, numeració (a)/(i), caselles de tasques i un espaiat que respecti la retícula?
- Com faig xips en línia: tecles, etiquetes, bancs de paraules per a exercicis?
- Com dono estils diferents a diverses taules (emplenaments, files alternes, marcs arrodonits) en un mateix document?
- Com amago les capçaleres a les obertures i a les pàgines en blanc, o pinto una pàgina parella en blanc amb el color de la part?
La resposta curta
// A table row is one line (the table's size × the body's leading ratio) plus cellPadding above
// and below: at the body size, (ROW − LEAD) / 2 of padding makes every row ROW deep, so the
// rules keep to the text's 15 pt grid, 10.6 mm apart: room for handwriting.
const ROW = 2 * LEAD; // pt
const lines = { id: 'lines', rules: 'horizontal', // a rule on the top and foot of every row
borderColor: col('rule'), borderWidth: pt(0.5), bodyFontFamily: LABEL, bodyFontSize: pt(BODY),
bodyColor: col('crimson'), cellPadding: pt((ROW - LEAD) / 2) };
// Every table in this paper is set 'here': where its ::resource directive stands in the text.
const table = (id, styleId, model) => ({ id, typeId: 'form', kind: 'table', createdAt: 0,
updatedAt: 0, placement: { position: 'here' }, table: { styleId, model } });
// One table per answer, the part's number in its first margin cell.
const answerLines = (id, part, rows) => table(id, 'lines', { columnWidths: [1, 5], rows: Array
.from({ length: rows }, (_, i) => [{ content: i ? '' : `**${part}**` }, { content: '' }]) });
Ingredients
- Funcions
- Llistes numeradesChips en líniaTabuladors i farcimentsEstils de taula amb nomTaules a partir de dadesTipus de recurs propisFigures just aquíEmplenaments de cel·laEstil dels peusSalts de pàgina i de columnaCapçaleres segons el tipus de pàginaCapçaleres i folisEstils de títolGeometria per seccióObertures dissenyadesAtributs de títolImatges als dissenys de pàginaRequadresColumnes en un requadre o al textEstils de paràgraf
- També fa servir
- Figures i taules com a recursosEspai vertical explícit
- Tipografia
- PT Serif, Inter Tight (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Numera les preguntes i posa'n les opcions a sota
const [NUMBER, GAP] = [12.5, 6]; // pt: the question numbers' size; number to text
const orderedLists = { fontFamily: LABEL, color: col('ink'), // bold, by default
separatorColor: col('crimson'), gap: pt(GAP), marginTop: pt(LEAD / 2), marginBottom: pt(0),
itemSpacing: pt(5), numberWidth: 'level', // 5 pt to the options or next part; text after '10.'
levels: [{ level: 1, fontSize: pt(NUMBER) }, // 'arabic' and '.', the defaults
{ level: 2, numberFormat: 'lower-alpha', separator: ')' },
{ level: 3, numberFormat: 'lower-roman', separator: ')' }] };
// Options: a bulletless item at the questions' depth, '10.' plus GAP in (boxes set their own).
const width = (s) => { const ctx = new OffscreenCanvas(1, 1).getContext('2d');
ctx.font = `700 ${NUMBER}pt "${LABEL}"`; return ctx.measureText(s).width * 0.75; }; // pt
const unorderedLists = () => ({ gap: pt(0), marginTop: pt(0), marginBottom: pt(0),
itemSpacing: pt(LEAD), // after the options: a line before the next question
indent: pt(width('10') + width('.') + GAP), levels: [{ level: 1, bulletChar: '' }] });
Cada nivell d'orderedLists té el seu propi numberFormat i el seu separator; separatorColor posa en el color d'accent el punt i el parèntesi de tancament, i el número queda en negre (llistes numerades). Amb numberWidth: 'level' els números s'alineen a la dreta amb el més ample del seu nivell, de manera que el text de totes les preguntes comença a 23 pt: els 17 pt de «10.» més GAP. Les quatre opcions formen un element de llista no ordenada amb bulletChar buit, al mateix nivell que les preguntes i no niat dins seu. El seu text comença a l'indent de la llista, que és l'amplada de «10.» mesurada en la font dels números més GAP, i així les opcions queden sota la primera lletra de la pregunta amb qualsevol tipus de lletra; el requadre d'instruccions fixa indent: pt(0), perquè les llistes d'un requadre prenen el sagnat del document. Entre dos elements del mateix nivell la separació és l'itemSpacing del primer: 5 pt després d'un element numerat, 15 pt després d'una línia d'opcions. Niada dins la seva pregunta, la línia d'opcions prendria els 5 pt de la llista de preguntes a banda i banda.
#2 · Fes les bombolles i les puntuacions amb xips
// A chip is 0.8 em above the baseline and 0.25 em below, plus paddingY and the border on each
// side: 1.29 em and two borders. One capital is 0.63–0.72 em wide, so paddingX 0.3 em (and the
// same two borders) squares the box; a radius over half its smaller side is clamped to that half.
const chip = (id, look) => ({ id, fontFamily: LABEL, fontSize: em(0.8), bold: true,
paddingY: em(0.12), ...look });
const bubble = (id, fill, ink, edge = 'crimson') => chip(id, { color: col(ink), paddingX: em(0.3),
background: col(fill), borderColor: col(edge), borderWidth: pt(0.7), borderRadius: em(1) });
const chipStyles = [bubble('bubble', 'paper', 'crimson'), // first: a bare :chip[A] takes it
bubble('filled', 'ink', 'paper', 'ink'), chip('marks', { color: col('crimson'),
background: col('blush'), borderWidth: pt(0), paddingX: em(0.45), gap: em(0.5) })];
Un xip és una caixa en línia, i un salt de línia no hi cau mai a dins (xips en línia). Amb una sola majúscula a dins, paddingX: em(0.3) deixa la caixa gairebé tan ampla com alta: a la plantilla, de 4,5 a 4,8 mm d'amplada per 4,7 mm d'alçada. borderRadius: em(1) supera la meitat de la caixa, i com que el radi d'un xip es limita a la meitat del seu costat menor, els extrems queden arrodonits del tot. Un xip sense style fa servir el primer estil de chipStyles, de manera que les vuitanta bombolles, quaranta a la plantilla i quaranta a les opcions, s'escriuen sense estil, com :chip[A]; només l'exemple omplert de les instruccions i les puntuacions n'indiquen un. La puntuació va alineada a la dreta: cada apartat acaba amb :tab abans del seu xip, i l'única tabulació del cos, al final de la mesura amb align: 'end', fa que el xip hi acabi (tabuladors i tabulacions). Els elements de llista de les preguntes prenen les tabulacions del cos, de manera que els xips de a) i de i) acaben al mateix lloc. Un apartat que a l'última línia ja no té lloc per al xip s'emporta l'última paraula a la línia següent amb el xip.
#3 · Dona a cada formulari el seu estil de taula
// No table has a header row; the flag keeps the default grey fill off one added later.
const form = { bodyFontFamily: LABEL, borderRadius: mm(2), headerBackgroundEnabled: false };
const tableStyles = [lines,
{ ...form, id: 'candidate', rules: 'grid', borderColor: col('rule'), borderWidth: pt(0.75),
bodyFontSize: pt(7.5), bodyColor: col('crimson'), cellPadding: mm(1.8) },
// No rules: the tint of each cell meets its neighbours' and the grid reads as one panel.
{ ...form, id: 'grid', rules: 'none', bodyBackgroundEnabled: true,
bodyBackground: col('tint'), bodyFontSize: pt(11.5), cellPadding: mm(1.4) }];
const cell = (content, extra) => ({ content, align: 'center', verticalAlign: 'middle', ...extra });
// The MARK cell sets the row's depth: three lines, the blank one a no-break space.
const candidate = table('candidate', 'candidate', { columnWidths: [4.2, 1.2, 2, 1.3], rows: [[
...t({ en: ['NAME', 'CLASS', 'CANDIDATE NUMBER'], es: ['NOMBRE Y APELLIDOS', 'GRUPO',
'N.º DE EXAMEN'] }).map((l) => cell(`**${l}**`, { align: 'left', verticalAlign: 'top' })),
cell(`**${t({ en: 'MARK', es: 'NOTA' })}**\n\u00A0\n**/ ${t({ en: '25', es: '10' })}**`,
{ align: 'right', background: col('tint') })]] });
const GROUP = ['A', 'B', 'C', 'D'].map((l) => cell(`:chip[${l}]`)), num = (n) => cell(`**${n}**`);
const grid = { ...table('grid', 'grid', { columnWidths: [0.7, 1, 1, 1, 1, 1.4, 0.7, 1, 1, 1, 1],
rows: [1, 2, 3, 4, 5].map((n) => [num(n), ...GROUP, cell(''), num(n + 5), ...GROUP]) }),
caption: t({ en: '**Section A answer grid**', es: '**Parte A: plantilla de respuestas**' }) };
// The grid's title is its caption: a heading would stand a body line off any 'here' table.
const captionStyle = { fontFamily: LABEL, fontSize: pt(9.4), color: col('crimson'),
position: 'above', gap: mm(1.6) }; // the rubric's size
Les caselles de l'alumne, la plantilla de bombolles i les ratlles són tres tableStyles, que cada taula tria amb styleId (estils de taula amb nom). Les ratlles de la resposta curta fan servir rules: 'horizontal' i un farciment que dona a cada fila l'alçada de dues línies del text, de manera que cada filet cau 30 pt (10,6 mm) per sota de l'anterior, sobre una de cada dues línies de la retícula de base de 15 pt. La línia del centre de la casella NOTA, que va en blanc, porta un espai no separable, perquè una línia de cel·la buida o amb només espais corrents no hi afegeix res: aquesta cel·la ocupa tres línies i fixa l'alçada de tota la fila en 14,4 mm, enfront de 10,8 mm amb dues línies. La plantilla no porta filets: el rosa de cada cel·la arriba fins al de la veïna i la plantilla es llegeix com un sol plafó. El rètol de la plantilla és un peu col·locat 1,6 mm per sobre (estil dels peus de recurs). Un títol quedaria com a mínim una línia de text (5,3 mm) més amunt, perquè tota taula col·locada amb 'here' deixa aquest espai al damunt. El tipus form té el captionPrefix buit, i per això el títol no porta al davant una etiqueta «Form 1.».
#4 · Dibuixa la portada amb els atributs del títol
const BAND = 116; // mm: the crimson band, bled off the top and both sides
const YEAR = { cap: 62, cut: 12, pad: 2 }; // mm: the digits' cap height; the band cuts 12 off
// span 'page' makes the cover an opener page, which the body pages' furniture skips.
const cover = { id: 'cover', span: 'page', margins: { right: mm(LEFT) }, // forms full width
advancedDesign: { enabled: true, slot: { elements: [ // the date line sets the height
{ kind: 'box', id: 'band', style: { backgroundColor: col('crimson') },
placement: at(0, 0, { width: mm(PAGE.w), height: mm(BAND) }) },
// Design text has no outline, so the year is an image, cut off by the band's foot.
{ kind: 'image', id: 'year', resourceId: 'year', placement: at(0, BAND - YEAR.cap
+ YEAR.cut - YEAR.pad, { width: mm(PAGE.w), height: mm(YEAR.cap - YEAR.cut + YEAR.pad) }) },
text('session', '{attr.session}', LABEL, 8.5, 600, 'blush', at(LEFT, 14), tag),
// 0.9 mm to the left: the H's side bearing at 64 pt (84 of 2048 units), so its stem aligns.
text('title', '{titleText}', LABEL, 64, 800, 'paper', at(LEFT - 0.9, 19), { lineHeight: 1 }),
text('paper', '{attr.paper}', LABEL, 15, 700, 'paper', at(LEFT, 44)),
text('topic', '{attr.topic}', TEXT, 15, 400, 'blush', at(LEFT, 52), { italic: true }),
text('date', '{attr.date}', LABEL, 9.5, 700, 'ink', at(LEFT, BAND + 6))] } } };
La portada és un sol títol, # Historia {style="cover" …}, i el seu estil dibuixa la banda, l'any i quatre línies de text que pren dels atributs del títol. Amb span: 'page', la pàgina compta com a obertura, de manera que el filet del marge, el foli i «Pasa la página» de les altres pàgines no hi surten i l'avís va al seu peu. Sense això, la portada és una pàgina corrent més. Els margins de l'estil eixamplen la columna de la portada fins als 168 mm per als formularis, i el títol següent, un de nivell 1 sense estil, torna les altres pàgines a la mesura de 134 mm.
#5 · Deixa la portada sense foli ni «Gira el full»
const [MARGIN, FOOT] = [LEFT + MEASURE + 7, -13]; // mm: the margin rule, 7 off the text; the foot
const body = { pages: 'body', ...tag }; // body pages only: never the cover
const NOTE = t({ en: 'Do not write in this margin', es: 'No escribas en este margen' });
const header = { elements: [
text('running', '{title} · {chapterTitle}', LABEL, 7.5, 600, 'muted', at(LEFT, 12), body),
{ kind: 'rule', id: 'margin', direction: 'vertical', pages: 'body', color: col('rule'),
thickness: pt(0.75), placement: at(MARGIN, TOP, { height: mm(PAGE.h - TOP - BOTTOM) }) },
text('note', NOTE, LABEL, 7.5, 600, 'muted', at(MARGIN + 3, TOP, { width: mm(28) }),
{ ...body, lineHeight: 1.3 })] };
const footer = { elements: [
text('notice', '{attr.notice}', LABEL, 8.5, 700, 'crimson', at(0, FOOT, { width: mm(PAGE.w) },
'bottom-left'), { pages: 'opener', align: 'center', ...tag }), // from the cover's H1
text('folio', '{pageNumber}', LABEL, 9, 700, 'ink', at(LEFT, FOOT, { width: mm(MEASURE) },
'bottom-left'), { ...body, align: 'center' }), // centred under the text
text('turn', t({ en: 'Turn over ›', es: 'Pasa la página ›' }), LABEL, 9, 700, 'ink', // rectos
at(-RIGHT, FOOT, null, 'bottom-right'), { ...body, parity: 'odd', align: 'right' })] };
Tots els elements fixos de les pàgines de cos porten pages: 'body', de manera que la portada, que és una obertura, només mostra el seu avís (pages: 'opener'). Per això cada part comença amb :::pagebreak i un títol sense breakBefore. Un títol que salta de pàgina converteix la seva en obertura, i les pàgines 2 i 3 perdrien el foli, la capçalera i el marge. parity: 'odd' deixa «Gira el full» a la pàgina senar, perquè la pàgina parella ja té al davant la següent.
La recepta completa
// ═══ Postext Cookbook · Nº 049 · Exam paper with an answer sheet ═════════════════
// https://postext.dev/en/cookbook/exam-paper
// Code: MIT · Text: Lincoln (PD); questions, Spanish translation (CC BY 4.0) · Art: in code
// Fonts: PT Serif, Inter Tight (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage, inlineSvgFonts,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'exam-paper';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { ink: '#1b1a1f', paper: '#ffffff', muted: '#6b6466', // heads, credits: 5.8:1
crimson: '#9b1c31', // the one accent: cover, numbering, bubbles, marks (8.1:1 on white)
blush: '#f3cdd4', tint: '#fbeff1', // type on the band, marks chips; the grid, the rubric box
rule: '#b9aeb0' }; // answer lines and hairlines
// col(id): a colour linked to its palette entry, with the entry's hex beside the id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults are linked to 'main-color': point it at the accent.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.crimson })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, LABEL, PAGE] = ['PT Serif', 'Inter Tight', { w: 215.9, h: 279.4 }]; // US Letter
const [TOP, BOTTOM, LEFT, MEASURE] = [22, 24, 24, 134]; // mm; 134 mm: about 75 characters
const RIGHT = PAGE.w - LEFT - MEASURE; // 57.9 mm: the examiner's margin, never mirrored
const [BODY, LEAD] = [11, 15]; // pt: text size and leading, the grid every line keeps to
const at = (x, y, size, edge = 'top-left') => ({ anchor: { to: 'page', edge },
offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });
const text = (id, content, family, size, weight, color, placement, extra) => ({ kind: 'text',
id, content, fontFamily: family, fontSize: pt(size), fontWeight: weight, color: col(color),
align: 'left', overflow: 'wrap', placement, ...extra });
const tag = { textTransform: 'uppercase', letterSpacing: pt(1.4) }; // 0.16–0.19 em
const small = { fontFamily: LABEL, fontSize: pt(7.5), lineHeight: pt(10), color: col('muted') };
// #region answer: ruled answer lines: a table whose rows are two body lines deep
// A table row is one line (the table's size × the body's leading ratio) plus cellPadding above
// and below: at the body size, (ROW − LEAD) / 2 of padding makes every row ROW deep, so the
// rules keep to the text's 15 pt grid, 10.6 mm apart: room for handwriting.
const ROW = 2 * LEAD; // pt
const lines = { id: 'lines', rules: 'horizontal', // a rule on the top and foot of every row
borderColor: col('rule'), borderWidth: pt(0.5), bodyFontFamily: LABEL, bodyFontSize: pt(BODY),
bodyColor: col('crimson'), cellPadding: pt((ROW - LEAD) / 2) };
// Every table in this paper is set 'here': where its ::resource directive stands in the text.
const table = (id, styleId, model) => ({ id, typeId: 'form', kind: 'table', createdAt: 0,
updatedAt: 0, placement: { position: 'here' }, table: { styleId, model } });
// One table per answer, the part's number in its first margin cell.
const answerLines = (id, part, rows) => table(id, 'lines', { columnWidths: [1, 5], rows: Array
.from({ length: rows }, (_, i) => [{ content: i ? '' : `**${part}**` }, { content: '' }]) });
// #endregion
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
#Imprimeix-lo en A4
La banda, l'any, el filet del marge i l'avís prenen les mides de PAGE, així que passar a A4 és canviar una línia. Els blocs de la portada no es mouen i el blanc sota la plantilla creix 17,6 mm en les dues edicions.
-const [TEXT, LABEL, PAGE] = ['PT Serif', 'Inter Tight', { w: 215.9, h: 279.4 }]; // US Letter
+const [TEXT, LABEL, PAGE] = ['PT Serif', 'Inter Tight', { w: 210, h: 297 }]; // A4#Afegeix un banc de paraules o una llista de comprovació
Els bancs de paraules, els buits i els cercles per pintar també són xips: la fitxa amb caixes de resposta i banc de paraules compon un banc de xips grocs dins d'un requadre niat i una llista de comprovació que obre cada línia amb un cercle buit.
Errors freqüents
Error freqüent
Un $ sol obre matemàtiques: escriu \$
El signe de dòlar obre matemàtiques en línia, de manera que un preu com $40 comença una fórmula. Escriu \$40. Escapaments i caràcters literals →
- Posar ratlles entre els apartats d'una pregunta en parteix la llista: la llista que segueix la taula comença un tram nou, i cada tram alinea els seus números amb el més ample dels seus, de manera que el text de ii) començaria 1 mm a la dreta del d'i). Aquí les respostes van en una pàgina pròpia i tots els apartats queden en una sola llista.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- The Gettysburg Address (19 November 1863), text of the Bliss copy · Abraham Lincoln · domini públic
- The questions, the instructions and the Spanish translation of Source A · Ignacio Ferro · CC BY 4.0
- Fonts
- PT Serif (SIL OFL 1.1) · Inter Tight (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)


