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

Receitas · Capítulo 2 · Tipo e texto

Cartilha de alfabetização com sílabas em chips

Uma unidade de cartilha para a letra M: os sons de cada palavra em chips na cor da vogal e uma grade de palavras ilustradas, uma aquarela por célula.

p. 37 · 1 de 3

  • Amostra em inglês: ainda sem edição em português
  • Refile 210 × 260 mm
  • 1 coluna
  • Andika 11/15
  • DynaPuff
  • Playpen Sans
  • 3 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 52 ms
  • 180 linhas de código

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

script.js · linhas 27–48no código completo
// 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

Tipografia
Andika, DynaPuff, Playpen Sans (SIL OFL 1.1)
Materiais
  • man-640.jpg
  • mano-640.jpg
  • manzana-480.jpg
  • mapa-640.jpg
  • mariposa-660.jpg
  • mat-640.jpg
  • mesa-640.jpg
  • mimosa-640.jpg
  • mono-640.jpg
  • moon-480.jpg
  • mop-640.jpg
  • mud-640.jpg
  • mug-640.jpg
  • muneca-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

script.js · linhas 144–154no código completo
  // 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

script.js · linhas 96–109no código completo
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

script.js · linhas 157–169no código completo
  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

script.js · linhas 60–79no código completo
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

script.js · linhas 83–92no código completo
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

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

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)
Sandbox