简单来说
说明每幅画在页面上铺到哪里:版心内、裁切线,还是越过裁切线;再用毫米给局部定宽。页面会自己排好。
成品一览
一本160 × 195毫米小型展览图录的七页,内容是荷兰国家博物馆、大都会艺术博物馆和美国国家美术馆收藏的四幅约翰内斯·维米尔室内画。文章从右页开始,标题下沉。文中提到的每幅画都单独占下一个完整的页面:《倒牛奶的女仆》在第2页,位于版心内,书眉照常;《拿水壶的年轻女子》和《读信的女人》在第4、5页相对,一幅齐裁切线,一幅越过裁切标记印进出血,两页都不排书眉和页码。天平的局部在第7页以60毫米宽印出,图注排在旁边。PDF带有裁切标记、TrimBox和BleedBox。
这道食谱解答
- 怎样把一幅画印成整页图版(在版心内、到裁切线或出血),再把一个局部按固定的毫米宽度印出来?
- 怎样做艺术图录:左页放条目,对面右页放图版?
- 怎样制作带出血、裁切标记、书签、页码标签和色彩空间的可付印PDF?
简短回答
// 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' };
用料
- 功能
- 整页图版以毫米计的图宽作为资源的图和表决定图位置的引用自定义资源类型编号题注题注样式来源与出处行侧题注出血与裁切标记按页面角色显示书眉书眉与页码对称页边距设计过的章首页标题属性段落样式语义调色板导出PDF
- 类型
- Spectral, Cormorant Garamond, Jost(SIL OFL 1.1)
- 素材
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)
做法
#1 · 图版用一种类型,每幅画定一个范围
代码就是上面的简短回答。图版类型把plate: true设为默认位置,所以文章引用的画会进入第一个能完整占用的页面,放大到版心,图注在下。REACH逐幅改变它:'trim'和'bleed'铺满整页,并以画面中心裁切,所以最好选比例接近页面的画(这四幅宽高比为0.85到0.89,页面为0.82)。captionMeasure: 'body'让版心内图版的图注与画同宽。
#2 · 文件大小按印刷位置来定
// 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] } }) }));
印前检查会把裁切算进去:这里的出血图版连出血高201毫米,文件要2400像素才能达到300 ppi;版心内的两幅需要的少一些。这几幅印出来在303到348 ppi之间。配置里的page.cutLines给纸张留出3毫米出血;没有它,'bleed'和'trim'一样停在裁切线。
#3 · 书眉避开满版图版
// 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) })] };
到裁切线或出血的图版会让所在页获得'plate'角色。这些书眉写的是pages: 'body',所以版心内图版的页面照常排书眉,第4、5页则不排。确实要在那里出现的元素,比如角落里的小号图片来源,可以在pages里写上'plate'。
#4 · 尺寸可以说清楚的局部
局部类型设为width: { value: 60, unit: 'mm' },并用captionSide: 'inside'。长度是拿来和所在位置比较的,而不是从中分一份:裁出的48毫米画布无论放在哪一栏、哪个版本,都印成60毫米宽,即放大1.25倍,图注也就能写明这一点。
完整食谱
// ═══ 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
组合好的script.js可以直接运行:把它粘贴到任何页面的模块脚本中,或在CodePen上打开这道食谱。 GitHub上的食谱文件夹 ↗ (在新标签页中打开)
变化
#所有图版都印到出血
给每幅画同样的范围:每个图版都铺满整页,不排书眉和页码,只有裁切不同。
-const REACH = { milkmaid: 'content', pitcher: 'trim', letter: 'bleed', balance: 'content' };
+const REACH = { milkmaid: 'bleed', pitcher: 'bleed', letter: 'bleed', balance: 'bleed' };#按原大印局部
从博物馆的文件里裁出60毫米画布,宽度不变:图注就可以写1:1。这幅画的原始文件有1666 ppi,即使只有几毫米的局部也仍然超过300 ppi。
常见问题
- 和另一幅在同一段里被引用的图版会等到再下一页,因为已经有浮动体的页面会被跳过,最多三页。
pt和mm宽度都有效;px和em不被当作长度,图会占满所在位置。- 比页面宽得多的画,在到裁切线或出血的图版上会被裁掉两侧。横幅的画最好留在版心内,整幅都能看到。
致谢
- 文本
- The essay, the captions and the note on the plates · Postext Cookbook · CC BY 4.0
- 图片
- 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
- 字体
- Spectral (SIL OFL 1.1) · Cormorant Garamond (SIL OFL 1.1) · Jost (SIL OFL 1.1)


