Em poucas palavras
Uma página de luta de um quadrinho japonês, com os espaços entre os quadros inclinados para a ação parecer avançar, e o grande som japonês do golpe mantido no lugar com uma pequena tradução ao lado.
O que você vai compor
A página em que se decide a final de kendô, do mesmo mangá da receita da direita para a esquerda, em duas edições lado a lado: o original japonês e o letreiramento no idioma desta página (em inglês na página japonesa). Quatro fileiras: o ginásio, os olhos de Hana pela grade do capacete, a troca de golpes e as reações. A terceira fileira é cortada por uma sarjeta inclinada, e assim o ataque do adversário e o contragolpe de Hana parecem se lançar um contra o outro; a quarta se inclina para o outro lado e desacelera a página. O golpe de Hana não tem borda nenhuma, e a onomatopeia dele, ドン, é composta numa gótica japonesa bem pesada que todas as edições mantêm, com uma pequena tradução embaixo nas páginas traduzidas.
Esta receita responde a
- Como faço para inclinar as sarjetas entre os quadros?
- Como faço para letrear onomatopeias sobre a arte?
A resposta curta
// The page is split in content.<lang>.md: `* [40~55 | *]` runs the gutter of the third
// tier from 40 % at the top to 55 % at the bottom, so both panels lean into the strike,
// and `24 [58~64 | *]` tilts the last tier the other way. The panel that lands the blow
// is drawn with `border=none`: no frame, so its speed lines run straight to the gutter.
// ドン keeps its Japanese face in every edition (`font=` on the line);
// the translations add a small subtitle under it, the way licensed manga gloss a drawn
// sound effect instead of redrawing it.
const comics = (lang) => ({
artDirection: 'rtl', // drawn for right-to-left reading: slants and order mirror with it
mirrorArt: false,
gutter: { horizontal: mm(4), vertical: mm(2.5) }, // a slanted gutter keeps its width
panel: { borderWidth: pt(1.1), borderColor: col('ink'), background: col('paper') },
lettering: {
fontFamily: EDITIONS[lang].faces[0], color: col('ink'),
fontSize: pt(['ja', 'zh'].includes(lang) ? 8.5 : 7.5),
writingMode: lang === 'zh' ? 'vertical' : 'auto',
},
balloonStyles: balloons(),
});
Ingredientes
- Funcionalidades
- Divisão em quadrosOnomatopeiasSentido de leitura e ordem do mangáFontes chinesas, japonesas e coreanasArte e enquadramento do quadroBordas e sarjetas dos quadrosLetreiramento em outros idiomasPersonagens e âncorasPáginas de quadrinhosLetreiramento de quadrinhosEstilos de balãoTexto verticalLivros encadernados pela direitaPaleta de cores semânticaPáginas em um canvasExportação para PDF
- Também usa
- Quebra de linha em chinêsCor do papelFontes incorporadas ao PDFFiguras e tabelas como recursosSobrescritos e subscritos
- Tipografia
- Zen Antique, Dela Gothic One, Comic Neue, Bangers, Noto Sans SC, ZCOOL KuaiLe, Playpen Sans Arabic, Lalezar (SIL OFL 1.1)
- Materiais
match-coach.jpgmatch-eyes.jpgmatch-final.jpgmatch-lunge.jpgmatch-stands.jpgmatch-strike.jpg- The kendo final in a packed gym, two fighters between three referees (Generated With Diffusion Models, original)
- Hana's eyes through her helmet grille (Generated With Diffusion Models, original)
- The opponent lunging with speed lines (Generated With Diffusion Models, original)
- Hana's leaping strike to the helmet (Generated With Diffusion Models, original)
- Sora cheering in the stands (Generated With Diffusion Models, original)
- Coach Mori nodding while the referees raise their flags (Generated With Diffusion Models, original)
Preparo
#1 · Inclinar a sarjeta na divisão
O código é a resposta curta acima. Um tamanho escrito 40~55 dá duas posições à borda distante de uma célula: 40 % da fileira em cima e 55 % embaixo. As células continuam sendo polígonos convexos, a sarjeta mantém a largura medida na perpendicular à inclinação e, com a leitura da direita para a esquerda, a inclinação se espelha junto com a ordem, de modo que a primeira célula continua sendo a da direita. A divisão da página é 24 / 18 / * [40~55 | *] / 24 [58~64 | *]: duas fileiras retas para preparar o momento, uma inclinada para o golpe e uma última inclinada para o outro lado (divisão da página).
#2 · Gritar com explosões e deixar as onomatopeias escaparem
const balloons = () => [
{ id: 'speech', fill: col('paper'), stroke: col('ink'), strokeWidth: pt(0.6), roundness: 2 },
{ id: 'shout', fill: col('paper'), stroke: col('ink'), burstPoints: 18, burstDepth: 0.3 },
{ id: 'thought', fill: col('paper'), stroke: col('ink') },
{ id: 'inner', fill: col('tone'), stroke: col('tone'), strokeWidth: pt(0), italic: false },
{ id: 'caption', fill: col('paper'), stroke: col('ink'), strokeWidth: pt(0.5) },
// white-edged on the art
{ id: 'sfx', color: col('ink'), haloColor: col('paper'), halo: pt(2.2) },
];
Os kiai dos dois lutadores são gritos: uma explosão de 18 pontas, mais fundas que as do padrão. As onomatopeias não têm balão nenhum; são letreiradas sobre o desenho com um contorno branco de 2,2 pt, para serem lidas por cima das linhas de movimento. O quadro do golpe é escrito ::panel{art=strike border=none}, e o ドン leva break, por isso pode atravessar a sarjeta inclinada até o quadro vizinho, como um letrista deixa um som transbordar da borda do quadro (onomatopeias).
#3 · Manter ドン em japonês e legendá-lo
const SFX = /^sfx(\{[^}\n]*\})?[ \t]*[::](.*)$/gm; // sound effects: the second face sets them
async function loadEdition(lang) {
const text = TEXT[lang];
const [face, sfx] = EDITIONS[lang].faces;
const faces = { [face]: FONTS[face], [sfx]: FONTS[sfx] };
const effects = [...text.matchAll(SFX)];
for (const [, attrs = '', words] of effects) { // ドン keeps its face in every language
const family = /font="([^"]+)"/.exec(attrs)?.[1];
if (!family) continue;
faces[family] = FONTS[family];
await loadCjkFonts({ [family]: FONTS[family] }, words, { vertical: true });
}
if (['ja', 'zh'].includes(lang)) { // CJK: only the files that hold these characters
const own = effects.filter(([, attrs = '']) => !attrs.includes('font=')).map((m) => m[2]);
await loadCjkFonts({ [face]: FONTS[face] }, text.replace(SFX, ''), { vertical: true });
await loadCjkFonts({ [sfx]: FONTS[sfx] }, own.join(''), { vertical: true });
}
if (lang === 'ar') await loadArabicFonts(faces, text);
await loadComicFonts(faces, text); // the bold and italic the faces do not ship
}
No mangá, as onomatopeias fazem parte do desenho, e as edições licenciadas costumam deixá-las no lugar e acrescentar uma pequena tradução ao lado. O roteiro faz o mesmo: todas as edições têm a linha sfx{… font="Dela Gothic One" break}: ドン; as edições letreiradas em linhas horizontais acrescentam vertical a ela, para que ドン mantenha a coluna que tem no original, e põem embaixo uma segunda onomatopeia, menor, como PÁ! ou WHAM. Como a fonte é indicada na linha, cada edição carrega a Dela Gothic One só com os caracteres de ドン, seja qual for a fonte de letreiramento dela.
#4 · Ajustar as áreas seguras às células inclinadas
const ART = { // fractions of the picture: the same in every language
final: {
alt: t({ en: 'The kendo final in a packed gym: two fighters cross swords among three referees.',
es: 'La final en un pabellón lleno: dos rivales cruzan las espadas entre tres árbitros.',
ca: 'La final en un pavelló ple: dos rivals creuen les espases entre tres àrbitres.',
fr: 'La finale dans un gymnase comble : deux combattants croisent le sabre entre trois '
+ 'arbitres.',
de: 'Das Kendo-Finale in einer vollen Halle: Zwei Kämpfer kreuzen zwischen drei '
+ 'Kampfrichtern die Schwerter.',
it: 'La finale in una palestra gremita: due atleti incrociano le spade tra tre '
+ 'arbitri.',
pt: 'A final num ginásio lotado: dois lutadores cruzam as espadas entre três árbitros.',
zh: '座无虚席的体育馆里的决赛:两名选手在三名裁判之间交剑。',
ar: 'النهائي في صالة ممتلئة: متباريان يتقاطع سيفاهما بين ثلاثة حكّام.',
ja: '満員の体育館での決勝。3人の審判の間で2人が剣先を交える。' }),
safeArea: { x: 0.22, y: 0.44, width: 0.56, height: 0.46 },
anchors: [{ id: 'hana', x: 0.31, y: 0.51, head: { x: 0.31, y: 0.49 },
face: { x: 0.28, y: 0.45, width: 0.07, height: 0.1 } },
{ id: 'rival', x: 0.68, y: 0.51, head: { x: 0.68, y: 0.49 },
face: { x: 0.65, y: 0.46, width: 0.06, height: 0.09 } },
{ id: 'shinpan', x: 0.575, y: 0.585, head: { x: 0.575, y: 0.56 },
face: { x: 0.56, y: 0.54, width: 0.03, height: 0.06 } }] },
eyes: {
alt: t({ en: "Hana's eyes through the bars of her helmet grille.",
es: 'Los ojos de Hana tras las barras de la rejilla del casco.',
ca: 'Els ulls de la Hana darrere les barres de la reixa del casc.',
fr: 'Les yeux de Hana derrière les barreaux de la grille de son casque.',
de: 'Hanas Augen hinter den Gitterstäben ihres Helms.',
it: 'Gli occhi di Hana dietro le sbarre della grata dell’elmo.',
pt: 'Os olhos de Hana atrás das barras da grade do capacete.',
zh: '面罩铁栏后花的眼睛。',
ar: 'عينا هانا خلف قضبان شبكة الخوذة.',
ja: '面金の向こうの花の目。' }),
safeArea: { x: 0.22, y: 0.26, width: 0.57, height: 0.38 },
anchors: [{ id: 'hana', x: 0.5, y: 0.62, head: { x: 0.5, y: 0.4 },
face: { x: 0.2, y: 0.3, width: 0.6, height: 0.3 } }] },
lunge: {
alt: t({ en: 'The opponent lunges at the viewer, speed lines all round.',
es: 'El rival se lanza hacia el lector entre líneas cinéticas.',
ca: 'El rival es llança cap al lector entre línies cinètiques.',
fr: 'L’adversaire se jette vers le lecteur, entouré de lignes de vitesse.',
de: 'Der Gegner stürzt auf den Betrachter zu, ringsum Bewegungslinien.',
it: 'L’avversario si lancia verso chi guarda, tra linee cinetiche.',
pt: 'O adversário avança contra o leitor entre linhas de velocidade.',
zh: '对手在速度线中朝读者猛刺过来。',
ar: 'الخصم يندفع نحو القارئ وسط خطوط السرعة.',
ja: '集中線の中、こちらへ突いてくる相手。' }),
safeArea: { x: 0.03, y: 0.01, width: 0.8, height: 0.61 },
avoid: [{ x: 0.02, y: 0.42, width: 0.23, height: 0.18 }],
anchors: [{ id: 'rival', x: 0.7, y: 0.2, head: { x: 0.7, y: 0.14 },
face: { x: 0.63, y: 0.02, width: 0.15, height: 0.24 } }] },
strike: {
alt: t({ en: "Hana leaps and strikes the top of the opponent's helmet; the sword bends.",
es: 'Hana salta y golpea la parte alta del casco del rival; la espada se dobla.',
ca: 'La Hana salta i colpeja la part alta del casc del rival; l’espasa es doblega.',
fr: 'Hana bondit et frappe le sommet du casque adverse ; le sabre plie.',
de: 'Hana springt und trifft den Gegner oben auf den Helm; das Schwert biegt sich.',
it: 'Hana salta e colpisce la sommità dell’elmo avversario; la spada si piega.',
pt: 'Hana salta e acerta o alto do capacete do adversário; a espada se curva.',
zh: '花跃起击中对手面罩顶部,竹剑弯了起来。',
ar: 'هانا تقفز وتضرب أعلى خوذة الخصم؛ ينثني السيف.',
ja: '跳び込んで相手の面を打つ花。竹刀がしなる。' }),
safeArea: { x: 0.36, y: 0.06, width: 0.42, height: 0.77 },
avoid: [{ x: 0.52, y: 0.48, width: 0.13, height: 0.16 }],
anchors: [{ id: 'hana', x: 0.43, y: 0.25, head: { x: 0.43, y: 0.18 },
face: { x: 0.38, y: 0.07, width: 0.1, height: 0.25 } }, { id: 'sfx', x: 0.75, y: 0.25 }] },
stands: {
alt: t({ en: 'Sora jumps up in the stands, fists raised, shouting.',
es: 'Sora salta en la grada con los puños en alto, gritando.',
ca: 'En Sora salta a la graderia amb els punys enlaire, cridant.',
fr: 'Sora bondit dans les gradins, poings levés, en criant.',
de: 'Sora springt auf der Tribüne auf, die Fäuste erhoben, und schreit.',
it: 'Sora salta sugli spalti con i pugni alzati, gridando.',
pt: 'Sora pula na arquibancada de punhos erguidos, gritando.',
zh: '空在看台上跳起来,举着拳头大喊。',
ar: 'سورا يقفز في المدرّجات رافعًا قبضتيه وهو يصيح.',
ja: '観客席で拳を突き上げて叫ぶ空。' }),
safeArea: { x: 0.08, y: 0.07, width: 0.69, height: 0.44 },
avoid: [{ x: 0.08, y: 0.06, width: 0.12, height: 0.1 },
{ x: 0.64, y: 0.35, width: 0.1, height: 0.12 }],
anchors: [{ id: 'sora', x: 0.51, y: 0.44, head: { x: 0.5, y: 0.37 },
face: { x: 0.4, y: 0.3, width: 0.22, height: 0.2 } }] },
coach: {
alt: t({ en: 'Mori, arms crossed and eyes closed; behind him the referees raise their flags.',
es: 'Mori, de brazos cruzados y ojos cerrados; detrás, los árbitros alzan las banderas.',
ca: 'En Mori, de braços plegats i ulls tancats; darrere, els àrbitres alcen les banderes.',
fr: 'Mori, bras croisés et yeux fermés ; derrière lui, les arbitres lèvent leurs '
+ 'drapeaux.',
de: 'Mori, Arme verschränkt, Augen geschlossen; hinter ihm heben die Kampfrichter '
+ 'die Fahnen.',
it: 'Mori, braccia conserte e occhi chiusi; dietro di lui gli arbitri alzano le '
+ 'bandiere.',
pt: 'Mori, de braços cruzados e olhos fechados; atrás, os árbitros erguem as bandeiras.',
zh: '森老师抱着双臂、闭着眼;身后的裁判举起了旗子。',
ar: 'موري عاقد الذراعين مغمض العينين، وخلفه يرفع الحكّام راياتهم.',
ja: '腕を組み目を閉じる森先生。後ろで審判が旗を上げる。' }),
safeArea: { x: 0.16, y: 0.1, width: 0.76, height: 0.53 },
avoid: [{ x: 0.55, y: 0.18, width: 0.4, height: 0.17 }, // the referees' flags
{ x: 0.22, y: 0.47, width: 0.25, height: 0.21 }], // Mori’s folded arms: his pose
anchors: [{ id: 'mori', x: 0.29, y: 0.31, head: { x: 0.29, y: 0.2 },
face: { x: 0.22, y: 0.1, width: 0.14, height: 0.24 } }] },
};
const panels = () => Promise.all([
comicPanel('final', asset('match-final.jpg'), ART.final),
comicPanel('eyes', asset('match-eyes.jpg'), ART.eyes),
comicPanel('lunge', asset('match-lunge.jpg'), ART.lunge),
comicPanel('strike', asset('match-strike.jpg'), ART.strike),
comicPanel('coach', asset('match-coach.jpg'), ART.coach),
comicPanel('stands', asset('match-stands.jpg'), ART.stands),
]);
Uma célula inclinada é mais larga numa ponta que na outra, e a imagem tem de cobri-la inteira. Cada área segura é cortada no que o quadro precisa, os olhos no close da grade e o busto de Sora na comemoração, para que caiba no recorte mais largo da célula e o motor nunca precise deixar faixas vazias em volta da imagem.
#5 · Pôr o original ao lado de cada edição
const FACING = LANG === 'ja' ? 'en' : LANG; // Japanese readers see the English edition
const TEXT = { ja: original, [FACING]: LANG === 'ja' ? english : markdown };
await loadFonts(FONTS, Object.values(TEXT).join('\n'));
const resources = await panels();
const build = async (lang) => { // the same pictures and page; this language's lettering
await loadEdition(lang);
return withLoadedFonts(() => buildDocument({ markdown: TEXT[lang], resources,
continuation: { pageIndexOffset: lang === 'ja' ? 1 : 2 } }, edition(lang)),
{ ...kitFonts(FONTS), text: TEXT[lang] });
};
const docs = [await build('ja'), await build(FACING)];
Cada idioma do site letreira a página no próprio arquivo, e o original japonês fica de frente para ela, do outro lado da página dupla (a página japonesa faz par com a edição inglesa). ドン fica em todas as edições, cada uma traz a legenda (PÁ!, WHAM, ZAS!, PAF !, WUMM, SDENG!, 咚, بوم!), e as inclinações nunca mudam.
A receita completa
// ═══ Postext Cookbook · Nº 150 · An action page with slanted gutters ═════════════════
// https://postext.dev/en/cookbook/manga-action-slants
// Code: MIT · Story: written for the recipe (CC BY 4.0) · Pictures: generated with diffusion models
// Fonts: Zen Antique, Comic Neue and six more (SIL OFL 1.1) · Needs postext ≥ 1.65.0
// The last page of a kendo final: slanted panels, a borderless strike, ドン kept in every edition.
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'pt'; // @lang: this edition's language; the Japanese original faces it
const RECIPE = 'manga-action-slants';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black ink on a warm white, one screen-tone grey
const palette = {
ink: '#151413', // panel borders, balloon outlines, the lettering
paper: '#fdfcf9', // the page and the balloons
tone: '#e8e6e1', // the inner-voice box, a light screen tone
muted: '#6f6b64',
accent: '#a8322b', // the cover red (the Folio case in recipe.json)
};
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: 'ink (defaults)', value: { hex: palette.ink, model: 'hex' } },
];
// #endregion
// The engine's lettering and sound-effect faces per language (defaultComicFont and
// defaultComicSfxFont), written out so FONTS and the PDF know them.
const EDITIONS = {
ja: { locale: 'ja', faces: ['Zen Antique', 'Dela Gothic One'] },
en: { locale: 'en-us', faces: ['Comic Neue', 'Bangers'] },
es: { locale: 'es', faces: ['Comic Neue', 'Bangers'] },
ca: { locale: 'ca', faces: ['Comic Neue', 'Bangers'] },
pt: { locale: 'pt-BR', faces: ['Comic Neue', 'Bangers'] },
fr: { locale: 'fr', faces: ['Comic Neue', 'Bangers'] },
de: { locale: 'de', faces: ['Comic Neue', 'Bangers'] },
it: { locale: 'it', faces: ['Comic Neue', 'Bangers'] },
zh: { locale: 'zh-Hans', faces: ['Noto Sans SC', 'ZCOOL KuaiLe'] },
ar: { locale: 'ar', faces: ['Playpen Sans Arabic', 'Lalezar'] },
};
// #region answer: the slant is in the split; the impact is in the panel and the effect
// The page is split in content.<lang>.md: `* [40~55 | *]` runs the gutter of the third
// tier from 40 % at the top to 55 % at the bottom, so both panels lean into the strike,
// and `24 [58~64 | *]` tilts the last tier the other way. The panel that lands the blow
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)
Erros comuns
Erro comum
Marque um texto japonês como 'ja', nunca com zh-Hans nem LANG
As edições de uma receita são en e es, mas uma amostra japonesa é japonesa nas duas: `locale: LANG` a marcaria como inglês ou espanhol, e uma marcação chinesa a comporia pelas regras chinesas (pontuação Kaiming, kana pequeno livre para começar linha, 图 no lugar de 図, formas chinesas dos glifos no PDF). Desde o postext 1.30 a marcação é também o idioma em que o texto é composto (em que é medido, pintado e incorporado), então qualquer marcação que não seja 'ja' dá outras formas de glifo que não as japonesas (as chinesas, sob uma marcação chinesa) e outras quebras de linha. Escreva 'ja': isso escolhe a região do Japão (quebra de linha e pontuação da JLReq, pontos de ênfase em gergelim, espaçamento dos furigana, rótulos 図 e 表) e desativa a hifenização. O lint reprova um texto com kana sob uma marcação zh ou ko. Quebra de linha em japonês (kinsoku) →
Erro comum
Fontes chinesas são carregadas em fatias, pelo bloco cjk
O Fontsource serve uma família chinesa, japonesa ou coreana em cerca de cem arquivos por peso, cada um com um intervalo de caracteres. loadFonts baixa só o arquivo latin, então na tela os caracteres chineses vêm de uma fonte do sistema e são medidos errado, e o fontsourceProvider entrega ao PDF esse arquivo latin, que os imprime como caixas vazias. Inclua o bloco cjk do kit, chame loadCjkFonts(FONTS, markdown) depois de loadFonts (uma vez por voz, com o texto que ela compõe, quando o livro usa várias fontes CJK) e passe a renderToPdf fontProvider: cjkPdfProvider: os dois pegam os arquivos que contêm os caracteres do texto. Fontes chinesas, japonesas e coreanas →
- Uma onomatopeia mantida em japonês numa edição letreirada em linhas horizontais é composta na horizontal, como o resto da edição, a não ser que a linha dela diga
vertical. - A comemoração de Sora é mais longa que o quadro pequeno dele em japonês, espanhol e catalão: deixada ao motor, ela atravessava a borda e a construção avisava
comicBalloonOverflow. Essas edições a marcam combreak(sora{shout break}): ela rompe a borda do quadro para cima, até a sarjeta e o quadro de cima, de propósito, e nada é informado. Um balão combreaknunca invade a margem da página, a não ser que o quadro dele tenha sangria; um ponto fixo (at=) o coloca em qualquer outro lugar.
Créditos
- Receita
- Ignacio Ferro
- Texto
- 決勝 (The Final), a one-page kendo manga written for this recipe, with its English, Spanish, Catalan, Chinese and Arabic letterings · Postext Cookbook · CC BY 4.0
- Imagens
- The kendo final in a packed gym, two fighters between three referees · Generated With Diffusion Models · original
- Hana's eyes through her helmet grille · Generated With Diffusion Models · original
- The opponent lunging with speed lines · Generated With Diffusion Models · original
- Hana's leaping strike to the helmet · Generated With Diffusion Models · original
- Sora cheering in the stands · Generated With Diffusion Models · original
- Coach Mori nodding while the referees raise their flags · Generated With Diffusion Models · original
- Fontes
- Zen Antique (SIL OFL 1.1) · Dela Gothic One (SIL OFL 1.1) · Comic Neue (SIL OFL 1.1) · Bangers (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)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


