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

Receitas · Capítulo 7 · Figuras e imagens

Ensaio fotográfico com pranchas sangradas

As pranchas são estilos de título gerados a partir de uma lista, cada uma enchendo a página até o refile; a da tempestade cruza a medianiz em duas metades.

Nesta página
Gênero
Fotolivros
Saída
Canvas
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.42.1
Licença
Atualizada em 10 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 280 × 210 mm
  • 1 coluna
  • Andada Pro 10,5/15
  • Syne
  • Syne Mono
  • 9 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 52 ms
  • 177 linhas de código

Em poucas palavras

Um fotolivro de paisagem que conta um dia na serra em seis imagens. Mostra como encher páginas inteiras com fotos até a borda e estender uma imagem sobre duas páginas lado a lado.

O que você vai compor

Sierra, um fotolivro de paisagem em formato 280 × 210 mm: um dia numa serra de granito em seis pranchas, da primeira luz até a manhã seguinte à primeira neve. Cada prancha enche a página até o refile e traz só um numeral pequeno e a hora no canto inferior esquerdo; a primeira traz também o título, SIERRA em Syne de 72 pt, vazado em branco no céu do amanhecer. A tempestade cruza a medianiz das páginas 4 e 5 como uma única imagem. Três textos curtos, compostos numa coluna de 100 mm junto à lombada, ficam de frente para as pranchas que vêm depois deles. O texto da tempestade termina numa prancha menor, a do entardecer, que flutua abaixo dele com o numeral na legenda. A última prancha mostra o circo glaciar da segunda, do mesmo matacão, coberto de neve. As pranchas são fotografias geradas com modelos de difusão; a da neve foi feita como edição da prancha do meio-dia, para que as duas vistas coincidam.

Esta receita responde a

  • Como dou a cada capítulo sua própria foto, cor ou variante de abertura?
  • Como insiro páginas em branco de propósito, ou começo uma seção em uma nova página dupla?
  • Como oculto os cabeços nas aberturas e nas páginas em branco, ou pinto uma página par em branco com a cor da parte?
  • Como componho ilustrações sem numeração: ornamentos, vinhetas, logotipos?

A resposta curta

script.js · linhas 35–57no código completo
// '{attr.art}' is filled in per heading, so a plain plate names its picture on its line:
// # Noon {style="lamina" art="mediodia" …}. Only the cover and the last plate draw extras.
const PLATES = [ // the style id, its picture, the ink of its caption, anything extra it draws
  { id: 'alba', art: 'alba', extra: (colour) => cover(colour) }, // an arrow: cover() is below
  { id: 'lamina', art: '{attr.art}' }, // any plate on a page of its own
  { id: 'pliego', art: '{attr.art}', half: 'verso' }, // one picture across a spread:
  { id: 'pliego-recto', art: '{attr.art}', half: 'recto' }, // the left half, then the right
  { id: 'nieve', art: 'nieve', ink: 'ink', extra: (colour) => colophon(colour) },
];
const plate = ({ id, art, half, ink = 'white', extra = () => [] }) => ({
  id, span: 'page', // an opener: a span heading always starts a page of its own
  // The left half opens on an even page, a verso, so the right half faces it across the
  // gutter (gotcha: parity-page1-recto).
  ...(half === 'verso' && { breakBefore: { enabled: true, parity: 'even' } }),
  // The picture is as deep as the page, more than the column holds: the plate claims the
  // whole page, and what follows starts on the next one.
  advancedDesign: { enabled: true, slot: { elements: [
    { kind: 'image', id: 'picture', resourceId: art, // the recto half is the same picture,
      placement: at('page', 'top-left', half === 'recto' ? -PAGE.width : 0, 0, // moved left
        { width: mm(half ? 2 * PAGE.width : PAGE.width), height: mm(PAGE.height) }) },
    ...(half === 'recto' ? [] : caption(col(ink))), ...extra(col(ink)),
  ] } },
});

Ingredientes

