In breve
Di’ fin dove arriva ogni dipinto sulla sua pagina, dentro i margini, fino al taglio o oltre, e dai al dettaglio la sua larghezza in millimetri. Le pagine si compongono da sole.
Che cosa comporrai
Sette pagine di un piccolo catalogo di mostra, 160 × 195 mm, su quattro interni di Johannes Vermeer del Rijksmuseum, del Met e della National Gallery of Art. Il saggio si apre su una pagina dispari con il titolo abbassato. Ogni dipinto che cita sta da solo sulla pagina intera successiva: La lattaia a pagina 2, dentro i margini e sotto la sua testatina; la Giovane donna con brocca e la Donna che legge una lettera si guardano alle pagine 4 e 5, l’una fermata al taglio, l’altra spinta nell’abbondanza oltre i segni di taglio, entrambe senza testatina né folio. Un dettaglio della bilancia è stampato largo 60 mm a pagina 7, con la didascalia accanto. Il PDF porta i segni, un TrimBox e un BleedBox.
Questa ricetta risponde a
- Come stampo un dipinto come tavola a piena pagina (dentro i margini, fino al taglio o al vivo) e un dettaglio a una larghezza fissa in mm?
- Come creo un catalogo d’arte: scheda sulla pagina sinistra, tavola sulla pagina destra di fronte?
- Come preparo un PDF pronto per la stampa con abbondanza, crocini di taglio, segnalibri, etichette di pagina e uno spazio colore?
La risposta breve
// Every plate stands alone on the first whole page after its citation, as large as the area
// allows. true (or 'content') keeps it inside the margins with its running heads; 'trim'
// covers the page to the cut, 'bleed' to the bleed. Those two crop the picture about its
// centre, put the caption on a band of paper at the foot, and drop the heads and the folio.
const plateType = { id: 'plate', name: t({ en: 'Plate', es: 'Lámina' }),
shortLabel: t({ en: 'plate', es: 'lámina' }), captionPrefix: t({ en: 'Plate', es: 'Lámina' }),
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
defaultPlacement: { plate: true, captionMeasure: 'body' } }; // the caption as wide as it
const REACH = { milkmaid: 'content', pitcher: 'trim', letter: 'bleed', balance: 'content' };
// A width as a length is measured against the slot, not shared out of it: the detail prints
// 60 mm wide in any layout, 1.25 times the 48 mm of canvas it shows. Its caption stands
// beside it in what is left of the column.
const DETAIL = { width: { value: 60, unit: 'mm' }, captionSide: 'inside', align: 'left' };
Ingredienti
- Funzionalità
- Tavole a piena paginaLarghezze delle figure in millimetriFigure e tabelle come risorseCitazioni che collocano le figureTipi di risorsa personalizzatiDidascalie numerateStile delle didascalieRighe di fonte e creditiDidascalie lateraliAbbondanza e segni di taglioTestatine secondo il ruolo della paginaTestatine e folioMargini speculariAperture progettateAttributi dei titoliStili di paragrafoTavolozza di colori semanticaEsportazione in PDF
- Tipo
- Spectral, Cormorant Garamond, Jost (SIL OFL 1.1)
- Risorse
balance-1700.jpgbalance-detail-1051.jpgletter-2400.jpgmilkmaid-1800.jpgpitcher-2400.jpg- Plate 1, Johannes Vermeer, The Milkmaid, c. 1660, Rijksmuseum SK-A-2344; the museum’s image reduced to 1,800 px high (Rijksmuseum, Amsterdam, CC0 1.0)
- Plate 2, Johannes Vermeer, Young Woman with a Water Pitcher, c. 1662, The Met 89.15.21; the museum’s image, its unpainted edges cut off, reduced to 2,400 px high (The Metropolitan Museum of Art, New York (Open Access), CC0 1.0)
- Plate 3, Johannes Vermeer, Woman Reading a Letter, c. 1663, Rijksmuseum SK-C-251; the museum’s image reduced to 2,400 px high (Rijksmuseum, Amsterdam, CC0 1.0)
- Plate 4, Johannes Vermeer, Woman Holding a Balance, c. 1664, National Gallery of Art 1942.9.97; the museum’s image reduced to 1,700 px high (National Gallery of Art, Washington (Open Access), CC0 1.0)
- Figure 1, a 48 × 63 mm detail of plate 4 cut from the museum’s full-resolution image and reduced to 800 px wide (National Gallery of Art, Washington (Open Access), CC0 1.0)
Preparazione
#1 · Un tipo per le tavole, una portata per dipinto
Il codice è la risposta breve qui sopra. Il tipo delle tavole mette plate: true nella collocazione predefinita, quindi un dipinto citato dal saggio passa alla prima pagina che può avere intera e cresce fino alla gabbia, con la didascalia sotto. REACH lo cambia dipinto per dipinto: 'trim' e 'bleed' coprono la pagina e ritagliano l’immagine attorno al centro, perciò conviene scegliere dipinti di proporzioni vicine a quelle della pagina (questi sono larghi da 0,85 a 0,89 per 1 di altezza, la pagina 0,82). captionMeasure: 'body' dà alla didascalia di una tavola interna la larghezza dell’immagine.
#2 · Ogni file su misura per dove si stampa
// JPEGs in assets/ at the pixels each needs for 300 ppi where it prints: 2,400 px high for
// the plates that cover the page (195 mm + 2 × 3 mm of bleed is 7.9 in), less for the rest.
const PAINTINGS = {
milkmaid: [[1617, 1800], { en: 'Johannes Vermeer, *The Milkmaid*, c. 1660',
es: 'Johannes Vermeer, *La lechera*, h. 1660' }, { en: 'Oil on canvas, 45.5 × 41 cm. '
+ 'Rijksmuseum, Amsterdam, SK-A-2344, purchased with the support of the Vereniging '
+ 'Rembrandt. Public domain.', es: 'Óleo sobre lienzo, 45,5 × 41 cm. Rijksmuseum, '
+ 'Ámsterdam, SK-A-2344, adquirido con el apoyo de la Vereniging Rembrandt. Dominio '
+ 'público.' }, { en: 'A kitchen maid in a yellow bodice and blue apron pours milk from '
+ 'a jug into a bowl beside a basket of bread, under a window on the left.', es: 'Una '
+ 'criada con corpiño amarillo y delantal azul vierte leche de una jarra en un cuenco, '
+ 'junto a un cesto de pan, bajo una ventana a la izquierda.' }],
pitcher: [[2116, 2400], { en: 'Johannes Vermeer, *Young Woman with a Water Pitcher*, '
+ 'c. 1662', es: 'Johannes Vermeer, *Joven con una jarra de agua*, h. 1662' },
{ en: 'Oil on canvas, 45.7 × 40.6 cm. The Metropolitan Museum of Art, New York, 89.15.21, '
+ 'Marquand Collection, gift of Henry G. Marquand, 1889. Public domain.', es: 'Óleo sobre '
+ 'lienzo, 45,7 × 40,6 cm. The Metropolitan Museum of Art, Nueva York, 89.15.21, '
+ 'colección Marquand, donación de Henry G. Marquand, 1889. Dominio público.' },
{ en: 'A young woman in a white linen hood opens a window with one hand and holds a '
+ 'silver-gilt pitcher in a basin with the other; a map hangs behind her.', es: 'Una joven '
+ 'con toca de lino blanco abre una ventana con una mano y sujeta con la otra una jarra '
+ 'de plata dorada sobre una palangana; detrás cuelga un mapa.' }],
letter: [[2039, 2400], { en: 'Johannes Vermeer, *Woman Reading a Letter*, c. 1663',
es: 'Johannes Vermeer, *Mujer leyendo una carta*, h. 1663' }, { en: 'Oil on canvas, '
+ '46.5 × 39 cm. Rijksmuseum, Amsterdam, SK-C-251, on loan from the City of Amsterdam '
+ '(A. van der Hoop Bequest). Public domain.', es: 'Óleo sobre lienzo, 46,5 × 39 cm. '
+ 'Rijksmuseum, Ámsterdam, SK-C-251, en préstamo de la ciudad de Ámsterdam (legado '
+ 'A. van der Hoop). Dominio público.' }, { en: 'A woman in a blue jacket stands reading '
+ 'a letter in front of a map of Holland, between two chairs, lit from the left.',
es: 'Una mujer con chaqueta azul lee una carta de pie ante un mapa de Holanda, entre dos '
+ 'sillas, con la luz a la izquierda.' }],
balance: [[1502, 1700], { en: 'Johannes Vermeer, *Woman Holding a Balance*, c. 1664',
es: 'Johannes Vermeer, *Mujer con una balanza*, h. 1664' }, { en: 'Oil on canvas, '
+ '39.7 × 35.5 cm. National Gallery of Art, Washington, 1942.9.97, Widener Collection. '
+ 'Public domain.', es: 'Óleo sobre lienzo, 39,7 × 35,5 cm. National Gallery of Art, '
+ 'Washington, 1942.9.97, colección Widener. Dominio público.' }, { en: 'A woman stands '
+ 'at a table spread with pearls and coins, holding up a small balance; a painting of the '
+ 'Last Judgment hangs behind her.', es: 'Una mujer, de pie ante una mesa con perlas y '
+ 'monedas, sostiene en alto una pequeña balanza; detrás cuelga un Juicio Final.' }],
'balance-detail': [[800, 1051], { en: 'Detail of :ref{id="balance"}: the beam and its two '
+ 'empty pans. The 48 mm of canvas it shows print 60 mm wide, 1.25 times their size.',
es: 'Detalle de la :ref{id="balance"}: el astil y sus dos platillos vacíos. Los 48 mm de '
+ 'lienzo que muestra se imprimen a 60 mm, 1,25 veces su tamaño.' }, { en: 'National '
+ 'Gallery of Art, Washington. Public domain.', es: 'National Gallery of Art, Washington. '
+ 'Dominio público.' }, { en: 'A hand holds a small balance by its loop between thumb '
+ 'and forefinger; both pans hang empty.', es: 'Una mano sostiene una pequeña balanza por '
+ 'el aro entre el pulgar y el índice; los dos platillos cuelgan vacíos.' }],
};
const resources = Object.entries(PAINTINGS).map(([id, [[w, h], caption, note, alt]]) => ({
id, typeId: REACH[id] ? 'plate' : 'detail', kind: 'bitmap', createdAt: 0, updatedAt: 0,
bitmap: { fileId: `${id}-${h > w ? h : w}.jpg`, format: 'jpeg', width: w, height: h },
caption: t(caption), note: t(note), altText: t(alt),
...(REACH[id] && { placement: { plate: REACH[id] } }) }));
Il controllo di stampa tiene conto del ritaglio: una tavola al vivo qui è alta 201 mm con l’abbondanza, quindi il suo file ha bisogno di 2.400 px per arrivare a 300 ppi, mentre le due tavole nei margini ne chiedono meno. Escono tra 303 e 348 ppi. page.cutLines dà al foglio i suoi 3 mm di abbondanza; senza, 'bleed' si ferma al taglio come 'trim'.
#3 · Testatine che lasciano libere le tavole piene
// pages: 'body' keeps them off the opener; a plate set to the trim or the bleed takes the
// 'plate' role, which no element here names, so its page prints bare.
const head = (id, content, parity, edge, x, extra = {}) => ({ kind: 'text', id, content,
parity, pages: 'body', fontFamily: LABEL, fontSize: pt(7.5), color: col('muted'),
placement: at('page', edge, x, 11), ...caps(7.5), ...extra });
const folio = { color: col('ink'), letterSpacing: pt(0.6) };
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', OUTER, folio),
head('verso-title', '{title}', 'even', 'top-left', OUTER + 8),
head('recto-title', '{chapterTitle}', 'odd', 'top-right', -(OUTER + 8)),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -OUTER, folio),
] };
const footer = { elements: [head('drop-folio', '{pageNumber}', 'all', 'top', 0,
{ ...folio, pages: 'opener', placement: at('container', 'top', 0, 8) })] };
Una tavola al taglio o al vivo dà alla sua pagina il ruolo 'plate'. Queste testatine chiedono pages: 'body', quindi si stampano sopra le tavole interne e spariscono alle pagine 4 e 5. Un elemento che deve comparire anche lì, per esempio un piccolo credito nell’angolo, nomina 'plate' nel suo pages.
#4 · Un dettaglio di misura nota
Il tipo del dettaglio mette width: { value: 60, unit: 'mm' } con captionSide: 'inside'. Una lunghezza si misura sullo spazio invece di prenderne una parte: i 48 mm di tela che il ritaglio mostra si stampano a 60 mm, 1,25 volte la loro misura, in qualunque colonna ed edizione, e la didascalia può dirlo.
La ricetta completa
// ═══ Postext Cookbook · Nº 183 · Art plates to the margins, the trim and the bleed ═════
// https://postext.dev/en/cookbook/art-plates-to-the-bleed
// Code: MIT · Text: original (CC BY 4.0) · Paintings: Rijksmuseum, The Met, NGA (CC0)
// Fonts: Spectral, Cormorant Garamond, Jost (SIL OFL 1.1) · Needs postext ≥ 1.73.0
// An exhibition essay on four interiors by Vermeer. Each painting is a full-page plate: two
// inside the margins, one to the trimmed edge, one out to the bleed. A detail prints 60 mm wide.
import {
buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'art-plates-to-the-bleed';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a warm paper and ink, and the ultramarine of the Delft jackets
const palette = {
ink: '#22201c', // text: a warm near-black
accent: '#2c4a7c', // kicker, caption labels: the blue of the reading woman's jacket
rule: '#c9bfae', // the opener's hairline
muted: '#6b6359', // running heads, folios, credit lines
paper: '#fbf9f4', // the page, and the band under a caption set over a plate
};
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' } })),
// The engine's defaults link to 'main-color': pointed at the accent, no default blue shows.
{ id: 'main-color', name: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// #endregion
const [TEXT, DISPLAY, LABEL] = ['Spectral', 'Cormorant Garamond', 'Jost'];
const [PAGE_W, PAGE_H, TOP, BOTTOM, INNER, OUTER] = [160, 195, 20, 22, 18, 24]; // mm
const BLEED = 3; // mm of picture past the trim on the bleed plate, and the crop marks' offset
const LEAD = 13.5; // body leading in pt
const at = (to, edge, x, y, size) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) },
...(size && { size }) });
const caps = (size) => ({ fontWeight: 500, textTransform: 'uppercase',
letterSpacing: pt(size * 0.2) });
// #region answer: a plate type, and how far each picture reaches
// Every plate stands alone on the first whole page after its citation, as large as the area
// allows. true (or 'content') keeps it inside the margins with its running heads; 'trim'
// covers the page to the cut, 'bleed' to the bleed. Those two crop the picture about its
// centre, put the caption on a band of paper at the foot, and drop the heads and the folio.
const plateType = { id: 'plate', name: t({ en: 'Plate', es: 'Lámina' }),
shortLabel: t({ en: 'plate', es: 'lámina' }), captionPrefix: t({ en: 'Plate', es: 'Lámina' }),
numberingTemplate: '{n}', resetOn: 'never', counterFormat: 'decimal',
defaultPlacement: { plate: true, captionMeasure: 'body' } }; // the caption as wide as it
Lo script.js composto funziona così com’è: incollalo nello script modulo di qualsiasi pagina, oppure apri la ricetta su CodePen. Cartella della ricetta su GitHub ↗ (si apre in una nuova scheda)
Varianti
#Tutte le tavole al vivo
Dai a tutti i dipinti la stessa portata: ogni tavola copre allora la sua pagina, senza testatina né folio, e cambia solo il ritaglio.
-const REACH = { milkmaid: 'content', pitcher: 'trim', letter: 'bleed', balance: 'content' };
+const REACH = { milkmaid: 'bleed', pitcher: 'bleed', letter: 'bleed', balance: 'bleed' };#Il dettaglio a grandezza naturale
Ritaglia 60 mm di tela dal file del museo e lascia la larghezza com’è: la didascalia dirà allora 1:1. L’originale di questo dipinto ha 1.666 ppi, quindi anche un dettaglio di pochi millimetri supera i 300 ppi.
Errori frequenti
- Una tavola citata nello stesso paragrafo di un’altra aspetta la pagina dopo, perché una pagina che ha già un mobile viene saltata, tre al massimo.
- Le larghezze in
ptemmfunzionano;pxedemnon sono lette come lunghezza, e la figura prende tutto il suo spazio. - Un dipinto molto più largo della pagina perde i lati in una tavola al taglio o al vivo. Tieni i formati orizzontali dentro i margini, dove l’immagine si vede intera.
Crediti
- Ricetta
- Ignacio Ferro
- Testo
- The essay, the captions and the note on the plates · Postext Cookbook · CC BY 4.0
- Immagini
- Plate 1, Johannes Vermeer, The Milkmaid, c. 1660, Rijksmuseum SK-A-2344; the museum’s image reduced to 1,800 px high · Rijksmuseum, Amsterdam · CC0 1.0
- Plate 2, Johannes Vermeer, Young Woman with a Water Pitcher, c. 1662, The Met 89.15.21; the museum’s image, its unpainted edges cut off, reduced to 2,400 px high · The Metropolitan Museum of Art, New York (Open Access) · CC0 1.0
- Plate 3, Johannes Vermeer, Woman Reading a Letter, c. 1663, Rijksmuseum SK-C-251; the museum’s image reduced to 2,400 px high · Rijksmuseum, Amsterdam · CC0 1.0
- Plate 4, Johannes Vermeer, Woman Holding a Balance, c. 1664, National Gallery of Art 1942.9.97; the museum’s image reduced to 1,700 px high · National Gallery of Art, Washington (Open Access) · CC0 1.0
- Figure 1, a 48 × 63 mm detail of plate 4 cut from the museum’s full-resolution image and reduced to 800 px wide · National Gallery of Art, Washington (Open Access) · CC0 1.0
- Font
- Spectral (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1) · Jost (SIL OFL 1.1)
- Codice
- MIT, come Postext
Modifica questo testo ↗ (si apre in una nuova scheda)Cartella della ricetta su GitHub ↗ (si apre in una nuova scheda)


