简单来说
纸店的一本小样册。每一页都写着自己印在哪种纸上,在3D查看器里,每一页看起来、翻起来都真的像那种纸。
成品一览
虚构的布里斯托尔纸商Harwell & Daughters的The Stock Book:十二页,成品尺寸120 × 176毫米,卡纸封面,四张内页各自介绍印着它的那种纸。每张纸的正面是这种纸的纸卡,写明克重、松厚度、表面处理、色调和不透明度;背面是一页按这种纸的常见用途排的文字:小说、信件、图版说明、词汇表。在屏幕上平铺时,十二页印出来没有区别。在Folio里,每张纸都有自己的纸张:米色的松厚纸,带条纹的直纹纸,翻起来平直坚挺的铜版纸,以及40克、一翻就落下、还能透出背面字迹的字典纸。
这道食谱解答
- 怎样让封面、插页或图版使用与全书不同的纸张?
- 怎样把文档显示成读者可以用手翻页的3D书本?
简短回答
const stocks = doc.pages.map((page) => page.paper?.type ?? 'the book’s paper');
const stage = document.createElement('section');
stage.id = 'folio';
stage.ariaLabel = 'The stock book in 3D';
stage.style.cssText = 'height: min(78vh, 720px); margin: 0 auto; max-width: 1280px';
document.getElementById('pages').before(stage);
createFolioFromDocument(stage, doc, {
appearance: { textureBaseUrl: 'https://postext.dev/folio/textures' },
alt: (i) => `Page ${i + 1}, printed on ${stocks[i]}`,
// page.paper is the fence's attributes as written: { type: 'bible', grammage: 40 }.
onChange: ({ pages }) => kitStatus(pages.map((i) => `p. ${i + 1}: ${stocks[i]}`
+ (doc.pages[i].paper?.grammage ? ` ${doc.pages[i].paper.grammage} g/m²` : ''))
.join(' · ')),
});
用料
- 类型
- Crimson Pro, Libre Caslon Display, IBM Plex Sans Condensed(SIL OFL 1.1)
- 素材
- 无:所有图片都用代码绘制
做法
#1 · 每张纸一个块
// :::paper{type=bookWove grammage=80}
// ## Book Wove, Natural {kicker="Stock 1 of 4"}
// … the stock card, a :::pagebreak, the specimen page …
// :::
// A fence starts and ends on a new page; each run here fills one leaf, recto and verso
// (gotcha: paper-run-whole-leaves). Canvas, HTML and PDF ignore the stock; Folio draws it.
const markdown = String.raw`---
title: "The Stock Book"
subtitle: "Four papers, each printed on itself"
author: "Harwell & Daughters, Paper Merchants"
---
:::paper{type=cardStock grammage=300 shade=#f7f3ea}
# The Stock Book {style="cover" kicker="Harwell & Daughters · Paper Merchants" season="Autumn 2026 · Four stocks on four leaves"}
# How to use this book {kicker="Before you begin"}
Every leaf in this book is printed on the paper it describes. The front of each leaf names the stock and gives its numbers; the back carries a page of type set the way that paper is most often used, so you can judge it as a reader will meet it.
Turn the leaves slowly. A heavy sheet turns in a wide, stiff curve, and a light one falls over almost at once. Hold a page up to the window and you will see how much of the reverse shows through. Run a thumb along the edge and you will feel the coating, or the lack of it.
The numbers on each card are the ones a printer asks for. Weight is in grams per square metre. Bulk, in cubic centimetres per gram, says how much thickness a gram of the paper gives you: multiply the two and you have the caliper of a single sheet in microns, and from that the spine of a book.
The covers are our house board, a 300 g uncoated card that takes a crease without cracking. We use it for the covers of this book and for most of the menus and programmes our customers print with us.
:::
:::paper{type=bookWove grammage=80}
# Book Wove, Natural {kicker="Stock 1 of 4"}
:::paragraphs{style="spec"}
**Weight** 80 g/m²
**Bulk** 1.6 cm³/g · a sheet of 128 µm
**Finish** uncoated, with a soft wove surface
**Shade** natural, a warm cream
**Opacity** 94 %
:::
A bulky, lightweight sheet made for novels. It is thicker than its weight suggests, so a short book still feels substantial in the hand, and its cream shade is kinder to the eye over a long evening than a bright white.
The wove surface comes from the woven wire the sheet forms on: an even, faint texture you see only at a low angle. Ink sits into it rather than on it, and type keeps a little softness at its edges.
**Best for** fiction, memoir, poetry, any book that is read rather than consulted.
:::pagebreak
## Specimen
The ferry left the north bank at six every evening, whatever the weather, and for thirty-one years Tobias Wren had written its passengers into a ledger bound in green cloth. He wrote the date, the hour and the state of the river, and then a line for every soul who came aboard: a name if they gave one, a description if they did not.
The river at Hallam is four hundred yards wide and never still. It comes down from the moors brown with peat, carrying branches and once, in the flood of the year his daughter was born, the roof of a barn with a goat standing on it. Tobias took the goat across for nothing and wrote it down as a passenger.
On the evening of the last crossing the light was going early. October had turned cold all at once, and the willows on the south bank had dropped their leaves in a single night, so that the landing stage looked bare and new.
:::
:::paper{type=uncoated grammage=100 texture=laid textureStrength=1.5 shade=#fbf8f1}
# Laid Writing, White {kicker="Stock 2 of 4"}
:::paragraphs{style="spec"}
**Weight** 100 g/m²
**Bulk** 1.25 cm³/g · a sheet of 125 µm
**Finish** uncoated, with laid and chain lines
**Shade** a soft, unbleached white
**Opacity** 96 %
:::
A writing paper with a ribbed surface. Close laid lines run across the sheet and wider chain lines cross them, the pattern a dandy roll presses into the wet web. Tilt the page under a lamp and the ribs catch the light.
It is a paper for letters and announcements more than for books: firm enough to stand in an envelope, rough enough to take a fountain pen without feathering, and quiet enough to print a single paragraph on and leave the rest of the sheet empty.
**Best for** letterheads, invitations, certificates, the endpapers of a fine edition.
:::pagebreak
## Specimen
*Harwell & Daughters, 14 Rope Walk, Bristol*
Dear Mrs Okafor,
Thank you for your letter and the proofs of the wedding stationery, which arrived this morning in perfect order. We agree that the laid sheet suits the invitation far better than the smooth one; the lines give the lettering something to rest on.
We have set aside two reams from the same making, so that the reply cards and the order of service will match the invitation exactly. Papers from different makings can differ by a shade, and on a table set side by side the difference shows.
The envelopes will follow on Thursday. If you would like the flaps lined, we keep a tissue in four colours and would be glad to send samples.
With our best wishes for the day,
*Ruth Harwell*
:::
:::paper{type=coatedGloss grammage=150 showThrough=false}
# Art Gloss, Bright White {kicker="Stock 3 of 4"}
:::paragraphs{style="spec"}
**Weight** 150 g/m²
**Bulk** 0.8 cm³/g · a sheet of 120 µm
**Finish** coated both sides, calendered to a gloss
**Shade** bright white
**Opacity** 98 %
:::
A heavy coated sheet, polished between steel rollers until it shines. The clay coating fills the hollows between the fibres, so ink stays on the surface and dries as a sharp, saturated dot. Photographs come up with deep blacks and clean highlights.
Because the coating is calendered hard, the sheet is thinner for its weight than an uncoated one, and noticeably stiffer. It turns as a single flat plane and lands with a sound. Nothing shows through from the reverse.
**Best for** art books, exhibition catalogues, posters, the plate section of a history.
:::pagebreak
## Specimen
*Plate 14.* Evening light on the estuary at Pill, looking west towards the two bridges. The photograph was taken from the old pilots’ steps an hour before high water, when the mud is still uncovered and holds the colour of the sky.
*Plate 15.* A barge loaded with Norwegian timber passes under the suspension bridge in 1931. Glass negative, the Harwell family collection; printed here at the size of the original plate.
On this paper the four process inks print as they will in the book: :swatch{color="cyan"} cyan, :swatch{color="magenta"} magenta, :swatch{color="yellow"} yellow and :swatch{color="key"} black, side by side and never muddied by the sheet.
Ask for the plate section of a book to be printed on gloss and bound in among the uncoated pages of the text: the reader will feel the change of paper at every turn.
:::
:::paper{type=bible grammage=40}
# India Bible, Opaque {kicker="Stock 4 of 4"}
:::paragraphs{style="spec"}
**Weight** 40 g/m²
**Bulk** 1.1 cm³/g · a sheet of 44 µm
**Finish** uncoated, with a fine vellum tooth
**Shade** an ivory white
**Opacity** 82 %
:::
The thinnest sheet we stock that will still go through a book press. A thousand pages of it make a spine of under five centimetres, which is why dictionaries, prayer books and the collected works of the long-winded are printed on it.
It is strong for its weight, but it is not opaque. Hold this leaf up and you will read the type on its back through the sheet. Good setting on a thin paper prints the lines of both sides in register, so that the show-through falls between the lines and not across them.
**Best for** dictionaries, scriptures, reference works, timetables, pocket editions.
:::pagebreak
## Specimen
:::paragraphs{style="entry"}
**caliper** *n.* The thickness of a single sheet of paper or board, measured in microns. From the instrument used to measure it.
**chain lines** *n. pl.* The widely spaced lines of a laid paper, left by the wires that hold the laid wires of the mould in place.
**deckle** *n.* The rough, feathered edge of a handmade sheet, where the pulp ran under the frame of the mould.
**grain** *n.* The direction in which most fibres in a sheet lie. A book folds and opens well when the grain runs parallel to its spine.
**opacity** *n.* The degree to which a sheet hides what is printed on its reverse.
**ream** *n.* Five hundred sheets of paper, once four hundred and eighty.
:::
:::
:::paper{type=cardStock grammage=300 shade=#f7f3ea}
# Ordering {kicker="Harwell & Daughters"}
Every stock in this book is held in our warehouse in full reams and in the sizes most printers use. Samples of any paper are free; send us the job and we will send the sheets. Orders placed before noon leave the same day.
When you write, give the weight and the name as they appear on the cards. If you are matching an earlier job, send us a sheet of it: we will find the making it came from.
:::paragraphs{style="colophon"}
Set in Crimson Pro, Libre Caslon Display and IBM Plex Sans Condensed (SIL Open Font License) · Text: original, CC BY 4.0 · Harwell & Daughters is a fictional merchant.
:::
# Harwell & Daughters {style="back" address="14 Rope Walk · Bristol · since 1897"}
:::
`; // content.<lang>.md, inlined by the Cookbook
:::paper块从新页开始,块后面的文字也从新页开始,所以这里每一段正好占满一张纸:正面是纸卡,接着一个:::pagebreak,背面是样张。一张纸的两面只有一种纸张,取自它的右页:从左页开始的换纸段,会把那一页印在它所在那张纸的纸张上(见常见问题)。
#2 · 全书的纸张和封面
const folio = {
tilt: 24,
// The paper of any page outside a :::paper fence (there are none here). Each fence's
// attributes override these field by field, and past them the stock's defaults apply.
paper: { type: 'uncoated' },
// 'pages': page 1 turns as the front board and page 12, a verso, as the back board, so no
// case is drawn round the block (gotcha: folio-cover-pages-even).
binding: { type: 'paperback', cover: 'pages', coverMaterial: 'paper' },
surface: { type: 'linen' },
lighting: { environment: 'daylight', intensity: 1 },
};
folio.paper是所有不在块里的页面所用的纸;块的属性逐项覆盖它,其余项取这种纸的默认值。cover: 'pages'让第1页成为封面、第12页成为封底,书在你打开之前是合上的;这要求页数为偶数,封底的parity: 'even'分页保证了这一点。
#3 · 出血的封面
const field = { kind: 'box', id: 'field', style: { backgroundColor: col('oxblood') },
placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(TRIM_H) } } };
const front = { enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field,
text('kicker', '{attr.kicker}', { ...label, fontSize: pt(7.5), color: col('cream') },
at('page', 'top-left', INNER, 22)),
text('title', '{titleText}', { fontFamily: 'Libre Caslon Display', fontSize: pt(52),
lineHeight: 0.95, color: col('cream'), align: 'left' },
{ ...at('#kicker', 'below', 0, 30), size: { width: mm(TRIM_W - INNER - OUTER) } }),
text('subtitle', '{subtitle}', { fontFamily: 'Crimson Pro', italic: true,
fontSize: pt(12), lineHeight: 1.3, color: col('cream'), align: 'left' },
{ ...at('#title', 'below', 0, 6), size: { width: mm(80) } }),
text('season', '{attr.season}', { ...label, fontSize: pt(7), color: col('cream') },
at('page', 'bottom-left', INNER, -18)),
] } };
const back = { enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field,
text('name', '{titleText}', { fontFamily: 'Libre Caslon Display', fontSize: pt(20),
lineHeight: 1, color: col('cream'), align: 'center' },
{ ...at('page', 'center', 0, -4), size: { width: mm(90) } }),
text('address', '{attr.address}', { ...label, fontSize: pt(6.8), color: col('cream'),
align: 'center' }, { ...at('#name', 'below', 0, 4), size: { width: mm(90) } }),
] } };
// The covers are the book's two openers; the folio skips them (pages: 'body', below).
// No margins: the design's column is the whole page, so the field reaches every edge, and the
// style's margins last only as long as its section, the cover page.
const flush = { span: 'page', margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const headingStyles = [
{ id: 'cover', numbered: false, toc: false, advancedDesign: front, ...flush },
{ id: 'back', numbered: false, toc: false, advancedDesign: back, ...flush,
breakBefore: { enabled: true, parity: 'even' } }, // the last page, a verso
];
每个封面都是一个标题样式,其设计里有一块与成品尺寸一样大的色块。这个样式在它的区段内把页边距设为零,而区段只有封面这一页,所以色块铺满每条边,后面的页面保留自己的页边距。
#4 · 纸卡
const card = { enabled: true, minHeight: mm(25), slot: { elements: [
text('kicker', '{attr.kicker}', { ...label, fontSize: pt(7), color: col('oxblood') },
at('container', 'top-left', 0, 2)),
text('name', '{titleText}', { fontFamily: 'Libre Caslon Display', fontSize: pt(24),
lineHeight: 1.05, color: col('ink'), align: 'left' },
{ ...at('#kicker', 'below', 0, 2.5), size: { width: 'fill' } }),
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.5), color: col('rule'),
placement: { ...at('#name', 'below', 0, 3.5), size: { width: 'fill' } } },
] } };
const spec = { id: 'spec', fontFamily: 'IBM Plex Sans Condensed', fontSize: pt(8),
lineHeight: pt(LEAD * 0.85), textAlign: 'left', firstLineIndent: pt(0), color: col('ink'),
boldColor: col('oxblood') };
每张纸都以一个由设计槽位绘制的一级标题开头:眉题取自标题的属性,然后是纸名和一条细线。规格行是一个段落样式,用窄体标签字体,粗体标签用强调色。
#5 · 从版面里读出纸张
代码就是上面的简短回答。在块内排出的每一页,都在page.paper里带着块的属性,原样照录:{ type: 'bible', grammage: 40 }。createFolioFromDocument把它们交给查看器,查看器按各自的纸张画每一张纸;这个pen还读取它们,写进状态栏和每一页的替代文字。
完整食谱
// ═══ Postext Cookbook · Nº 101 · A swatch book, every leaf on its own paper ═══════════
// https://postext.dev/en/cookbook/paper-swatch-book
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Crimson Pro, Libre Caslon Display, IBM Plex Sans Cond. (OFL) · Needs postext ≥ 1.25.0
//
// A paper merchant's stock book: each leaf sits inside a :::paper fence that names its stock,
// and postext-folio draws that leaf with the stock's shade, surface, stiffness and opacity.
// Turn the leaves and compare: the gloss sheet turns flat and stiff, the bible paper falls
// over at once and shows its back through, the card covers turn as boards.
import { buildDocumentWithFonts, renderPageToCanvas } from 'https://esm.sh/postext';
import { createFolioFromDocument } from 'https://esm.sh/postext-folio';
const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'paper-swatch-book';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the house colours, and the four process inks the gloss page shows
const palette = {
ink: '#22201d', // text
oxblood: '#5e2128', // the covers' colour field, kickers and folios
cream: '#f3ead6', // type on the covers
rule: '#cbc2b3', // hairlines
muted: '#6f675e', // labels, folios, the colophon
cyan: '#00a0e0', magenta: '#e0007a', yellow: '#ffe100', key: '#1b1b1b', // process inks
};
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' } })),
{ id: 'main-color', name: 'accent (defaults)', value: { hex: palette.oxblood, model: 'hex' } },
];
// #endregion
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER] = [120, 176, 18, 20, 16, 14]; // mm
const LEAD = 13.4; // pt
const label = { fontFamily: 'IBM Plex Sans Condensed', fontWeight: 600, letterSpacing: pt(1.2),
textTransform: 'uppercase', align: 'left' };
const at = (to, edge, x = 0, y = 0) => ({ anchor: { to, edge }, offset: { x: mm(x), y: mm(y) } });
const text = (id, content, look, placement) => ({ kind: 'text', id, content, overflow: 'wrap',
placement, ...look });
// #region folio: the book's own paper and binding; the leaves' papers come from the text
const folio = {
tilt: 24,
// The paper of any page outside a :::paper fence (there are none here). Each fence's
// attributes override these field by field, and past them the stock's defaults apply.
paper: { type: 'uncoated' },
// 'pages': page 1 turns as the front board and page 12, a verso, as the back board, so no
// case is drawn round the block (gotcha: folio-cover-pages-even).
binding: { type: 'paperback', cover: 'pages', coverMaterial: 'paper' },
组合好的script.js可以直接运行:把它粘贴到任何页面的模块脚本中,或在CodePen上打开这道食谱。 GitHub上的食谱文件夹 ↗ (在新标签页中打开)
变化
常见问题
易错点
换纸段从新页开始、在新页结束,一张纸取其右页的纸张
:::paper中的文字从新页开始,其后的文字也从新页开始。一张纸有两页而只有一种纸张,即其右页的纸张,所以从左页开始的换纸段,这一页会印在它所在那张纸的纸张上。需要从右页开始的地方,加一个分页。 为一组页面换用纸张 →
易错点
cover: 'pages'需要偶数页才有封底
binding.cover设为'pages'时,第一页作为封面翻动,最后一页只有落在左页时才作为封底。页数为奇数时书只有封面没有封底:把页数补成偶数,或保留书壳。 纸张、装订、台面与光照(Folio) →
易错点
Folio查看器取其容器的尺寸
createFolioFromDocument把书本放进你给它的元素中,按钮和页码显示在元素的边距里。没有高度的元素(正常文档流中的空div)什么也显示不出:要用CSS给它设定高度。 3D书本查看器(Folio) →
致谢
- 文本
- 原创文字, CC BY 4.0
- 字体
- Crimson Pro (SIL OFL 1.1) · Libre Caslon Display (SIL OFL 1.1) · IBM Plex Sans Condensed (SIL OFL 1.1)


