Saltar al contingut principal
Recepta número 68

Receptari · Capítol 7 · Figures i imatges

Assaig fotogràfic amb làmines a sang

Les làmines són estils d'encapçalament fets des d'una llista, i cadascuna omple la pàgina a sang; la de la tempesta travessa l'espai central en dues meitats.

En aquesta pàgina
Sortida
Canvas
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.42.1
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 280 × 210 mm
  • 1 columna
  • Andada Pro 10,5/15
  • Syne
  • Syne Mono
  • 9 pàgines
  • Nivell
  • Postext 1.57.1
  • Compost en 49 ms
  • 177 línies de codi

En poques paraules

Un fotollibre de paisatge que explica un dia a la serra en sis imatges. Ensenya a omplir pàgines senceres amb fotos fins a la vora i a estendre una imatge sobre dues pàgines afrontades.

Què compondràs

Sierra, un fotollibre apaïsat de 280 × 210 mm: un dia en una serra de granit en sis làmines, des de la primera llum fins al matí següent a la primera nevada. Cada làmina omple la pàgina fins al tall i només porta un número petit i l'hora a la cantonada inferior esquerra; la primera porta a més el títol, SIERRA en Syne de 72 pt, calat en blanc sobre el cel de l'alba. La tempesta travessa l'espai central de les pàgines 4 i 5 com una sola imatge. Tres textos breus, en una columna de 100 mm al costat del llom, queden cadascun davant de la làmina que el segueix. El de la tempesta acaba en una làmina més petita, la del capvespre, que flota sota el text i porta el número al peu. L'última làmina repeteix la segona: el mateix circ des del mateix bloc, nevat. Les làmines són fotografies generades amb models de difusió; la de la neu es va fer editant la del migdia, perquè les dues vistes coincideixin.

Aquesta recepta respon a

  • Com dono a cada capítol la seva pròpia foto, el seu color o una variant d'obertura?
  • Com insereixo pàgines en blanc expressament, o començo una secció en una doble pàgina nova?
  • Com amago les capçaleres a les obertures i a les pàgines en blanc, o pinto una pàgina parella en blanc amb el color de la part?
  • Com componc il·lustracions sense numerar: ornaments, vinyetes, logotips?

La resposta curta

script.js · línies 35–57al codi complet
// '{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)),
  ] } },
});

Ingredients

Tipografia
Andada Pro, Syne, Syne Mono (SIL OFL 1.1)
Recursos
  • 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)

Elaboració

#1 · Un estil d'encapçalament per làmina, generat a partir d'una llista

El codi és a la resposta curta, més amunt. plate() genera un estil d'encapçalament a partir de cada fila de PLATES, i el Markdown fixa l'ordre de l'assaig amb una línia per làmina: # Noche {style="lamina" art="noche" n="V" hora="22:10"}. El resourceId de l'element d'imatge és '{attr.art}', un marcador com els d'un text, així que totes les làmines senzilles comparteixen l'estil lamina i indiquen la seva imatge a la línia del títol; només la portada i l'última làmina, que dibuixen alguna cosa més, conserven un estil propi (elements d'imatge). span: 'page' obre cada làmina en una pàgina pròpia. La imatge fa 210 mm d'alt, igual que la pàgina, i un disseny reserva fins a la vora inferior de les seves imatges. És més que els 158 mm de la columna de les pàgines de text, així que la làmina es queda la pàgina sencera i el que ve darrere comença a la següent, sense minHeight ni marges propis.

Els dos estils del plec, pliego i pliego-recto, dibuixen la mateixa imatge de 560 mm, aquí art="tormenta": a la pàgina parella comença a la vora esquerra, i a la senar, 280 mm més a l'esquerra; cada pàgina mostra la seva meitat i el canvas retalla la resta al tall. parity: 'even' manté afrontades les dues meitats. Si treus del Markdown la làmina del migdia i no fixes la paritat, la meitat esquerra obre la pàgina 3, senar, i la dreta queda al dors, a la 4; amb la paritat, la pàgina 3 queda en blanc i la tempesta continua a les pàgines 4 i 5.

#2 · El número i l'hora surten de la línia del títol

script.js · línies 61–72al codi complet
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)) },
];

El número i l'hora són atributs del títol, així que el contingut continua al Markdown i un sol disseny serveix per a totes les làmines. Amb right-of, l'hora es col·loca a la dreta del número i les vores superiors de tots dos queden alineades. La línia de base d'un text de disseny queda a 0,8 de la seva caixa de línia per sota de la vora superior de l'element, i aquesta caixa fa per defecte 1,2 vegades el cos; per això dropTo(13, 8) baixa l'hora 0,8 × 1,2 × (13 − 8) pt i l'hora de 8 pt es recolza a la línia de base del número de 13 pt, a 193,4 mm de la vora superior de la pàgina. L'hora comença amb un punt volat, com el peu de la làmina IV, perquè la I de Syne és una barra llisa que, sola al costat de l'hora, sembla un filet. La meitat dreta de la tempesta no porta peu, i la làmina de la neu compon el seu en tinta perquè el primer pla és blanc.

