En pocas palabras
Un fotolibro de paisaje que cuenta un día en la sierra en seis imágenes. Enseña a llenar páginas enteras con fotos hasta el borde y a extender una imagen sobre dos páginas enfrentadas.
Lo que vas a componer
Sierra, un fotolibro apaisado de 280 × 210 mm: un día en una sierra de granito en seis láminas, desde la primera luz hasta la mañana siguiente a la primera nevada. Cada lámina llena su página hasta el corte y solo lleva un número pequeño y la hora en la esquina inferior izquierda; la primera lleva además el título, SIERRA en Syne de 72 pt, calado en blanco sobre el cielo del alba. La tormenta cruza el medianil de las páginas 4 y 5 como una sola imagen. Tres textos breves, en una columna de 100 mm junto al lomo, quedan cada uno enfrente de la lámina que lo sigue. El de la tormenta termina en una lámina más pequeña, la del atardecer, que flota bajo el texto y lleva su número en el pie. La última lámina repite la segunda: el mismo circo desde el mismo bolo, nevado. Las láminas son fotografías generadas con modelos de difusión; la de la nieve se hizo editando la del mediodía, para que las dos vistas coincidan.
Esta receta responde a
- ¿Cómo doy a cada capítulo su propia foto, su color o una variante de apertura?
- ¿Cómo inserto páginas en blanco a propósito, o empiezo una sección en una doble página nueva?
- ¿Cómo oculto las cabeceras en las aperturas y las páginas en blanco, o pinto una página par en blanco con el color de la parte?
- ¿Cómo compongo ilustraciones sin numerar: adornos, viñetas, logotipos?
La respuesta corta
// '{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
- Funciones
- Imágenes en los diseños de páginaEstilos de títuloAperturas diseñadasAnclaje de elementos de diseñoGeometría por secciónAtributos de títuloCapítulos que abren en página imparCabeceras según el tipo de páginaCitas que colocan las figurasTipos de recurso propiosEstilo de los piesCubiertas, portadas y colofonesColor del papelMárgenes simétricosTextos, filetes y cajas en los diseños de páginaSeparación silábica e idioma del documentoPaleta de color semánticaFiguras y tablas como recursosPáginas en un canvas
- Tipografía
- Andada Pro, Syne, Syne Mono (SIL OFL 1.1)
- Recursos
alba-1600.jpgatardecer-2000.jpgmediodia-1600.jpgnieve-1600.jpgnoche-1600.jpgtormenta-2400.jpg- Lámina I, alba: crestas que se pierden en una bruma melocotón bajo un cielo azul oscuro (Generated With Diffusion Models, original)
- Lámina II, mediodía: un circo de granito y su laguna (Generated With Diffusion Models, original)
- Lámina III, tormenta: lluvia, un rayo y un claro de sol a doble página (Generated With Diffusion Models, original)
- Lámina IV, atardecer: la cresta encendida de naranja bajo un cielo violeta (Generated With Diffusion Models, original)
- Lámina V, noche: estrellas sobre las crestas y un refugio iluminado (Generated With Diffusion Models, original)
- Lámina VI, nieve: el circo de la lámina II a la mañana siguiente (Generated With Diffusion Models, original)
Elaboración
#1 · Un estilo de título por lámina, generado a partir de una lista
El código está en la respuesta corta, más arriba. plate() genera un estilo de encabezado a partir de cada fila de PLATES, y el Markdown fija el orden del ensayo con una línea por lámina: # Noche {style="lamina" art="noche" n="V" hora="22:10"}. El resourceId del elemento de imagen es '{attr.art}', un marcador como los de un texto, así que todas las láminas sencillas comparten el estilo lamina e indican su imagen en la línea del encabezado; solo la portada y la última lámina, que dibujan algo más, conservan un estilo propio (elementos de imagen). span: 'page' abre cada lámina en una página propia. La imagen mide 210 mm de alto, lo mismo que la página, y un diseño reserva hasta el borde inferior de sus imágenes. Es más que los 158 mm de la columna de las páginas de texto, así que la lámina se queda con la página entera y lo que viene detrás empieza en la siguiente, sin minHeight ni márgenes propios.
Los dos estilos de la doble página, pliego y pliego-recto, dibujan la misma imagen de 560 mm, aquí art="tormenta": en la página par empieza en el borde izquierdo, y en la impar, 280 mm más a la izquierda; cada página muestra su mitad y el canvas recorta el resto en el corte. parity: 'even' mantiene enfrentadas las dos mitades. Si quitas del Markdown la lámina del mediodía y no fijas la paridad, la mitad izquierda abre la página 3, impar, y la derecha queda al dorso, en la 4; con la paridad, la página 3 se queda en blanco y la tormenta sigue en las páginas 4 y 5.
#2 · El número y la hora salen de la línea del título
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 y la hora son atributos del encabezado, así que el contenido sigue en el Markdown y un solo diseño sirve para todas las láminas. Con right-of, la hora se coloca a la derecha del número y los bordes superiores de los dos quedan alineados. La línea base de un texto de diseño queda a 0,8 de su caja de línea por debajo del borde superior del elemento, y esa caja mide por defecto 1,2 veces el cuerpo; por eso dropTo(13, 8) baja la hora 0,8 × 1,2 × (13 − 8) pt y la hora de 8 pt se apoya en la línea base del número de 13 pt, a 193,4 mm del borde superior de la página. La hora empieza con un punto medio, como el pie de la lámina IV, porque la I de Syne es una barra lisa que, sola junto a la hora, parece un filete. La mitad derecha de la tormenta no lleva pie, y la lámina de la nieve compone el suyo en tinta porque su primer plano es blanco.
#3 · Un título y un colofón sobre las propias láminas
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 es la portada. {title} y {subtitle} leen el frontmatter, y extra en PLATES añade los dos elementos al diseño de esa lámina, en el color de su pie. El colofón va en la última lámina de la misma manera, en tinta sobre la nieve: dos elementos de 7,5 pt, uno por línea, tomados de los atributos colofon y tipos, alineados a la derecha, el segundo en la línea base del número. Un solo elemento con ajuste de línea cortaría allí donde se le acabara el ancho; con un elemento por línea, el corte cae después de la licencia.
#4 · Los textos siguen a sus láminas sin salto
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 precede a un texto llena su página, así que el texto empieza en la siguiente sin salto propio. Una página cuyo primer bloque es un título con salto es una página de apertura, y pages: 'body' la deja sin folio. Sin salto, las páginas de texto conservan su folio; las láminas, abiertas por títulos con span, se quedan sin él. breakBefore: { enabled: false } desactiva el salto a página impar que un encabezado de nivel 1 tiene por defecto; con ese salto, la página de cada texto sería una página de apertura, sin folio. FOOT pone el folio en la línea base de los números de las láminas, a 193,4 mm del borde superior, de modo que el folio de cada texto y el número de la lámina de enfrente quedan en la misma línea.
#5 · Declara todas las láminas y cita solo 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 elemento de imagen dibuja un recurso declarado, así que las seis imágenes están en resources: JPEG de la carpeta assets/ de la receta, cada uno recortado a la forma de la página o de la doble página que llena y declarado con su tamaño en píxeles, que es lo único que lee la composición. loadImage() registra cada archivo antes de componer. Solo la lámina IV se cita con :ref, y por eso es la única que flota. Ocupa el primer hueco libre tras la cita, en la página de su texto, una línea por debajo del último párrafo. Un tipo numerado le pondría el pie Lámina 1, porque es el único recurso de su tipo que flota. lamina tiene en cambio un numberingTemplate y un captionPrefix vacíos, de modo que no se imprime Lámina., y el propio pie empieza por IV. En la frase, la lámina se cita con el text de :ref, porque un :ref sin text imprime solo la palabra lámina.
La receta 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' } }),
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Haz flotar las láminas frente a sus fichas
Para láminas que flotan hasta la página impar, enfrente de la ficha de un catálogo, con el ancho de la figura calculado a partir de sus proporciones, consulta Fichas de catálogo frente a sus láminas.
#Abre un artículo sobre una foto a sangre
Para una foto a sangre en la cabeza de un artículo, con el titular y la entradilla encima, consulta el reportaje de revista.
Errores frecuentes
Error frecuente
La página 1 es impar: planifica con números físicos
La página 1 queda a la derecha y la 2 es la primera página par, así que planifica los pliegos con números de página físicos: una apertura en página par queda frente a la impar que la sigue. Saltos de página y de columna →
Error frecuente
Sin <marker> ni filtros en los SVG, o pasan a mapa de bits
Una figura SVG solo sigue siendo vectorial en el PDF sin <marker>, filtros ni máscaras; si no, pasa a mapa de bits, y los filtros muy anidados pueden dejarla en blanco en Chrome. Dibuja las puntas de flecha como trazados. Figuras y tablas como recursos →
- No cites nunca una lámina que ya dibuja un diseño. Citada, flota además como figura: un
:refa la lámina del mediodía en el primer texto pone una segunda copia en la página 3, y la tormenta se retrasa dos páginas, tras una página en blanco. - La lámina del atardecer queda una línea por debajo de su texto, no al pie de la página. En la última página de un texto, el flotante que queda debajo de él sube hasta el texto (
layout.hugClosingFloats, activado por defecto), yposition: 'bottom'no cambia nada ahí. - Cada texto está ajustado a una página en las dos ediciones. Si el primero pasa a la página 3, la lámina del mediodía se va a la 4 y la tormenta a las páginas 6 y 7, tras una página 5 en blanco.
- La mitad derecha de la tormenta es un segundo encabezado
# Tormenta. La página no imprime ese título, pero un:::tocgenerado a partir de los títulos recoge la tormenta dos veces, en las páginas 4 y 5. - Las láminas terminan en el corte, que es el borde del canvas. Con
page.cutLinesactivado, el canvas crece alrededor del corte, y la franja de sangrado de cada lámina sale del color del papel. Para imprenta, ancla las láminas a'bleed'y agrándalas lo que mida el sangrado por cada lado.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Los tres textos, los pies y el colofón, en español y en inglés, y las seis láminas, dibujadas en código · Postext Cookbook · CC BY 4.0
- Imágenes
- Lámina I, alba: crestas que se pierden en una bruma melocotón bajo un cielo azul oscuro · Generated With Diffusion Models · original
- Lámina II, mediodía: un circo de granito y su laguna · Generated With Diffusion Models · original
- Lámina III, tormenta: lluvia, un rayo y un claro de sol a doble página · Generated With Diffusion Models · original
- Lámina IV, atardecer: la cresta encendida de naranja bajo un cielo violeta · Generated With Diffusion Models · original
- Lámina V, noche: estrellas sobre las crestas y un refugio iluminado · Generated With Diffusion Models · original
- Lámina VI, nieve: el circo de la lámina II a la mañana siguiente · Generated With Diffusion Models · original
- Fuentes
- Andada Pro (SIL OFL 1.1) · Syne (SIL OFL 1.1) · Syne Mono (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


