In short
A comic laid out across two facing pages as if they were one: a wide picture of a crowded market runs over the middle of the book, three panels sit under it.
What you'll build
The second story of the album in Nº 152, ¡Abuelo!, told across two facing pages. A December Saturday packs the market; Lola loses her grandfather in the crowd. The top half of the spread is one panorama, 432 mm wide: Lola, tiny, at the far left, Paco searching at the far right, and the aisle of the market running into the fold between them. Under it, three panels: Lola alone among the legs, Paco whistling from a fruit crate, the reunion with his beret in the air. The split is written once for both pages, so the panorama crosses the spine and the gutter of the lower tier falls on the fold. Spanish is the original; the English, Catalan, Chinese, Arabic, Japanese, Portuguese, French, German and Italian editions letter the same spread.
This recipe answers
- How do I lay one comic page across a double-page spread?
The short answer
// The content writes :::page{spread split="55 / * [25 | 25 | *]"}: one frame from the verso's
// outer margin to the recto's (the inner margins drop out), split as one page. The panorama
// crosses the spine; the line at 50 % of the lower tier is the spine itself, so its gutter
// straddles the fold and no panel is cut by it.
const comics = {
gutter: { horizontal: mm(5), vertical: mm(4) }, // 2 mm of white on each side of the fold
panel: { borderWidth: pt(0.75), borderColor: col('ink'), background: col('paper') },
lettering: { fontFamily: LETTER, fontSize: pt(LATIN ? 9.5 : 8.5), lineHeight: 1.1,
color: col('ink') },
runningHeads: true, // folios on both halves
};
// A spread opens on a verso, an even page. Page 1 of a document is a recto, so the engine
// would leave it blank and start on page 2; this episode continues an album at page 2.
const continuation = { pageIndexOffset: 1, pageNumbering: { startAt: 2 } };
One split across two facing pages, opened on a verso
Ingredients
- Features
- Double-page comic spreadsPanel splitsPanel art and cropsSpeakers and anchorsComic pagesComic letteringRe-lettering in other languagesBalloon stylesPanel borders and guttersMirrored marginsSemantic colour palettePages on a canvasPDF export
- Also uses
- Paper colourHeads by page roleFonts embedded in the PDFFigures and tables as resourcesSound effects
- Type
- Patrick Hand, Bangers, Noto Sans SC, ZCOOL KuaiLe, Zen Antique, Dela Gothic One, Playpen Sans Arabic, Lalezar (SIL OFL 1.1)
- Assets
ds1-1900.jpgds2.jpgds3.jpgds4.jpg- Panorama of the crowded market hall: tiny Lola stands lost on the far left; far right, her grandfather searches the crowd. (Generated With Diffusion Models, original)
- Lola, tearful, stands among grown-ups' legs and shopping bags. (Generated With Diffusion Models, original)
- Paco stands on a fruit crate and whistles through his fingers; shoppers turn to look. (Generated With Diffusion Models, original)
- Lola leaps into her grandfather's arms; his beret flies off and the stallholders smile. (Generated With Diffusion Models, original)
Method
#1 · One split over both pages
The code is the short answer above. The whole comic is one directive with the spread flag:
:::page{spread split="55 / * [25 | 25 | *]"}
::panel{art=ds1}
caption: Un sábado de diciembre, el mercado estaba hasta los topes.
lola: ¿Abuelo?
paco{shout}: ¿Lola? ¡Lolaaa!The frame runs from the verso's outer margin to the recto's; the inner margins drop out. The first tier, 55 % of the height, is a single panel across the spine. In the second, 25 | 25 | * puts its first line at 25 % and its second at 50 %, the spine itself: two square panels on the verso, the reunion on the recto. A spread opens on an even page, and a document's page 1 is a recto, so the build passes continuation: { pageIndexOffset: 1 }: this episode continues the album at page 2, and no blank page comes first.
#2 · A panorama big enough for two pages
// The panorama is 1,900 px wide: across the 432 mm of the spread it prints at about 112 dpi.
const box = ([x, y, width, height]) => ({ x, y, width, height });
const who = (id, x, y, head, face) => ({ id, x, y,
...(head && { head: { x: head[0], y: head[1] } }), ...(face && { face: box(face) }) });
const ART = {
ds1: { width: 1900, height: 633, safeArea: box([.03, .27, .93, .53]),
alt: t({ en: 'Panorama of the crowded market hall: tiny Lola stands lost on the far left; '
+ 'far right, her grandfather searches the crowd.',
es: 'Panorámica del mercado lleno de gente: a la izquierda del todo, Lola, '
+ 'diminuta, está perdida; a la derecha del todo, su abuelo la busca entre la multitud.',
ca: 'Panoràmica del mercat ple de gent: a l’extrem esquerre, la Lola, petitíssima, '
+ 'està perduda; a l’extrem dret, el seu avi la busca entre la gentada.',
zh: '拥挤的市场全景:最左边,小小的萝拉迷了路;最右边,她的爷爷在人群中寻找她。',
ar: 'منظر واسع للسوق المزدحم: لولا الصغيرة تائهة في أقصى اليسار، وفي أقصى اليمين '
+ 'جدّها يبحث عنها بين الناس.',
ja: '人でいっぱいの市場のパノラマ。左端に小さなローラが迷子になって立ち、右端では祖父が人ごみの中を探している。',
pt: 'Panorama do mercado lotado: na ponta esquerda, a pequena Lola está perdida; na ponta '
+ 'direita, o avô a procura no meio da multidão.',
fr: 'Panorama de la halle du marché bondée : tout à gauche, la petite Lola est perdue ; '
+ 'tout à droite, son grand-père la cherche dans la foule.',
de: 'Panorama der vollen Markthalle: Ganz links steht die kleine Lola verloren da; ganz '
+ 'rechts sucht ihr Großvater die Menge ab.',
it: 'Panoramica del mercato coperto pieno di gente: all’estrema sinistra la piccola Lola si '
+ 'è persa; all’estrema destra suo nonno la cerca tra la folla.' }),
anchors: [
who('lola', .065, .58, [.063, .55], [.045, .51, .04, .11]),
who('paco', .925, .38, [.925, .34], [.9, .3, .05, .12]),
],
faces: [box([.062, .305, .022, .055])], // the fishmonger behind Lola, who says nothing
},
ds2: { width: 1152, height: 1152, safeArea: box([.31, .08, .35, .62]),
alt: t({ en: "Lola, tearful, stands among grown-ups' legs and shopping bags.",
es: 'Lola, con lágrimas en los ojos, está de pie entre piernas de mayores y bolsas '
+ 'de la compra.',
ca: 'La Lola, amb llàgrimes als ulls, és dreta entre cames de grans i bosses de la compra.',
zh: '萝拉含着眼泪,站在大人们的腿和购物袋之间。',
ar: 'لولا والدموع في عينيها واقفة بين سيقان الكبار وأكياس التسوّق.',
ja: '涙ぐんだローラが、大人の足と買い物袋のあいだに立っている。',
pt: 'Lola, com lágrimas nos olhos, está de pé entre pernas de adultos e sacolas '
+ 'de compras.',
fr: 'Lola, les larmes aux yeux, se tient entre des jambes d’adultes et des sacs de '
+ 'courses.',
de: 'Lola steht mit Tränen in den Augen zwischen Erwachsenenbeinen und Einkaufstaschen.',
it: 'Lola, con le lacrime agli occhi, è in piedi tra gambe di adulti e borse della '
+ 'spesa.' }),
anchors: [
who('lola', .505, .24, [.48, .17], [.4, .1, .18, .19]),
],
},
ds3: { width: 1000, height: 1000, safeArea: box([.34, .07, .47, .23]),
alt: t({ en: 'Paco stands on a fruit crate and whistles through his fingers; shoppers '
+ 'turn to look.',
es: 'Paco, subido a una caja de fruta, silba con los dedos; la gente se vuelve a mirar.',
ca: 'En Paco, enfilat a una caixa de fruita, xiula amb els dits; la gent es gira a mirar.',
zh: '帕科站在水果箱上,用手指吹口哨;买东西的人都回过头来看。',
ar: 'باكو واقف على صندوق فاكهة ويصفّر بأصابعه، والمتسوّقون يلتفتون لينظروا.',
ja: 'パコが果物の木箱に乗って指笛を吹き、買い物客がふり返る。',
pt: 'Paco, em cima de um caixote de frutas, assobia com os dedos; as pessoas se viram '
+ 'para olhar.',
fr: 'Paco, debout sur une cagette de fruits, siffle avec ses doigts ; les clients se '
+ 'retournent.',
de: 'Paco steht auf einer Obstkiste und pfeift auf den Fingern; die Leute drehen sich um.',
it: 'Paco, in piedi su una cassetta della frutta, fischia con le dita; la gente si volta a '
+ 'guardare.' }),
anchors: [
who('paco', .5, .2, [.47, .14], [.38, .08, .17, .16]),
who('sfx', .62, .17),
],
},
ds4: { width: 1200, height: 800, safeArea: box([.33, .05, .48, .57]),
alt: t({ en: "Lola leaps into her grandfather's arms; his beret flies off and the "
+ "stallholders smile.",
es: 'Lola salta a los brazos de su abuelo; la boina sale volando y los tenderos sonríen.',
ca: 'La Lola salta als braços del seu avi; la boina surt volant i els paradistes somriuen.',
zh: '萝拉扑进爷爷怀里;他的贝雷帽飞了出去,摊主们都笑了。',
ar: 'لولا تقفز إلى ذراعي جدّها، وقبعته تطير، والباعة يبتسمون.',
ja: 'ローラが祖父の腕に飛びこむ。ベレー帽が飛び、店の人たちがほほえむ。',
pt: 'Lola pula nos braços do avô; a boina sai voando e os feirantes sorriem.',
fr: 'Lola saute dans les bras de son grand-père ; son béret s’envole et les marchands '
+ 'sourient.',
de: 'Lola springt ihrem Großvater in die Arme; seine Baskenmütze fliegt davon, und die '
+ 'Händler lächeln.',
it: 'Lola salta in braccio al nonno; il basco gli vola via e i bancarellai sorridono.' }),
anchors: [
who('lola', .51, .27, [.47, .2], [.42, .14, .13, .19]),
who('paco', .595, .31, [.62, .22], [.55, .14, .15, .22]),
],
avoid: [box([.67, .06, .13, .22])],
},
};
The panorama is the only picture printed across the fold, 432 × 144 mm, so it ships at 1,900 px (380 KB); the other three are 1,000–1,200 px. Its safe area is a band across nearly its whole width, and its two speakers stand at the edges, 6 % and 92 % across, far from the spine, where the binding would swallow a balloon. The picture was drawn with the middle free of faces: the aisle of the market runs into the fold. A crowd is full of faces that speak no line: the fishmonger behind Lola is marked in faces, the list of the faces of people who say nothing, so her first balloon stands beside him and never on his face or his cap, and the Japanese edition pins its column there (at="2.8% 37%").
#3 · The album's balloons
comics.balloonStyles = [
{ id: 'speech', fill: col('balloon'), stroke: col('ink'), strokeWidth: pt(0.6) },
{ id: 'caption', fill: col('cartouche'), stroke: col('ink'), strokeWidth: pt(0.6),
padding: em(0.45), aspect: 3.4 },
{ id: 'shout', fill: col('balloon'), stroke: col('ink'), burstPoints: 16, fontScale: 1.2 },
{ id: 'whisper', fill: col('balloon'), stroke: col('ink') },
{ id: 'sfx', fontFamily: DISPLAY, color: col('orange'), halo: pt(1.6), haloColor: col('ink'),
fontScale: 3.2 },
];
comics.cast = [
{ id: 'lola', name: 'Lola' },
{ id: 'paco', name: t({ es: 'el abuelo Paco', en: 'Grandpa Paco', ca: "l'avi Paco",
zh: '帕科爷爷', ar: 'الجد باكو', ja: 'パコおじいちゃん', pt: 'o vovô Paco', fr: 'papi Paco',
de: 'Opa Paco',
it: 'nonno Paco' }) },
];
The balloon styles are those of Nº 152: white speech balloons, pale yellow cartouches, a burst for Paco's shout, a dashed outline for Lola's whisper, and the whistle in the album's sound-effect face, Bangers in the Latin editions. cast gives the PDF and the EPUB the names they read before each line.
The whole recipe
// ═══ Postext Cookbook · Nº 154 · One comic page across a double spread ═══════════════
// https://postext.dev/en/cookbook/comic-double-spread
// Code: MIT · Story: written for the recipe (CC BY 4.0) · Pictures: generated with diffusion models
// Fonts: Patrick Hand, Bangers, the comic faces of each script (OFL) · Needs postext ≥ 1.34.0
// One split tree laid across two facing pages: a panorama runs over the spine, and the
// tier under it splits at the spine's gutter. Same album, same lettering as Nº 152.
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage, defaultComicFont,
defaultComicSfxFont,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: 'es' | 'en' | 'ca' | 'zh' | 'ar' | 'ja' | 'pt' | 'fr' | 'de' | 'it'
const RECIPE = 'comic-double-spread';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the album's flat colours
const palette = {
ink: '#1d1b19', // outlines, lettering, folios
orange: '#d9601a', // the sound effect
cartouche: '#fbe8a6', // narration boxes
balloon: '#ffffff',
muted: '#5f5a54', // the colophon
paper: '#fffdf8',
};
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: 'orange (defaults)', value: { hex: palette.orange, model: 'hex' } },
];
// #endregion
const LOCALE = t({ es: 'es', en: 'en-gb', ca: 'ca', zh: 'zh-Hans', ar: 'ar', ja: 'ja',
pt: 'pt-BR', fr: 'fr', de: 'de', it: 'it' });
const LATIN = ['es', 'en', 'ca', 'pt', 'fr', 'de', 'it'].includes(LANG);
const LETTER = LATIN ? 'Patrick Hand' : defaultComicFont(LOCALE); // mixed-case hand lettering
const DISPLAY = defaultComicSfxFont(LOCALE); // Bangers, Dela Gothic One, ZCOOL KuaiLe, Lalezar
// #region answer: one split across two facing pages, opened on a verso
// The content writes :::page{spread split="55 / * [25 | 25 | *]"}: one frame from the verso's
// outer margin to the recto's (the inner margins drop out), split as one page. The panorama
// crosses the spine; the line at 50 % of the lower tier is the spine itself, so its gutter
// straddles the fold and no panel is cut by it.
const comics = {
gutter: { horizontal: mm(5), vertical: mm(4) }, // 2 mm of white on each side of the fold
panel: { borderWidth: pt(0.75), borderColor: col('ink'), background: col('paper') },
lettering: { fontFamily: LETTER, fontSize: pt(LATIN ? 9.5 : 8.5), lineHeight: 1.1,
color: col('ink') },
The composed script.js runs as it is: paste it into any page’s module script, or open the recipe on CodePen. Recipe folder on GitHub ↗ (opens in a new tab)
Variations
#Start the book with the spread
Drop the continuation and the engine leaves page 1 blank (role blank), so the spread still falls on pages 2 and 3.
-const continuation = { pageIndexOffset: 1, pageNumbering: { startAt: 2 } };
+const continuation = {};Pitfalls
- Balloons keep out of an 8 mm band about the spine, pins included: a speaker standing on the fold gets a balloon pushed to one side. Keep the speakers of a panel that crosses the spine away from its middle.
- A balloon keeps off two figures whose faces touch, a hug or a fight, its own speaker's included. In the Japanese and Arabic editions the spread reads from the right, the reunion panel moves to the left page and the flying beret takes its top right corner; Paco's two balloons go over the market beside his head, not over the hug. Mark both faces in the art (
face) so that the engine sees them touch.
Credits
- Recipe
- Ignacio Ferro
- Text
- ¡Abuelo! (Grandpa!), a two-page comic written for this recipe, in six languages · Postext Cookbook · CC BY 4.0
- Images
- Panorama of the crowded market hall: tiny Lola stands lost on the far left; far right, her grandfather searches the crowd. · Generated With Diffusion Models · original
- Lola, tearful, stands among grown-ups' legs and shopping bags. · Generated With Diffusion Models · original
- Paco stands on a fruit crate and whistles through his fingers; shoppers turn to look. · Generated With Diffusion Models · original
- Lola leaps into her grandfather's arms; his beret flies off and the stallholders smile. · Generated With Diffusion Models · original
- Fonts
- Patrick Hand (SIL OFL 1.1) · Bangers (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · ZCOOL KuaiLe (SIL OFL 1.1) · Zen Antique (SIL OFL 1.1) · Dela Gothic One (SIL OFL 1.1) · Playpen Sans Arabic (SIL OFL 1.1) · Lalezar (SIL OFL 1.1)
Edit this write-up ↗ (opens in a new tab)Recipe folder on GitHub ↗ (opens in a new tab)


