Em poucas palavras
Três páginas de uma cartilha em inglês para crianças pequenas, dedicadas à letra M. Cada som de uma palavra fica numa etiqueta colorida, e cada palavra da grade tem o desenho.
O que você vai compor
A unidade 12 de Letter by Letter, uma cartilha inglesa inventada: três páginas sobre o som do m. A abertura põe um Mm em DynaPuff de 190 pt numa faixa creme, ao lado de duas coisas cujo nome em inglês começa com m, um macaco (monkey) e uma lua (moon). Cada palavra é dividida nos sons, e cada som é um chip na cor da vogal da palavra: a vermelho, e laranja, i verde-azulado, o azul, u roxo. O m é preenchido e os outros sons são só contornados, e assim a criança vê onde o som desta unidade cai em map e em gum. A página 38 traz seis palavras ilustradas numa grade arredondada, com uma aquarela em cada célula, e depois três linhas para cobrir. As aquarelas foram geradas com modelos de difusão; a faixa, os ícones e as linhas para cobrir são desenhados em código. A página 39 tem quatro frases em 24 pt, um box de palavras para colorir e um recado para pais e responsáveis.
A edição em espanhol é outra unidade, e não uma tradução: a unidade 7 de Letra a letra, sobre a mesma letra. O espanhol é ensinado por sílabas abertas (ma, me, mi, mo, mu), e por isso os chips dela guardam sílabas, {mi·mo·sa}. Essas sílabas não são palavras em inglês, e as cartilhas inglesas trabalham som por som; a unidade inglesa junta os sons de palavras curtas, {m·a·p}, e as agrupa em famílias que rimam (-at, -an, -ug, -op). As duas unidades saem do mesmo código: os mesmos estilos de chip, a mesma função syllables(), a mesma grade, as mesmas linhas para cobrir e os mesmos boxes.
Esta receita responde a
- 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?
- Como acrescento espaço vertical entre dois blocos, se as linhas em branco não fazem nada?
- Como monto uma ficha de exercícios: linhas para preencher, caixas de resposta, bancos de palavras, listas de verificação?
A resposta curta
// A word's syllables are chips with nothing between them, so their boxes touch and the white
// border draws the seam. Across a word space a chip keeps at least `gap`: 0.5 em sets the
// words of a 24 pt row 4.2 mm apart, where the space alone leaves 2.3 mm. Inside a sentence
// the '-frase' twins keep no gap, so the word space alone parts a chip from the word before.
// A 24 pt chip, padding and border included, is 10.4 mm tall (gotcha: chip-overlap).
const syllable = { fontFamily: TEXT, bold: true, borderWidth: pt(1), borderColor: col('paper'),
paddingX: em(0.26), paddingY: em(0.05), gap: em(0.5) };
const chipStyles = [
...'aeiou'.split('').flatMap((v) => [ // one pair per vowel
{ ...syllable, id: v, background: col(v), color: col('paper') }, // a syllable with m
{ ...syllable, id: `${v}-borde`, background: col('paper'), color: col(v), borderColor: col(v) },
]).flatMap((style) => [style, { ...style, id: `${style.id}-frase`, gap: em(0) }]),
{ ...syllable, id: 'pinta', bold: false, background: col('paper'), color: col('ink'),
borderColor: col('ink'), borderWidth: pt(0.8) }, // an outline for the child to colour in
];
const vowel = (s) => s.normalize('NFD').toLowerCase().match(/[aeiou]/)[0]; // 'mú' → 'u'
const chipOf = (s, v, end) => `:chip[${s}]{style="${v}${/m/i.test(s) ? '' : '-borde'}${end}"}`;
// {mi·mo·sa} → :chip[mi]{style="i"}:chip[mo]{style="o"}:chip[sa]{style="a-borde"}, and a word
// written after another word, as in 'me {mi·ma}.', takes the '-frase' twins. A piece with no
// vowel, the m and the p of the English {m·a·p}, takes the vowel of its word.
const syllables = (text) => text.replace(/(\p{L} )?\{([\p{L}·]+)\}/gu, (_, before = '', word) =>
before + word.split('·').map((s) => chipOf(s, vowel(s + word), before && '-frase')).join(''));
Ingredientes
- Funcionalidades
- Chips no textoImagens nas células de tabelaAberturas desenhadasAtributos de títuloEstilos de títuloImagens nos designs de páginaTextos, fios e caixas nos designs de páginaAncoragem de elementos de designCabeços e fóliosEstilos de tabela com nomeEstilos de parágrafoEspaço vertical explícitoBoxesPaleta de cores semânticaFiguras e tabelas como recursosTipos de recurso personalizadosFiguras exatamente aquiPáginas em um canvas
- Tipografia
- Andika, DynaPuff, Playpen Sans (SIL OFL 1.1)
- Materiais
man-640.jpgmano-640.jpgmanzana-480.jpgmapa-640.jpgmariposa-660.jpgmat-640.jpgmesa-640.jpgmimosa-640.jpgmono-640.jpgmoon-480.jpgmop-640.jpgmud-640.jpgmug-640.jpgmuneca-640.jpg- A watercolour of the butterfly on the opener (Generated With Diffusion Models, original)
- A watercolour of the apple on the opener (Generated With Diffusion Models, original)
- A watercolour of the hand in the picture grid (Generated With Diffusion Models, original)
- A watercolour of the map in the picture grid of both units (Generated With Diffusion Models, original)
- A watercolour of the table in the picture grid (Generated With Diffusion Models, original)
- A watercolour of the mimosa sprig in the picture grid (Generated With Diffusion Models, original)
- A watercolour of the monkey: in the picture grid of the Spanish unit and on the opener of the English one (Generated With Diffusion Models, original)
- A watercolour of the doll in the picture grid (Generated With Diffusion Models, original)
- A watercolour of the moon on the opener of the English unit (Generated With Diffusion Models, original)
- A watercolour of the mat in the picture grid of the English unit (Generated With Diffusion Models, original)
- A watercolour of the man in the picture grid of the English unit (Generated With Diffusion Models, original)
- A watercolour of the mug in the picture grid of the English unit (Generated With Diffusion Models, original)
- A watercolour of the mop in the picture grid of the English unit (Generated With Diffusion Models, original)
- A watercolour of the mud in the picture grid of the English unit (Generated With Diffusion Models, original)
- The cream band, the activity icons and the tracing rows, drawn in code in the page’s palette (Ignacio Ferro, MIT)
Preparo
#1 · Um estilo de chip por vogal e uma função que escreve os chips
A resposta curta monta 21 estilos de chip espalhando um mesmo objeto, syllable. Há um estilo preenchido por vogal para o m, um contornado por vogal para os outros sons, um gêmeo -frase de cada um desses dez e pinta, o contorno em tinta que a criança pinta. syllables() transforma {m·a·p} em três :chip[…] sem nada entre eles, de modo que os sons de uma palavra se encostam e a borda branca desenha a emenda. Um chip leva a cor da vogal, e um pedaço sem vogal, aqui o m e o p, leva a da palavra, por isso map fica toda vermelha. Do outro lado de um espaço entre palavras, um chip mantém pelo menos o gap, e 0,5 em deixa as palavras de uma fileira de 24 pt a 4,2 mm uma da outra, onde o espaço sozinho deixaria 2,3 mm. Dentro de uma frase, esse vão quase dobraria o espaço antes da palavra nova, por isso uma palavra que vem depois de outra recebe os gêmeos -frase, cujo gap de 0 deixa o espaço de 2,3 mm como está. Na edição em espanhol os pedaços são sílabas, {mi·mo·sa}, e cada uma tem a vogal.
#2 · Uma entrelinha que dá espaço aos chips
// A 24 pt chip is 10.4 mm tall: at 30 pt (10.6 mm) leading the chips of two sentences would
// stand 0.1 mm apart, so every line the child reads has 45 pt, and the syllables 60 pt.
paragraphStyles: [
{ id: 'consigna', fontFamily: LABEL, fontSize: pt(10), lineHeight: pt(GRID),
color: col('muted') }, // the instruction under each activity
{ id: 'fila', fontSize: pt(34), lineHeight: pt(4 * GRID), textAlign: 'center' },
{ id: 'palabras', fontSize: pt(24), lineHeight: pt(3 * GRID), textAlign: 'center' },
{ id: 'lectura', fontSize: pt(24), lineHeight: pt(3 * GRID) },
{ id: 'colofon', fontSize: pt(7.5), lineHeight: pt(10), // Andika: Playpen has no italic
color: col('muted'), marginTop: pt(GRID) },
],
O enchimento vertical e a borda de um chip são pintados fora da linha e não somam entrelinha, de modo que um chip mais alto que o passo da linha esbarra nos chips da linha de baixo. Um chip de 24 pt tem 10,4 mm de altura; com entrelinha de 30 pt (10,6 mm), os chips de duas frases ficariam a 0,1 mm um do outro. As linhas que a criança lê recebem 45 pt e as fileiras de 34 pt da primeira atividade 60 pt, três e quatro linhas da grade de 15 pt das instruções.
#3 · Uma aquarela em cada célula
const PICTURE_WORDS = t({ en: ['m·a·p', 'm·a·t', 'm·a·n', 'm·u·g', 'm·o·p', 'm·u·d'],
es: ['ma·no', 'ma·pa', 'me·sa', 'mi·mo·sa', 'mo·no', 'mu·ñe·ca'] });
const tableStyles = [{ id: 'dibujos', borderRadius: mm(5), // the frame and its fills, rounded
headerBackgroundEnabled: false, // a header row added later would print grey (#f0f0f0)
bodyBackgroundEnabled: true, bodyBackground: col('cream'), // cream tiles…
rules: 'grid', borderColor: col('paper'), borderWidth: pt(4), // …parted by white rules
bodyFontSize: pt(20), cellPadding: mm(3) }]; // the words' chips are 20 pt
const cells = (row) => PICTURE_WORDS.slice(row * 3, row * 3 + 3)
.map((word) => ({ content: syllables(`{${word}}`), align: 'center' }));
let grid = { columnWidths: [1, 1, 1], rows: [cells(0), cells(1)] };
PICTURE_WORDS.forEach((word, k) => { // the picture above the word, 0.72 of the cell's width
const resourceId = word.replaceAll('·', '').replace('ñ', 'n');
grid = setCellImage(grid, { row: Math.floor(k / 3), col: k % 3 }, { resourceId, width: 0.72 });
});
setCellImage põe uma imagem acima do texto de uma célula, com uma fração da largura interna da célula, aqui 0,72 (36,5 mm), e a linha cresce para acomodá-la. Cada aquarela é um JPEG pintado sobre branco e multiplicado pelo creme dos ladrilhos, por isso ela assenta no ladrilho sem caixa em volta. Abaixo de cada aquarela vem a palavra em chips de som. Uma célula de tabela aceita marcação de chip como qualquer parágrafo. O estilo de tabela dibujos arredonda a moldura e os fundos em 5 mm e separa os ladrilhos creme com fios brancos de 4 pt.
#4 · Uma linha de espaço antes do box
calloutStyles: [
{ id: 'colorea', background: col('cream'), borderRadius: mm(4),
marginTop: pt(0), // the :::space before the box is the whole gap above it
padding: { top: mm(4), right: mm(5), bottom: mm(5), left: mm(5) },
titleStyle: { fontFamily: LABEL, fontSize: pt(15), fontWeight: 700, color: col('ink') },
body: { fontFamily: LABEL, fontSize: pt(10), lineHeight: pt(GRID), color: col('muted') } },
{ id: 'familia', backgroundEnabled: false,
stripe: { enabled: true, side: 'top', width: pt(2.5), color: col('rule') },
padding: { top: mm(3), right: mm(0), bottom: mm(0), left: mm(0) },
titleStyle: { fontFamily: LABEL, fontSize: pt(8.5), fontWeight: 700, color: col('ink'),
...tag },
body: { fontSize: pt(10.5), lineHeight: pt(GRID) } },
],
O Markdown põe :::space{lines=1} entre a última frase e o box para colorir, uma linha de 15 pt (5,3 mm). O marginTop do box é 0, por isso essa linha é todo o espaço; sem ela, o box começaria onde termina a linha da última frase. Um :::space que abre um box é descartado, de modo que o box começa com o enunciado e os chips da legenda de cores, e o próprio :::space vem depois deles, entre a legenda e a tarefa de colorir.
#5 · A abertura da letra
const THINGS = t({ en: ['monkey', 'moon'], es: ['mariposa', 'manzana'] }); // ids and labels
const BAND = 104; // mm: the depth of the band's drawing; its wave dips to 101.9 mm
// The opener reserves seventeen grid lines, the first grid line past the foot of the band's
// image, so the first activity title stands on the grid like the others: two lines under
// the band, its instruction right under it.
const opener = { enabled: true, minHeight: pt(17 * GRID),
slot: { elements: [
picture('band', 'banda', at(0, 0, { width: mm(210), height: mm(BAND) })),
words('unit', '{attr.unit}', LABEL, 9, 700, 'paper', at(SIDE, 12.5), { ...tag,
box: { backgroundColor: col('ink'), borderRadius: mm(3),
padding: { top: mm(1.2), right: mm(2.8), bottom: mm(1.2), left: mm(2.8) } } }),
words('kicker', '{attr.kicker}', LABEL, 8.5, 600, 'muted', // level with the pill's text
{ anchor: { to: '#unit', edge: 'right-of' }, offset: { x: mm(4), y: mm(1.4) } }, tag),
words('letter', '{titleText}', DISPLAY, 190, 700, 'ink', at(SIDE - 3, 19), { lineHeight: 1 }),
words('name', '{attr.name}', LABEL, 20, 600, 'ink', at(SIDE + 1, 76)),
picture('first', THINGS[0], at(146, 12, { width: mm(40) })),
picture('second', THINGS[1], at(151, 53, { width: mm(30) })),
...[45.5, 84.5].map((y, k) => words(THINGS[k], THINGS[k], LABEL, 10, 600, 'muted',
at(146, y, { width: mm(40) }), { align: 'center' })), // its name under each picture
] } };
O Mm é o texto do título ({titleText}); o número da unidade, a série e o nome sob a letra são atributos na mesma linha do título. A faixa, o macaco e a lua são imagens. A faixa tem 104 mm de altura, e a abertura reserva a página até a primeira linha da grade abaixo do pé dela, de modo que o título da primeira atividade começa a 118,5 mm, na grade e 16,6 mm abaixo do ponto mais baixo da onda (101,9 mm).
#6 · Ícones ao lado dos títulos das atividades
const ICON = 9; // mm
const H2 = { level: 2, marginBottom: pt(0), // two grid lines per title, and two above it
lineHeight: pt(2 * GRID), marginTop: pt(2 * GRID) };
const activity = (id, icon) => ({ id, advancedDesign: { enabled: true, slot: { elements: [
picture('icon', icon, { anchor: { to: 'container', edge: 'top-left' },
size: { width: mm(ICON), height: mm(ICON) } }),
words('title', '{titleText}', LABEL, 15, 700, 'ink', { anchor: { to: '#icon',
edge: 'right-of' }, offset: { x: mm(3) }, size: { width: mm(140), height: mm(ICON) } },
{ verticalAlign: 'middle' }), // centred on the icon
] } } });
Cada título de atividade indica o estilo de título, como em ## Read the sentences {style="lee"}, e o estilo desenha um ícone com o título centralizado ao lado. Os títulos continuam sendo de nível 2, por isso o nível H2 define o espaçamento: duas linhas da grade de lineHeight para o título e mais duas de marginTop acima dele.
A receita completa
// ═══ Postext Cookbook · Nº 060 · Early reader with syllable chips ════════════════
// https://postext.dev/en/cookbook/reading-primer-syllables
// Code: MIT · Text: original (CC BY 4.0) · Pictures: diffusion models · Icons: drawn in code
// Fonts: Andika, DynaPuff, Playpen Sans (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, prepareFonts, renderPageToCanvas, registerResourceImage, setCellImage,
} from 'https://esm.sh/postext';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'reading-primer-syllables';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { ink: '#242832', paper: '#ffffff', muted: '#5f6470', // text; instructions
cream: '#f6f0e3', rule: '#d3c9b6', // the band, the tiles and the pictures' ground; guides
// The vowel code: a syllable takes its vowel's colour. White on these fills measures
// 3.2–4.9:1, above WCAG's 3:1 for large text: the vowel chips are bold, 20 pt or more.
a: '#d9482b', e: '#dd740c', i: '#1f9a8f', o: '#3f6fd8', u: '#9152cf' };
// Every colour is linked to its palette entry by id.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
// The engine's defaults are linked to 'main-color': point it at the ink.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.ink })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, LABEL] = ['Andika', 'DynaPuff', 'Playpen Sans']; // Andika: one-storey a
const [TOP, SIDE, GRID] = [18, 20, 15]; // mm, mm, pt: every activity starts on the 15 pt grid
// #region answer: one chip style per vowel, and {ma·má} in the text written out as chips
// A word's syllables are chips with nothing between them, so their boxes touch and the white
// border draws the seam. Across a word space a chip keeps at least `gap`: 0.5 em sets the
// words of a 24 pt row 4.2 mm apart, where the space alone leaves 2.3 mm. Inside a sentence
// the '-frase' twins keep no gap, so the word space alone parts a chip from the word before.
// A 24 pt chip, padding and border included, is 10.4 mm tall (gotcha: chip-overlap).
const syllable = { fontFamily: TEXT, bold: true, borderWidth: pt(1), borderColor: col('paper'),
paddingX: em(0.26), paddingY: em(0.05), gap: em(0.5) };
const chipStyles = [
...'aeiou'.split('').flatMap((v) => [ // one pair per vowel
{ ...syllable, id: v, background: col(v), color: col('paper') }, // a syllable with m
{ ...syllable, id: `${v}-borde`, background: col('paper'), color: col(v), borderColor: col(v) },
]).flatMap((style) => [style, { ...style, id: `${style.id}-frase`, gap: em(0) }]),
{ ...syllable, id: 'pinta', bold: false, background: col('paper'), color: col('ink'),
borderColor: col('ink'), borderWidth: pt(0.8) }, // an outline for the child to colour in
];
const vowel = (s) => s.normalize('NFD').toLowerCase().match(/[aeiou]/)[0]; // 'mú' → 'u'
const chipOf = (s, v, end) => `:chip[${s}]{style="${v}${/m/i.test(s) ? '' : '-borde'}${end}"}`;
// {mi·mo·sa} → :chip[mi]{style="i"}:chip[mo]{style="o"}:chip[sa]{style="a-borde"}, and a word
// written after another word, as in 'me {mi·ma}.', takes the '-frase' twins. A piece with no
// vowel, the m and the p of the English {m·a·p}, takes the vowel of its word.
const syllables = (text) => text.replace(/(\p{L} )?\{([\p{L}·]+)\}/gu, (_, before = '', word) =>
before + word.split('·').map((s) => chipOf(s, vowel(s + word), before && '-frase')).join(''));
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
#Arredonde os chips em pílulas
Um raio maior que metade da altura do chip é limitado a essa metade, por isso um valor grande desenha pontas redondas. Um chip de uma letra só sai quase um círculo, e as emendas dentro de uma palavra viram entalhes.
- paddingX: em(0.26), paddingY: em(0.05), gap: em(0.5) };
+ paddingX: em(0.26), paddingY: em(0.05), gap: em(0.5), borderRadius: em(1) };Erros comuns
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 →
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 →
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 →
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imagens
- A watercolour of the butterfly on the opener · Generated With Diffusion Models · original
- A watercolour of the apple on the opener · Generated With Diffusion Models · original
- A watercolour of the hand in the picture grid · Generated With Diffusion Models · original
- A watercolour of the map in the picture grid of both units · Generated With Diffusion Models · original
- A watercolour of the table in the picture grid · Generated With Diffusion Models · original
- A watercolour of the mimosa sprig in the picture grid · Generated With Diffusion Models · original
- A watercolour of the monkey: in the picture grid of the Spanish unit and on the opener of the English one · Generated With Diffusion Models · original
- A watercolour of the doll in the picture grid · Generated With Diffusion Models · original
- A watercolour of the moon on the opener of the English unit · Generated With Diffusion Models · original
- A watercolour of the mat in the picture grid of the English unit · Generated With Diffusion Models · original
- A watercolour of the man in the picture grid of the English unit · Generated With Diffusion Models · original
- A watercolour of the mug in the picture grid of the English unit · Generated With Diffusion Models · original
- A watercolour of the mop in the picture grid of the English unit · Generated With Diffusion Models · original
- A watercolour of the mud in the picture grid of the English unit · Generated With Diffusion Models · original
- The cream band, the activity icons and the tracing rows, drawn in code in the page’s palette · Ignacio Ferro · MIT
- Fontes
- Andika (SIL OFL 1.1) · DynaPuff (SIL OFL 1.1) · Playpen Sans (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


