Em poucas palavras
Duas páginas de um livro de receitas caseiras, uma receita em cada. Mostra como pôr os ingredientes e os passos do preparo lado a lado numa ficha.
O que você vai compor
Duas páginas espelhadas de Salt & Olive Oil, um livro de receitas caseiras espanholas inventado, no formato 190 × 250 mm, uma receita por página. Uma fotografia, gerada com modelos de difusão e carregada como JPEG, sangra pelos 104 mm do alto: uma tortilha com uma fatia separada numa mesa cor de açafrão, uma tigela de gazpacho numa mesa verde-sálvia. Sobre ela ficam o antetítulo, o título em Young Serif de 42 pt, pílulas com tempo, dificuldade e estação, e uma nota na letra manuscrita Caveat que aponta para o prato. Abaixo do texto de apresentação em itálico, uma ficha branca leva no canto superior direito uma aba vermelho-tomate com as porções. Os ingredientes descem pela coluna esquerda com travessões verde-oliva e chips de etiqueta; abaixo dos da tortilha, desenhos de uma tigela, uma frigideira e um prato encabeçam um checklist. O modo de preparo ocupa a coluna direita, e cada passo começa com um algarismo de estilo antigo de 26 pt.
Esta receita responde a
- Como coloco duas colunas dentro de um boxe (uma coluna de texto ao lado de uma coluna com figura)?
- Como acrescento uma aba numerada (“BOXE 1-1”), um ícone de canto ou um ícone na margem com um fio?
- Como personalizo listas: marcadores por nível, numeração (a)/(i), caixas de seleção de tarefas e um espaçamento que fique na grade?
- Como faço chips em linha: teclas, etiquetas, bancos de palavras para exercícios?
- Como acrescento a uma abertura uma linha de autor, uma linha fina ou um primeiro parágrafo com capitular?
A resposta curta
// 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
- Funcionalidades
- Colunas num boxe ou no textoAbas numeradas nos boxesListas numeradasBoxes aninhadosÍcones e selos de canto nos boxesChips no textoListas com marcadores e de verificaçãoBoxesAberturas desenhadasFaixa de capítulo em largura totalEstilos de títuloAtributos de títuloTextos, fios e caixas nos designs de páginaImagens nos designs de páginaQuebras de linha nos títulosCor do papelCabeços e fóliosPaleta de cores semânticaEstilos de parágrafoFiguras e tabelas como recursos
- Tipografia
- Young Serif, Figtree, Caveat (SIL OFL 1.1)
- Materiais
gazpacho-1520.jpgtortilla-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)
Preparo
#1 · Dê a cada coluna um box próprio
Com as listas soltas, um grupo de colunas dentro de um box corta onde as colunas ficam mais niveladas, entre blocos ou entre as linhas de um deles, e o primeiro passo do gazpacho se divide dos dois lados da medianiz: a primeira linha fecha a coluna de ingredientes e o resto abre a do preparo. Um box aninhado, como na resposta curta logo acima, é um só bloco, e o grupo nunca corta dentro dele. Para pôr uma imagem num deles é preciso um ::resource com posicionamento 'here', porque qualquer outro faz dela uma flutuante, que sai do box e é posicionada como qualquer figura citada. O label do estilo da ficha transforma o label="SERVES 4" do delimitador na aba: um offset igual à height a apoia na borda superior da ficha, e o rule vai do canto oposto até o garfo e a faca (estilos de boxe).
#2 · Centralize os números de passo em duas linhas
// 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) };
O número de uma lista é pintado centralizado um pouco acima da primeira linha de base do item, de modo que numberFontSize sozinho deixaria os algarismos de 26 pt na altura da primeira linha; numberVerticalOffset os baixa 2,5 mm, para o meio da faixa que vai das maiúsculas da primeira linha até a linha de base da segunda. A Young Serif tem algarismos de estilo antigo: 3, 4 e 5 descem abaixo da linha de base em que 1 e 2 se apoiam. Com separatorColor definido, o separador é pintado como um trecho à parte, e o ponto padrão sai verde-oliva ao lado de um algarismo vermelho (listas numeradas).
#3 · Encabece o checklist com uma tira de desenhos
// :::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') } };
O box prep só tem o título e o ícone, e por isso funciona como cabeçalho: uma width do ícone de 3,75 vezes o size estica o quadrado do ícone numa tira de 18,75 × 5 mm, e os três desenhos a preenchem à esquerda do título (estilos de boxe). Um ícone ocupa uma coluna própria ao lado de tudo o que está no box, por isso as tarefas vêm depois do box, onde se alinham com os travessões dos ingredientes em vez de começar 21 mm para dentro. Os itens - [ ] imprimem a caixa de tarefa padrão, e unorderedLists.marginTop: 0 deixa que eles sigam o cabeçalho à distância do marginBottom, os mesmos 2,4 mm que os títulos de coluna mantêm (listas com marcadores).
#4 · Transforme as etiquetas em 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[Vegetarian]{style="tag"} põe uma palavra numa caixa que nunca quebra entre linhas. Um borderRadius maior que metade da altura da caixa é limitado a essa metade, o que transforma as duas pontas em semicírculos; com borderWidth: 0, a pílula é desenhada só com o tom de fundo. A caixa tem 11,4 pt de altura, menos que os 12,8 pt de entrelinha da ficha, por isso uma segunda linha de etiquetas não encostaria na primeira (estilos de chip).
#5 · Um design, uma fotografia por receita
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="…"} escolhe o estilo de título e preenche os espaços dele com os atributos, entre eles o texto de apresentação em itálico (atributos de título). O resourceId do elemento de imagem é '{attr.art}', um marcador como o de um texto, e assim as duas receitas dividem um estilo e cada título indica a fotografia (elementos de imagem). Cada pílula é ancorada right-of à anterior, o título above à primeira pílula e o antetítulo acima do título, de modo que um título mais longo empurra o antetítulo para cima enquanto as pílulas mantêm a linha. O texto de apresentação é o elemento mais baixo do design, por isso a abertura reserva até a última linha dele e a ficha começa logo abaixo, sem minHeight. A nota é ancorada à página, como a fotografia e a seta, um segundo elemento de imagem desenhado em código, e termina 2 mm antes da seta nas duas páginas, embora as margens espelhadas desloquem a mancha 2 mm para a direita na página ímpar.
#6 · Registre as imagens 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))]);
Os dois elementos de imagem da abertura, o ícone da aba e o ícone do cabeçalho do checklist indicam cada um um recurso, e o canvas pinta o arquivo que loadImage ou loadSvg registrou para ele. Nenhum :ref cita esses recursos, por isso nenhum vira figura numerada. As imagens não levam palavras: as notas manuscritas são texto de design composto por cima.
A receita 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 = 'en'; // @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].
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
#Conte blocos em vez de pôr as colunas em boxes
Sem os boxes de coluna, breaks indica o filho que abre a coluna direita, e cada item de lista, a linha de etiquetas e o cabeçalho do checklist contam como um: o gazpacho precisa de breaks="10" (oito ingredientes e as etiquetas vêm antes), a tortilha de breaks="11". Os títulos de coluna e o espaço entre passos do estilo de coluna somem junto.
:::callout{type="card" label="SERVES 6"}
-:::columns{count=2}
-:::callout{type="column" title="Ingredients"}
+:::columns{count=2 breaks="10"}
- **1.5 kg** ripe plum tomatoes
@@ seven more ingredients and a blank line @@
:chip[Vegan]{style="tag"} :chip[No-cook]{style="tag"} :chip[Make ahead]{style="tag"}
-:::
-:::callout{type="column" title="Method"}
+
1. Chop the tomatoes, seeded pepper, peeled cucumber and garlic.
@@ steps 2 to 5 @@
:::
-:::
:::#Ponha a aba no canto esquerdo
'top-left' espelha o rótulo: a aba passa para o canto esquerdo, o garfo e a faca para a direita dela, e o fio entra pela direita.
background: col('tomato'), height: mm(TAB), offset: mm(TAB), paddingX: mm(2.6),
+ position: 'top-left', // 'top-right' by defaultErros comuns
Erro comum
O número de uma lista é centralizado na primeira linha, não apoiado na linha de base
O número de uma lista numerada é pintado com a linha de base 'middle' do canvas, 0,3 em do texto acima da primeira linha de base do item, então um número em outra fonte ou com numberFontSize maior cresce para cima e para baixo a partir daí, em vez de se apoiar na linha: uma fonte de display fica alta, e um número grande de passo fica pendurado sobre a primeira linha. Posicione-o com orderedLists.numberVerticalOffset e confira o resultado em tamanho real. Os números do sumário se apoiam na linha de base desde o postext 1.5; os das listas continuam centralizados. Listas numeradas →
Erro comum
O lists.color de um boxe também recolore os números das listas
O lists.color de um estilo de boxe colore igualmente os marcadores do boxe e os números das suas listas numeradas, sempre que o estilo o define: se você der assim marcadores verde-oliva a um boxe, os números dos passos também ficam verde-oliva. (Até o postext 1.4, ele só chegava aos números quando era diferente de unorderedLists.color.) Para colorir só os marcadores de um boxe, defina unorderedLists.color no documento e deixe lists.color fora do estilo do boxe, o que mantém os números em orderedLists.color. Boxes →
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 →
- Um rótulo não tem
textTransformnemletterSpacing, de modo que SERVES 4 e PARA 4 são digitados em maiúsculas nos delimitadores.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imagens
- 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
- Fontes
- Young Serif (SIL OFL 1.1) · Figtree (SIL OFL 1.1) · Caveat (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)