#3 · Un títol i un colofó sobre les mateixes làmines

script.js · línies 76–90al codi complet
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) }));

La primera làmina és la portada. {title} i {subtitle} llegeixen el frontmatter, i extra a PLATES afegeix els dos elements al disseny d'aquesta làmina, en el color del seu peu. El colofó va a l'última làmina de la mateixa manera, en tinta sobre la neu: dos elements de 7,5 pt, un per línia, presos dels atributs colofon i tipos, alineats a la dreta, el segon a la línia de base del número. Un sol element amb ajust de línia tallaria allà on se li acabés l'amplada; amb un element per línia, el tall cau després de la llicència.

#4 · Els textos segueixen les seves làmines sense salt

script.js · línies 94–114al codi complet
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) }),
] };

La làmina que precedeix un text omple la pàgina, així que el text comença a la següent sense salt propi. Una pàgina que comença amb un títol amb salt és una pàgina d'obertura, i pages: 'body' la deixa sense foli. Sense salt, les pàgines de text conserven el foli; les làmines, obertes per títols amb span, se'n queden sense. breakBefore: { enabled: false } desactiva el salt a pàgina senar que un títol de nivell 1 té per defecte; amb aquest salt, la pàgina de cada text seria una pàgina d'obertura, sense foli. FOOT posa el foli a la línia de base dels números de les làmines, a 193,4 mm de la vora superior, de manera que el foli de cada text i el número de la làmina del davant queden a la mateixa línia.

#5 · Declara totes les làmines i cita només la que flota

script.js · línies 195–221al codi complet
// 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' }) }),
];

Un element d'imatge dibuixa un recurs declarat, així que les sis imatges són a resources: JPEG de la carpeta assets/ de la recepta, cadascun retallat a la forma de la pàgina o de la doble pàgina que omple i declarat amb la seva mida en píxels, que és l'únic que llegeix la composició. loadImage() registra cada fitxer abans de compondre. Només la làmina IV se cita amb :ref, i per això és l'única que flota. Ocupa el primer espai lliure després de la cita, a la pàgina del seu text, una línia per sota de l'últim paràgraf. Un tipus numerat li posaria el peu Làmina 1, perquè és l'únic recurs del seu tipus que flota. lamina té en canvi un numberingTemplate i un captionPrefix buits, de manera que no s'imprimeix Làmina., i el mateix peu comença per IV. A la frase, la làmina s'anomena amb el text de :ref, perquè un :ref sense text imprimeix només la paraula lámina.

La recepta 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 = 'es'; // @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' } }),

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

#Fes flotar les làmines davant de les seves fitxes

Per a làmines que floten fins a la pàgina senar, davant de la fitxa d'un catàleg, amb l'amplada de la figura calculada a partir de les seves proporcions, consulta Fitxes de catàleg davant de les seves làmines.

#Obre un article sobre una foto a sang

Per a una foto a sang al capdavant d'un article, amb el titular i l'entradeta a sobre, consulta el reportatge de revista.

Errors freqüents

Error freqüent

La pàgina 1 és senar: planifica amb números físics

La pàgina 1 queda a la dreta i la 2 és la primera pàgina parella, així que planifica els plecs amb números de pàgina físics: una obertura en pàgina parella queda davant de la senar que la segueix. Salts de pàgina i de columna →

Error freqüent

Sense <marker> ni filtres als SVG, o passen a mapa de bits

Una figura SVG només continua sent vectorial al PDF sense <marker>, filtres ni màscares; si no, passa a mapa de bits, i els filtres molt imbricats la poden deixar en blanc a Chrome. Dibuixa les puntes de fletxa com a traçats. Figures i taules com a recursos →

  • No citis mai una làmina que ja dibuixa un disseny. Citada, flota a més com a figura: un :ref a la làmina del migdia al primer text posa una segona còpia a la pàgina 3, i la tempesta es retarda dues pàgines, després d'una pàgina en blanc.
  • La làmina del capvespre queda una línia per sota del seu text, no al peu de la pàgina. A l'última pàgina d'un text, el flotant que queda a sota puja fins al text (layout.hugClosingFloats, activat per defecte), i position: 'bottom' no hi canvia res.
  • Cada text està ajustat a una pàgina en les dues edicions. Si el primer passa a la pàgina 3, la làmina del migdia se'n va a la 4 i la tempesta a les pàgines 6 i 7, després d'una pàgina 5 en blanc.
  • La meitat dreta de la tempesta és un segon títol # Tormenta. La pàgina no imprimeix aquest títol, però un :::toc generat a partir dels títols recull la tempesta dues vegades, a les pàgines 4 i 5.
  • Les làmines acaben al tall, que és la vora del canvas. Amb page.cutLines activat, el canvas creix al voltant del tall, i la franja de sang de cada làmina surt del color del paper. Per a impremta, ancora les làmines a 'bleed' i fes-les créixer, per cada costat, el que faci la sang.

Crèdits

Text
  • 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
Imatges
  • 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
Fonts
Andada Pro (SIL OFL 1.1) · Syne (SIL OFL 1.1) · Syne Mono (SIL OFL 1.1)
Sandbox