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

Receitas · Capítulo 11 · Quadrinhos e mangá

Uma página letreirada em seis idiomas

Página de quadrinhos com divisão e desenhos fixos, letreirada por idioma: o locale escolhe a fonte; o japonês é vertical e, como o árabe, parte da direita.

Nesta página
Gênero
Quadrinhos
Saída
Canvas · PDF
Nível
Avançado
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.34.0 · postext-pdf ≥ 1.34.0
Licença
Atualizada em 16 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 170 × 260 mm
  • 1 coluna
  • Comic Neue 10/14
  • 2 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 147 ms
  • 111 linhas de código

Em poucas palavras

A mesma página de quadrinhos em inglês, espanhol, francês, japonês, chinês e árabe: só as palavras mudam, e o Postext redesenha cada balão em volta delas.

O que você vai compor

Uma página de quadrinhos, The Lighthouse Radio: Maya chega ao farol do avô quando uma tempestade se aproxima, o rádio está mudo e o culpado é Biscuit, dormindo em cima do cabo. A divisão e os cinco desenhos em aquarela são fixos; o que muda de uma edição para outra é um roteiro de nove linhas. Cada edição desta receita compõe o próprio idioma, e toda edição compõe também a página em francês ao lado: inglês e francês, espanhol e francês, e assim por diante com o japonês, o chinês e o árabe. O motor redesenha cada balão em volta das palavras que ele contém. O japonês é letreirado em colunas verticais em Zen Antique. As páginas japonesa e árabe se leem a partir da direita, e por isso os três quadros da fileira do meio trocam de lugar.

Esta receita responde a

  • Como faço para letrear uma história em quadrinhos em outro idioma?
  • Como faço para letrear japonês na vertical dentro dos balões?

A resposta curta

script.js · linhas 33–52no código completo
const LOCALE = t({ en: 'en-gb', es: 'es', ja: 'ja', zh: 'zh-Hans', ar: 'ar' });
const comics = {
  // No fontFamily: each language is lettered in its own comic face (defaultComicFont):
  // Comic Neue, Zen Antique for Japanese, Noto Sans SC, Playpen Sans Arabic. The size is
  // one for the whole book: a longer translation grows its balloons, never shrinks its text.
  lettering: { fontSize: pt(8.5), lineHeight: 1.12, color: col('ink') },
  // writingMode 'auto' (the default): Japanese is lettered in vertical columns.
  // readingDirection 'auto': a Japanese or Arabic page reads from the right, so the
  // tier of three panels is laid out right to left from the same split. The art keeps
  // its drawn direction (mirrorArt: false).
  panel: { borderWidth: pt(1), borderColor: col('ink') },
  gutter: { horizontal: mm(4), vertical: mm(3) },
  balloonStyles: [
    { id: 'caption', fill: col('caption'), stroke: col('ink'), strokeWidth: pt(0.6) },
    { id: 'sfx', color: col('red'), halo: pt(1.4), haloColor: col('paper'), rotate: -8 },
  ],
  readingDirection: 'auto', // the default, written out: it is what an edition flips
  cast: [{ id: 'maya', name: 'Maya' }, { id: 'tomas', name: 'Tomás' }],
  runningHeads: true, // the footer prints on the comic page
};

Ingredientes

Tipografia
Comic Neue, Bangers, Zen Antique, Dela Gothic One, Noto Sans SC, ZCOOL KuaiLe, Playpen Sans Arabic, Lalezar (SIL OFL 1.1)
Materiais
  • lh-arrive.jpg
  • lh-beam.jpg
  • lh-biscuit.jpg
  • lh-maya.jpg
  • lh-radio.jpg
  • A girl in a yellow raincoat walks up a coastal path towards a red-and-white lighthouse, a fat orange cat trotting ahead; storm clouds gather over the sea. (Generated With Diffusion Models, original)
  • The old keeper, white-bearded in a navy sweater and cap, taps a valve radio in the lamp room, microphone in hand; the great lens glows beside him. (Generated With Diffusion Models, original)
  • Close-up of Maya frowning at the floor and pointing down. (Generated With Diffusion Models, original)
  • Under the desk, the fat orange cat sleeps on his back on top of the black radio cable, squashing it flat. (Generated With Diffusion Models, original)
  • Night: the lighthouse beam sweeps over a dark sea; Maya and her grandfather stand on the lantern gallery, and far out a fishing boat shows its lights. (Generated With Diffusion Models, original)

