Saltar al contingut principal
Recepta número 33

Receptari · Capítol 6 · Requadres i notes

Fitxa de recepta: ingredients al costat de l'elaboració

Dues pàgines de receptari amb una fitxa amb la pestanya PARA 4: ingredients, etiquetes i llista de tasques a l'esquerra; passos amb xifres vermelles a la dreta.

En aquesta pàgina

pp. 58–59 · 1–2 de 2

  • Mostra en castellà: encara no hi ha edició en català
  • Format 190 × 250 mm
  • 1 columna
  • Figtree 9,4/12,8
  • Caveat
  • Young Serif
  • 2 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 53 ms
  • 187 línies de codi

En poques paraules

Dues pàgines d'un llibre de cuina casolana, una recepta a cadascuna. Ensenya a posar els ingredients i els passos de la recepta l'un al costat de l'altre en una fitxa.

Què compondràs

Dues pàgines encarades de Sal y aceite, un receptari casolà inventat de 190 × 250 mm, amb una recepta per pàgina. Una fotografia, generada amb models de difusió i carregada com a JPEG, ocupa a sang els 104 mm superiors: una truita amb una porció separada sobre una taula safrà, un bol de gaspatxo sobre una altra de verd sàlvia. A sobre van l'avanttítol, el títol en Young Serif de 42 pt, píndoles amb el temps, la dificultat i la temporada, i una nota manuscrita en Caveat que assenyala el plat. Sota l'entradeta, una fitxa blanca porta a dalt a la dreta una pestanya vermell tomàquet amb les racions. Els ingredients baixen per l'esquerra amb ratlles verd oliva i xips d'etiqueta; sota els de la truita, un bol, una paella i un plat dibuixats encapçalen una llista de tasques. Cada pas de l'elaboració, a la dreta, porta al davant una xifra elzeviriana de 26 pt.

Aquesta recepta respon a

  • Com poso dues columnes dins d'un requadre (una de text al costat d'una altra amb una figura)?
  • Com afegeixo una pestanya numerada («REQUADRE 1-1»), una icona de cantonada o una icona al marge amb un filet?
  • Com personalitzo les llistes: pics per nivell, numeració (a)/(i), caselles de tasques i un espaiat que respecti la retícula?
  • Com faig xips en línia: tecles, etiquetes, bancs de paraules per a exercicis?
  • Com afegeixo a una obertura una línia d'autor, una entradeta o un primer paràgraf amb caplletra?

La resposta curta

script.js · línies 26–48al codi complet
// 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].

Ingredients

Tipografia
Young Serif, Figtree, Caveat (SIL OFL 1.1)
Recursos
  • gazpacho-1520.jpg
  • tortilla-1520.jpg
  • The tortilla on its plate, a photograph (Generated With Diffusion Models, original)
  • The bowl of gazpacho, a photograph (Generated With Diffusion Models, original)
  • The note’s arrow and the pictograms, drawn in code in the page’s palette (Ignacio Ferro, CC BY 4.0)

Elaboració

#1 · Un requadre per a cada columna

Amb les llistes soltes, un grup de columnes en un requadre talla on les seves columnes queden més igualades, entre blocs o entre les línies d'un bloc, de manera que el primer pas del gaspatxo es parteix a banda i banda de l'espai entre columnes: la seva primera línia tanca la columna d'ingredients i la resta obre la de l'elaboració. Un requadre niat, com a la resposta curta de dalt, és un sol bloc, i el grup mai no hi talla a dins. Per posar-hi una imatge cal un ::resource amb la col·locació 'here', perquè amb qualsevol altra la imatge flota, surt del requadre i es col·loca com qualsevol figura citada. El label de l'estil de la fitxa converteix el label="PARA 4" de la línia d'obertura en la pestanya: un offset igual a la seva height la recolza sobre la vora superior de la fitxa, i el rule va des de la cantonada contrària fins a la forquilla i el ganivet (estils de requadre).

#2 · Centra els números de pas en dues línies

script.js · línies 66–76al codi complet
// 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 d'una llista es pinta centrat una mica per sobre de la primera línia de base de l'element, així que numberFontSize tot sol deixaria les xifres de 26 pt a l'altura de la primera línia; numberVerticalOffset les baixa 2,5 mm, al centre de la franja que va de les majúscules de la primera línia a la línia de base de la segona. Young Serif té xifres elzevirianes, de manera que el 3, el 4 i el 5 baixen de la línia de base on es recolzen l'1 i el 2. Amb separatorColor, el separador es pinta com un tram a part, i el punt per defecte surt verd oliva al costat de la xifra vermella (llistes numerades).

#3 · Encapçala la llista amb una tira de dibuixos

script.js · línies 52–62al codi complet
// :::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 requadre prep només porta el seu títol i la seva icona, i per això fa d'encapçalament: un width de la icona de 3,75 vegades la seva size converteix el seu quadrat en una tira de 18,75 × 5 mm, i els tres dibuixos l'omplen a l'esquerra del títol (estils de requadre). La icona ocupa una columna pròpia al costat de tot el que hi ha al seu requadre, així que les tasques van després del requadre, on s'alineen amb les ratlles dels ingredients en lloc de començar 21 mm més endins. Els elements - [ ] pinten la casella de tasca per defecte, i unorderedLists.marginTop: 0 els deixa seguir l'encapçalament a la distància del seu marginBottom, els mateixos 2,4 mm que guarden els títols de columna (llistes amb pics).