Tipografia
Andada Pro, Syne, Syne Mono (SIL OFL 1.1)
Materiais
  • alba-1600.jpg
  • atardecer-2000.jpg
  • mediodia-1600.jpg
  • nieve-1600.jpg
  • noche-1600.jpg
  • tormenta-2400.jpg
  • Plate I, dawn: ridges fading into a peach haze under a dark blue sky (Generated With Diffusion Models, original)
  • Plate II, noon: a granite cirque and its lake (Generated With Diffusion Models, original)
  • Plate III, storm: rain, lightning and a break of sun across a spread (Generated With Diffusion Models, original)
  • Plate IV, dusk: the crest lit orange under a violet sky (Generated With Diffusion Models, original)
  • Plate V, night: stars over the ridges and a lit refuge (Generated With Diffusion Models, original)
  • Plate VI, snow: the cirque of plate II the morning after (Generated With Diffusion Models, original)

Preparo

#1 · Um estilo de título para cada prancha, gerado a partir de uma lista

O código é a resposta curta logo acima. plate() gera um estilo de título a partir de cada linha de PLATES, e o Markdown define a ordem do ensaio, uma linha por prancha: # Night {style="lamina" art="noche" n="V" hora="22:10"}. O resourceId do elemento de imagem é '{attr.art}', um marcador como os de um texto, de modo que todas as pranchas simples compartilham o estilo lamina e indicam a imagem na linha do título; só a capa e a última prancha, que desenham elementos a mais, mantêm um estilo próprio (elementos de imagem). span: 'page' abre cada prancha numa página própria. A imagem tem 210 mm de altura, a mesma da página, e um design reserva até o pé das imagens. Isso é mais que os 158 mm da coluna das páginas de texto, por isso a prancha fica com a página inteira e o que vem depois começa na seguinte, sem minHeight nem margens próprias.

Os dois estilos da página dupla, pliego e pliego-recto, desenham a mesma imagem de 560 mm, aqui art="tormenta": a metade do verso a partir da borda esquerda da página, a metade do anverso 280 mm mais à esquerda, de modo que cada página mostra a metade e o canvas corta o resto no refile. parity: 'even' mantém as duas metades frente a frente. Sem isso, tirar a prancha do meio-dia do Markdown poria a metade esquerda na página 3, uma página ímpar, e a metade direita no verso, na página 4; com isso, a página 3 fica em branco e a tempestade continua enchendo as páginas 4 e 5.

#2 · O numeral e a hora vêm da linha do título

script.js · linhas 61–72no código completo
const NUMERAL = { x: 16, y: PAGE.height - 21, size: 13 }; // mm from the top left; size in pt
// A design text's baseline sits 0.8 of its line box below its top: set a smaller label beside
// a larger one this much lower and the two share a baseline.
const dropTo = (big, small, lineHeight = 1.2) => (0.8 * lineHeight * (big - small) * 25.4) / 72;
const caption = (colour) => [
  { kind: 'text', id: 'numeral', content: '{attr.n}', fontFamily: 'Syne', fontWeight: 700,
    fontSize: pt(NUMERAL.size), color: colour, align: 'left',
    placement: at('page', 'top-left', NUMERAL.x, NUMERAL.y) },
  { kind: 'text', id: 'hour', content: '· {attr.hora}', fontFamily: 'Syne Mono', fontSize: pt(8),
    letterSpacing: pt(0.8), color: colour, align: 'left', // the dot: a lone I reads as a bar
    placement: at('#numeral', 'right-of', 1.6, dropTo(NUMERAL.size, 8)) },
];

O numeral e a hora são atributos do título, por isso o conteúdo fica no Markdown e um só design serve para todas as pranchas. A hora fica pendurada right-of do numeral, o que alinha o topo dos dois. A linha de base de um texto de design fica a 0,8 da caixa de linha abaixo do topo do elemento, e a caixa de linha mede por padrão 1,2 vez o corpo, de modo que dropTo(13, 8) desce a hora 0,8 × 1,2 × (13 − 8) pt e apoia a hora de 8 pt na linha de base do numeral de 13 pt, a 193,4 mm do topo da página. A hora começa com um ponto médio, como a legenda da prancha IV, porque o I da Syne é uma barra simples que, sozinha ao lado da hora, parece um fio. A metade direita da tempestade não tem legenda, e a prancha da neve compõe a sua na cor da tinta, porque o primeiro plano é branco.

#3 · Um título e um colofão nas próprias pranchas