Preparo

#1 · Uma configuração para todos os idiomas

O código é a resposta curta acima. Nada na configuração indica um idioma além de locale. Sem fontFamily, o letreiramento usa a fonte de quadrinhos do idioma do documento (defaultComicFont): Comic Neue, Zen Antique, Noto Sans SC ou Playpen Sans Arabic, e a onomatopeia a fonte de display correspondente. writingMode: 'auto' transforma os balões japoneses em colunas verticais; readingDirection: 'auto' faz as páginas japonesa e árabe serem lidas a partir da direita, como as línguas, de modo que o mesmo split="30 / 35 [* | * | *] / *" põe o quadro do rádio à direita e o do gato à esquerda. Os ids dos personagens (maya, tomas) são os mesmos em todos os roteiros, e as âncoras dos desenhos respondem a eles.

O corpo é um só para o livro todo. O roteiro em inglês tem 216 letras, o espanhol 220, o francês 224 e o chinês 74 caracteres; os roteiros mais longos ganham balões maiores, nunca letra menor.

#2 · O francês vai junto em todas as edições

script.js · linhas 217–223no código completo
const build = (md, cfg) =>
  withLoadedFonts(() => buildDocument({ markdown: md, resources }, cfg),
    { ...kitFonts(FONTS), text: md });
const docs = [await build(markdown, config())];
// French is not a site language, so every edition carries its page: the same config
// with another locale.
docs.push(await build(french, { ...config(), locale: 'fr', footer: footerFor('fr', 'fr') }));

O francês não é uma das edições desta receita, por isso cada edição monta dois documentos: a própria página e depois a francesa, a partir de content.fr.en.md, com a mesma configuração e locale igual a 'fr'. O roteiro francês usa o espaço fino inseparável antes de ! e ?, como pede a tipografia francesa.

#3 · Os desenhos não mudam

