跳到主要内容
食谱编号153

排版食谱 · 第11章 · 漫画与连环画

用六种语言嵌字的一页漫画

分格和画面不变,每种语言一份台词:locale 决定字体,日文竖排,日文和阿拉伯文从右往左读。

本页内容
类型
漫画
输出
Canvas · PDF
难度
高级
Postext
已用Postext 1.65.0测试
需要≥ 1.34.0 · postext-pdf ≥ 1.34.0
许可证
更新于2026年10月16日
代码MIT · 文本CC BY 4.0
  • 成品尺寸170 × 260 mm
  • 1栏
  • Noto Sans SC 10/14
  • Comic Neue
  • 2页
  • 难度
  • Postext 1.65.0
  • 排版用时276 ms
  • 111行代码

简单来说

同一页漫画的英语、西班牙语、法语、日语、中文和阿拉伯语版:只换文字,Postext 围绕文字重画每个对话框。

成品一览

一页漫画《灯塔的电台》:暴风雨要来的时候,玛雅来到爷爷的灯塔,电台坏了,罪魁祸首是睡在电线上的猫饼干。分格和五幅水彩画是固定的,各个版本之间只换一份九行的台词。这份食谱的每个版本先排自己的语言,旁边再排一页法语:英语配法语、西班牙语配法语,日语、中文和阿拉伯语也一样。引擎围绕每个对话框里的文字重新画框。日文用 Zen Antique 竖排嵌字。日文和阿拉伯文页面从右往左读,所以中间一排的三格互换了位置。

这道食谱解答

  • 怎样把漫画用另一种语言重新嵌字?
  • 怎样在对话框里竖排日文?

简短回答

script.js · 第33–52行在完整代码中
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
};

用料

类型
Comic Neue, Bangers, Zen Antique, Dela Gothic One, Noto Sans SC, ZCOOL KuaiLe, Playpen Sans Arabic, Lalezar(SIL OFL 1.1)
素材
  • 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, 原创)
  • 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, 原创)
  • Close-up of Maya frowning at the floor and pointing down. (Generated With Diffusion Models, 原创)
  • 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, 原创)
  • 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, 原创)

做法

#1 · 所有语言共用一份配置

代码就是上面的简短回答。配置里只有 locale 提到语言。不设 fontFamily 时,嵌字采用文档语言的漫画字体(defaultComicFont):Comic Neue、Zen Antique、Noto Sans SC 或 Playpen Sans Arabic,拟声词也用对应的展示字体。writingMode: 'auto' 让日文对话框竖排;readingDirection: 'auto' 让日文和阿拉伯文页面照各自语言的习惯从右往左读,于是同一个 split="30 / 35 [* | * | *] / *" 把电台那一格放到右边,猫那一格放到左边。说话人的 id(maya、tomas)在每份台词里都一样,画面上的锚点就按这些 id 对应。

全书只有一个字号。英语台词 216 个字母,西班牙语 220 个,法语 224 个,中文 74 个字;台词越长,对话框越大,字却不会变小。

#2 · 每个版本都带上法语页

script.js · 第217–223行在完整代码中
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') }));

法语不是这道食谱的版本之一,所以每个版本都构建两个文档:先是自己的那一页,然后用 content.fr.en.md 排法语页,配置相同,只把 locale 设为 'fr'。法语台词在 ! 和 ? 前用窄的不换行空格,这是法语排版的规矩。

#3 · 画面不变

script.js · 第123–198行在完整代码中
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])],
  },

};

安全区比这套分格的格子更窄:中间一排三格,每格约宽 46 毫米、高 80 毫米,所以每幅方形的画露出宽度约 58% 的一条,而安全区只占 36%–42%,包住说话人的脸和台词说到的东西。日文版和阿拉伯文版都不镜像画面(mirrorArt 仍为 false):玛雅依旧从左边走上小路,只有画格的顺序跟着阅读方向变。

完整食谱

沙盒
// ═══ 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 = 'zh'; // @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 },
  ],

组合好的script.js可以直接运行:把它粘贴到任何页面的模块脚本中,或在CodePen上打开这道食谱。 GitHub上的食谱文件夹 ↗ (在新标签页中打开)

变化

#在从右往左的版本里镜像画面

mirrorArt: true 会在页面的阅读方向与画面原本的方向相反时翻转每幅画。画里有文字或时钟的格子,用 ::panel{mirror=false} 让它保持不翻。

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

常见问题

  • 台词每一行用 id 指定说话人,而不是名字:每种语言都写 maya:。读屏软件念出的名字来自 cast[].name。
  • 法文页和本版共用画面,所以它各格的替代文字是本版的语言;想用法文,就在 content.fr.en.md 里写 ::panel{alt="…"}。

致谢

文本
  • 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
图片
  • 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 · 原创
  • 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 · 原创
  • Close-up of Maya frowning at the floor and pointing down. · Generated With Diffusion Models · 原创
  • 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 · 原创
  • 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 · 原创
字体
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)
沙盒PDF