script.js · linhas 76–90no código completo
const cover = (colour) => [
  { kind: 'text', id: 'title', content: '{title}', fontFamily: 'Syne', fontWeight: 800,
    fontSize: pt(72), lineHeight: 1, letterSpacing: pt(6), textTransform: 'uppercase',
    color: colour, align: 'left', placement: at('page', 'top-left', 22, 26) },
  { kind: 'text', id: 'subtitle', content: '{subtitle}', fontFamily: 'Syne Mono',
    fontSize: pt(10), letterSpacing: pt(2), textTransform: 'uppercase', color: colour,
    align: 'left', placement: at('#title', 'below', 1.5, 3) },
];
// The colophon: one element per line, 10.5 pt apart, so the break falls after the licence, and
// the second line on the baseline of the plate's numeral.
const COLOPHON = { y: NUMERAL.y + dropTo(NUMERAL.size, 7.5), leading: (10.5 * 25.4) / 72 };
const colophon = (colour) => ['colofon', 'tipos'].map((key, line) => ({ kind: 'text', id: key,
  content: `{attr.${key}}`, fontFamily: 'Syne Mono', fontSize: pt(7.5), letterSpacing: pt(0.2),
  color: colour, align: 'right',
  placement: at('page', 'top-right', -16, COLOPHON.y - (1 - line) * COLOPHON.leading) }));

A primeira prancha é a capa. {title} e {subtitle} leem o front matter, e extra em PLATES acrescenta os dois elementos ao design dessa prancha, na cor da legenda. O colofão vai na última prancha do mesmo jeito, na cor da tinta sobre a neve: dois elementos de 7,5 pt, um por linha, a partir dos atributos colofon e tipos, alinhados à direita, o segundo na linha de base do numeral. Um único elemento com quebra automática quebraria onde a largura acabasse; com um elemento por linha, a quebra cai depois da licença.

#4 · Os textos seguem as pranchas sem quebra

script.js · linhas 94–114no código completo
const textOpener = { enabled: true, slot: { elements: [
  { kind: 'text', id: 'hours', content: '{attr.hora}', fontFamily: 'Syne Mono', fontSize: pt(8),
    letterSpacing: pt(0.8), color: col('accent'), align: 'left',
    placement: at('container', 'top-left', 0, 0) },
  { kind: 'text', id: 'title', content: '{titleText}', fontFamily: 'Syne', fontWeight: 700,
    fontSize: pt(28), lineHeight: 1.05, // a multiple of the size
    color: col('ink'), align: 'left', overflow: 'wrap',
    placement: at('#hours', 'below', 0, 2.5, { width: 'fill' }) },
] } };
// The folio and the book's title under the text block, flush with its left edge, on the
// baseline of the plates' numerals. Not on the plates: a span heading opens their pages, so
// they are opener pages, and 'body' leaves them out.
const foot = (id, content, extra) => ({ kind: 'text', id, content, pages: 'body',
  fontFamily: 'Syne Mono', fontSize: pt(7.5), letterSpacing: pt(0.8), color: col('muted'),
  align: 'left', ...extra });
const FOOT = NUMERAL.y + dropTo(NUMERAL.size, 7.5) - (PAGE.height - MARGIN.bottom); // from the foot
const footer = { elements: [
  foot('folio', '{pageNumber}', { color: col('ink'),
    placement: at('container', 'top-left', 0, FOOT) }),
  foot('book', '{title}', { textTransform: 'uppercase', placement: at('#folio', 'right-of', 5) }),
] };

A prancha antes de um texto enche a página, por isso o texto começa na página seguinte sem quebra própria. Uma página cujo primeiro bloco é um título com quebra é uma página de abertura, e o pages: 'body' do fólio a deixa de fora. Sem quebra, as páginas de texto mantêm o fólio; as pranchas, abertas por títulos na largura da página, ficam sem ele. breakBefore: { enabled: false } desativa a quebra para página ímpar que um título de nível 1 tem por padrão; com essa quebra, a página de cada texto seria uma página de abertura, sem fólio. FOOT põe o fólio na linha de base dos numerais das pranchas, a 193,4 mm do topo da página, de modo que o fólio de um texto e o numeral da prancha em frente ficam na mesma linha.

#5 · Declare todas as pranchas e cite só a que flutua

script.js · linhas 195–221no código completo
// Plate IV is the one plate that floats, so a counter of its type would number it 1. The type
// prints no number (no caption prefix, an empty template) and the caption carries the numeral.
// The text names the plate with :ref's text, since a bare :ref prints 'lámina' and nothing else.
const lamina = { id: 'lamina', name: t({ en: 'Plate', es: 'Lámina' }),
  shortLabel: t({ en: 'plate', es: 'lámina' }), numberingTemplate: '',
  resetOn: 'never', counterFormat: 'decimal', captionPrefix: '' };