script.js · linhas 123–198no código completo
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 = {
  'lh-arrive': { width: 1100, height: 733, safeArea: box([.22, .08, .4, .64]),
    alt: t({ en: 'A girl in a yellow raincoat walks up a coastal path towards a red-and-white '
        + 'lighthouse, a fat orange cat trotting ahead; storm clouds gather over the sea.',
      es: 'Una niña con chubasquero amarillo sube por un camino de costa hacia un faro '
        + 'rojo y blanco, con un gato naranja gordo trotando delante; sobre el mar se '
        + 'acumulan nubes de tormenta.',
      zh: '一个穿黄色雨衣的女孩沿着海边小路走向红白相间的灯塔,一只胖橘猫小跑在前面;海上聚起了暴风雨的乌云。',
      ar: 'فتاة بمعطف مطر أصفر تصعد دربًا ساحليًا نحو منارة حمراء وبيضاء، وأمامها قط '
        + 'برتقالي سمين يهرول، والغيوم تتجمّع فوق البحر.',
      ja: '黄色いレインコートの女の子が、赤と白の灯台へ続く海辺の小道をのぼっていく。前を太ったオレンジ色の猫が小走りし、海の上には嵐の雲が集まっている。' }),
    anchors: [
      who('maya', .29, .52, [.27, .47], [.22, .42, .12, .16]),
      who('biscuit', .4, .68, [.4, .66], [.37, .64, .07, .08]),
    ],
    avoid: [box([.51, .09, .1, .43])],
  },
  'lh-radio': { width: 1000, height: 1000, safeArea: box([.11, .36, .36, .31]),
    alt: t({ en: 'The old keeper, white-bearded in a navy sweater and cap, taps a valve radio '
        + 'in the lamp room, microphone in hand; the great lens glows beside him.',
      es: 'El viejo farero, de barba blanca, jersey azul marino y gorra, golpea una radio '
        + 'de válvulas en la sala de la lámpara con el micrófono en la mano; a su lado '
        + 'brilla la gran lente.',
      zh: '白胡子的老守塔人穿着藏青色毛衣、戴着帽子,在灯室里手握话筒敲着一台电子管收音机;巨大的透镜在他身旁发光。',
      ar: 'حارس المنارة العجوز بلحيته البيضاء وكنزته الكحلية وقبعته ينقر على مذياع قديم '
        + 'في غرفة الفانوس والميكروفون في يده، والعدسة الكبيرة تتوهّج بجانبه.',
      ja: '白いひげの老灯台守が、紺のセーターに帽子姿で、灯室でマイクを握って真空管ラジオをたたいている。そばで大きなレンズが光っている。' }),
    anchors: [
      who('tomas', .345, .52, [.38, .44], [.29, .4, .16, .18]),
    ],
    avoid: [box([0, .44, .22, .26])],
  },
  'lh-maya': { width: 1100, height: 1100, safeArea: box([.25, .27, .41, .68]),
    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.',
      zh: '玛雅的特写:她皱着眉头看着地板,手指向下指。',
      ar: 'لقطة قريبة لمايا وهي تعقد حاجبيها ناظرةً إلى الأرض وتشير إلى أسفل.',
      ja: 'マヤのアップ。眉をひそめて床を見つめ、下を指さしている。' }),
    anchors: [
      who('maya', .54, .565, [.5, .3], [.4, .33, .24, .29]),
    ],
    avoid: [box([.27, .73, .25, .22])],
  },
  'lh-biscuit': { width: 1000, height: 1000, safeArea: box([.58, .25, .42, .33]),
    alt: t({ en: 'Under the desk, the fat orange cat sleeps on his back on top of the black '
        + 'radio cable, squashing it flat.',
      es: 'Bajo la mesa, el gato naranja gordo duerme panza arriba encima del cable negro '
        + 'de la radio y lo aplasta.',
      zh: '桌子底下,胖橘猫四脚朝天地睡在收音机的黑色电线上,把电线压得扁扁的。',
      ar: 'تحت المكتب ينام القط البرتقالي السمين على ظهره فوق سلك المذياع الأسود ويسحقه.',
      ja: '机の下で、太ったオレンジ色の猫がラジオの黒いコードの上にあおむけで眠り、コードをぺしゃんこにしている。' }),
    anchors: [
      who('biscuit', .72, .355, [.73, .32], [.64, .27, .2, .18]),
    ],
    avoid: [box([.93, .28, .07, .24]), box([0, .72, .4, .1])],
  },
  'lh-beam': { width: 1200, height: 800, safeArea: box([.15, .01, .25, .3]),
    alt: t({ en: 'Night: the lighthouse beam sweeps over a dark sea; Maya and her grandfather '
        + 'stand on the lantern gallery, and far out a fishing boat shows its lights.',
      es: 'De noche, el haz del faro 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.',
      zh: '夜里,灯塔的光束扫过漆黑的海面;玛雅和外公站在灯室外的回廊上,远处一艘渔船亮着灯。',
      ar: 'ليلًا يمسح شعاع المنارة بحرًا مظلمًا، ومايا وجدّها واقفان على شرفة الفانوس، '
        + 'وفي البعيد قارب صيد بأضوائه.',
      ja: '夜。灯台の光の帯が暗い海をなでる。マヤと祖父は灯室の回廊に立ち、沖には漁船の明かりが見える。' }),
    anchors: [
      who('maya', .235, .15, null, [.21, .11, .05, .07]),
      who('tomas', .3, .145, null, [.28, .11, .04, .06]),
    ],
    avoid: [box([.79, .55, .08, .09])],
  },

};