#4 · Les etiquetes, en xips

script.js · línies 80–82al codi complet
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"} fica una paraula en una caixa que mai no es parteix entre línies. Un borderRadius més gran que la meitat de l'alçada de la caixa es queda en aquesta meitat i arrodoneix els extrems en semicercle; amb borderWidth: 0, la píndola es dibuixa només amb el to de fons. La caixa fa 11,4 pt d'alçada, menys que els 12,8 pt d'interlineat de la fitxa, així que una segona línia d'etiquetes no tocaria la primera (estils de xip).

#5 · Un disseny i una fotografia per a cada recepta

script.js · línies 86–120al codi complet
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="…"} tria l'estil d'encapçalament i n'omple el disseny amb els atributs, també l'entradeta en cursiva (atributs d'encapçalament). El resourceId de l'element d'imatge és '{attr.art}', un marcador com els d'un text, així que les dues receptes comparteixen un estil i cada títol indica la seva fotografia (elements d'imatge). Cada píndola s'ancora amb right-of a l'anterior, el títol amb above a la primera i l'avanttítol sobre el títol, així que un títol més llarg empeny cap amunt l'avanttítol i les píndoles no es mouen de la seva línia. L'entradeta és l'element més baix del disseny, així que l'obertura reserva fins a la seva última línia i la fitxa comença a sota sense minHeight. La nota s'ancora a la pàgina, com la fotografia i la fletxa, un segon element d'imatge dibuixat en codi, i acaba a 2 mm de la fletxa a les dues pàgines, tot i que amb els marges en mirall la caixa de la pàgina senar comenci 2 mm més a la dreta.

#6 · Registra les imatges com a recursos

script.js · línies 271–293al codi complet
// 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))]);

Els dos elements d'imatge de l'obertura, la icona de la pestanya i la de l'encapçalament de la llista fan referència cadascun a un recurs, i el canvas pinta el fitxer que loadImage o loadSvg hi va registrar. Cap :ref no cita aquests recursos, així que cap no es converteix en una figura numerada. Les imatges no porten paraules: les notes manuscrites són text de disseny compost a sobre.

La recepta completa

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

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Compta blocs en lloc de tancar les columnes

Sense els requadres de columna, breaks indica en quin bloc comença la columna dreta, i cada element de llista, la línia d'etiquetes i l'encapçalament de la llista de tasques compten com un: el gaspatxo necessita breaks="10" (abans hi van vuit ingredients i les etiquetes) i la truita, breaks="11". Amb els requadres se'n van també els títols de columna i l'espai entre passos de l'estil 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
@@ set ingredients més i una línia en blanc @@
 :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.
@@ passos 2 a 5 @@
 :::
-:::
 :::

#Posa la pestanya a la cantonada esquerra

Amb 'top-left' la pestanya passa a la cantonada esquerra, la forquilla i el ganivet queden a la seva dreta i el filet entra des de la dreta.

     background: col('tomato'), height: mm(TAB), offset: mm(TAB), paddingX: mm(2.6),
+    position: 'top-left', // 'top-right' per defecte

Errors freqüents

Error freqüent

El número d'una llista es centra a la primera línia, no es recolza en la línia de base

El número d'una llista numerada es pinta amb la línia de base «middle» del canvas, 0,3 em del text per sobre de la primera línia de base de l'element, així que un número en una altra font o amb un numberFontSize més gran creix cap amunt i cap avall des d'allà en lloc de recolzar-se en la línia: una font de retolació queda alta i un número de pas gran penja sobre la primera línia. Col·loca'l amb orderedLists.numberVerticalOffset i revisa el resultat a mida real. Els números de l'índex es recolzen en la línia de base des de postext 1.5; els de les llistes continuen centrats. Llistes numerades →

Error freqüent

El lists.color d'un requadre també canvia el color dels números de les seves llistes

El lists.color d'un estil de requadre acoloreix per igual les vinyetes del requadre i els números de les seves llistes numerades, sempre que l'estil el fixi: si dones així vinyetes verd oliva a un requadre, els seus números de pas també es tornen verd oliva. (Fins a postext 1.4 només arribava als números quan era diferent d'unorderedLists.color.) Per acolorir només les vinyetes d'un requadre, fixa unorderedLists.color al document i deixa lists.color fora de l'estil del requadre, que així conserva els números en orderedLists.color. Requadres →

Error freqüent

Els xips més alts que l'interlineat toquen la línia següent

Un xip amb una caixa més alta que l'interlineat toca els xips de la línia següent (l'avís chipOverlap). Redueix-ne el farciment vertical, la vora o el cos, o obre l'interlineat. Chips en línia →

  • El rètol de la pestanya (label) no té textTransform ni letterSpacing, així que PARA 4 i SERVES 4 ja van en majúscules a les línies d'obertura.

Crèdits

Text
Text original, CC BY 4.0
Imatges
  • The tortilla on its plate, a photograph · Generated With Diffusion Models · original
  • The bowl of gazpacho, a photograph · Generated With Diffusion Models · original
  • The note’s arrow and the pictograms, drawn in code in the page’s palette · Ignacio Ferro · CC BY 4.0
Fonts
Young Serif (SIL OFL 1.1) · Figtree (SIL OFL 1.1) · Caveat (SIL OFL 1.1)
Sandbox