Pular para o conteúdo principal
Receita número 144

Receitas · Capítulo 11 · Quadrinhos e mangá

Os mesmos quadros em três divisões de página

Cinco quadros de HQ em três árvores de divisão: o split de :::page corta a página e a área segura de cada imagem mantém o assunto à vista em qualquer célula.

Nesta página
Gênero
Quadrinhos
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licença
Atualizada em 10 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Refile 168 × 259 mm
  • 1 coluna
  • Comic Neue 10,5/15
  • Bangers
  • 4 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 406 ms
  • 132 linhas de código

Em poucas palavras

Uma página de HQ desenhada uma vez e diagramada de três jeitos. As mesmas cinco imagens e os mesmos diálogos preenchem três grades de quadros diferentes, e cada imagem é recortada de novo para caber no quadro.

O que você vai compor

Uma prova de diagramação para uma página de HQ, O farol de Porthcove: uma folha de rosto e a mesma página em três planos, para o autor escolher. As cinco imagens (Maya subindo ao farol, o avô diante de um rádio mudo, Maya apontando para o chão, o gato dormindo sobre o cabo, o farol aceso à noite) e as seis falas letreiradas nunca mudam; muda só o split de cada :::page. Cada imagem é recortada de novo para a célula e cada balão é posicionado de novo junto de quem fala. O formato é o do gibi americano, 168 × 259 mm, e a prova sai em dez edições, cada uma letreirada no idioma.

Esta receita responde a

  • Como faço para dividir uma página em quadros de quadrinhos?
  • Como faço para manter um rosto à vista quando o quadro recorta a imagem?
  • Como faço para letrear uma história em quadrinhos em outro idioma?

A resposta curta

script.js · linhas 48–65no código completo
// 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
};

Ingredientes

Tipografia
Comic Neue, Bangers, Zen Antique, Dela Gothic One, ZCOOL KuaiLe, ZCOOL QingKe HuangYou, Playpen Sans Arabic, Lalezar (SIL OFL 1.1)
Materiais
  • lh-arrive.jpg
  • lh-beam.jpg
  • lh-biscuit.jpg
  • lh-maya.jpg
  • lh-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)

Preparo

#1 · Corte a página com uma árvore de divisão

O código é a resposta curta lá em cima. Um :::page ocupa a mancha, aqui 144 × 227 mm, e o atributo split a corta. / separa linhas, | separa colunas, cada medida é uma porcentagem da célula que ela corta, * reparte o que sobra e um colchete corta aquela célula de novo no outro eixo (dividir a página). O plano C, 30 [30 | 20 | *] / *, faz uma fileira com 30% da altura, divide essa fileira em células de 30% e 20% de largura mais o resto e deixa embaixo uma única célula alta. As sarjetas ficam a cavalo de cada linha de corte: 4 mm entre fileiras, 3 mm entre quadros da mesma fileira. As linhas ::panel preenchem as células na ordem de leitura, as linhas de cima para baixo e as colunas a partir do lado de início.

Plano C: a fileira 30 | 20 | resto, com o gato sobreposto ao terceiro quadro.

#2 · Dê a cada imagem uma área segura

script.js · linhas 182–293no código completo
// 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 imagem é desenhada uma vez e recortada para preencher a célula em que cair. A área segura é a parte que todo recorte conserva inteira (quadros e desenhos). A área segura da imagem do rádio é só o faroleiro, 24% da largura, por isso a célula de 26 mm do plano C mostra o personagem do boné às botas e deixa o rádio de fora; as células largas dos planos A e B mostram os dois. Uma célula cujo formato não comporta a área segura recebe a imagem com faixas vazias, e a composição avisa (comicPanelLetterbox). As âncoras marcam a boca e o rosto de cada personagem nas mesmas frações, de modo que os rabichos encontram quem fala em qualquer recorte.

#3 · Ponha um quadro sobre outro

A divisão do plano C cria quatro células para cinco quadros. O gato entra com inset="50 50 46 46": um quadro de 46% da largura e 46% da altura, colocado em 50%, 50% do quadro anterior, o de Maya. Um quadro sobreposto não ocupa célula, de modo que os quadros seguintes mantêm o lugar, e ele é lido logo depois do quadro que cobre.

#4 · Letreire dez edições a partir de um layout

script.js · linhas 35–44no código completo
// 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'],
});

A divisão, as imagens, os recortes e as âncoras são iguais em todos os idiomas; content.<lang>.md guarda só as palavras, com os mesmos ids de personagem (maya, tomas). A edição japonesa compõe os balões na vertical, oito caracteres por coluna, e tira o 。 final; ela é lida da direita para a esquerda, como a árabe, por isso os quadros de cada fileira se espelham, mas as imagens não. O corpo do letreiramento fica em 8 pt em todas as edições: uma fala mais longa dá um balão maior, nunca uma letra menor (letreiramento).

A receita completa

Sandbox
// ═══ 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 = 'pt'; // @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

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Incline a fileira do meio

Uma medida escrita 30~40 leva a sarjeta final daquela célula de 30% numa ponta a 40% na outra. Células inclinadas perdem os cantos arredondados.

-:::page{split="30 / 35 [* | * | *] / *"}
+:::page{split="30 / 35 [30~40 | * | *] / *"}

#Espelhe a arte nas edições da direita para a esquerda

Por padrão, as imagens mantêm a orientação. Uma HQ desenhada sem letreiros nem relógios pode seguir o sentido de leitura.

 const comics = {
+  mirrorArt: true, // as imagens se espelham numa edição da direita para a esquerda
   gutter: { horizontal: mm(4), vertical: mm(3) },

Erros comuns

  • Uma célula com um quinto da largura da página comporta umas quatro palavras por linha em 8 pt, e no plano C o rosto do faroleiro está no meio da célula dele: os dois balões sobre a tempestade são mais altos que o espaço acima ou abaixo do rosto. Ali a primeira das duas falas leva break (tomas{break}:), e assim o par pode atravessar a sarjeta até o quadro de Maya; o motor mantém o segundo balão depois do primeiro e nunca o deixa invadir a margem da página. Sem break, a composição avisa comicBalloonOverflow. Na edição em português as duas falas são curtas o bastante para ficar empilhadas abaixo do rosto, dentro da célula do faroleiro.
  • Uma área segura mais justa dá um recorte limpo em mais células, mas o que fica fora dela pode ser cortado: as botas na primeira fileira do plano A, o rádio no plano C.

Créditos

Texto
Texto original, CC BY 4.0
Imagens
  • 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
Fontes
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)
SandboxPDF