# 20枚の奥行きをもつトンネルブック

> dieCutsで19の丸窓を同じ軸に、ひとつずつ小さく抜き、表紙から20枚の森の層を通して、池のほとりのシカまで見通します。

- HTML版: https://postext.dev/ja/cookbook/forest-tunnel-book
- レシピ No. 195 · 出力と組み込み · 難易度 3 (上級) · 出力: Canvas, PDF, ライブ操作
- ジャンル: 一枚物とエフェメラ
- 必要なもの postext ≥ 1.84.0, postext-pdf ≥ 1.84.0 · テスト環境 1.84.0, postext-pdf 1.84.0 ／テスト日 2026-11-13
- ページ: [1](https://postext.dev/cookbook/forest-tunnel-book/en/p01.webp?v=bc45895d), [2](https://postext.dev/cookbook/forest-tunnel-book/en/p02.webp?v=bc45895d), [3](https://postext.dev/cookbook/forest-tunnel-book/en/p03.webp?v=bc45895d), [4](https://postext.dev/cookbook/forest-tunnel-book/en/p04.webp?v=bc45895d), [11](https://postext.dev/cookbook/forest-tunnel-book/en/p11.webp?v=bc45895d), [19](https://postext.dev/cookbook/forest-tunnel-book/en/p19.webp?v=bc45895d), [21](https://postext.dev/cookbook/forest-tunnel-book/en/p21.webp?v=bc45895d), [29](https://postext.dev/cookbook/forest-tunnel-book/en/p29.webp?v=bc45895d), [37](https://postext.dev/cookbook/forest-tunnel-book/en/p37.webp?v=bc45895d), [39](https://postext.dev/cookbook/forest-tunnel-book/en/p39.webp?v=bc45895d), [40](https://postext.dev/cookbook/forest-tunnel-book/en/p40.webp?v=bc45895d)
- PDF: https://postext.dev/cookbook/forest-tunnel-book/en/forest-tunnel-book.pdf?v=bc45895d
- Sandboxで開く: https://postext.dev/ja/sandbox#recipe=forest-tunnel-book&lang=en (.postext: https://postext.dev/cookbook/forest-tunnel-book/en/forest-tunnel-book.postext)
- 最終更新: 2026-11-13
- 他の言語: [en](https://postext.dev/en/cookbook/forest-tunnel-book.md), [es](https://postext.dev/es/cookbook/forest-tunnel-book.md), [ca](https://postext.dev/ca/cookbook/forest-tunnel-book.md), [de](https://postext.dev/de/cookbook/forest-tunnel-book.md), [fr](https://postext.dev/fr/cookbook/forest-tunnel-book.md), [it](https://postext.dev/it/cookbook/forest-tunnel-book.md), [pt](https://postext.dev/pt/cookbook/forest-tunnel-book.md), [zh](https://postext.dev/zh/cookbook/forest-tunnel-book.md), [ar](https://postext.dev/ar/cookbook/forest-tunnel-book.md)

## かんたんな説明

森の散歩をえがいた厚いボードブック。どの丁にも前より少し小さな丸い穴があり、表紙から最後のページまで見通せます。

## できあがり

*Into the Wood*（スペイン語版は『Al fondo del bosque』）。150ミリ角、20枚のボードでできたトンネルブックです。右ページはそれぞれ描かれた森の一層で（オーク、ジギタリス、コマドリ、シダの中のキツネ、フクロウ、シラカバ）、どれも前より少し小さな丸窓を同じ中心に抜いてあります。最後の層だけは抜かず、空き地の池にいる母ジカと子ジカです。表紙からのぞくと19の窓を通ってシカまで目が届き、ボードの切り口が木の幹のようにトンネルを囲みます。各丁の裏には、向かいの層を名指す一行の詩があります。印刷所に渡すPDFには、すべての窓が抜き型の版に載ります。

**このレシピが答える問い:**

- どの丁にも穴をあけて、表紙から最後のページまで見通せるトンネルブックを作るには？
- 抜き型の線をPDFの専用の版に載せて抜き型屋に渡すには？

## 手短な答え

```js
// script.js, 行 38–50
// Leaf k (pages 2k − 1 and 2k) is cut with a circle of radius R1 · Q^(k − 1) round the
// same centre: 58 mm on the cover down to 12 mm on leaf 19. Leaf 20, the clearing, is
// whole, so from the cover the eye goes through nineteen windows to the far plane.
const [CX, CY, R1, Q] = [75, 66, 58, 0.9162];
const radius = (k) => R1 * Q ** (k - 1);
const leaves = Array.from({ length: 19 }, (_, i) => i + 1);
const dieCuts = {
  shapes: leaves.map((k) => ({ id: `w${k}`, name: `${t({ en: 'Window', es: 'Ventana' })} ${k}`,
    shape: 'circle', x: mm(CX - radius(k)), y: mm(CY - radius(k)),
    width: mm(2 * radius(k)), height: mm(2 * radius(k)) })),
  pages: leaves.map((k) => ({ pages: String(2 * k - 1), die: `w${k}` })), // recto of leaf k
  corners: { radius: mm(4), edges: 'fore' },
};
```

## 材料

**学べること**

- [抜き穴](https://postext.dev/ja/docs/special-inks-die-cuts.md#抜き加工): dieCuts.shapesとdieCuts.pages（または:::diecutコンテナー）で、ページとその丁に穴を抜きます。表裏の文字は穴をよけて組まれます。
- [PDFの抜き型の線](https://postext.dev/ja/docs/special-inks-die-cuts.md#pdfでの抜き型の線): print.dieLineは、穴と型抜きの縁を専用のSeparation版に描きます。オーバープリントで、印刷機ではインキを載せない、抜き型屋のための版です。

**ほかに使うもの**

- [角丸と型抜きの本](https://postext.dev/ja/docs/special-inks-die-cuts.md#角丸と型抜きの本)
- [3Dの本のビューアー（Folio）](https://postext.dev/ja/docs/configuration-html-folio-epub.md#3dの本postext-folio)
- [見出しスタイル](https://postext.dev/ja/docs/configuration-styles.md#見出しスタイル)
- [ページデザインの画像](https://postext.dev/ja/docs/configuration-headers-footers.md#画像要素)
- [ページデザインのテキスト・罫・ボックス](https://postext.dev/ja/docs/configuration-headers-footers.md#柱とノンブル)
- [文書のメタデータ](https://postext.dev/ja/docs/document-format.md#フロントマター)
- [段落スタイル](https://postext.dev/ja/docs/configuration-styles.md#段落スタイル)
- [裁ち落としとトンボ](https://postext.dev/ja/docs/configuration-page-layout.md#トンボ)
- [CMYKとグレースケールのPDF](https://postext.dev/ja/docs/configuration-fonts-colors-viewers.md#pdf生成設定)
- [PDFの書き出し](https://postext.dev/ja/docs/configuration-pdf-output.md#pdfの生成)
- [リソースとしての図と表](https://postext.dev/ja/docs/document-format-resources.md#リソース)
- [セマンティックカラーパレット](https://postext.dev/ja/docs/configuration-fonts-colors-viewers.md#カラーパレット)
- [キャンバス上のページ](https://postext.dev/ja/docs/configuration-programmatic-usage.md#ページをビットマップに描画する)
- [用紙、綴じ、机、照明（Folio）](https://postext.dev/ja/docs/configuration-fonts-colors-viewers.md#folioビューアー設定)
- [見出しの属性](https://postext.dev/ja/docs/document-format.md#見出しの属性)
- [デザインした章扉](https://postext.dev/ja/docs/configuration-headings.md#幅と詳細デザイン)
- [用紙の色](https://postext.dev/ja/docs/configuration-page-layout.md#ページ)
- [PDFに埋め込むフォント](https://postext.dev/ja/docs/configuration-pdf-output.md#なぜフォントプロバイダーが必要か)
- [番号のない章](https://postext.dev/ja/docs/configuration-styles.md#見出しスタイル)

**設定の一覧**

- [`bodyText`](https://postext.dev/ja/docs/configuration-text.md#本文), [`colorPalette`](https://postext.dev/ja/docs/configuration-fonts-colors-viewers.md#カラーパレット), [`dieCuts`](https://postext.dev/ja/docs/special-inks-die-cuts.md#抜き加工), [`folio`](https://postext.dev/ja/docs/configuration-html-folio-epub.md#外観), [`footer`](https://postext.dev/ja/docs/configuration-headers-footers.md#柱とノンブル), [`header`](https://postext.dev/ja/docs/configuration-headers-footers.md#柱とノンブル), [`headingStyles`](https://postext.dev/ja/docs/configuration-styles.md#見出しスタイル), [`headings`](https://postext.dev/ja/docs/configuration-headings.md#見出し), [`layout`](https://postext.dev/ja/docs/configuration-page-layout.md#レイアウト), [`locale`](https://postext.dev/ja/docs/configuration-language.md#ハイフネーション), [`page`](https://postext.dev/ja/docs/configuration-page-layout.md#ページ), [`paragraphStyles`](https://postext.dev/ja/docs/configuration-styles.md#段落スタイル), [`print`](https://postext.dev/ja/docs/configuration-fonts-colors-viewers.md#印刷出力設定)

**API**

- [`buildDocumentWithFonts`](https://postext.dev/ja/docs/configuration-programmatic-usage.md#レイアウトの前にフォントを読み込む), [`createFolioFromDocument`](https://postext.dev/ja/docs/configuration-html-folio-epub.md#3dの本postext-folio), [`decompressWoff2`](https://postext.dev/ja/docs/configuration-pdf-output.md#ブラウザー向けフォントプロバイダーfontsource--woff2), [`registerResourceImage`](https://postext.dev/ja/docs/architecture.md#apiの概要), [`renderPageToCanvas`](https://postext.dev/ja/docs/configuration-programmatic-usage.md#ページをビットマップに描画する), [`renderToPdf`](https://postext.dev/ja/docs/configuration-pdf-output.md#pdfの生成)

**書体**

- Cormorant Garamond (OFL-1.1), Lora (OFL-1.1)

## 作り方

### 1 · 同じ軸にそろえた19の窓

コードは上の[手短な答え](https://postext.dev/ja/cookbook/forest-tunnel-book.md#手短な答え)です。窓はループで作ります。k枚目の丁には同じ中心で半径R1 · Q^(k − 1)の円が与えられ、`dieCuts.pages`がそれを2k − 1ページ、つまりその丁の表に置きます。穴は丁の両面を抜くので、裏にも同じ窓が左右反転して開きます。Q = 0.9162で、半径は18段階で58ミリから12ミリになります。

### 2 · 窓と位置をそろえた森の層

```js
// script.js, 行 54–71
// The plane pictures were scaled so each painting's opening meets its window, centred on
// (CX, CY), over a softened copy of itself; the window's centre is flat, the die takes it.
const SHEET = { width: mm(TRIM + 2 * BLEED), height: mm(TRIM + 2 * BLEED) };
const painting = { kind: 'image', id: 'painting', resourceId: '{attr.picture}', fit: 'cover',
  placement: at('page', 'top-left', -BLEED, -BLEED, SHEET) };
const full = (elements) => ({ enabled: true, minHeight: mm(TRIM - TOP), slot: { elements } });
const plate = { kind: 'box', id: 'plate', placement: at('page', 'top-left', 25, 129,
  { width: mm(100), height: mm(17) }), style: { backgroundColor: col('forest') } };
const line = (id, content, y, size, color, extra) => ({ kind: 'text', id, content,
  fontFamily: DISPLAY, fontSize: pt(size), lineHeight: 1.1, color: col(color),
  align: 'center', placement: at('page', 'top-left', 25, y, { width: mm(100) }), ...extra });
const headingStyles = [
  { id: 'cover', numbered: false, toc: false, advancedDesign: full([painting, plate,
    line('title', '{title}', 131, 21, 'cream', { fontWeight: 600 }),
    line('subtitle', '{subtitle}', 139.5, 10.5, 'moss', { italic: true })]) },
  { id: 'plane', numbered: false, breakBefore: { enabled: true, parity: 'odd' },
    advancedDesign: full([painting]) },
];
```

どの絵にも霧の空き間があるので、本に入れる前に絵を拡大縮小しました。各画像で、葉が輪の半分を覆う半径をピクセルで測り、その半径がその丁の窓に重なるよう、窓の中心に合わせて縮めています。表紙から見ると、各層は窓のまわりの細い葉の輪だけを見せ、輪が重なってトンネルになります。抜き型が取り去る中央は単色なので、ファイルはほとんど重くなりません。

### 3 · Die版の19の円

```js
// script.js, 行 83–84
  print: { standard: 'pdfx4', outputProfile: 'fogra51', convertImages: false,
    dieLine: { output: 'page', ink: 'Die', width: pt(0.5) } },
```

PDFは各窓と、小口側の角を丸めた各丁の輪郭を、オーバープリントでインキを載せない`Die`の分版に描きます。`convertImages: false`で、40ページの絵でも1.5メガバイトに収まります。

### 4 · 手の中のトンネル

```js
// script.js, 行 99–105
  folio: {
    tilt: 40, yaw: -30,
    paper: { type: 'board', shade: '#f4ecd6' },
    binding: { type: 'hardcover', cover: 'pages', coverMaterial: 'paper' },
    surface: { type: 'oak' },
    lighting: { environment: 'daylight', intensity: 1.1 },
  },
```

20枚のボードは厚いかたまりになり、Folioはそのすべてに窓を抜きます。閉じた本にはトンネルが現れ、切り口の壁が段になって空き地まで下りていきます。

### 5 · 平らなページで20層

```js
// script.js, 行 250–260
// `beneath` paints the page two on, which paints the page two on from it, and so on to
// the clearing: page 1 shows all twenty planes. Each canvas is painted once and reused.
const under = new Map();
const beneath = (i) => {
  if (!under.has(i) && doc.pages[i]) {
    const canvas = document.createElement('canvas');
    under.set(i, canvas);
    renderPageToCanvas(doc.pages[i], doc, canvas, { scale: 1, beneath });
  }
  return under.get(i);
};
```

`beneath`は2ページ先のページを、それ自身の`beneath`で描きます。表紙の窓には3ページが、その窓には5ページが見え、39ページまで続きます。各ページは一度だけ描いて使い回します。

## レシピの全体

レシピのフォルダーから合成した1つのファイルで、サンプルのテキストとレシピ集の共通キットを埋め込んであり、自分でページを組み立てます。動かすには、空のページの`<script type="module">`に入れるか、新しいCodePenのpenのJSパネルに貼り付けます（モジュールとして）。esm.shからpostextを読み込むので、インストールもビルドも要りません。

- レシピのフォルダー: https://github.com/drnachio/postext/tree/main/cookbook/forest-tunnel-book

### script.js

```js
// ═══ Postext Cookbook · Nº 195 · A tunnel book twenty leaves deep ═══════════════════════
// https://postext.dev/en/cookbook/forest-tunnel-book
// Code: MIT · Text: original (CC BY 4.0) · Paintings: generated with diffusion models
// Fonts: Cormorant Garamond, Lora (SIL OFL 1.1) · Needs postext ≥ 1.84.0
//
// Twenty board leaves, each printed with one plane of a wood and cut with a round window a
// little smaller than the one before. From the cover you look down the whole tunnel, past
// oaks, foxgloves, an owl and a fox, to a doe and her fawn at a pool in the clearing.
import {
  buildDocumentWithFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createFolioFromDocument } from 'https://esm.sh/postext-folio';

const LANG = 'en'; // @lang: the language of the sample document ('en' | 'es')
const RECIPE = 'forest-tunnel-book';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: a deep forest green behind the words, cream type
const palette = {
  forest: '#1c2a1e', // the versos, and the plate under the cover title
  cream: '#f4ecd6', // all the type
  moss: '#a9b98a', // the subtitle and the colophon
};
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: 'moss (defaults)', value: { hex: palette.moss, model: 'hex' } },
];
// #endregion
const [TRIM, BLEED] = [150, 3]; // mm: a square board book, and its bleed
const [TOP, SIDE] = [128, 14]; // the words on each verso sit under its window
const [DISPLAY, TEXT] = ['Cormorant Garamond', 'Lora'];
const at = (to, edge, x = 0, y = 0, size) => ({ anchor: { to, edge },
  offset: { x: mm(x), y: mm(y) }, ...(size && { size }) });

// #region answer: nineteen windows, each smaller than the last, all on one axis
// Leaf k (pages 2k − 1 and 2k) is cut with a circle of radius R1 · Q^(k − 1) round the
// same centre: 58 mm on the cover down to 12 mm on leaf 19. Leaf 20, the clearing, is
// whole, so from the cover the eye goes through nineteen windows to the far plane.
const [CX, CY, R1, Q] = [75, 66, 58, 0.9162];
const radius = (k) => R1 * Q ** (k - 1);
const leaves = Array.from({ length: 19 }, (_, i) => i + 1);
const dieCuts = {
  shapes: leaves.map((k) => ({ id: `w${k}`, name: `${t({ en: 'Window', es: 'Ventana' })} ${k}`,
    shape: 'circle', x: mm(CX - radius(k)), y: mm(CY - radius(k)),
    width: mm(2 * radius(k)), height: mm(2 * radius(k)) })),
  pages: leaves.map((k) => ({ pages: String(2 * k - 1), die: `w${k}` })), // recto of leaf k
  corners: { radius: mm(4), edges: 'fore' },
};
// #endregion

// #region planes: each recto a painted plane, the verso behind it a line of the walk
// The plane pictures were scaled so each painting's opening meets its window, centred on
// (CX, CY), over a softened copy of itself; the window's centre is flat, the die takes it.
const SHEET = { width: mm(TRIM + 2 * BLEED), height: mm(TRIM + 2 * BLEED) };
const painting = { kind: 'image', id: 'painting', resourceId: '{attr.picture}', fit: 'cover',
  placement: at('page', 'top-left', -BLEED, -BLEED, SHEET) };
const full = (elements) => ({ enabled: true, minHeight: mm(TRIM - TOP), slot: { elements } });
const plate = { kind: 'box', id: 'plate', placement: at('page', 'top-left', 25, 129,
  { width: mm(100), height: mm(17) }), style: { backgroundColor: col('forest') } };
const line = (id, content, y, size, color, extra) => ({ kind: 'text', id, content,
  fontFamily: DISPLAY, fontSize: pt(size), lineHeight: 1.1, color: col(color),
  align: 'center', placement: at('page', 'top-left', 25, y, { width: mm(100) }), ...extra });
const headingStyles = [
  { id: 'cover', numbered: false, toc: false, advancedDesign: full([painting, plate,
    line('title', '{title}', 131, 21, 'cream', { fontWeight: 600 }),
    line('subtitle', '{subtitle}', 139.5, 10.5, 'moss', { italic: true })]) },
  { id: 'plane', numbered: false, breakBefore: { enabled: true, parity: 'odd' },
    advancedDesign: full([painting]) },
];
// #endregion

const config = {
  locale: t({ en: 'en-gb', es: 'es' }),
  colorPalette,
  page: { sizePreset: 'custom', width: mm(TRIM), height: mm(TRIM), dpi: 150,
    backgroundColor: col('forest'), cutLines: { enabled: false, bleed: mm(BLEED) },
    margins: { top: mm(TOP), bottom: mm(0), left: mm(SIDE), right: mm(SIDE) } },
  layout: { layoutType: 'single' },
  dieCuts,
  // #region die-line: nineteen circles on the Die plate, one per recto
  print: { standard: 'pdfx4', outputProfile: 'fogra51', convertImages: false,
    dieLine: { output: 'page', ink: 'Die', width: pt(0.5) } },
  // #endregion
  bodyText: { fontFamily: DISPLAY, fontSize: pt(14), lineHeight: pt(17), italic: true,
    color: col('cream'), italicColor: col('cream'), textAlign: 'center', firstLineIndent: pt(0),
    hyphenation: { enabled: false }, optimalLineBreaking: true, avoidRunts: true },
  headings: { fontFamily: DISPLAY, color: col('cream'), levels: [
    { level: 1, fontSize: pt(14), lineHeight: pt(17), marginTop: pt(0), marginBottom: pt(0) },
  ] },
  headingStyles,
  paragraphStyles: [{ id: 'colophon', fontFamily: TEXT, fontSize: pt(9), lineHeight: pt(12.5),
    italic: false, color: col('moss'), textAlign: 'center', firstLineIndent: pt(0),
    marginBottom: pt(4) }],
  header: { elements: [] }, // a picture book carries no running heads
  footer: { elements: [] }, // and no folios
  // #region folio: twenty board leaves, seen low enough for the windows to show their walls
  folio: {
    tilt: 40, yaw: -30,
    paper: { type: 'board', shade: '#f4ecd6' },
    binding: { type: 'hardcover', cover: 'pages', coverMaterial: 'paper' },
    surface: { type: 'oak' },
    lighting: { environment: 'daylight', intensity: 1.1 },
  },
  // #endregion
};

// ─── 2 · Content ────────────────────────────────────────────────────────────
// Each plane is a heading with a picture; the line after it is printed on its verso.
const markdown = String.raw`---
title: "Into the Wood"
subtitle: "A tunnel book in twenty planes"
---

# Into the Wood {style="cover" picture="plane01"}

Past the old oaks, the foxgloves lean out to see who comes.

# Foxgloves {style="plane" picture="plane02"}

Red toadstools sit out on the roots in the moss.

# Toadstools {style="plane" picture="plane03"}

A robin on the bramble sings that it saw you first.

# The robin {style="plane" picture="plane04"}

Bluebells lie under the trees like a low blue mist.

# Bluebells {style="plane" picture="plane05"}

A fox looks out of the bracken, and is gone.

# The fox {style="plane" picture="plane06"}

Holly, with its red berries and its sharp green leaves.

# Holly {style="plane" picture="plane07"}

The birches stand pale, like candles nobody has lit.

# Birches {style="plane" picture="plane08"}

An owl in the oak opens one eye, and shuts it again.

# The owl {style="plane" picture="plane09"}

The ferns grow wide, and the light comes in.

# Ferns {style="plane" picture="plane10"}

Old stones wear coats of green velvet moss.

# Mossy stones {style="plane" picture="plane11"}

A squirrel runs up a trunk and scolds you from the top.

# The squirrel {style="plane" picture="plane12"}

Two rabbits sit up and agree that you are harmless.

# Rabbits {style="plane" picture="plane13"}

The far trunks go grey and soft in the mist.

# Grey trunks {style="plane" picture="plane14"}

The path goes on, and the moss is soft underfoot.

# The path {style="plane" picture="plane15"}

The sun comes down through the leaves in long bright bars.

# Sunlight {style="plane" picture="plane16"}

The mist turns to gold all round you.

# Golden mist {style="plane" picture="plane17"}

The last branches open like a door.

# The last branches {style="plane" picture="plane18"}

Foxgloves again, standing tall in the sun.

# Foxgloves in the sun {style="plane" picture="plane19"}

And there, at the pool in the clearing, the deer.

# The clearing {style="plane" picture="plane20"}

:::paragraphs{style="colophon"}
Twenty painted planes of a wood, each with a smaller window than the last: from the cover you look through them all to the clearing.

Words: Postext Cookbook, CC BY 4.0. Paintings generated with diffusion models.
:::
`; // content.<lang>.md, inlined by the Cookbook

const PLANES = t({
  en: ['Two old oaks and ferns', 'Foxgloves', 'Red toadstools in the moss',
    'A robin on a bramble', 'Bluebells', 'A fox in autumn bracken', 'Holly with red berries',
    'Pale birches', 'A tawny owl on an oak branch', 'Wide ferns in the light',
    'Mossy stones', 'A red squirrel on a trunk', 'Two rabbits', 'Grey trunks in the mist',
    'The path through moss', 'Sunbeams through the leaves', 'Golden mist',
    'The last branches', 'Foxgloves in the sun', 'A doe and her fawn drinking at a pool'],
  es: ['Dos robles viejos y helechos', 'Dedaleras', 'Setas rojas en el musgo',
    'Un petirrojo en una zarza', 'Campanillas', 'Un zorro entre helechos de otoño',
    'Acebo con bayas rojas', 'Abedules pálidos', 'Un cárabo en una rama de roble',
    'Helechos a la luz', 'Piedras con musgo', 'Una ardilla roja en un tronco', 'Dos conejos',
    'Troncos grises en la niebla', 'El sendero entre el musgo', 'Rayos de sol entre las hojas',
    'Niebla dorada', 'Las últimas ramas', 'Dedaleras al sol',
    'Una cierva y su cervatillo bebiendo en una charca'],
});
const id = (k) => `plane${String(k).padStart(2, '0')}`;
const resources = PLANES.map((alt, i) => ({ id: id(i + 1), typeId: 'figure', kind: 'bitmap',
  createdAt: 0, updatedAt: 0, altText: alt,
  bitmap: { fileId: `${id(i + 1)}.jpg`, format: 'jpeg', width: 760, height: 760 } }));
const FILES = { plane01: asset('plane01.jpg'), plane02: asset('plane02.jpg'),
  plane03: asset('plane03.jpg'), plane04: asset('plane04.jpg'), plane05: asset('plane05.jpg'),
  plane06: asset('plane06.jpg'), plane07: asset('plane07.jpg'), plane08: asset('plane08.jpg'),
  plane09: asset('plane09.jpg'), plane10: asset('plane10.jpg'), plane11: asset('plane11.jpg'),
  plane12: asset('plane12.jpg'), plane13: asset('plane13.jpg'), plane14: asset('plane14.jpg'),
  plane15: asset('plane15.jpg'), plane16: asset('plane16.jpg'), plane17: asset('plane17.jpg'),
  plane18: asset('plane18.jpg'), plane19: asset('plane19.jpg'), plane20: asset('plane20.jpg') };

// ─── 3 · Fonts ──────────────────────────────────────────────────────────────
const FONTS = { 'Cormorant Garamond': ['500i', '600'], Lora: ['400'] };

// ─── 4 · Build & show ───────────────────────────────────────────────────────
await Promise.all(Object.entries(FILES).map(([key, url]) => loadImage(`${key}.jpg`, url)));
// The press file first, with bleed and marks; the screen's trimmed pages last.
const cut = { ...config.page.cutLines, enabled: true };
const pressConfig = { ...config, page: { ...config.page, cutLines: cut } };
const press = await buildDocumentWithFonts({ markdown, resources }, pressConfig, kitFonts(FONTS));
const doc = await buildDocumentWithFonts({ markdown, resources }, config, kitFonts(FONTS));

// #region folio-stage: the book closed on the desk, the tunnel straight ahead
const stage = document.createElement('section');
stage.id = 'folio';
stage.ariaLabel = t({ en: 'The tunnel book in 3D', es: 'El libro túnel en 3D' });
stage.style.cssText = 'height: min(78vh, 720px); margin: 0 auto; max-width: 1280px';
document.body.append(stage);
createFolioFromDocument(stage, doc, { at: 0,
  appearance: { textureBaseUrl: 'https://postext.dev/folio/textures' } });
// #endregion

// #region see-through: every recto looks down the rest of the tunnel
// `beneath` paints the page two on, which paints the page two on from it, and so on to
// the clearing: page 1 shows all twenty planes. Each canvas is painted once and reused.
const under = new Map();
const beneath = (i) => {
  if (!under.has(i) && doc.pages[i]) {
    const canvas = document.createElement('canvas');
    under.set(i, canvas);
    renderPageToCanvas(doc.pages[i], doc, canvas, { scale: 1, beneath });
  }
  return under.get(i);
};
// #endregion
showPages(doc, { title: t({ en: 'Into the Wood · a tunnel book',
  es: 'Al fondo del bosque · un libro túnel' }), beneath });
document.getElementById('pages').before(stage);
offerPdf(() => renderToPdf(press, { fontProvider: fontsourceProvider, resourceBytes: imageBytes,
  profileBaseUrl: 'https://postext.dev/icc/' }), `${RECIPE}.pdf`);

// ─── Kit ── helpers shared by every Cookbook recipe · postext.dev/cookbook ─────

// ─── Kit · core v1 ── the same in every recipe · postext.dev/cookbook
function mm(value) { return { value, unit: 'mm' }; }
function pt(value) { return { value, unit: 'pt' }; }
function em(value) { return { value, unit: 'em' }; }
/** The sample language's string: t({ en: 'Figure', es: 'Figura' }). */
function t(strings) { return strings[LANG] ?? Object.values(strings)[0]; }
/** A file in this recipe's assets folder, served from the Postext repo by jsDelivr. */
function asset(file) { return `https://cdn.jsdelivr.net/gh/drnachio/postext@main/cookbook/${RECIPE}/assets/${file}`; }

// ─── Kit · fonts v3 ── the same in every recipe · postext.dev/cookbook
// Postext loads the faces a config asks for before layout and asks the kit
// for Fontsource's files, the ones the PDF embeds too.

/** buildDocumentWithFonts' options: the resolver, and FONTS' faces loaded
 *  with the config's. FONTS = { 'Family Name': ['400', '400i', '700'] }. */
function kitFonts(FONTS = {}) {
  const faces = Object.entries(FONTS).flatMap(([family, specs]) => specs.map((spec) =>
    ({ family, weight: parseInt(spec, 10), style: spec.endsWith('i') ? 'italic' : 'normal' })));
  return { resolve: fontsourceResolver, faces };
}

/** A face's files with their ranges: latin, then latin-ext and greek when
 *  `text` needs them (kitSubsetsFor). Null for a face Fontsource lacks. */
async function fontsourceResolver(family, weight, style, { text = '' } = {}) {
  const id = fontsourceId(family);
  const meta = await fontsourceMeta(family);
  if (meta && !(await fontsourceWeights(family, style)).includes(weight)) return null;
  kitStatus('Loading fonts…');
  const at = await fontsourceAt(id);
  return ['latin', ...kitSubsetsFor(text, meta)].map((subset) => ({
    source: `${at}files/${id}-${subset}-${weight}-${style}.woff2`,
    unicodeRange: kitRanges()[subset],
  }));
}

/** Each file's unicode-range (a function: the kit runs after the pen's code). */
function kitRanges() {
  return {
    latin: 'U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,'
      + 'U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD',
    'latin-ext': 'U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,'
      + 'U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF',
    greek: 'U+0370-03FF',
  };
}

/** For the cjk, arabic and comics blocks: loads `faces` (as FONTS) for the
 *  sample `text`; `optional` skips a face Fontsource lacks. Files are added in
 *  the order asked, the last winning a shared character. Resolves to the count. */
async function loadFonts(faces, text = '', { optional = false } = {}) {
  kitStatus('Loading fonts…');
  const ranges = kitRanges();
  const jobs = [];
  for (const [family, specs] of Object.entries(faces)) {
    const id = fontsourceId(family);
    const todo = [...new Set(specs)].map((spec) => [parseInt(spec, 10), spec.endsWith('i') ? 'italic' : 'normal'])
      .filter(([weight, style]) => !hasFace(family, weight, style)); // before any await
    const at = fontsourceAt(id);
    const meta = optional || /[^\0-ÿ]/u.test(text) ? await fontsourceMeta(family) : null;
    const subsets = ['latin', ...kitSubsetsFor(text, meta)];
    for (const [weight, style] of todo) {
      if (optional && !(meta && (await fontsourceWeights(family, style)).includes(weight))) continue;
      for (const subset of subsets) {
        const url = `${await at}files/${id}-${subset}-${weight}-${style}.woff2`;
        const face = new FontFace(family, `url(${url}) format('woff2')`,
          { weight: String(weight), style, unicodeRange: ranges[subset] });
        jobs.push(face.load().catch(() => {
          if (subset === 'latin' && !optional) throw new Error(`Fontsource has no ${family} ${weight} ${style}`);
        }));
      }
    }
  }
  const ready = await Promise.all(jobs).catch((error) => { kitFail(error); throw error; });
  return ready.filter((face) => face && document.fonts.add(face)).length;
}

/** A loaded FontFace covers this face (fonts.check() says yes to any family). */
function hasFace(family, weight, style) {
  for (const face of document.fonts) {
    if (face.status !== 'loaded' || face.style !== style) continue;
    if (face.family.replace(/^["']|["']$/g, '') !== family) continue;
    const [low, high = low] = face.weight.split(' ').map(Number);
    if (weight >= low && weight <= high) return true;
  }
  return false;
}

/** The files beyond latin `text` needs that `meta`'s family ships. */
function kitSubsetsFor(text, meta) {
  return [[/[Ā-˿ᴀ-ᶿḀ-ỿ†ℓⱠ-Ɀ꜠-ꟿ]/u, 'latin-ext'], [/[Ͱ-Ͽ]/u, 'greek']]
    .filter(([re, x]) => re.test(text) && meta?.subsets?.includes(x)).map(([, x]) => x);
}

/** Fontsource's id for a family: 'Source Serif 4' → 'source-serif-4'. */
function fontsourceId(family) { return family.toLowerCase().replace(/\s+/g, '-'); }

/** A package's folder at the one version @5 names now (#766). */
function fontsourceAt(id, u = `https://cdn.jsdelivr.net/npm/@fontsource/${id}@`) {
  return (fontsourceAt.c ??= {})[id] ??= fetch(u + '5/package.json').then((r) => r.json())
    .then((p) => p.version || 5, () => 5).then((v) => `${u}${v}/`);
}

/** The family's Fontsource metadata (weights, styles, subsets), or null. */
function fontsourceMeta(family, id = fontsourceId(family)) {
  return (fontsourceMeta.c ??= {})[id] ??= fetch(`https://api.fontsource.org/v1/fonts/${id}`)
    .then((res) => (res.ok ? res.json() : null), () => null);
}

/** The weights the package ships in `style`: the API pairs none (no Libre
 *  Caslon 700 italic file), so italics are read from latin-italic.css. */
function fontsourceWeights(family, style, id = fontsourceId(family)) {
  return (fontsourceWeights.c ??= {})[id + style] ??= fontsourceMeta(family).then(async (m) => {
    if (!m?.styles.includes(style)) return m ? [] : [400, 700];
    const css = style === 'italic' ? await fetch(`${await fontsourceAt(id)}latin-italic.css`).then((r) => (r.ok ? r.text() : ''), () => '') : '';
    const w = [...css.matchAll(/weight: (\d+)/g)].map((x) => +x[1]);
    return w.length ? w : m.weights;
  });
}

// ─── Kit · viewer v2 ── the same in every recipe · postext.dev/cookbook
/** The pages as spreads on a dark desk, page 1 alone, then verso | recto,
 *  each painted when it scrolls near. Other options go to renderPageToCanvas. */
function showPages(docs, { title, width = 460, ...render } = {}) {
  const root = viewer(title);
  const pages = [docs].flat().flatMap((doc) =>
    doc.pages.map((page) => ({ doc, page, n: (doc.pageIndexOffset ?? 0) + page.index })));
  const spreads = [];
  let verso = null;
  for (const p of pages) {
    if (p.n % 2 === 1) { if (verso) spreads.push([verso, null]); verso = p; }
    else { spreads.push([verso, p]); verso = null; }
  }
  if (verso) spreads.push([verso, null]);
  const density = Math.min(window.devicePixelRatio || 1, 2);
  showPages.painter?.disconnect();
  const painter = new IntersectionObserver((entries) => {
    for (const { isIntersecting, target } of entries) {
      if (!isIntersecting) continue;
      painter.unobserve(target);
      const { doc, page } = target.postext;
      renderPageToCanvas(page, doc, target, { ...render, scale: (width * density) / page.width });
    }
  }, { rootMargin: '800px' });
  showPages.painter = painter;
  root.replaceChildren(...spreads.map((pair) => {
    const spread = document.createElement('div');
    spread.className = 'pt-spread';
    for (const p of pair) {
      const figure = document.createElement('figure');
      if (p) {
        const label = p.page.pageLabel || String(p.n + 1);
        const canvas = document.createElement('canvas');
        canvas.postext = p;
        canvas.style.aspectRatio = `${p.page.width} / ${p.page.height}`;
        canvas.setAttribute('role', 'img');
        canvas.setAttribute('aria-label', `Page ${label}`);
        const folio = document.createElement('figcaption');
        folio.textContent = label;
        figure.append(canvas, folio);
        painter.observe(canvas);
      } else figure.className = 'pt-blank';
      spread.append(figure);
    }
    return spread;
  }));
  kitStatus(`${pages.length} ${pages.length === 1 ? 'page' : 'pages'}`);
  document.documentElement.dataset.postext = 'ready';
  return pages.length;
}

/** The desk, the bar and the error reporting, created once. */
function viewer(title) {
  if (!document.getElementById('pt-kit')) {
    document.head.insertAdjacentHTML('beforeend', `<style id="pt-kit">
      :root { color-scheme: dark; }
      body { margin: 0; background: #0e1014; color: #b9bcc4; font: 13px/1.45 system-ui, sans-serif; }
      #pt-bar { position: sticky; top: 0; z-index: 1; display: flex; flex-wrap: wrap; align-items: center;
        gap: 6px 16px; padding: 10px 16px; background: rgb(14 16 20 / .92); backdrop-filter: blur(6px);
        border-bottom: 1px solid #23262d; }
      #pt-bar strong { color: #f4f1ea; font-weight: 600; }
      #pt-actions { display: flex; gap: 12px; margin-left: auto; }
      #pt-actions a, #pt-actions button { color: #d8a21a; font: inherit; background: none; border: 0; padding: 0; cursor: pointer; }
      #pages { display: grid; justify-items: center; gap: 48px; padding: 32px 16px 72px; }
      .pt-spread { display: flex; }
      .pt-spread figure { margin: 0; width: min(460px, 44vw); }
      .pt-spread canvas { display: block; width: 100%; background: #fff;
        box-shadow: 0 1px 2px rgb(0 0 0 / .5), 0 22px 44px -16px rgb(0 0 0 / .8); }
      .pt-spread figure:first-child canvas { box-shadow: inset -14px 0 14px -14px rgb(0 0 0 / .18), 0 1px 2px rgb(0 0 0 / .5), 0 22px 44px -16px rgb(0 0 0 / .8); }
      .pt-spread figcaption { margin-top: 10px; text-align: center; font: 600 10px/1 system-ui, sans-serif;
        letter-spacing: .18em; text-transform: uppercase; color: #6c7079; }
      .pt-blank { visibility: hidden; }
      @media (max-width: 760px) {
        .pt-spread { flex-direction: column; gap: 32px; }
        .pt-spread figure { width: min(460px, 92vw); }
        .pt-blank { display: none; }
      }
    </style>`);
    document.body.insertAdjacentHTML('afterbegin',
      '<header id="pt-bar"><strong id="pt-title"></strong><span id="pt-status" role="status"></span><span id="pt-actions"></span></header>');
    document.getElementById('pt-title').textContent = document.title || 'Postext';
    addEventListener('error', (event) => kitFail(event.error ?? event.message));
    addEventListener('unhandledrejection', (event) => kitFail(event.reason));
  }
  if (title) document.getElementById('pt-title').textContent = title;
  return document.getElementById('pages')
    ?? document.body.appendChild(Object.assign(document.createElement('main'), { id: 'pages' }));
}

function kitStatus(text) {
  viewer();
  document.getElementById('pt-status').textContent = text;
}

function kitFail(error) {
  document.documentElement.dataset.postext = 'error';
  kitStatus(`Error: ${error?.message ?? error}`);
}

// ─── Kit · pdf v3 ── the same in every recipe that exports a PDF
/** The Fontsource files the screen used, as TrueType, with their range and
 *  place: the nearest weight the family ships in that style, upright with no italic;
 *  latin, then what its letters need (kitSubsetsFor). */
async function fontsourceProvider(family, weight, style, request) {
  const id = fontsourceId(family);
  const meta = await fontsourceMeta(family);
  const s = style === 'italic' && meta && !meta.styles.includes('italic') ? 'normal' : style;
  const shipped = meta ? await fontsourceWeights(family, s) : [];
  const weights = shipped.length ? shipped : [400, 700];
  const w = weights.reduce((a, b) => (Math.abs(b - weight) < Math.abs(a - weight) ? b : a));
  const text = String.fromCodePoint(...(request?.codePoints ?? []));
  const files = await Promise.all(['latin', ...kitSubsetsFor(text, meta)].map(async (subset, order) => {
    const res = await fetch(`${await fontsourceAt(id)}files/${id}-${subset}-${w}-${s}.woff2`);
    if (!res.ok) throw new Error(`Fontsource has no ${family} ${w} ${s} ${subset}`);
    return Object.assign(await decompressWoff2(new Uint8Array(await res.arrayBuffer())),
      { unicodeRange: kitRanges()[subset], order });
  }));
  return files.length === 1 ? files[0] : files;
}

/** A "Build the PDF" button; then "Open the PDF" (a new tab: CodePen's frame
 *  shows no PDFs) and a download link. */
function offerPdf(makePdf, filename) {
  viewer();
  const button = Object.assign(document.createElement('button'), { type: 'button', textContent: 'Build the PDF' });
  button.dataset.postextPdf = filename;
  button.addEventListener('click', async () => {
    button.disabled = true;
    button.textContent = 'Building the PDF…';
    try {
      const bytes = await makePdf();
      const url = URL.createObjectURL(new Blob([bytes], { type: 'application/pdf' }));
      const size = `${Math.max(1, Math.round(bytes.length / 1024))} KB`;
      button.replaceWith(
        Object.assign(document.createElement('a'), { href: url, target: '_blank', rel: 'noopener', textContent: 'Open the PDF ↗' }),
        Object.assign(document.createElement('a'), { href: url, download: filename, textContent: `Download ${filename} · ${size}` }));
    } catch (error) {
      button.disabled = false;
      button.textContent = 'Build the PDF';
      kitFail(error);
    }
  });
  document.getElementById('pt-actions').append(button);
}

// ─── Kit · images v3 ── recipes with pictures · postext.dev/cookbook
/** Registers a photo or PNG for the canvas and keeps its bytes for the PDF.
 *  fetch → ImageBitmap never taints the canvas (a plain cross-origin <img> would). */
async function loadImage(fileId, url) {
  const res = await fetch(url);
  if (!res.ok) throw new Error(`Image not found (${res.status}): ${url}`);
  const bytes = new Uint8Array(await res.arrayBuffer());
  registerResourceImage(fileId, await createImageBitmap(new Blob([bytes])));
  (loadImage.bytes ??= new Map()).set(fileId, bytes);
}

/** Registers SVG markup as a vector image, its fonts inside (inlineSvgFonts, ≥ 1.25).
 *  `options` go to registerResourceImage: { singleInk: true } tints it on the canvas. */
async function loadSvg(fileId, svg, options) {
  if (typeof inlineSvgFonts === 'function') svg = await inlineSvgFonts(svg, svgFaces);
  const img = new Image();
  img.src = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(svg)}`;
  await img.decode();
  registerResourceImage(fileId, img, options);
  (loadImage.bytes ??= new Map()).set(fileId, new TextEncoder().encode(svg));
}

/** A face's Fontsource files: nearest weight; latin + what the SVG sets. */
async function svgFaces(family, weight, style, { codePoints = [] } = {}) {
  const [id, m] = [fontsourceId(family), await fontsourceMeta(family)];
  const w = m?.weights.reduce((a, b) => (Math.abs(b - weight) < Math.abs(a - weight) ? b : a)) ?? weight;
  const s = m?.styles.includes(style) === false ? 'normal' : style;
  return Promise.all(['latin', ...kitSubsetsFor(String.fromCodePoint(...codePoints), m)].map(async (x) => new Uint8Array(
    await (await fetch(`${await fontsourceAt(id)}files/${id}-${x}-${w}-${s}.woff2`)).arrayBuffer())));
}

/** renderToPdf({ resourceBytes: imageBytes }) */
function imageBytes(fileId) { return loadImage.bytes?.get(fileId); }

/** renderToHtml({ resourceImageUrl: imageUrl }) */
function imageUrl(fileId) {
  const bytes = imageBytes(fileId);
  if (!bytes) return undefined;
  imageUrl.urls ??= new Map();
  if (!imageUrl.urls.has(fileId)) {
    const type = /\.svg$/i.test(fileId) ? 'image/svg+xml' : /\.png$/i.test(fileId) ? 'image/png' : 'image/jpeg';
    imageUrl.urls.set(fileId, URL.createObjectURL(new Blob([bytes], { type })));
  }
  return imageUrl.urls.get(fileId);
}

// ─── /Kit ───────────────────────────────────────────────────────────────────────
```

## アレンジ

### 角の丸い四角の窓

`roundRect`で角の半径を半幅の3分の1にすると、切り絵のようなやわらかい感じになります。

```diff
-    shape: 'circle', x: mm(CX - radius(k)), y: mm(CY - radius(k)),
+    shape: 'roundRect', radius: mm(radius(k) / 3), x: mm(CX - radius(k)), y: mm(CY - radius(k)),
```

### 四隅をすべて丸める

小さな手のためのボードブックは、各丁の四隅を丸めます。

```diff
-  corners: { radius: mm(4), edges: 'fore' },
+  corners: { radius: mm(8), edges: 'all' },
```

## クレジット

- レシピ: Ignacio Ferro ([@drnachio](https://github.com/drnachio))
- テキスト: The verse of the walk and the colophon: Postext Cookbook, CC-BY-4.0
- 画像: Plane 1 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 2 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 3 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 4 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 5 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 6 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 7 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 8 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 9 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 10 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 11 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 12 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 13 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 14 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 15 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 16 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 17 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 18 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 19 of the wood: Generated With Diffusion Models, オリジナル
- 画像: Plane 20 of the wood: Generated With Diffusion Models, オリジナル
- 書体: Cormorant Garamond (OFL-1.1), Lora (OFL-1.1)
- コード: MIT · サンプルの内容: CC-BY-4.0

## 関連レシピ

- [No. 193 · 絵と穴の位置がそろった、いないいないばあのボードブック](https://postext.dev/ja/cookbook/peek-a-boo-board-book.md): dieCutsで次の絵のだまし所に合わせた4つの抜き穴、さらに小さな穴へ続く表紙の窓、角丸、抜き型の線。 · 難易度 2 (中級) · 一枚物とエフェメラ
- [No. 100 · 組版した本を机の上に3Dで開く](https://postext.dev/ja/cookbook/folio-book-on-a-desk.md): postext-folioパッケージのcreateFolioFromDocumentが、組版した章をクロス装の本としてクルミ材の机の上に開きます。見た目はconfig.folioで決めます。 · 難易度 2 (中級) · 小説・戯曲・文芸
- [No. 191 · クラフト紙に白インキで刷るベーカリーのメニュー](https://postext.dev/ja/cookbook/white-ink-kraft-menu.md): 不透明白を特色としてクラフト紙に刷ります。茶色の板紙に白い文字、茶色の文字の下に白いカード、緑の面から白抜きにした文字。 · 難易度 3 (上級) · 一枚物とエフェメラ
