Pular para o conteúdo principal
Receita número 22

Receitas · Capítulo 6 · Boxes e notas

Atividade com caixas de resposta e banco de palavras

Uma folha de ciências de quatro páginas: caixas de resposta brancas em cartões verde-claros, 2 mm abaixo de cada pergunta e fora da grade, e lacunas em chips.

  • Amostra em inglês: ainda sem edição em português
  • Refile 200 × 260 mm
  • 1 coluna
  • Andika 12/17
  • Baloo 2
  • Fredoka
  • 4 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 57 ms
  • 185 linhas de código

Em poucas palavras

Uma folha de atividades de ciências para crianças de oito anos, sobre as partes de uma planta. Cada pergunta tem embaixo um quadro para a resposta, e algumas frases têm lacunas para completar com uma lista de palavras.

O que você vai compor

A folha 3A de Seedlings Science, uma coleção inventada para crianças de oito anos, em quatro páginas de 200 × 260 mm impressas de um lado só. Uma faixa verde-folha traz a unidade numa pílula amarela, o título e campos brancos para nome e data; ao lado, um pé de ervilha em aquarela, dentro de um disco branco, tem as seis partes numeradas em amarelo. A aquarela foi gerada com modelos de difusão e já chega recortada no disco, em dois JPEGs que se encontram na borda da faixa: o de cima tem o verde da faixa nos cantos, e o de baixo, branco; os números e as linhas de chamada continuam em código, por cima da imagem. Cada atividade é um título numerado sobre um cartão verde-claro. Os cartões trazem caixas de resposta brancas com uma pequena indicação cinza e espaço para várias linhas, bancos de palavras em chips amarelos, lacunas contornadas dentro das frases, uma tabela de alimentos para ligar às partes da planta e uma lista de círculos para colorir. Cada caixa de resposta fica 2 mm abaixo da pergunta e 5 mm acima do que vem depois, e cada cartão termina 9 mm acima do que vier em seguida na página. O texto é composto em Andika, que a SIL desenhou para crianças em alfabetização.

Esta receita responde a

  • Como aninho boxes, como uma ficha de exercícios com caixas de resposta, com espaçamento exato?
  • Como monto uma ficha de exercícios: linhas para preencher, caixas de resposta, bancos de palavras, listas de verificação?
  • Como faço chips em linha: teclas, etiquetas, bancos de palavras para exercícios?
  • Como coloco imagens ou ícones dentro das células de uma tabela?

A resposta curta

script.js · linhas 25–57no 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

Tipografia
Andika, Baloo 2, Fredoka (SIL OFL 1.1)
Materiais
  • 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)

Preparo

#1 · Tirar também os títulos da grade

script.js · linhas 162–170no 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 },
    ] },

Na resposta curta, as margens de cada caixa se fundem com as das vizinhas, e a maior prevalece. Os 5 mm de um banco de palavras vencem os 2 mm acima da lista que vem embaixo, e os 5 mm da última caixa de resposta caem dentro dos 5 mm de preenchimento inferior do cartão, em vez de se somarem a eles. Na grade, um título de nível 2 reserva entre 10,8 e 14,1 mm em vez dos 8,6 mm do disco, porque o que vem depois volta para a linha de 17 pt seguinte; headings.snapToGrid: false mantém a reserva em 8,6 mm. Pôr snapToGrid nos estilos aninhados não muda nada, porque só o cartão externo pode sair da grade (boxes aninhados). O equilíbrio de colunas está desativado porque ele acrescenta espaço acima dos títulos para preencher a página; na página 2, poria 33 mm acima da atividade 3 em vez de 9.

#2 · Fazer de cada lacuna um chip

script.js · linhas 61–75no 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) }),
];

Um chip é uma caixa inquebrável na linha, e o preenchimento dele é pintado para além da linha sem deixá-la mais alta. Um banco de palavras é uma fileira de chips num boxe aninhado bank. As lacunas, os pontos para ligar e os círculos para colorir também são chips, cada um escrito :chip[ ]: um chip com um espaço é uma caixa vazia, feita de preenchimento e contorno (chips em linha). paddingX define a largura: uma lacuna tem 34 mm dentro de uma frase e 38 mm sozinha numa coluna, e um círculo ganha de cada lado metade da altura de 1,25 em. Na lista de verificação, o círculo fica onde estaria o marcador (bulletChar: ''). Com 19,6 pt, uma lacuna é mais alta que a linha de 17 pt, e por isso cada uma tem um item de lista só para ela, a 24 pt do seguinte.

#3 · Numerar as atividades com um desenho de título

script.js · linhas 79–93no 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] } } };

