Saltar al contenido principal
Receta número 49

Recetario · Capítulo 6 · Recuadros y notas

Examen con hoja de respuestas

Un examen de historia de cuatro páginas: burbujas y puntos en chips, la puntuación en una tabulación, preguntas numeradas 1, a), i) y renglones de una tabla.

  • Formato 215,9 × 279,4 mm
  • 1 columna
  • PT Serif 11/15
  • Inter Tight
  • 4 páginas
  • Nivel
  • Postext 1.57.1
  • Compuesto en 60 ms
  • 180 líneas de código

En pocas palabras

Un examen de historia de cuatro páginas con portada, burbujas para marcar y renglones para escribir. Enseña a numerar preguntas y apartados y a mostrar la puntuación de cada uno.

Lo que vas a componer

La prueba 2 de un simulacro de examen de historia sobre la guerra de Secesión, en un cuadernillo de cuatro páginas en tamaño carta. La portada abre con una banda carmesí y el año 1863 dibujado en contorno; debajo van las casillas del alumno, las instrucciones a dos columnas y la plantilla de burbujas de la parte A. En la página 2 hay diez preguntas tipo test, cada una con sus cuatro opciones debajo, y cada opción empieza por una burbuja con su letra, como las de la plantilla. La página 3 recoge el discurso de Gettysburg como fuente A y, tras él, las preguntas numeradas 11, a), i), con la puntuación de cada apartado en un chip junto al margen derecho. La página 4 es para las respuestas: un renglón cada dos líneas de texto, en grupos que empiezan por el número de su apartado. Tras la portada, cada página lleva folio y un margen para el corrector, y la única impar de ellas dice «Pasa la página».

Esta receta responde a

  • ¿Cómo hago una ficha de ejercicios: líneas para rellenar, cajas de respuesta, bancos de palabras, listas de comprobación?
  • ¿Cómo personalizo las listas: viñetas por nivel, numeración (a)/(i), casillas de tareas y un espaciado que respete la rejilla?
  • ¿Cómo hago chips en línea: teclas, etiquetas, bancos de palabras para ejercicios?
  • ¿Cómo doy estilos distintos a varias tablas (rellenos, filas alternas, marcos redondeados) en un mismo documento?
  • ¿Cómo oculto las cabeceras en las aperturas y las páginas en blanco, o pinto una página par en blanco con el color de la parte?

La respuesta corta

script.js · líneas 35–47en el código completo
// 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: '' }]) });

Ingredientes

Tipografía
PT Serif, Inter Tight (SIL OFL 1.1)
Recursos
Ninguno: todas las imágenes se dibujan en código

Elaboración

#1 · Numera las preguntas y pon sus opciones debajo

script.js · líneas 51–63en el código completo
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 nivel de orderedLists tiene su propio numberFormat y su separator; separatorColor pone en el color de acento el punto y el paréntesis de cierre, y el número queda en negro (listas ordenadas). Con numberWidth: 'level' los números se alinean a la derecha con el más ancho de su nivel, así que el texto de todas las preguntas empieza a 23 pt: los 17 pt de «10.» más GAP. Las cuatro opciones forman un elemento de lista no ordenada con bulletChar vacío, al mismo nivel que las preguntas y no anidado en ellas. Su texto empieza en el indent de la lista, que es el ancho de «10.» medido en la fuente de los números más GAP, y así las opciones quedan bajo la primera letra de la pregunta con cualquier tipo de letra; el recuadro de instrucciones fija indent: pt(0), porque las listas de un recuadro toman la sangría del documento. Entre dos elementos del mismo nivel la separación es el itemSpacing del primero: 5 pt tras un elemento numerado, 15 pt tras una línea de opciones. Anidada en su pregunta, la línea de opciones tomaría los 5 pt de la lista de preguntas a ambos lados.

#2 · Haz las burbujas y las puntuaciones con chips

script.js · líneas 67–76en el código completo
// 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 chip es una caja dentro de la línea, y un salto de línea nunca cae en su interior (chips en línea). Con una sola mayúscula dentro, paddingX: em(0.3) deja la caja casi tan ancha como alta: en la plantilla, de 4,5 a 4,8 mm de ancho para 4,7 mm de alto. borderRadius: em(1) pasa de la mitad de la caja, y como el radio de un chip se limita a la mitad de su lado menor, los extremos quedan redondeados del todo. Un chip sin style toma el primer estilo de chipStyles, de modo que las ochenta burbujas, cuarenta en la plantilla y cuarenta en las opciones, se escriben sin estilo, como :chip[A]; solo el ejemplo relleno de las instrucciones y las puntuaciones indican uno. La puntuación va alineada a la derecha: cada apartado termina con :tab antes de su chip, y la única tabulación del texto base, al final de la medida con align: 'end', hace que el chip termine allí (tabuladores y tabulaciones). Los elementos de lista de las preguntas toman las tabulaciones del texto base, así que los chips de a) y de i) terminan en el mismo punto. Un apartado cuya última línea ya no tiene sitio para el chip baja su última palabra a la línea siguiente junto con él.