As áreas seguras são mais estreitas que as células desta divisão: a fileira do meio tem três quadros de cerca de 46 mm de largura por 80 mm de altura, de modo que cada desenho quadrado mostra uma coluna de cerca de 58 % da largura, enquanto a área segura, o rosto do personagem e aquilo de que a fala trata, ocupa de 36 a 42 %. Os desenhos não são espelhados para o japonês nem para o árabe (mirrorArt continua false): Maya continua subindo o caminho a partir da esquerda, e só a ordem dos quadros acompanha a leitura.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 153 · One page lettered in six languages ═══════════════════
// https://postext.dev/en/cookbook/one-page-six-languages
// Code: MIT · Story: written for the recipe (CC BY 4.0) · Pictures: generated with diffusion models
// Fonts: Comic Neue, Bangers, the comic faces of each script (OFL) · Needs postext ≥ 1.34.0
// One comic page, its split and its five pictures fixed, lettered from a script per
// language: each edition sets its own page, and the French one beside it.
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: the edition: 'en' | 'es' | 'ja' | 'zh' | 'ar' (French rides along)
const RECIPE = 'one-page-six-languages';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink and paper, the lighthouse red for the sound effect
const palette = {
  ink: '#1b1d22', // borders, lettering
  red: '#c23a2b', // the purr (4.9:1 on paper)
  caption: '#f3ead2', // narration boxes, the colour of old charts
  muted: '#5d6068', // the footer
  paper: '#ffffff',
};
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: 'red (defaults)', value: { hex: palette.red, model: 'hex' } },
];
// #endregion

// #region answer: one config for every language; the locale picks face, direction and columns
const LOCALE = t({ en: 'en-gb', es: 'es', ja: 'ja', zh: 'zh-Hans', ar: 'ar' });
const comics = {
  // No fontFamily: each language is lettered in its own comic face (defaultComicFont):
  // Comic Neue, Zen Antique for Japanese, Noto Sans SC, Playpen Sans Arabic. The size is
  // one for the whole book: a longer translation grows its balloons, never shrinks its text.
  lettering: { fontSize: pt(8.5), lineHeight: 1.12, color: col('ink') },
  // writingMode 'auto' (the default): Japanese is lettered in vertical columns.
  // readingDirection 'auto': a Japanese or Arabic page reads from the right, so the
  // tier of three panels is laid out right to left from the same split. The art keeps
  // its drawn direction (mirrorArt: false).
  panel: { borderWidth: pt(1), borderColor: col('ink') },
  gutter: { horizontal: mm(4), vertical: mm(3) },
  balloonStyles: [
    { id: 'caption', fill: col('caption'), stroke: col('ink'), strokeWidth: pt(0.6) },
    { id: 'sfx', color: col('red'), halo: pt(1.4), haloColor: col('paper'), rotate: -8 },
  ],

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

#Espelhar os desenhos nas edições da direita para a esquerda

mirrorArt: true espelha cada desenho quando a página é lida no sentido contrário ao que o desenho foi feito. Deixe sem espelhar um quadro com letras ou um relógio usando ::panel{mirror=false}.

   readingDirection: 'auto', // the default, written out: it is what an edition flips
+  mirrorArt: true,

Erros comuns

  • Uma linha do roteiro indica o personagem pelo id, não pelo nome: escreva maya: em todos os idiomas. O nome que um leitor de tela anuncia é cast[].name.
  • A página francesa compartilha os desenhos da edição, por isso o texto alternativo dos quadros dela está no idioma da edição; escreva ::panel{alt="…"} em content.fr.en.md para ter o texto alternativo em francês.

Créditos

Texto
  • The lighthouse radio, a one-page comic written for this recipe in English, Spanish, French, Japanese, Chinese and Arabic · Postext Cookbook · CC BY 4.0
Imagens
  • A girl in a yellow raincoat walks up a coastal path towards a red-and-white lighthouse, a fat orange cat trotting ahead; storm clouds gather over the sea. · Generated With Diffusion Models · original
  • The old keeper, white-bearded in a navy sweater and cap, taps a valve radio in the lamp room, microphone in hand; the great lens glows beside him. · Generated With Diffusion Models · original
  • Close-up of Maya frowning at the floor and pointing down. · Generated With Diffusion Models · original
  • Under the desk, the fat orange cat sleeps on his back on top of the black radio cable, squashing it flat. · Generated With Diffusion Models · original
  • Night: the lighthouse beam sweeps over a dark sea; Maya and her grandfather stand on the lantern gallery, and far out a fishing boat shows its lights. · 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) · Noto Sans SC (SIL OFL 1.1) · ZCOOL KuaiLe (SIL OFL 1.1) · Playpen Sans Arabic (SIL OFL 1.1) · Lalezar (SIL OFL 1.1)
SandboxPDF