简单来说
一本3D口袋书,旁边是一块控制面板。换纸张、装订、桌面或光照,书马上跟着变,不用重新排版。
成品一览
Six Knots,一本十页的口袋书,成品尺寸110 × 160毫米,在Folio里打开,旁边是一个包含config.folio全部设置的面板。选一种纸,书页的颜色、表面和挺度随之改变;把装订从平装换成精装,书芯外面就多了一个书壳;还可以选书壳而不用印刷的封面,选布面或皮面、桌面、光照和倾角。书只排一次。每次改动都用setAppearance交给查看器,所以没有一行移动,也没有一页重新绘制;表单下方显示这些设置对应的代码,可以直接粘贴到config.folio里。
这道食谱解答
- 付印前怎样预览书的装订、封面、纸张和光照效果?
- 怎样把文档显示成读者可以用手翻页的3D书本?
简短回答
const book = createFolioFromDocument(document.getElementById('folio'), doc, {
// The look starts from doc.config.folio; setAppearance replaces it on every change.
appearance: { textureBaseUrl: 'https://postext.dev/folio/textures' },
onChange: ({ pages }) => kitStatus(`${doc.pages.length} pages · open at `
+ pages.map((i) => i + 1).join('–')),
});
function update() {
const folio = folioOf();
// Only the appearance changes: the pages keep their paintings, nothing is laid out again.
book.setAppearance({ folio });
show('grammage-out', `${folio.paper.grammage} g/m²`);
show('intensity-out', folio.lighting.intensity.toFixed(2));
show('tilt-out', `${folio.tilt}°`);
document.getElementById('folio-json').textContent = `folio: ${JSON.stringify(folio, null, 2)}`;
}
form.addEventListener('input', update);
// A stock sets its own weight: picking one moves the weight slider to the stock's.
const WEIGHTS = { uncoated: 90, bookWove: 80, coatedMatte: 115, coatedSilk: 115,
coatedGloss: 115, bible: 40, newsprint: 48, cardStock: 250 };
form.elements['paper.type'].addEventListener('change', (event) => {
form.elements['paper.grammage'].value = WEIGHTS[event.target.value];
update();
});
document.getElementById('reset-view').addEventListener('click', () => book.resetView());
update();
用料
- 类型
- Source Serif 4, Outfit(SIL OFL 1.1)
- 素材
- 无:所有图片都用代码绘制
做法
#1 · 按配置路径给字段命名
const form = document.getElementById('controls');
const hex = (value) => ({ hex: value, model: 'hex' });
function folioOf() { // 'paper.grammage' → { paper: { grammage } }, typed by the input
const folio = {};
for (const el of form.elements) {
if (!el.name || el.type === 'button' || el.tagName === 'OUTPUT') continue;
const value = el.type === 'checkbox' ? el.checked : el.type === 'range' ? Number(el.value)
: el.type === 'color' ? hex(el.value) : el.value;
const [group, key] = el.name.split('.');
if (key) (folio[group] ??= {})[key] = value;
else folio[group] = value;
}
return folio;
}
const show = (name, value) => { form.elements[name].value = value; };
表单的每个字段都以它在config.folio中的路径命名(paper.grammage、binding.cover、lighting.environment),所以一个循环就能把表单变成查看器需要的对象:滑块给出数字,复选框给出布尔值,取色器给出{ hex, model }颜色。pen排版时,这个对象也就是文档自己的config.folio,因此沙盒打开这本书时,外观和表单的初始状态一致。
#2 · 查看器可以当作封板翻动的封面
const field = { kind: 'box', id: 'field', style: { backgroundColor: col('brick') },
placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(TRIM_H) } } };
const flush = { numbered: false, span: 'page', footer: { elements: [] },
margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = (id, title, extra = {}) => ({ id, ...flush, ...extra, advancedDesign: {
enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field, ...title] } } });
const headingStyles = [
cover('cover', [
text('title', '{titleText}', { fontFamily: SANS, fontWeight: 700, fontSize: pt(40),
lineHeight: 0.92, color: col('cream') },
{ ...at('page', 'top-left', INNER, 30), size: { width: mm(80) } }),
text('strap', '{attr.strap}', { fontFamily: 'Source Serif 4', italic: true,
fontSize: pt(11), lineHeight: 1.3, color: col('cream') },
{ ...at('#title', 'below', 0, 6), size: { width: mm(72) } }),
text('author', '{author}', caps(7, col('cream')), at('page', 'bottom-left', INNER, -16)),
]),
cover('back', [
text('strap', '{attr.strap}', { fontFamily: 'Source Serif 4', italic: true,
fontSize: pt(11), lineHeight: 1.3, color: col('cream'), align: 'center' },
{ ...at('page', 'center', 0, 0), size: { width: mm(76) } }),
], { breakBefore: { enabled: true, parity: 'even' } }), // the back: always a verso
];
binding.cover: 'pages'时,第一页是封面,最后一页如果落在左页上就是封底。封底的标题样式分页到偶数页,所以书总是在左页结束,两块封面都能翻动。把表单改成A case round the pages,这两页就在布面书壳里作为普通书页翻动。
#3 · 原地改变书的外观
代码就是上面的简短回答。setAppearance({ folio })替换文档的设置并重绘场景:纸张的厚度和挺度、书壳、桌面贴图和光照。书页保留已经画好的内容,所以改动在下一帧就能看到。每种纸都有自己的克重,所以选纸时克重滑块会跟着移动;读者按住右键拖动转过书之后,resetView()把镜头还原。
完整食谱
// ═══ Postext Cookbook · Nº 103 · A bench for the Folio viewer's settings ═══════════════
// https://postext.dev/en/cookbook/folio-settings-bench
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Source Serif 4, Outfit (SIL OFL 1.1) · Needs postext ≥ 1.26.0
//
// A pocket book of knots, laid out once and opened in postext-folio next to a form of every
// folio setting: paper, binding, covers, desk, light and tilt. Each change goes to the viewer
// with setAppearance, so the book is redrawn in place and no page is laid out or painted
// again. The settings as code sit under the form, ready to paste into config.folio.
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 = 'folio-settings-bench';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: brick red for the covers and the knot numbers, a warm ink for the text
const palette = {
ink: '#24211f',
brick: '#9a3b2e', // the cover field, kickers and folios
cream: '#f6efe2', // type on the covers
muted: '#6f6860',
};
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.brick, model: 'hex' } },
];
// #endregion
const [TRIM_W, TRIM_H, TOP, BOTTOM, INNER, OUTER] = [110, 160, 15, 17, 14, 12]; // mm: a pocket
const LEAD = 12.4; // pt
const SANS = 'Outfit';
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',
align: 'left', placement, ...look });
const caps = (size, color) => ({ fontFamily: SANS, fontSize: pt(size), fontWeight: 600,
letterSpacing: pt(size * 0.16), textTransform: 'uppercase', color });
// #region covers: a full-page colour field on page 1 and on the last page
const field = { kind: 'box', id: 'field', style: { backgroundColor: col('brick') },
placement: { ...at('bleed', 'top-left'), size: { width: 'fill', height: mm(TRIM_H) } } };
const flush = { numbered: false, span: 'page', footer: { elements: [] },
margins: { top: mm(0), bottom: mm(0), left: mm(0), right: mm(0) } };
const cover = (id, title, extra = {}) => ({ id, ...flush, ...extra, advancedDesign: {
enabled: true, minHeight: mm(TRIM_H), slot: { elements: [field, ...title] } } });
const headingStyles = [
cover('cover', [
text('title', '{titleText}', { fontFamily: SANS, fontWeight: 700, fontSize: pt(40),
<section id="bench">
<div id="folio" role="region" aria-label="The book in 3D"></div>
<form id="controls" aria-label="Folio settings">
<fieldset>
<legend>Paper</legend>
<label>Stock <select name="paper.type">
<option value="uncoated">Uncoated</option><option value="bookWove" selected>Book wove</option>
<option value="coatedMatte">Coated matte</option><option value="coatedSilk">Coated silk</option>
<option value="coatedGloss">Coated gloss</option><option value="bible">Bible</option>
<option value="newsprint">Newsprint</option><option value="cardStock">Card</option>
</select></label>
<label>Weight <output name="grammage-out">80 g/m²</output>
<input type="range" name="paper.grammage" min="30" max="300" step="5" value="80"></label>
<label>Texture <select name="paper.texture">
<option value="auto" selected>The stock’s</option><option value="smooth">Smooth</option>
<option value="vellum">Vellum</option><option value="wove">Wove</option>
<option value="laid">Laid</option><option value="linen">Linen</option>
<option value="felt">Felt</option>
</select></label>
<label class="check"><input type="checkbox" name="paper.showThrough" checked> Show-through</label>
</fieldset>
<fieldset>
<legend>Binding</legend>
<label>Type <select name="binding.type">
<option value="hardcover">Hardcover</option><option value="paperback" selected>Paperback</option>
<option value="sewn">Sewn softcover</option><option value="layflat">Lay-flat</option>
<option value="saddleStitch">Saddle stitch</option>
</select></label>
<label>Covers <select name="binding.cover">
<option value="pages" selected>The first and last pages</option>
<option value="case">A case round the pages</option>
</select></label>
<label>Material <select name="binding.coverMaterial">
<option value="auto" selected>The binding’s</option><option value="cloth">Cloth</option>
<option value="paper">Paper</option><option value="leather">Leather</option>
</select></label>
<label>Colour <input type="color" name="binding.coverColor" value="#9a3b2e"></label>
</fieldset>
<fieldset>
<legend>Desk and light</legend>
<label>Surface <select name="surface.type">
<option value="oak" selected>Oak</option><option value="walnut">Walnut</option>
<option value="linen">Linen</option><option value="felt">Felt</option>
<option value="leather">Leather</option><option value="marble">Marble</option>
<option value="plain">Plain</option><option value="none">None</option>
</select></label>
<label>Light <select name="lighting.environment">
<option value="studio">Studio</option><option value="daylight" selected>Daylight</option>
/* The bench: the book on the left, the settings on the right, the flat pages below. */
#bench {
display: grid; grid-template-columns: minmax(0, 1fr) 300px; gap: 16px;
max-width: 1320px; margin: 0 auto; padding: 16px; box-sizing: border-box;
color: #c9ccd3; font: 13px/1.4 system-ui, sans-serif;
}
#folio { height: min(80vh, 760px); min-height: 420px; }
#controls { display: grid; gap: 12px; align-content: start; }
#controls fieldset {
display: grid; gap: 8px; margin: 0; padding: 10px 12px 12px;
border: 1px solid #2a2e36; border-radius: 6px;
}
#controls legend {
padding: 0 4px; color: #f0b35a; font-weight: 600; font-size: 11px;
letter-spacing: .12em; text-transform: uppercase;
}
#controls label { display: grid; grid-template-columns: 1fr auto; gap: 4px 8px; align-items: center; }
#controls label > select, #controls label > input[type="range"] { grid-column: 1 / -1; }
#controls label.check { display: flex; gap: 8px; }
#controls select, #controls button {
min-height: 32px; padding: 4px 8px; border: 1px solid #3a3f49; border-radius: 4px;
background: #1a1d23; color: #eceef2; font: inherit;
}
#controls input[type="color"] {
width: 44px; height: 32px; padding: 0; border: 1px solid #3a3f49; border-radius: 4px;
background: none;
}
#controls input[type="range"] { accent-color: #f0b35a; }
#controls output { color: #8d9199; font-variant-numeric: tabular-nums; }
#controls button { cursor: pointer; }
#controls button:hover, #controls button:focus-visible { border-color: #f0b35a; }
#folio-json {
margin: 0; padding: 10px 12px; max-height: 220px; overflow: auto; border-radius: 6px;
background: #15171c; color: #aeb3bd; font: 11.5px/1.45 ui-monospace, Menlo, monospace;
}
@media (max-width: 860px) {
#bench { grid-template-columns: minmax(0, 1fr); }
#folio { height: 70vh; }
}
组合好的script.js可以直接运行:把它粘贴到任何页面的模块脚本中,或在CodePen上打开这道食谱。 GitHub上的食谱文件夹 ↗ (在新标签页中打开)
变化
常见问题
易错点
Folio查看器取其容器的尺寸
createFolioFromDocument把书本放进你给它的元素中,按钮和页码显示在元素的边距里。没有高度的元素(正常文档流中的空div)什么也显示不出:要用CSS给它设定高度。 3D书本查看器(Folio) →
易错点
cover: 'pages'需要偶数页才有封底
binding.cover设为'pages'时,第一页作为封面翻动,最后一页只有落在左页时才作为封底。页数为奇数时书只有封面没有封底:把页数补成偶数,或保留书壳。 纸张、装订、台面与光照(Folio) →
致谢
- 文本
- 原创文字, CC BY 4.0
- 字体
- Source Serif 4 (SIL OFL 1.1) · Outfit (SIL OFL 1.1)