// JPEGs in assets/, cut to the page's shape: 1600 × 1200 px for 280 × 210 mm (145 dpi).
const picture = (id, [w, h], alt, extra = {}) => ({ id, typeId: 'lamina', kind: 'bitmap',
  bitmap: { fileId: `${id}-${w}.jpg`, format: 'jpeg', width: w, height: h },
  createdAt: 0, updatedAt: 0, altText: t(alt), ...extra });
const resources = [ // the five the heading styles draw, never cited, and plate IV
  picture('alba', [1600, 1200], { en: 'Eight ridges fading into a peach dawn haze.',
    es: 'Ocho crestas que se pierden en la bruma del alba.' }),
  picture('mediodia', [1600, 1200], { en: 'A granite cirque and its lake under a pale noon sky.',
    es: 'Un circo de granito y su laguna bajo el cielo pálido del mediodía.' }),
  picture('tormenta', [2400, 900], { en: 'A storm over the range: rain on the left, lightning '
    + 'and a break of sun on the right.', es: 'Una tormenta sobre la sierra: lluvia a la '
    + 'izquierda; un rayo y un claro de sol a la derecha.' }),
  picture('noche', [1600, 1200], { en: 'Stars over dark ridges and two lit windows at a refuge.',
    es: 'Estrellas sobre crestas oscuras y dos ventanas encendidas en un refugio.' }),
  picture('nieve', [1600, 1200], { en: 'The cirque the morning after, white with new snow.',
    es: 'El circo a la mañana siguiente, blanco de nieve nueva.' }),
  // 2000 px, 339 mm at the layout's 150 dpi, which the float fits to the 100 mm measure.
  picture('atardecer', [2000, 800], { en: 'A crest lit orange under strips of cloud, violet sky.',
    es: 'Una cresta encendida de naranja bajo franjas de nube, en un cielo violeta.' },
  { caption: t({ en: 'IV · Dusk · 19:41', es: 'IV · Atardecer · 19:41' }) }),
];

Um elemento de imagem de um design desenha um recurso declarado, por isso as seis imagens estão em resources: JPEGs da pasta assets/ da receita, cada um recortado no formato da página ou da página dupla que preenche e declarado com o tamanho em pixels, que é só o que a diagramação lê. loadImage() registra cada arquivo antes da composição. A prancha IV é a única citada com :ref e, por isso, a única que flutua. Ela ocupa o primeiro espaço livre depois da citação, na página do texto, uma linha abaixo do último parágrafo. Um tipo numerado lhe daria a legenda Plate 1, já que ela é o único recurso do tipo que flutua. lamina, em vez disso, tem um numberingTemplate e um captionPrefix vazios, de modo que não se imprime Plate., e a própria legenda começa com IV. Na frase, o text do :ref dá nome à prancha, porque um :ref sem ele imprime só a palavra plate.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 068 · Photo essay with full-bleed plates ═══════════════
// https://postext.dev/en/cookbook/photo-essay-full-bleed
// Code: MIT · Text: original (CC BY 4.0) · Plates: diffusion models
// Fonts: Andada Pro, Syne, Syne Mono (SIL OFL 1.1) · Needs postext ≥ 1.42.1
// Sierra, a landscape photobook: one day in a mountain range in six plates, each on a page of
// its own and one across the gutter of a spread, with three short texts between them.
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'photo-essay-full-bleed';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the paper between the plates, the ink and one rust for the labels
const palette = {
  ink: '#1c1f27', // text: the blue-black of the night plate
  paper: '#f3f0ea', // every page's ground: a pale stone, seen only between the plates
  accent: '#94462e', // the times over each text: the dusk plate's rust, dark enough for 8 pt
  muted: '#5f646d', // the running foot and the caption of the small plate
  white: '#fbfaf7', // type set on the plates
};
// col() links a colour to its palette entry; the hex is the value the entry holds.
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries(palette)
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const PAGE = { width: 280, height: 210 }; // a landscape photobook, in mm
const MARGIN = { top: 28, bottom: 24, inner: 40, outer: 140 }; // text pages: a 100 mm measure
const LEAD = 15; // body leading in pt
const at = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
  offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });

