En poques paraules
Una pàgina de còmic dibuixada una vegada i maquetada de tres maneres. Les mateixes cinc imatges i els mateixos diàlegs omplen tres reixes de vinyetes diferents, i cada imatge es retalla de nou per a la seva vinyeta.
Què compondràs
Una prova de maqueta per a una pàgina de còmic, La llum de Porthcove: una portada i la mateixa pàgina en tres plans, perquè l’autor triï. Les cinc imatges (la Maya pujant al far, el seu avi davant una ràdio muda, la Maya assenyalant el terra, el gat adormit sobre el cable, el far encès de nit) i els sis textos retolats no canvien; només canvia el split de cada :::page. Cada imatge es retalla un altre cop per a la seva vinyeta i cada bafarada es col·loca un altre cop al costat de qui parla. El format és el d’un còmic americà, 168 × 259 mm, i la prova surt en deu edicions, cadascuna retolada en el seu idioma.
Aquesta recepta respon a
- Com divideixo una pàgina en vinyetes?
- Com evito que el retall d'una vinyeta talli la cara d'un personatge?
- Com retolo un còmic en una altra llengua?
La resposta curta
// Every :::page fills the type area; its split attribute cuts it into cells and its ::panel
// lines fill them in reading order (rows top to bottom, columns from the start side):
// :::page{split="30 / 35 [* | * | *] / *"} three tiers, the middle one in three
// :::page{split="60 [* / *] | * [* / * / *]"} two columns, then each column in tiers
// :::page{split="30 [30 | 20 | *] / *"} a 30 % tier cut 30 | 20 | rest, then the rest
// A size is a percentage of the parent cell, * shares what is left, [ … ] cuts that cell
// on the other axis. A panel with inset="x y w h" sits over the panel before it.
const comics = {
gutter: { horizontal: mm(4), vertical: mm(3) }, // between tiers, between panels in a tier
panel: { borderWidth: pt(1), borderColor: col('ink'), background: col('paper') },
lettering: { fontFamily: LETTERING, fontSize: pt(8), color: col('ink'), inset: mm(1) },
balloonStyles: [
{ id: 'speech', stroke: col('ink') },
{ id: 'caption', fill: col('caption'), stroke: col('ink') },
{ id: 'sfx', fontFamily: SFX, color: col('accent'), haloColor: col('paper') },
],
runningHeads: true, // a comic page has no running head unless asked: here, its folio
};
Ingredients
- Funcions
- Divisió en vinyetesImatge i retall de la vinyetaPersonatges i àncoresZona segura de la imatgeVores i separacions de les vinyetesPàgines de còmicRetolació de còmicRetolar en altres llengüesEstils de bafaradaOnomatopeiesPaleta de color semànticaPàgines en un canvasExportació a PDF
- També fa servir
- Paràgrafs en l'altra direccióVinyetes inserides, a sang i amb la vora trencadaColor del paperEstils de paràgrafFonts incrustades al PDFFigures i taules com a recursos
- Tipografia
- Comic Neue, Bangers, Zen Antique, Dela Gothic One, ZCOOL KuaiLe, ZCOOL QingKe HuangYou, Playpen Sans Arabic, Lalezar (SIL OFL 1.1)
- Recursos
lh-arrive.jpglh-beam.jpglh-biscuit.jpglh-maya.jpglh-radio.jpg- Panel picture: Maya arrives at the lighthouse (Generated With Diffusion Models, original)
- Panel picture: Tomás at the radio (Generated With Diffusion Models, original)
- Panel picture: Maya finds the problem (Generated With Diffusion Models, original)
- Panel picture: Biscuit asleep on the cable (Generated With Diffusion Models, original)
- Panel picture: the lamp lit at night (Generated With Diffusion Models, original)
Elaboració
#1 · Talla la pàgina amb un arbre de divisió
El codi és la resposta curta de dalt. Un :::page ocupa la caixa de la pàgina, aquí 144 × 227 mm, i el seu atribut split la talla. / separa files, | separa columnes, cada mesura és un percentatge de la cel·la que talla, * reparteix el que queda i un claudàtor torna a tallar aquella cel·la en l’altre eix (dividir la pàgina). El pla C, 30 [30 | 20 | *] / *, fa una tira del 30 % d’alt, la parteix en cel·les del 30 % i del 20 % d’ample més la resta, i deixa a sota una sola cel·la alta. Els carrers queden a cavall de cada línia: 4 mm entre tires, 3 mm entre vinyetes d’una mateixa tira. Les línies ::panel omplen les cel·les en ordre de lectura: les files de dalt a baix i les columnes des del costat d’inici.