#3 · Da a cada formulario su estilo de tabla

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

Las casillas del alumno, la plantilla de burbujas y los renglones son tres tableStyles, que cada tabla elige con styleId (estilos de tabla con nombre). Los renglones de la respuesta corta usan rules: 'horizontal' y un relleno que da a cada fila la altura de dos líneas del texto, así que cada filete cae 30 pt (10,6 mm) por debajo del anterior, sobre una de cada dos líneas de la rejilla base de 15 pt. La línea del centro de la casilla NOTA, que va en blanco, lleva un espacio de no separación, porque una línea de celda vacía o con solo espacios corrientes no añade nada: esa celda ocupa tres líneas y fija la altura de toda la fila en 14,4 mm, frente a 10,8 mm con dos líneas. La plantilla no lleva filetes: el rosa de cada celda llega hasta el de la vecina y la plantilla se lee como un solo panel. El rótulo de la plantilla es un pie colocado 1,6 mm por encima (estilo de pies de recurso). Un título quedaría al menos una línea de texto (5,3 mm) más arriba, porque toda tabla colocada con 'here' deja ese espacio encima. El tipo form tiene el captionPrefix vacío, y por eso el rótulo no lleva delante una etiqueta «Form 1.».

#4 · Dibuja la portada con los atributos del título

script.js · líneas 105–120en el código completo
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 es un solo título, # Historia {style="cover" …}, y su estilo dibuja la banda, el año y cuatro líneas de texto que toma de los atributos del encabezado. Con span: 'page', la página cuenta como apertura, así que el filete del margen, el folio y «Pasa la página» de las demás páginas no salen en ella y el aviso va en su pie. Sin él, la portada es una página corriente más. Los margins del estilo ensanchan la columna de la portada hasta los 168 mm para los formularios, y el título siguiente, uno de nivel 1 sin estilo, devuelve las demás páginas a la medida de 134 mm.

#5 · Deja la portada sin folio ni «Pasa la página»

script.js · líneas 124–139en el código completo
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' })] };

Todos los elementos fijos de las páginas de cuerpo llevan pages: 'body', de modo que la portada, que es una apertura, solo muestra su aviso (pages: 'opener'). Por eso cada parte empieza con :::pagebreak y un título sin breakBefore. Un título que salta de página convierte la suya en apertura, y las páginas 2 y 3 perderían el folio, la cabecera y el margen. parity: 'odd' deja «Pasa la página» en la página impar, porque la página par ya tiene enfrente la siguiente.

La receta completa

Sandbox
// ═══ 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

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

#Imprímelo en A4

La banda, el año, el filete del margen y el aviso toman sus medidas de PAGE, así que pasar a A4 es cambiar una línea. Los bloques de la portada no se mueven y el blanco bajo la plantilla crece 17,6 mm en las dos ediciones.

-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

#Añade un banco de palabras o una lista de comprobación

Los bancos de palabras, los huecos y los círculos para colorear también son chips: la ficha con cajas de respuesta y banco de palabras compone un banco de chips amarillos dentro de un recuadro anidado y una lista de comprobación que abre cada línea con un círculo vacío.

Errores frecuentes

Error frecuente

Un $ suelto abre matemáticas: escribe \$

El signo de dólar abre matemáticas en línea, así que un precio como $40 empieza una fórmula. Escribe \$40. Escapes y caracteres literales →

  • Poner renglones entre los apartados de una pregunta parte su lista: la lista que sigue a la tabla empieza un tramo nuevo, y cada tramo alinea sus números con el más ancho de los suyos, así que el texto de ii) empezaría 1 mm a la derecha del de i). Aquí las respuestas van en su propia página y todos los apartados quedan en una sola lista.

Créditos

Texto
  • El discurso de Gettysburg (19 de noviembre de 1863), texto de la copia Bliss · Abraham Lincoln · dominio público
  • Las preguntas, las instrucciones y la traducción al español de la fuente A · Ignacio Ferro · CC BY 4.0
Fuentes
PT Serif (SIL OFL 1.1) · Inter Tight (SIL OFL 1.1)
Sandbox