Um título de nível 2 com advancedDesign mantém o lugar na coluna, e o design é desenhado no lugar do texto: um disco com {number}, que imprime o numberingTemplate do nível, e {titleText} à direita (span e design avançado). O disco e o título têm 8,6 mm de altura, e fora da grade o título reserva exatamente isso, por isso o design não precisa de minHeight. Como os números vêm do contador do nível 2, uma atividade inserida no Markdown renumera as que vêm depois. O título da autoavaliação usa um estilo com numbered: false, que o deixa fora da contagem, e uma estrela em SVG fica onde estaria o disco.

#4 · Pôr os desenhos nas células da tabela

script.js · linhas 131–147no 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 desenha um recurso dentro da célula, aqui com 76 % da largura da célula, e a linha cresce para caber. verticalAlign: 'middle' centraliza em relação ao desenho o nome do alimento, os pontos e o chip. A coluna mais larga, 31 % da tabela, fica vazia para o aluno traçar a linha. O estilo nomeado arredonda a moldura da tabela e recorta nela o preenchimento branco do corpo. Ele não desenha fios, por isso o painel é só o preenchimento branco (estilos de tabela nomeados). O tipo de recurso dela tem captionPrefix vazio, e a tabela não tem texto de legenda, de modo que nenhuma legenda sai embaixo. placement: { position: 'here' } põe a tabela onde está a linha ::resource, dentro do cartão. Um boxe deixa sobre uma tabela assim uma linha do próprio texto, 6 mm aqui; layout.inlineResourceGapInBoxes: false desativa isso, e um :::space{lines=0.33} antes da linha ::resource põe os 2 mm que as caixas de resposta mantêm sob a pergunta.

A receita 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 = 'en'; // @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 });

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Devolver os cartões à grade

Com o padrão snapToGrid: true, o que vem depois de um cartão desce para a linha seguinte da grade de 17 pt, e os 9 mm sob cada cartão viram 14,5 mm sob a atividade 2, 13,2 mm sob a atividade 4 e 11,2 mm sob a atividade 6.

-  snapToGrid: false,
+  snapToGrid: true,

#Dar mais espaço a uma resposta

:::space conta em linhas de 17 pt da própria caixa de resposta, e cada linha a mais dá ao aluno 6 mm a mais para escrever.

 Write here
-:::space{lines=4}
+:::space{lines=6}

Erros comuns

Erro comum

:::space é descartado no topo de um boxe ou de uma coluna

:::space é descartado no topo de uma coluna, de um grupo :::columns, de um boxe sem título que tenha outro conteúdo e da continuação de um boxe dividido. Desde o postext 1.5, um boxe feito só de :::space tem a altura que o espaço pede (um boxe de resposta, lugar para escrever), e o espaço logo abaixo do título de um boxe desce o corpo nessa mesma altura. Para abrir com espaço um boxe sem título, dê a ele um título ou uma primeira linha e acrescente o espaço depois. Espaço vertical explícito →

Erro comum

Um boxe aninhado ignora span, placement e snapToGrid

Um boxe aninhado em outro ignora seus span, placement, snapToGrid e floatBarrier: ele sempre é composto dentro do boxe que o contém, com a largura interna deste. Boxes aninhados →

Erro comum

Chips mais altos que a entrelinha encostam na linha seguinte

Um chip cuja caixa é mais alta que a entrelinha encosta nos chips da linha seguinte (o aviso chipOverlap). Reduza o preenchimento vertical, a borda ou o tamanho do chip, ou aumente a entrelinha. Chips no texto →

Verificação do Sandbox · chipOverlap

Chips encostam na linha vizinha

Por quê. A caixa de um estilo de chip é mais alta que a entrelinha; por isso, os chips de linhas consecutivas se tocam.

Correção. Reduza o preenchimento vertical, o contorno ou o tamanho do chip, ou aumente a entrelinha. Docs →

  • Um boxe não consegue pautar as próprias linhas de escrita, porque os estilos de boxe não têm fundo pautado. As caixas de resposta ficam em branco e tiram a altura de :::space, e as linhas curtas de completar são chips contornados.
  • Um estilo de título com numbered: false continua desenhando o design do nível, com {number} vazio. Sem um design próprio, a autoavaliação abriria com um disco verde vazio, por isso review copia o design das atividades e põe a estrela onde ficava o disco.

Créditos

Texto
Texto original, CC BY 4.0
Imagens
  • 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
Fontes
Andika (SIL OFL 1.1) · Baloo 2 (SIL OFL 1.1) · Fredoka (SIL OFL 1.1)
Sandbox