En pocas palabras
Dos páginas de un libro de cocina casera, una receta en cada una. Enseña a poner los ingredientes y los pasos de la receta uno al lado del otro en una ficha.
Lo que vas a componer
Dos páginas enfrentadas de Sal y aceite, un recetario casero inventado de 190 × 250 mm, con una receta por página. Una fotografía, generada con modelos de difusión y cargada como JPEG, ocupa a sangre los 104 mm superiores: una tortilla con una porción separada sobre una mesa azafrán, un cuenco de gazpacho sobre otra verde salvia. Encima van el antetítulo, el título en Young Serif de 42 pt, píldoras con el tiempo, la dificultad y la temporada, y una nota manuscrita en Caveat que señala el plato. Bajo la entradilla, una tarjeta blanca lleva arriba a la derecha una pestaña rojo tomate con las raciones. Los ingredientes bajan por la izquierda con rayas verde oliva y chips de etiqueta; bajo los de la tortilla, un bol, una sartén y un plato dibujados encabezan una lista de tareas. Cada paso de la elaboración, a la derecha, lleva delante una cifra elzeviriana de 26 pt.
Esta receta responde a
- ¿Cómo pongo dos columnas dentro de un recuadro (una de texto junto a otra con una figura)?
- ¿Cómo añado una pestaña numerada («RECUADRO 1-1»), un icono de esquina o un icono al margen con un filete?
- ¿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 añado a una apertura una línea de autor, una entradilla o un primer párrafo con capitular?
La respuesta corta
// In the Markdown, :::callout{type="card" label="SERVES 4"} holds a :::columns{count=2} group
// of two nested boxes, :::callout{type="column" title="Ingredients"} and one for the method.
// The group levels its columns by cutting between blocks or lines, so loose lists would run
// the method on under the ingredients. A nested box is one block that never splits, so the
// only cut left is between the two.
const TAB = 5.6; // mm: the tab's height, and how far it rises above the card
const card = { id: 'card', background: col('card'),
padding: { top: mm(4.5), right: mm(6), bottom: mm(5), left: mm(6) },
// No space of its own above: the tab starts on the first grid line under the opener.
columnGap: mm(7), marginTop: mm(0),
// label="…" on the fence prints here: a tab on the top-right corner, a cutlery pictogram
// beside it and a rule from the far corner that makes the tab part of the card.
label: { fontFamily: TEXT, fontSize: pt(8), color: col('card'), // bold by default
background: col('tomato'), height: mm(TAB), offset: mm(TAB), paddingX: mm(2.6),
icon: { resourceId: 'cutlery', width: mm(TAB * 6 / 8), gap: mm(1.6) }, // as tall as the tab
rule: { enabled: true, color: col('tomato'), width: pt(1.2) } } };
// The two columns: frameless boxes whose only device is a tracked title.
const NONE = { top: mm(0), right: mm(0), bottom: mm(0), left: mm(0) };
const column = { id: 'column', backgroundEnabled: false, padding: NONE,
lists: { gap: mm(2.2), itemSpacing: pt(3.5) }, // for the steps as well as the dashes
titleStyle: { fontFamily: TEXT, fontSize: pt(8), color: col('tomato'), // bold by default
textTransform: 'uppercase', letterSpacing: pt(1.5), gap: mm(2.4) } };
// config() plugs them in: calloutStyles: [card, column, prep].
Ingredientes
- Funciones
- Columnas en un recuadro o en el textoPestañas numeradas en los recuadrosListas numeradasRecuadros anidadosIconos y distintivos de esquinaChips en líneaListas de viñetas y de comprobaciónRecuadrosAperturas diseñadasBanda de capítulo a todo el anchoEstilos de títuloAtributos de títuloTextos, filetes y cajas en los diseños de páginaImágenes en los diseños de páginaSaltos de línea en los títulosColor del papelCabeceras y foliosPaleta de color semánticaEstilos de párrafoFiguras y tablas como recursos
- Tipografía
- Young Serif, Figtree, Caveat (SIL OFL 1.1)
- Recursos
gazpacho-1520.jpgtortilla-1520.jpg- La tortilla en su plato, una fotografía (Generated With Diffusion Models, original)
- El cuenco de gazpacho, una fotografía (Generated With Diffusion Models, original)
- La flecha de la nota y los pictogramas, dibujados en código con la paleta de la página (Ignacio Ferro, CC BY 4.0)
Elaboración
#1 · Un recuadro para cada columna
Con las listas sueltas, un grupo de columnas en un recuadro corta donde sus columnas quedan más igualadas, entre bloques o entre las líneas de uno, así que el primer paso del gazpacho se parte a ambos lados del medianil: su primera línea cierra la columna de ingredientes y el resto abre la de la elaboración. Un recuadro anidado, como en la respuesta corta de arriba, es un solo bloque, y el grupo nunca corta dentro de él. Para meter una imagen en uno hace falta un ::resource con la colocación 'here', porque con cualquier otra la imagen flota, sale del recuadro y se coloca como cualquier figura citada. El label del estilo de la tarjeta convierte el label="PARA 4" de la línea de apertura en la pestaña: un offset igual a su height la apoya sobre el borde superior de la tarjeta, y el rule va desde la esquina contraria hasta el tenedor y el cuchillo (estilos de recuadro).
#2 · Centra los números de paso en dos líneas
// Young Serif has old-style figures: 1 and 2 stand 0.56 em, a little above its 0.50 em
// x-height, so 5.1 mm at STEP. A list number is centred 0.3 em (of the text) above the item's
// first baseline, with the canvas 'middle' baseline, which Chrome puts 0.24 em above Young
// Serif's own (gotcha: list-number-centred). DROP centres the figures on the step's first two
// lines, from the cap height of the first to the baseline of the second.
const [STEP, FIGURE, MIDDLE, CAP] = [26, 0.56, 0.24, 0.7]; // pt; em of each face
const DROP = (LEAD - CAP * BODY) / 2 + 0.3 * BODY + (FIGURE / 2 - MIDDLE) * STEP; // pt
const orderedLists = { fontFamily: DISPLAY, fontWeight: 400, // Young Serif ships 400 only
numberFontSize: pt(STEP), color: col('tomato'),
separatorColor: col('olive'), separatorGap: pt(0.6), // the default '.' as its own run
numberVerticalOffset: pt(DROP) };
El número de una lista se pinta centrado un poco por encima de la primera línea base del elemento, así que numberFontSize por sí solo dejaría las cifras de 26 pt a la altura de la primera línea; numberVerticalOffset las baja 2,5 mm, al centro de la franja que va de las mayúsculas de la primera línea a la línea base de la segunda. Young Serif tiene cifras elzevirianas, de modo que el 3, el 4 y el 5 bajan de la línea base en la que se apoyan el 1 y el 2. Con separatorColor, el separador se pinta como un tramo aparte, y el punto por defecto sale verde oliva junto a la cifra roja (listas ordenadas).
#3 · Encabeza la lista con una tira de dibujos
// :::callout{type="prep" title="Before you start"}, closed at once, is a header: a box that
// holds only its title and icon. The icon is one picture of three drawings; a width KIT times
// its size makes its box a strip, and the picture is fitted into width × size, left of the
// title. Tasks set inside the box would start after that column, 21 mm in, so the '- [ ]'
// items follow the box, where they print the default task box, '☐'.
const [STRIP, KIT] = [5, 30 / 8]; // mm: the strip's height; the drawing's width over height
const prep = { id: 'prep', backgroundEnabled: false, padding: NONE,
marginTop: pt(LEAD), marginBottom: column.titleStyle.gap, // the tasks follow at this gap
icon: { kind: 'resource', resourceId: 'kit', size: mm(STRIP), width: mm(STRIP * KIT),
align: 'center' }, // the title centred on the strip
titleStyle: { ...column.titleStyle, color: col('olive') } };
El recuadro prep solo lleva su título y su icono, y por eso hace de encabezado: un width del icono de 3,75 veces su size convierte su cuadrado en una tira de 18,75 × 5 mm, y los tres dibujos la llenan a la izquierda del título (estilos de recuadro). El icono ocupa una columna propia junto a todo lo que hay en su recuadro, así que las tareas van después del recuadro, donde se alinean con las rayas de los ingredientes en vez de empezar 21 mm más adentro. Los elementos - [ ] pintan la casilla de tarea por defecto, y unorderedLists.marginTop: 0 los deja seguir al encabezado a la distancia de su marginBottom, los mismos 2,4 mm que guardan los títulos de columna (listas no ordenadas).
#4 · Las etiquetas, en chips
const chipStyles = [{ id: 'tag', fontSize: em(0.86), bold: true, background: col('tint'),
borderWidth: pt(0), borderRadius: em(1), // no outline; a radius past half the height: a pill
paddingX: em(0.7), paddingY: em(0.18), gap: em(0.3) }];
:chip[Vegetariana]{style="tag"} mete una palabra en una caja que nunca se parte entre líneas. Un borderRadius mayor que la mitad de la altura de la caja se queda en esa mitad y redondea los extremos en semicírculo; con borderWidth: 0, la píldora se dibuja solo con el tono de fondo. La caja mide 11,4 pt de alto, menos que los 12,8 pt de interlineado de la tarjeta, así que una segunda línea de etiquetas no tocaría la primera (estilos de chip).
#5 · Un diseño y una fotografía para cada receta
const BAND = 104; // mm: the photo's foot; the pills sit 13 mm above it, the lead 6 mm below
const NOTE = { x: 18, y: 24, w: 70 }; // mm on the page: the box ends 2 mm before the arrow
const at = (x, y, size) => ({ anchor: { to: 'container', edge: 'top-left' },
offset: { x: mm(x), y: mm(y - PAGE.top) }, size }); // y in mm from the top of the page
const text = (id, content, family, size, placement, extra) => ({ kind: 'text', id, content,
fontFamily: family, fontSize: pt(size), color: col('ink'), align: 'left',
overflow: 'wrap', placement, ...extra }); // a foot wraps too, where the default is '…'
const tracked = { fontWeight: 700, textTransform: 'uppercase', letterSpacing: pt(1.6) };
// Pills are text boxes chained right-of each other; each prints one heading attribute.
const pill = (id, after) => text(id, `{attr.${id}}`, TEXT, 8.4, after ? { anchor:
{ to: `#${after}`, edge: 'right-of' }, offset: { x: mm(1.8) } } : at(0, BAND - 13), {
fontWeight: 600, box: { backgroundColor: col('card'), borderRadius: mm(3),
padding: { top: mm(1.1), right: mm(2.8), bottom: mm(1.1), left: mm(2.8) } } });
// One heading style for every recipe; each heading names its photo: art="tortilla".
const opener = { id: 'receta', advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'image', id: 'art', resourceId: '{attr.art}', // filled in per heading, like a text
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: mm(PAGE.w), height: mm(BAND) } } },
{ kind: 'image', id: 'arrow', resourceId: 'arrow', // the note's arrow, over the photo
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: mm(PAGE.w), height: mm(BAND) } } },
text('note', '{attr.note}', HAND, 19, { anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(NOTE.x), y: mm(NOTE.y) }, size: { width: mm(NOTE.w) } },
{ fontWeight: 600, align: 'right' }), // on the page, like the arrow and the photo
pill('time'), pill('level', 'time'), pill('season', 'level'),
text('title', '{titleText}', DISPLAY, 42, { anchor: { to: '#time', edge: 'above' },
offset: { y: mm(-3.2) }, size: { width: mm(96) } }, // two lines: the \\ in the heading
{ lineHeight: 1 }), // set solid: 42 pt from line to line
text('kicker', '{attr.kicker}', TEXT, 8.2, { anchor: { to: '#title', edge: 'above' },
offset: { y: mm(-2.4) }, size: { width: mm(96) } }, tracked),
// The lead is the design's lowest element: the opener reserves down to its last line, and
// the card starts under it without a minHeight.
text('lead', '{attr.lead}', TEXT, 10.5, at(0, BAND + 6, { width: mm(122) }),
{ italic: true, lineHeight: 1.45 }),
] } } };
# Tortilla \\ de patatas {style="receta" art="tortilla" kicker="…" lead="…"} elige el estilo de encabezado y llena su diseño con los atributos, también la entradilla en cursiva (atributos de encabezado). El resourceId del elemento de imagen es '{attr.art}', un marcador como los de un texto, así que las dos recetas comparten un estilo y cada título indica su fotografía (elementos de imagen). Cada píldora se ancla con right-of a la anterior, el título con above a la primera y el antetítulo sobre el título, así que un título más largo empuja hacia arriba el antetítulo y las píldoras no se mueven de su línea. La entradilla es el elemento más bajo del diseño, así que la apertura reserva hasta su última línea y la tarjeta empieza bajo ella sin minHeight. La nota se ancla a la página, como la fotografía y la flecha, un segundo elemento de imagen dibujado en código, y termina a 2 mm de la flecha en las dos páginas, aunque con los márgenes en espejo la caja de la página impar empiece 2 mm más a la derecha.
#6 · Registra las imágenes como recursos
// The opener's image elements and both icons name a resource id; the resource names the file
// the canvas paints (loadImage or loadSvg registers it). No :ref cites them, so none is numbered.
const photo = (id, altText) => ({ id, typeId: 'figure', kind: 'bitmap', createdAt: 0, updatedAt: 0,
altText, bitmap: { fileId: `${id}-1520.jpg`, format: 'jpeg', width: 1520, height: 832 } });
const ART = { // markup, width and height in mm, and the alt text
arrow: [arrow, PAGE.w, BAND, t({ en: 'An arrow to the dish', es: 'Una flecha al plato' })],
cutlery: [cutlery, 6, 8, t({ en: 'Fork and knife', es: 'Tenedor y cuchillo' })],
kit: [kit, 8 * KIT, 8, t({ en: 'A bowl with two eggs, a frying pan and a plate',
es: 'Un bol con dos huevos, una sartén y un plato' })] };
const resources = [
photo('tortilla', t({ en: 'A potato omelette with a slice pulled out, on a blue-rimmed plate '
+ 'and a red-checked napkin', es: 'Una tortilla de patatas con una porción separada, en un '
+ 'plato de borde azul sobre una servilleta de cuadros rojos' })),
photo('gazpacho', t({ en: 'A bowl of gazpacho with diced vegetables and a spoon, on a '
+ 'blue-checked napkin beside a tomato', es: 'Un cuenco de gazpacho con dados de verdura '
+ 'y una cuchara, sobre una servilleta de cuadros azules junto a un tomate' })),
...Object.entries(ART).map(([id, [, w, h, altText]]) => ({ id, typeId: 'figure',
kind: 'svg', createdAt: 0, updatedAt: 0, altText, svg: { fileId: `${id}.svg`, width: w * 10,
height: h * 10 } })), // 10 px a millimetre: the sizes only set the aspect ratio here
];
const photos = resources.filter((r) => r.kind === 'bitmap').map((r) => r.bitmap.fileId);
await Promise.all([...photos.map((file) => loadImage(file, asset(file))),
...Object.entries(ART).map(([id, [svg]]) => loadSvg(`${id}.svg`, svg))]);
Los dos elementos de imagen de la apertura, el icono de la pestaña y el del encabezado de la lista remiten cada uno a un recurso, y el canvas pinta el archivo que loadImage o loadSvg registró para él. Ningún :ref cita estos recursos, así que ninguno se convierte en una figura numerada. Las imágenes no llevan palabras: las notas manuscritas son texto de diseño compuesto encima.
La receta completa
// ═══ Postext Cookbook · Nº 033 · Recipe card: ingredients beside the method ═══════
// https://postext.dev/en/cookbook/recipe-card
// Code: MIT · Text: original (CC BY 4.0) · Photos: diffusion models · Pictograms: CC BY 4.0
// Fonts: Young Serif, Figtree, Caveat (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
const LANG = 'es'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'recipe-card';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
const palette = { ink: '#2b2118', muted: '#76634e', // text; folios and the colophon
paper: '#f7eddb', card: '#fffdf8', // the cream page; the white recipe card on it
tomato: '#bf3d29', olive: '#6b7a3a', tint: '#f6e3c1' }; // numbers and tab; dashes; tags
// 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 tomato, so nothing prints blue.
const colorPalette = Object.entries({ ...palette, 'main-color': palette.tomato })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const [TEXT, DISPLAY, HAND] = ['Figtree', 'Young Serif', 'Caveat'];
const PAGE = { w: 190, h: 250, top: 22, inner: 18, outer: 16 }; // mm, mirrored margins
const [BODY, LEAD] = [9.4, 12.8]; // pt: the text of the cards and the notes under them
// #region answer: a white card with a servings tab, two columns inside it
// In the Markdown, :::callout{type="card" label="SERVES 4"} holds a :::columns{count=2} group
// of two nested boxes, :::callout{type="column" title="Ingredients"} and one for the method.
// The group levels its columns by cutting between blocks or lines, so loose lists would run
// the method on under the ingredients. A nested box is one block that never splits, so the
// only cut left is between the two.
const TAB = 5.6; // mm: the tab's height, and how far it rises above the card
const card = { id: 'card', background: col('card'),
padding: { top: mm(4.5), right: mm(6), bottom: mm(5), left: mm(6) },
// No space of its own above: the tab starts on the first grid line under the opener.
columnGap: mm(7), marginTop: mm(0),
// label="…" on the fence prints here: a tab on the top-right corner, a cutlery pictogram
// beside it and a rule from the far corner that makes the tab part of the card.
label: { fontFamily: TEXT, fontSize: pt(8), color: col('card'), // bold by default
background: col('tomato'), height: mm(TAB), offset: mm(TAB), paddingX: mm(2.6),
icon: { resourceId: 'cutlery', width: mm(TAB * 6 / 8), gap: mm(1.6) }, // as tall as the tab
rule: { enabled: true, color: col('tomato'), width: pt(1.2) } } };
// The two columns: frameless boxes whose only device is a tracked title.
const NONE = { top: mm(0), right: mm(0), bottom: mm(0), left: mm(0) };
const column = { id: 'column', backgroundEnabled: false, padding: NONE,
lists: { gap: mm(2.2), itemSpacing: pt(3.5) }, // for the steps as well as the dashes
titleStyle: { fontFamily: TEXT, fontSize: pt(8), color: col('tomato'), // bold by default
textTransform: 'uppercase', letterSpacing: pt(1.5), gap: mm(2.4) } };
// config() plugs them in: calloutStyles: [card, column, prep].
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
#Cuenta bloques en lugar de encerrar las columnas
Sin los recuadros de columna, breaks indica en qué bloque empieza la columna derecha, y cada elemento de lista, la línea de etiquetas y el encabezado de la lista de tareas cuentan como uno: el gazpacho necesita breaks="10" (antes van ocho ingredientes y las etiquetas) y la tortilla, breaks="11". Con los recuadros se van también los títulos de columna y el espacio entre pasos del estilo de columna.
:::callout{type="card" label="PARA 6"}
-:::columns{count=2}
-:::callout{type="column" title="Ingredientes"}
+:::columns{count=2 breaks="10"}
- **1,5 kg** de tomates de pera maduros
@@ siete ingredientes más y una línea en blanco @@
:chip[Vegana]{style="tag"} :chip[Sin fuego]{style="tag"} :chip[De víspera]{style="tag"}
-:::
-:::callout{type="column" title="Elaboración"}
+
1. Trocea los tomates, el pimiento sin semillas, el pepino pelado y el ajo.
@@ pasos 2 a 5 @@
:::
-:::
:::#Pon la pestaña en la esquina izquierda
Con 'top-left' la pestaña pasa a la esquina izquierda, el tenedor y el cuchillo quedan a su derecha y el filete entra desde la derecha.
background: col('tomato'), height: mm(TAB), offset: mm(TAB), paddingX: mm(2.6),
+ position: 'top-left', // 'top-right' por defectoErrores frecuentes
Error frecuente
El número de una lista se centra en su primera línea, no se apoya en la línea base
El número de una lista numerada se pinta con la línea base «middle» del canvas, 0,3 em del texto por encima de la primera línea base del elemento, así que un número en otra fuente o con un numberFontSize mayor crece hacia arriba y hacia abajo desde ahí en vez de apoyarse en la línea: una fuente de rótulo queda alta y un número grande de paso cuelga sobre la primera línea. Colócalo con orderedLists.numberVerticalOffset y revisa el resultado a tamaño real. Los números del índice se apoyan en la línea base desde postext 1.5; los de las listas siguen centrados. Listas numeradas →
Error frecuente
El lists.color de un recuadro también cambia el color de los números de sus listas
El lists.color de un estilo de recuadro colorea por igual las viñetas del recuadro y los números de sus listas numeradas, siempre que el estilo lo fije: si das así viñetas verde oliva a un recuadro, sus números de paso también se vuelven verde oliva. (Hasta postext 1.4 solo llegaba a los números cuando era distinto de unorderedLists.color.) Para colorear solo las viñetas de un recuadro, fija unorderedLists.color en el documento y deja lists.color fuera del estilo del recuadro, que así conserva los números en orderedLists.color. Recuadros →
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 →
- El rótulo de la pestaña (
label) no tienetextTransformniletterSpacing, así que PARA 4 y SERVES 4 van ya en mayúsculas en las líneas de apertura.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imágenes
- La tortilla en su plato, una fotografía · Generated With Diffusion Models · original
- El cuenco de gazpacho, una fotografía · Generated With Diffusion Models · original
- La flecha de la nota y los pictogramas, dibujados en código con la paleta de la página · Ignacio Ferro · CC BY 4.0
- Fuentes
- Young Serif (SIL OFL 1.1) · Figtree (SIL OFL 1.1) · Caveat (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)


