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
// '{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
- Funcions
- Imatges als dissenys de pàginaEstils de títolObertures dissenyadesAncoratge d'elements de dissenyGeometria per seccióAtributs de títolCapítols que obren en pàgina senarCapçaleres segons el tipus de pàginaCites que col·loquen les figuresTipus de recurs propisEstil dels peusCobertes, portades i colofonsColor del paperMarges simètricsTextos, filets i caixes als dissenys de pàginaPartició de mots i llengua del documentPaleta de color semànticaFigures i taules com a recursosPàgines en un canvas
- Tipografia
- Andada Pro, Syne, Syne Mono (SIL OFL 1.1)
- Recursos
alba-1600.jpgatardecer-2000.jpgmediodia-1600.jpgnieve-1600.jpgnoche-1600.jpgtormenta-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
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
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
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
// 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
// ═══ 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
:refa 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), iposition: '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:::tocgenerat 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.cutLinesactivat, 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
- Recepta
- Ignacio Ferro
- 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)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


