En pocas palabras
Tres páginas de una cartilla para aprender a leer, dedicadas a la letra M. Cada sílaba va en una etiqueta del color de su vocal y cada palabra de la cuadrícula lleva su dibujo.
Lo que vas a componer
La unidad 7 de Letra a letra, una cartilla de lectura inventada: tres páginas dedicadas a la eme. La apertura compone una Mm de DynaPuff a 190 pt sobre una franja crema, junto a dos cosas cuyo nombre empieza por eme, una mariposa y una manzana. Las sílabas de la unidad van en chips del color de su vocal: rojo la a, naranja la e, turquesa la i, azul la o y morado la u. Las que llevan eme van rellenas y las demás, solo con el contorno, así que el niño ve qué mitad de mesa es de esta unidad. La página 38 reúne seis palabras con su acuarela en una tabla de esquinas redondeadas y tres pautas para repasar. Las acuarelas se generaron con modelos de difusión; la franja, los iconos y las pautas están dibujados en código. La 39 trae cuatro frases a 24 pt, un recuadro de sílabas para colorear y una nota para la familia.
La edición inglesa no es una traducción, sino otra unidad: la 12 de Letter by Letter, dedicada a la misma letra. El español se enseña a leer por sílabas abiertas (ma, me, mi, mo, mu), que en inglés no son palabras, y las cartillas inglesas trabajan sonido a sonido. Por eso la unidad inglesa parte palabras cortas en sus sonidos, {m·a·p}, y las agrupa en familias que riman (-at, -an, -ug, -op). Las dos unidades salen del mismo código: los mismos estilos de chip, la misma función syllables(), la misma tabla, las mismas pautas y los mismos recuadros.
Esta receta responde a
- ¿Cómo hago chips en línea: teclas, etiquetas, bancos de palabras para ejercicios?
- ¿Cómo pongo imágenes o iconos dentro de las celdas de una tabla?
- ¿Cómo añado espacio vertical entre dos bloques, si las líneas en blanco no hacen nada?
- ¿Cómo hago una ficha de ejercicios: líneas para rellenar, cajas de respuesta, bancos de palabras, listas de comprobación?
La respuesta corta
// 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
- Funciones
- Chips en líneaImágenes en las celdasAperturas diseñadasAtributos de títuloEstilos de títuloImágenes en los diseños de páginaTextos, filetes y cajas en los diseños de páginaAnclaje de elementos de diseñoCabeceras y foliosEstilos de tabla con nombreEstilos de párrafoEspacio vertical explícitoRecuadrosPaleta de color semánticaFiguras y tablas como recursosTipos de recurso propiosFiguras justo aquíPáginas en un canvas
- Tipografía
- Andika, DynaPuff, Playpen Sans (SIL OFL 1.1)
- Recursos
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- Una acuarela de la mariposa de la apertura (Generated With Diffusion Models, original)
- Una acuarela de la manzana de la apertura (Generated With Diffusion Models, original)
- Una acuarela de la mano de la tabla de dibujos (Generated With Diffusion Models, original)
- Una acuarela del mapa de la tabla de dibujos de las dos unidades (Generated With Diffusion Models, original)
- Una acuarela de la mesa de la tabla de dibujos (Generated With Diffusion Models, original)
- Una acuarela de la rama de mimosa de la tabla de dibujos (Generated With Diffusion Models, original)
- Una acuarela del mono: en la tabla de dibujos de la unidad española y en la apertura de la inglesa (Generated With Diffusion Models, original)
- Una acuarela de la muñeca de la tabla de dibujos (Generated With Diffusion Models, original)
- Una acuarela de la luna de la apertura de la unidad inglesa (Generated With Diffusion Models, original)
- Una acuarela del felpudo de la tabla de dibujos de la unidad inglesa (Generated With Diffusion Models, original)
- Una acuarela del hombre de la tabla de dibujos de la unidad inglesa (Generated With Diffusion Models, original)
- Una acuarela de la taza de la tabla de dibujos de la unidad inglesa (Generated With Diffusion Models, original)
- Una acuarela de la fregona de la tabla de dibujos de la unidad inglesa (Generated With Diffusion Models, original)
- Una acuarela del barro de la tabla de dibujos de la unidad inglesa (Generated With Diffusion Models, original)
- La franja crema, los iconos de las actividades y las pautas de caligrafía, dibujados en código con la paleta de la página (Ignacio Ferro, MIT)
Elaboración
#1 · Un estilo de chip por vocal y una función que escribe los chips
La respuesta corta saca los 21 estilos de chip de un mismo objeto, syllable. Hay uno relleno por vocal para las sílabas con eme, otro con contorno por vocal para las demás, un gemelo -frase de cada uno de esos diez y pinta, el contorno en tinta que el niño colorea. La función syllables() convierte {mi·mo·sa} en tres :chip[…] sin nada entre ellos, así que las sílabas de una palabra se tocan y el borde blanco marca la junta. Cada chip toma el color de su vocal, y una pieza sin vocal, como la m y la p del {m·a·p} de la unidad inglesa, toma la de su palabra. Donde hay un espacio entre palabras, el chip guarda como mínimo su gap: con 0,5 em, las palabras de una fila de 24 pt quedan a 4,2 mm, y el espacio solo dejaría 2,3 mm. Dentro de una frase, ese gap casi duplicaría el espacio delante de la palabra nueva; por eso, cuando la palabra va detrás de otra, lleva los gemelos -frase, con gap 0, y el espacio se queda en 2,3 mm.
#2 · Un interlineado que deja sitio a los 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) },
],
El relleno vertical y el borde de un chip se pintan fuera de su línea y no suman interlineado, así que un chip más alto que el interlineado choca con los chips de la línea de abajo. Un chip de sílaba a 24 pt mide 10,4 mm de alto; con 30 pt de interlineado (10,6 mm), los chips de dos frases quedarían a 0,1 mm. Por eso las líneas que lee el niño llevan 45 pt y las filas de sílabas 60 pt, tres y cuatro líneas de la rejilla base de 15 pt en la que van las consignas.
#3 · Una acuarela en cada celda
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 pone una imagen encima del texto de una celda con una fracción de su ancho interior, aquí 0,72 (36,5 mm), y la fila crece para que quepa. Cada acuarela es un JPEG pintado sobre blanco y multiplicado por el crema de las baldosas, así que se asienta en la baldosa sin recuadro. Bajo cada acuarela va la palabra en chips de sílabas, que una celda admite como cualquier párrafo. El estilo de tabla dibujos redondea el marco y sus rellenos a 5 mm y separa las baldosas crema con filetes blancos de 4 pt.
#4 · Una línea de espacio antes del recuadro
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) } },
],
Entre la última frase y el recuadro para colorear, el Markdown lleva :::space{lines=1}, una línea de 15 pt (5,3 mm). El marginTop del recuadro es 0, así que esa línea es todo el espacio; sin ella, el recuadro empezaría justo donde acaba la línea de la última frase. Un :::space que abre un recuadro se descarta, de modo que el recuadro empieza con su enunciado y los chips de la muestra de colores, y su propio :::space va detrás, entre la muestra y la tarea de colorear.
#5 · La apertura de la 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
] } };
La Mm es el texto del título ({titleText}), y el número de la unidad, la serie y el nombre de la letra son atributos de esa misma línea. La franja, la mariposa y la manzana son imágenes. La franja mide 104 mm de alto, y la apertura reserva la página hasta la primera línea de la rejilla bajo su pie, así que el título de la primera actividad empieza a 118,5 mm, sobre la rejilla y 16,6 mm por debajo del punto más bajo de la onda (101,9 mm).
#6 · Iconos junto a los títulos de actividad
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 actividad indica su estilo, como en ## Lee las frases {style="lee"}, y el estilo dibuja un icono con el título centrado a su lado. Siguen siendo encabezados de nivel 2, así que el espacio lo fija el nivel H2: dos líneas de la rejilla base de lineHeight para el título y otras dos de marginTop encima.
La receta 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 = 'es'; // @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(''));
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
#Convierte las sílabas en píldoras
Un radio mayor que la mitad de la altura del chip se recorta a esa mitad, así que un valor grande dibuja extremos redondos. Una sílaba de una sola letra sale casi redonda, y las juntas dentro de una palabra se convierten en muescas.
- 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) };Errores frecuentes
Error frecuente
Los chips más altos que el interlineado tocan la línea siguiente
Un chip cuya caja es más alta que el interlineado toca los chips de la línea siguiente (el aviso chipOverlap). Reduce su relleno vertical, su borde o su cuerpo, o abre el interlineado. Chips en línea →
Error frecuente
:::space se descarta al principio de un recuadro o columna
:::space se descarta al principio de una columna, de un grupo :::columns, de un recuadro sin título que tiene más contenido y de la continuación de un recuadro partido. Desde postext 1.5 un recuadro hecho solo de :::space mide lo que pide el espacio (una caja de respuesta, sitio para escribir), y el espacio que va justo bajo el título de un recuadro baja el cuerpo esa misma altura. Para abrir con espacio un recuadro sin título, dale un título o una primera línea y añade después el espacio. Espacio vertical explícito →
Comprobación del Sandbox · chipOverlap
Los chips tocan la línea siguiente
Por qué. La caja de un estilo de chip es más alta que el interlineado, así que los chips de líneas seguidas se tocan.
Solución. Reduce el relleno vertical, el contorno o el cuerpo del chip, o aumenta el interlineado. Documentación →
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imágenes
- Una acuarela de la mariposa de la apertura · Generated With Diffusion Models · original
- Una acuarela de la manzana de la apertura · Generated With Diffusion Models · original
- Una acuarela de la mano de la tabla de dibujos · Generated With Diffusion Models · original
- Una acuarela del mapa de la tabla de dibujos de las dos unidades · Generated With Diffusion Models · original
- Una acuarela de la mesa de la tabla de dibujos · Generated With Diffusion Models · original
- Una acuarela de la rama de mimosa de la tabla de dibujos · Generated With Diffusion Models · original
- Una acuarela del mono: en la tabla de dibujos de la unidad española y en la apertura de la inglesa · Generated With Diffusion Models · original
- Una acuarela de la muñeca de la tabla de dibujos · Generated With Diffusion Models · original
- Una acuarela de la luna de la apertura de la unidad inglesa · Generated With Diffusion Models · original
- Una acuarela del felpudo de la tabla de dibujos de la unidad inglesa · Generated With Diffusion Models · original
- Una acuarela del hombre de la tabla de dibujos de la unidad inglesa · Generated With Diffusion Models · original
- Una acuarela de la taza de la tabla de dibujos de la unidad inglesa · Generated With Diffusion Models · original
- Una acuarela de la fregona de la tabla de dibujos de la unidad inglesa · Generated With Diffusion Models · original
- Una acuarela del barro de la tabla de dibujos de la unidad inglesa · Generated With Diffusion Models · original
- La franja crema, los iconos de las actividades y las pautas de caligrafía, dibujados en código con la paleta de la página · Ignacio Ferro · MIT
- Fuentes
- Andika (SIL OFL 1.1) · DynaPuff (SIL OFL 1.1) · Playpen Sans (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