#2 · Dona a cada imatge una zona segura
// From the art manifest; fractions of each picture, the same in every language. The safe
// area is what every crop keeps: Tomás alone, not his radio, so a cell a fifth of the page
// wide still shows him; the lighthouse and the gallery, not the boat, so a tall cell holds them.
const ART = {
'lh-arrive': { width: 1100, height: 733, safeArea: { x: 0.22, y: 0.08, width: 0.4, height: 0.64 },
anchors: [{ id: 'maya', x: 0.29, y: 0.52, head: { x: 0.27, y: 0.47 },
face: { x: 0.22, y: 0.42, width: 0.12, height: 0.16 } },
{ id: 'biscuit', x: 0.4, y: 0.68, face: { x: 0.37, y: 0.64, width: 0.07, height: 0.08 } }],
avoid: [{ x: 0.51, y: 0.09, width: 0.1, height: 0.43 }],
alt: t({ en: 'A girl in a yellow raincoat walks up a coastal path towards a red-and-white '
+ 'lighthouse, a fat orange cat ahead of her.',
es: 'Una niña con chubasquero amarillo sube por un camino de costa hacia un faro rojo y '
+ 'blanco, con un gato naranja gordo delante.',
ca: 'Una nena amb impermeable groc puja per un camí de costa cap a un far vermell i blanc, '
+ 'amb un gat taronja gras al davant.',
zh: '一个穿黄色雨衣的女孩沿着海边小路走向红白相间的灯塔,一只胖胖的橘猫走在前面。',
ar: 'فتاة بمعطف مطر أصفر تصعد دربًا ساحليًا نحو منارة حمراء وبيضاء، وأمامها قط برتقالي سمين.',
ja: '黄色いレインコートの女の子が、赤と白の灯台へ続く海辺の小道をのぼっていく。前を太ったオレンジ色の猫が歩く。',
pt: 'Uma menina de capa de chuva amarela sobe um caminho à beira-mar rumo a um farol '
+ 'vermelho e branco, com um gato laranja gordo à frente.',
fr: 'Une fillette en ciré jaune monte un sentier côtier vers un phare rouge et blanc, '
+ 'précédée d’un gros chat roux.',
de: 'Ein Mädchen in gelbem Regenmantel geht einen Küstenpfad zu einem rot-weißen '
+ 'Leuchtturm hinauf, eine dicke rote Katze vor ihr.',
it: 'Una bambina con l’impermeabile giallo sale per un sentiero costiero verso un faro '
+ 'bianco e rosso, preceduta da un grosso gatto rosso.' }) },
'lh-radio': { width: 1000, height: 1000,
safeArea: { x: 0.27, y: 0.38, width: 0.24, height: 0.3 },
anchors: [{ id: 'tomas', x: 0.345, y: 0.52, head: { x: 0.38, y: 0.44 },
face: { x: 0.29, y: 0.4, width: 0.16, height: 0.18 } }],
avoid: [{ x: 0, y: 0.44, width: 0.22, height: 0.26 }],
alt: t({ en: 'The old keeper, white-bearded, in a navy sweater and cap, taps a valve radio '
+ 'with the microphone in his hand.',
es: 'El viejo farero, de barba blanca, jersey azul marino y gorra, golpea una radio de '
+ 'válvulas con el micrófono en la mano.',
ca: 'El vell faroner, de barba blanca, jersei blau marí i gorra, pica una ràdio de vàlvules '
+ 'amb el micròfon a la mà.',
zh: '白胡子的老守塔人穿着藏青色毛衣、戴着帽子,手握话筒,敲着一台电子管收音机。',
ar: 'حارس المنارة العجوز بلحيته البيضاء وكنزته الكحلية وقبعته ينقر على مذياع قديم '
+ 'والميكروفون في يده.',
ja: '白いひげの老灯台守が、紺のセーターに帽子姿でマイクを握り、真空管ラジオをたたいている。',
pt: 'O velho faroleiro, de barba branca, suéter azul-marinho e boné, dá batidinhas num '
+ 'rádio valvulado com o microfone na mão.',
fr: 'Le vieux gardien, barbe blanche, pull bleu marine et casquette, tapote une radio à '
+ 'lampes, le micro à la main.',
de: 'Der alte Wärter mit weißem Bart, marineblauem Pullover und Mütze klopft auf ein '
+ 'Röhrenradio, das Mikrofon in der Hand.',
it: 'Il vecchio guardiano, barba bianca, maglione blu e berretto, picchietta su una radio a '
+ 'valvole con il microfono in mano.' }) },
'lh-maya': { width: 1100, height: 1100, safeArea: { x: 0.25, y: 0.27, width: 0.41, height: 0.68 },
anchors: [{ id: 'maya', x: 0.54, y: 0.565, head: { x: 0.5, y: 0.3 },
face: { x: 0.4, y: 0.33, width: 0.24, height: 0.29 } }],
avoid: [{ x: 0.27, y: 0.73, width: 0.25, height: 0.22 }],
alt: t({ en: 'Close-up of Maya frowning at the floor and pointing down.',
es: 'Primer plano de Maya, que frunce el ceño mirando al suelo y señala hacia abajo.',
ca: 'Primer pla de la Maya, que arrufa les celles mirant a terra i assenyala avall.',
zh: '玛雅的特写:她皱着眉头看着地板,手指向下指。',
ar: 'لقطة قريبة لمايا وهي تعقد حاجبيها ناظرةً إلى الأرض وتشير إلى أسفل.',
ja: 'マヤのアップ。眉をひそめて床を見つめ、下を指さしている。',
pt: 'Close de Maya, de testa franzida, olhando para o chão e apontando para baixo.',
fr: 'Gros plan sur Maya, sourcils froncés, qui fixe le sol et pointe le doigt vers le '
+ 'bas.',
de: 'Nahaufnahme von Maya, die mit gerunzelter Stirn auf den Boden blickt und nach unten '
+ 'zeigt.',
it: 'Primo piano di Maya, accigliata, che fissa il pavimento e indica in basso.' }) },
'lh-biscuit': { width: 1000, height: 1000,
safeArea: { x: 0.58, y: 0.25, width: 0.42, height: 0.33 },
anchors: [{ id: 'biscuit', x: 0.72, y: 0.355, head: { x: 0.73, y: 0.32 },
face: { x: 0.64, y: 0.27, width: 0.2, height: 0.18 } }],
avoid: [{ x: 0.93, y: 0.28, width: 0.07, height: 0.24 },
{ x: 0, y: 0.72, width: 0.4, height: 0.1 }],
alt: t({ en: 'Under the desk the fat orange cat sleeps on his back, right on top of the black '
+ 'radio cable.',
es: 'Bajo la mesa, el gato naranja gordo duerme panza arriba justo encima del cable negro '
+ 'de la radio.',
ca: 'Sota la taula, el gat taronja gras dorm panxa enlaire just a sobre del cable negre de '
+ 'la ràdio.',
zh: '桌子底下,胖橘猫四脚朝天地睡着,正好压在收音机的黑色电线上。',
ar: 'تحت المكتب ينام القط البرتقالي السمين على ظهره فوق سلك المذياع الأسود تمامًا.',
ja: '机の下で、太ったオレンジ色の猫がラジオの黒いコードの真上にあおむけで眠っている。',
pt: 'Debaixo da mesa, o gato laranja gordo dorme de barriga para cima bem em cima do cabo '
+ 'preto do rádio.',
fr: 'Sous le bureau, le gros chat roux dort sur le dos, juste sur le câble noir de la '
+ 'radio.',
it: 'Sotto la scrivania, il grosso gatto rosso dorme a pancia in su, proprio sopra il cavo '
+ 'nero della radio.',
de: 'Unter dem Schreibtisch schläft die dicke rote Katze auf dem Rücken, genau auf dem '
+ 'schwarzen Kabel des Funkgeräts.' }) },
'lh-beam': { width: 1200, height: 800, safeArea: { x: 0.15, y: 0.01, width: 0.25, height: 0.3 },
anchors: [{ id: 'maya', x: 0.235, y: 0.15,
face: { x: 0.21, y: 0.11, width: 0.05, height: 0.07 } },
{ id: 'tomas', x: 0.3, y: 0.145, face: { x: 0.28, y: 0.11, width: 0.04, height: 0.06 } }],
avoid: [{ x: 0.79, y: 0.55, width: 0.08, height: 0.09 }],
alt: t({ en: 'Night: the beam sweeps over a dark sea; Maya and her grandfather stand on the '
+ 'lantern gallery and a fishing boat shows its lights far out.',
es: 'De noche, el haz barre un mar oscuro; Maya y su abuelo están en la galería de la '
+ 'linterna y a lo lejos se ven las luces de un pesquero.',
ca: 'De nit, el feix escombra un mar fosc; la Maya i el seu avi són a la galeria de la '
+ 'llanterna i lluny es veuen els llums d’un pesquer.',
zh: '夜里,灯塔的光束扫过漆黑的海面;玛雅和外公站在灯室外的回廊上,远处一艘渔船亮着灯。',
ar: 'ليلًا يمسح الشعاع بحرًا مظلمًا، ومايا وجدّها واقفان على شرفة الفانوس، وفي البعيد قارب '
+ 'صيد بأضوائه.',
ja: '夜。光の帯が暗い海をなでる。マヤと祖父は灯室の回廊に立ち、沖には漁船の明かりが見える。',
pt: 'À noite, o facho varre um mar escuro; Maya e o avô estão na galeria da lanterna e, ao '
+ 'longe, aparecem as luzes de um barco de pesca.',
fr: 'La nuit, le faisceau balaie une mer sombre ; Maya et son grand-père se tiennent sur '
+ 'la galerie de la lanterne et, au large, un bateau de pêche montre ses feux.',
de: 'Nacht: Der Lichtstrahl streicht über ein dunkles Meer; Maya und ihr Großvater stehen '
+ 'auf der Galerie der Laterne, und weit draußen zeigt ein Fischerboot seine Lichter.',
it: 'Di notte il fascio di luce spazza un mare scuro; Maya e suo nonno sono sulla balconata '
+ 'della lanterna e, al largo, si vedono le luci di un peschereccio.' }) },
};
Cada imatge es dibuixa una vegada i es retalla per omplir la cel·la que li toqui. La zona segura és el que tot retall conserva sencer (vinyetes i imatges). La de la ràdio és només el faroner, el 24 % de l’amplada, de manera que la cel·la de 26 mm del pla C el mostra de la gorra a les botes i deixa fora la ràdio; les cel·les amples dels plans A i B ensenyen totes dues coses. Si una cel·la no pot contenir la zona segura, la imatge queda amb bandes i la composició avisa (comicPanelLetterbox). Les àncores marquen la boca i la cara de cada personatge en les mateixes fraccions, i així els rabets el troben en qualsevol retall.
#3 · Posa una vinyeta sobre una altra
La divisió del pla C dona quatre cel·les per a cinc vinyetes. El gat hi entra amb inset="50 50 46 46": una vinyeta del 46 % d’ample i d’alt, col·locada al 50 %, 50 % de la vinyeta anterior, la de la Maya. Una vinyeta inserida no ocupa cel·la, de manera que les següents conserven el seu lloc, i es llegeix just després de la que tapa.
#4 · Retola deu edicions amb la mateixa maqueta
// The lettering and sound-effect faces of each edition: the engine's defaults, but for Chinese
// two ZCOOL faces drawn for cartoons instead of Noto Sans SC. content.<lang>.md holds the words
// of each edition under the same speaker ids; Japanese balloons are set vertically, and the
// Japanese and Arabic editions, read right to left, mirror the order of the panels in every row.
const [LETTERING, SFX] = t({
en: ['Comic Neue', 'Bangers'], es: ['Comic Neue', 'Bangers'], ca: ['Comic Neue', 'Bangers'],
ja: ['Zen Antique', 'Dela Gothic One'], zh: ['ZCOOL KuaiLe', 'ZCOOL QingKe HuangYou'],
ar: ['Playpen Sans Arabic', 'Lalezar'], pt: ['Comic Neue', 'Bangers'],
fr: ['Comic Neue', 'Bangers'], de: ['Comic Neue', 'Bangers'], it: ['Comic Neue', 'Bangers'],
});
La divisió, les imatges, els retalls i les àncores són iguals en tots els idiomes; content.<lang>.md només porta les paraules, amb els mateixos identificadors de personatge (maya, tomas). L’edició japonesa compon les bafarades en vertical, amb vuit caràcters per columna, i treu el 。 final; es llegeix de dreta a esquerra, com l’àrab, així que les vinyetes de cada fila s’inverteixen, però les imatges no. El cos de la retolació és 8 pt en totes: un text més llarg dona una bafarada més gran, mai una lletra més petita (retolació).
La recepta completa
// ═══ Postext Cookbook · Nº 144 · One set of panels, three page splits ═══════════════
// https://postext.dev/en/cookbook/comic-page-splitters
// Code: MIT · Text: original (CC BY 4.0) · Pictures: generated with diffusion models
// Fonts: Comic Neue, Bangers and the faces of five editions (OFL) · Needs postext ≥ 1.25.0
//
// A layout proof for one page of a comic: the same five pictures and the same lines of
// dialogue laid out under three `split` trees. Each picture carries a safe area, so its subject
// stays in view whether its cell is wide, tall or square, and the lettering is placed again
// around the speakers' anchors on every page and in every language.
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'ca'; // @lang: 'en' | 'es' | 'ca' | 'zh' | 'ar' | 'ja' | 'pt' | 'fr' | 'de' | 'it'
const RECIPE = 'comic-page-splitters';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the night sea, the lighthouse red and the yellow of the captions
const palette = {
ink: '#1b2430', // panel borders, lettering and text: a blue-black
accent: '#b8322a', // the lighthouse red: the proof's labels
caption: '#f4e7bf', // caption boxes, an old-paper yellow
muted: '#5f6873', // folios and the imprint
paper: '#fdfbf6',
};
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.accent, model: 'hex' } },
];
// #endregion
// #region editions: one comic, six editions, each lettered in faces for its script
// The lettering and sound-effect faces of each edition: the engine's defaults, but for Chinese
// two ZCOOL faces drawn for cartoons instead of Noto Sans SC. content.<lang>.md holds the words
// of each edition under the same speaker ids; Japanese balloons are set vertically, and the
// Japanese and Arabic editions, read right to left, mirror the order of the panels in every row.
const [LETTERING, SFX] = t({
en: ['Comic Neue', 'Bangers'], es: ['Comic Neue', 'Bangers'], ca: ['Comic Neue', 'Bangers'],
ja: ['Zen Antique', 'Dela Gothic One'], zh: ['ZCOOL KuaiLe', 'ZCOOL QingKe HuangYou'],
ar: ['Playpen Sans Arabic', 'Lalezar'], pt: ['Comic Neue', 'Bangers'],
fr: ['Comic Neue', 'Bangers'], de: ['Comic Neue', 'Bangers'], it: ['Comic Neue', 'Bangers'],
});
// #endregion
// #region answer: the comic: a frame, gutters, a panel border, and a page per split
// Every :::page fills the type area; its split attribute cuts it into cells and its ::panel
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Inclina la tira central
Una mesura escrita 30~40 porta el carrer final d’aquella cel·la del 30 % en un extrem al 40 % en l’altre. Les cel·les inclinades perden les cantonades arrodonides.
-:::page{split="30 / 35 [* | * | *] / *"}
+:::page{split="30 / 35 [30~40 | * | *] / *"}#Inverteix les imatges en les edicions de dreta a esquerra
Per defecte, les imatges conserven l’orientació. Un còmic dibuixat sense rètols ni rellotges pot seguir el sentit de lectura.
const comics = {
+ mirrorArt: true, // les imatges s’inverteixen en una edició de dreta a esquerra
gutter: { horizontal: mm(4), vertical: mm(3) },Errors freqüents
- Una cel·la d’un cinquè de l’amplada de la pàgina admet unes quatre paraules per línia a 8 pt, i al pla C el faroner té la cara al mig de la seva: les seves dues bafarades sobre la tempesta no caben ni a sobre ni a sota. Allà la primera de les dues frases porta
break(tomas{break}:), així que la parella pot travessar el carrer cap a la vinyeta de la Maya; el motor deixa la segona bafarada darrere de la primera i mai no la treu al marge de la pàgina. Sensebreak, la construcció avisacomicBalloonOverflow. - Una zona segura més ajustada dona un retall net en més cel·les, però el que queda fora es pot perdre: les botes a la primera tira del pla A, la ràdio al pla C.
Crèdits
- Recepta
- Ignacio Ferro
- Text
- Text original, CC BY 4.0
- Imatges
- Panel picture: Maya arrives at the lighthouse · Generated With Diffusion Models · original
- Panel picture: Tomás at the radio · Generated With Diffusion Models · original
- Panel picture: Maya finds the problem · Generated With Diffusion Models · original
- Panel picture: Biscuit asleep on the cable · Generated With Diffusion Models · original
- Panel picture: the lamp lit at night · Generated With Diffusion Models · original
- Fonts
- Comic Neue (SIL OFL 1.1) · Bangers (SIL OFL 1.1) · Zen Antique (SIL OFL 1.1) · Dela Gothic One (SIL OFL 1.1) · ZCOOL KuaiLe (SIL OFL 1.1) · ZCOOL QingKe HuangYou (SIL OFL 1.1) · Playpen Sans Arabic (SIL OFL 1.1) · Lalezar (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