// #region answer: the plates' heading styles, generated from a list
// '{attr.art}' is filled in per heading, so a plain plate names its picture on its line:
// # Noon {style="lamina" art="mediodia" …}. Only the cover and the last plate draw extras.
const PLATES = [ // the style id, its picture, the ink of its caption, anything extra it draws
  { id: 'alba', art: 'alba', extra: (colour) => cover(colour) }, // an arrow: cover() is below
  { id: 'lamina', art: '{attr.art}' }, // any plate on a page of its own
  { id: 'pliego', art: '{attr.art}', half: 'verso' }, // one picture across a spread:
  { id: 'pliego-recto', art: '{attr.art}', half: 'recto' }, // the left half, then the right
  { id: 'nieve', art: 'nieve', ink: 'ink', extra: (colour) => colophon(colour) },
];
const plate = ({ id, art, half, ink = 'white', extra = () => [] }) => ({
  id, span: 'page', // an opener: a span heading always starts a page of its own
  // The left half opens on an even page, a verso, so the right half faces it across the
  // gutter (gotcha: parity-page1-recto).
  ...(half === 'verso' && { breakBefore: { enabled: true, parity: 'even' } }),

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

#Faça as pranchas flutuarem de frente para os verbetes

Para pranchas que flutuam até a página ímpar em frente a um verbete de catálogo, com a largura da figura calculada pelas proporções, veja Verbetes de catálogo de frente para as pranchas.

#Abra uma matéria sobre uma foto sangrada

Para uma foto sangrada no alto de uma matéria, com o título e o olho por cima, veja a reportagem de revista.

Erros comuns

Erro comum

A página 1 é ímpar: planeje com os números físicos

A página 1 fica à direita e a 2 é a primeira página par, então planeje as páginas duplas com os números físicos de página: uma abertura em página par fica de frente para a ímpar que vem depois dela. Quebras de página e de coluna →

Erro comum

Sem <marker> nem filtros na arte SVG (vira bitmap)

Uma figura SVG só continua vetorial no PDF sem <marker>, filtros e máscaras; caso contrário, é rasterizada, e filtros muito aninhados podem deixá-la em branco no Chrome. Desenhe as pontas de seta como caminhos (paths). Figuras e tabelas como recursos →

  • Nunca cite uma prancha que um design já desenha. Citada, ela também flutua como figura: um :ref à prancha do meio-dia no primeiro texto põe uma segunda cópia dela na página 3, e a tempestade anda duas páginas, depois de uma página em branco.
  • A prancha do entardecer fica uma linha abaixo do texto, não no pé da página. Na última página de um texto, um flutuante que esteja abaixo dele sobe até o texto (layout.hugClosingFloats, ativado por padrão), e position: 'bottom' não muda nada ali.
  • Cada texto foi ajustado para caber numa página nas duas edições. Se o primeiro passar para a página 3, a prancha do meio-dia vai para a página 4 e a tempestade para as páginas 6 e 7, depois de uma página 5 em branco.
  • A metade direita da tempestade é um segundo título # Storm. A página não imprime esse título, mas um :::toc montado a partir dos títulos lista a tempestade duas vezes, nas páginas 4 e 5.
  • As pranchas terminam no refile, que é a borda do canvas. Com page.cutLines ativado, o canvas cresce em volta do refile, e a sangria em volta de cada prancha mostra a cor do papel. Para impressão, ancore as pranchas em 'bleed' e aumente cada uma pela medida da sangria em todos os lados.

Créditos

Texto
  • The three texts, the captions and the colophon, in Spanish and English, and the six plates, drawn in code · Postext Cookbook · CC BY 4.0
Imagens
  • Plate I, dawn: ridges fading into a peach haze under a dark blue sky · Generated With Diffusion Models · original
  • Plate II, noon: a granite cirque and its lake · Generated With Diffusion Models · original
  • Plate III, storm: rain, lightning and a break of sun across a spread · Generated With Diffusion Models · original
  • Plate IV, dusk: the crest lit orange under a violet sky · Generated With Diffusion Models · original
  • Plate V, night: stars over the ridges and a lit refuge · Generated With Diffusion Models · original
  • Plate VI, snow: the cirque of plate II the morning after · Generated With Diffusion Models · original
Fontes
Andada Pro (SIL OFL 1.1) · Syne (SIL OFL 1.1) · Syne Mono (SIL OFL 1.1)
Sandbox