In short
The same comic page in English, Spanish, French, Japanese, Chinese and Arabic: only the words change, and Postext redraws every balloon around them.
What you'll build
One page of a comic, The Lighthouse Radio: Maya arrives at her grandfather's lighthouse as a storm comes in, the radio is dead, and the culprit is Biscuit, asleep on the cable. The split and the five watercolour pictures are fixed; what changes from one edition to the next is a script of nine lines. Each edition of this recipe sets its own language, and every edition also sets the French page beside it: English and French, Spanish and French, and so on through Japanese, Chinese and Arabic. The engine redraws each balloon around the words it holds. Japanese is lettered in vertical columns in Zen Antique. The Japanese and Arabic pages read from the right, so the three panels of the middle tier change places.
This recipe answers
- How do I re-letter a comic in another language?
- How do I letter Japanese vertically inside balloons?
The short answer
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
};
One config for every language; the locale picks face, direction and columns
Ingredients
- Features
- Re-lettering in other languagesReading direction and manga orderComic letteringSpeakers and anchorsPanel splitsPanel art and cropsComic pagesBalloon stylesSound effectsChinese, Japanese and Korean fontsArabic fontsRight-to-left textVertical textSemantic colour palettePages on a canvasPDF export
- Also uses
- Panel borders and guttersHeads by page roleFonts embedded in the PDFFigures and tables as resources
- Type
- Comic Neue, Bangers, Zen Antique, Dela Gothic One, Noto Sans SC, ZCOOL KuaiLe, Playpen Sans Arabic, Lalezar (SIL OFL 1.1)
- Assets
lh-arrive.jpglh-beam.jpglh-biscuit.jpglh-maya.jpglh-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)
Method
#1 · One config for every language
The code is the short answer above. Nothing in the config names a language but locale. With no fontFamily, the lettering takes the comic face of the document language (defaultComicFont): Comic Neue, Zen Antique, Noto Sans SC or Playpen Sans Arabic, and the sound effect the matching display face. writingMode: 'auto' turns the Japanese balloons into vertical columns; readingDirection: 'auto' reads the Japanese and Arabic pages from the right, as their languages do, so the same split="30 / 35 [* | * | *] / *" sets the radio panel on the right and the cat on the left. The speaker ids (maya, tomas) are the same in every script, and the pictures' anchors answer to them.
The size is one for the whole book. The English script has 216 letters, the Spanish 220, the French 224, the Chinese 74 characters; the longer scripts get larger balloons, never smaller type.
#2 · French rides along in every edition
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') }));
French is not one of this recipe's editions, so each edition builds two documents: its own page, then the French one from content.fr.en.md, with the same config and a locale of 'fr'. The French script uses the narrow no-break space before ! and ?, as French typesetting does.
#3 · The pictures do not change
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])],
},
};
The safe areas are narrower than the cells of this split: the middle tier holds three panels about 46 mm wide and 80 mm tall, so each square picture shows a column about 58 % of its width, while its safe area, the speaker's face and what the line is about, takes 36–42 %. The pictures are not mirrored for Japanese or Arabic (mirrorArt stays false): Maya still walks up the path from the left, and only the order of the panels follows the reading.
The whole recipe
// ═══ 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 },
],
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
#Mirror the pictures for the right-to-left editions
mirrorArt: true flips every picture when the page reads the other way from the art's drawn direction. Leave a panel with lettering or a clock in it unflipped with ::panel{mirror=false}.
readingDirection: 'auto', // the default, written out: it is what an edition flips
+ mirrorArt: true,Pitfalls
- A script line names a speaker by id, not by name: write
maya:in every language. The name a screen reader announces iscast[].name. - The French page shares the edition's pictures, so its panels' alt text is in the edition's language; give
::panel{alt="…"}incontent.fr.en.mdfor French alt text.
Credits
- Recipe
- Ignacio Ferro
- Text
- 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
- Images
- 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
- 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) · 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)
Edit this write-up ↗ (opens in a new tab)Recipe folder on GitHub ↗ (opens in a new tab)


