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

Receitas · Capítulo 2 · Tipo e texto

Um livro ilustrado em hiragana, espaçado por frase

Um livro ilustrado vertical em hiragana com um espaço entre as frases (wakachigaki): keep-all mantém cada frase inteira, e as linhas só quebram nos espaços.

Nesta página
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
  • Amostra em inglês: ainda sem edição em português
  • Refile 260 × 200 mm
  • Coluna e meia, medianiz de 14,1 mm
  • Klee One 20/36
  • Zen Maru Gothic
  • 10 páginas
  • Nível
  • Postext 1.57.1
  • Diagramado em 46 ms
  • 136 linhas de código

Em poucas palavras

Um livro ilustrado japonês para crianças pequenas, todo em hiragana, com um espaço depois de cada grupo de palavras e linhas que nunca o partem, sob uma imagem em cada página.

O que você vai compor

Um livro ilustrado de dez páginas, かみの ふね (O barco de papel), escrito para a receita e ilustrado com dez pinturas: depois da chuva, uma menina dobra um barco de papel vermelho, e o barco desce o rio, passa por um sapo, uma garça e a lua e chega ao mar. Ele é composto como se compõem os livros japoneses para os leitores mais novos: só hiragana, a 20 pt em Klee One, uma letra feita a partir do modelo dos livros didáticos escolares, e um espaço entre as frases, 分かち書き (wakachigaki), para que a criança leia uma frase de cada vez. As páginas são em paisagem, 260 × 200 mm, verticais e encadernadas pela direita: a imagem ocupa o alto da página, embaixo vêm linhas curtas de oito caracteres, e o barco segue para a esquerda à medida que as páginas viram.

Esta receita responde a

  • Como espaço por frases um livro ilustrado japonês (wakachigaki), com linhas que só quebram nos espaços?
  • Por que kana pequenos, ー e sinais de fechamento não podem começar uma linha em japonês, e como escolho o rigor da regra?
  • Quais fontes compõem japonês, com os kanji nas formas japonesas, na tela e no PDF?

A resposta curta

script.js · linhas 40–50no código completo
// The story is typed with an ordinary space (U+0020) after each phrase (文節). Japanese
// text may break between any two kana, so the space alone does not keep a phrase whole:
// keep-all drops the breaks between two letters and keeps those at a space, after 、。」
// and before 「. Kinsoku still applies.
const phrases = { wordBreak: 'keep-all' }; // cjk.wordBreak
const bodyText = {
  fontFamily: HAND, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  // Ragged: a justified line would stretch its spaces and its kana to fill the tier.
  textAlign: 'left', firstLineIndent: em(0),
};

Ingredientes

Tipografia
Klee One, Zen Maru Gothic (SIL OFL 1.1)
Materiais
  • bridge-1400.jpg
  • cover-1430.jpg
  • dusk-1400.jpg
  • frog-1400.jpg
  • heron-1400.jpg
  • night-1400.jpg
  • rain-1400.jpg
  • sea-1400.jpg
  • stream-1400.jpg
  • window-1400.jpg
  • The cover: a red paper boat on a river through green meadows, a clear sky on the right for the title (Generated With Diffusion Models, original)
  • Mii-chan folding the red paper boat at a low table by the window, after the rain (Generated With Diffusion Models, original)
  • Mii-chan waving goodbye to the boat on the stream (Generated With Diffusion Models, original)
  • A frog on a stone talking to the boat (Generated With Diffusion Models, original)
  • The boat under a wooden footbridge, little fish following it (Generated With Diffusion Models, original)
  • A white heron on the bank watching the boat on the wide river (Generated With Diffusion Models, original)
  • Dusk: a pink sky over the river mouth and the sea beyond (Generated With Diffusion Models, original)
  • Night: the full moon's reflection lighting the boat's way (Generated With Diffusion Models, original)
  • The boat at sea, greeted by seagulls (Generated With Diffusion Models, original)
  • Mii-chan at her window, looking towards the distant sea (Generated With Diffusion Models, original)

Preparo

#1 · Mantenha cada frase inteira

O código está na resposta curta, mais acima. O texto japonês pode quebrar entre dois kana quaisquer, por isso um espaço entre frases só acrescenta respiro; sozinho, não impede que uma linha termine dentro de あか|い. cjk.wordBreak: 'keep-all' mantém apenas as quebras num espaço e junto da pontuação, depois de 、。」 ou antes de 「, como faz o word-break: keep-all do CSS, e as regras de kinsoku continuam valendo (Tipografia do Leste Asiático). O espaço é um U+0020 comum, de 0,35 em na Klee One, e a linha o descarta quando ele cai no fim. Um U+3000 também separa frases, mas é um caractere fixo de um eme de largura, que fica no fim da linha.

Página 3: oito linhas, cada uma terminando num espaço ou depois de 」 e 、: 「いって / らっしゃい。」 / みいちゃんが / そっと てを…

O texto é alinhado sem justificação. Justificada, uma linha curta esticaria os espaços e os intervalos entre os kana para chegar ao pé da faixa; um livro ilustrado deixa cada linha onde a última frase termina.

#2 · Ponha as imagens numa faixa acima do texto

script.js · linhas 54–62no código completo
// In vertical text 'left' is the top of the page: the side column is a tier that takes
// the pictures (floats), and the text runs in the tier under it, right to left.
const layout = {
  layoutType: 'oneAndHalf', writingMode: 'vertical-rl', sideColumnRole: 'floats',
  sideColumnSide: 'left', sideColumnPercent: 58, gutterWidth: pt(2 * BODY),
};
const cjk = { ...phrases, grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES } };
const resourceTypes = [{ id: 'picture', name: 'え', shortLabel: 'え', numberingTemplate: '{n}',
  resetOn: 'never', counterFormat: 'decimal', captionPrefix: '' }]; // pictures, no captions

No texto vertical, 'left' é o alto da página, de modo que uma diagramação de coluna e meia com a coluna lateral à esquerda vira duas faixas: as imagens flutuam na de cima (14 caracteres de altura) e o texto corre na de baixo (8 caracteres). Cada página cita a imagem com ::resource{id="…"} e termina com :::pagebreak. O tipo de recurso das imagens não tem prefixo de legenda, e as imagens são 2,186 vezes mais largas do que altas, o formato da faixa, por isso cada uma a preenche (escrita vertical).

#3 · Faça da capa uma imagem de página inteira

script.js · linhas 66–83no código completo
// In the flow frame of a vertical page x runs down the sheet and y leftward from its right
// edge; a box's width runs down the sheet.
const at = (down, across) => ({ anchor: { to: 'page', edge: 'top-left' },
  offset: { x: mm(down), y: mm(across) } });
const cover = {
  id: 'cover', numbered: false, toc: false, span: 'page', header: { elements: [] },
  breakBefore: { enabled: true, parity: 'any' },
  advancedDesign: { enabled: true, minHeight: mm(TRIM.w - 40), slot: { elements: [
    { kind: 'image', id: 'art', resourceId: 'cover', decorative: true,
      placement: { anchor: { to: 'bleed', edge: 'top-left' },
        size: { width: mm(TRIM.h), height: mm(TRIM.w) } } },
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: ROUND, fontWeight: 700,
      fontSize: pt(60), lineHeight: 1, letterSpacing: pt(6), color: col('boat'),
      placement: at(22, 34) },
    { kind: 'text', id: 'latin', content: '{attr.latin}', fontFamily: ROUND, fontWeight: 700,
      fontSize: pt(9), lineHeight: 1.4, color: col('ink'), placement: at(22, 62) },
  ] } },
};

A capa é um design de título na largura da página: a imagem é ancorada à sangria com o tamanho da própria página (no fluxo vertical, o width desce pela folha), e o título é composto descendo pelo céu, à direita, em Zen Maru Gothic de 60 pt.

#4 · Carregue as pinturas como bitmaps

script.js · linhas 188–203no código completo
// The scenes have the tier's shape, 612 : 280 (ART); the cover has the page's, 260 : 200.
const PICTURES = { // id: [file, width, height, alt text in the book's language]
  cover: ['cover-1430.jpg', 1430, 1100, 'あおい かわに あかい かみの ふねが うかんで いる。'],
  rain: ['rain-1400.jpg', 1400, 641, 'まどべの ちゃぶだいで、みいちゃんが あかい かみで ふねを おって いる。'],
  stream: ['stream-1400.jpg', 1400, 641, 'みいちゃんが おがわに ふねを ながし、てを ふって いる。'],
  frog: ['frog-1400.jpg', 1400, 641, 'かわの いしの うえの かえるが、ながれて いく ふねに はなしかけて いる。'],
  bridge: ['bridge-1400.jpg', 1400, 641, 'きの はしの したを ふねが くぐり、ちいさな さかなが ついて くる。'],
  heron: ['heron-1400.jpg', 1400, 641, 'ひろい かわの きしで、しろい さぎが ふねを みおくって いる。'],
  dusk: ['dusk-1400.jpg', 1400, 641, 'ももいろの ゆうやけの かわに ふねが うかび、とおくに うみが みえる。'],
  night: ['night-1400.jpg', 1400, 641, 'まんげつが かわに うつり、ひかりの みちの そばを ふねが すすむ。'],
  sea: ['sea-1400.jpg', 1400, 641, 'あおい うみに でた ふねの うえを、かもめが とんで いる。'],
  window: ['window-1400.jpg', 1400, 641, 'みいちゃんが まどから、まちの むこうの うみを みて いる。'],
};
const pictures = Object.entries(PICTURES).map(([id, [fileId, w, h, altText]]) => ({
  id, typeId: 'picture', kind: 'bitmap', createdAt: 0, updatedAt: 0, altText,
  placement: { span: 'side' }, bitmap: { fileId, format: 'jpeg', width: w, height: h } }));

As dez imagens são pinturas, arquivos JPEG em assets/ da receita. As nove cenas são cortadas no formato da faixa, 612 : 280, e a capa no da página, 260 : 200, por isso cada uma preenche o quadro e nada é cortado. Cada uma é um recurso bitmap declarado com o tamanho em pixels, com texto alternativo no idioma do livro, e o arquivo é carregado com o fileId do recurso antes da composição. Com 1.400 px de largura, as cenas saem impressas a cerca de 165 dpi ao longo da faixa (tipos de recurso).

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 127 · A hiragana picture book, spaced by phrase ══════════
// https://postext.dev/en/cookbook/hiragana-picture-book
// Code: MIT · Story: written for the recipe (CC BY 4.0) · Pictures: generated with diffusion models
// Fonts: Klee One, Zen Maru Gothic (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A picture book for small readers: hiragana only, a space between phrases, vertical.
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'en'; // @lang: the language of the frame; the story is Japanese in both editions
const RECIPE = 'hiragana-picture-book';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the paper boat's red, river blues, a warm paper
const palette = {
  ink: '#2e2a26', // the text: a soft near-black
  boat: '#cf4430', // the boat, the title (4.6:1 on the paper)
  river: '#5d93ad',
  grass: '#86b665',
  muted: '#6e675f', // the colophon
  paper: '#fbf6ea',
};
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: 'boat (defaults)', value: { hex: palette.boat, model: 'hex' } },
];
// #endregion

const HAND = 'Klee One'; // 教科書体: the hand a child learns to write kana from
const ROUND = 'Zen Maru Gothic'; // the cover's title
const [BODY, LEAD] = [20, 36]; // pt: large kana, a line gap of 0.8 em
const PT = 25.4 / 72; // mm in a point
const TRIM = { w: 260, h: 200 }; // mm: a landscape picture book (横長)
const [CHARS, PICTURE, LINES] = [8, 14, 17]; // characters: text tier, picture tier; lines
const ART = { w: LINES * LEAD * PT, h: PICTURE * BODY * PT }; // mm: 215.9 × 98.8

// #region answer: わかち書き — a space between phrases, and lines that break only there
// The story is typed with an ordinary space (U+0020) after each phrase (文節). Japanese
// text may break between any two kana, so the space alone does not keep a phrase whole:
// keep-all drops the breaks between two letters and keeps those at a space, after 、。」
// and before 「. Kinsoku still applies.
const phrases = { wordBreak: 'keep-all' }; // cjk.wordBreak
const bodyText = {
  fontFamily: HAND, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  // Ragged: a justified line would stretch its spaces and its kana to fill the tier.

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

#Justifique as linhas

Justificada, cada linha chega ao pé da faixa: primeiro se esticam os espaços entre as frases, até meio eme, e depois os intervalos entre os kana (JLReq §3.8). Uma linha curta de kana de 20 pt mostra então intervalos largos, e é por isso que a receita deixa as linhas sem justificar.

-  textAlign: 'left', firstLineIndent: em(0),
+  textAlign: 'justify', firstLineIndent: em(0),

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

Componha o japonês com uma fonte japonesa

A Noto Serif SC e a TC têm kana, mas desenham os kanji com formas chinesas (直, 骨 e 角 mudam) e o kana com desenho chinês. Componha o texto em Noto Serif JP ou Shippori Mincho B1 e os títulos em Noto Sans JP, carregadas com loadCjkFonts. Os arquivos japoneses do Fontsource não têm hentaigana nem outros kana históricos (U+1B000–1B16F): loadCjkFonts falha com eles e o PDF imprime caixas, então escreva o kana moderno ou inclua nos recursos da receita uma fonte que os tenha. A Shippori Mincho também não tem as vogais com mácron ō e ū: componha o rōmaji com uma fonte latina. Kana, kanji e rōmaji →

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 →

  • keep-all mantém as quebras que o texto já tem: o Postext não encontra as frases, de modo que quem escreve digita os espaços. Uma frase mais longa que a linha ainda quebra por dentro, no último ponto que as regras de kinsoku permitem.
  • O chinês nunca separa as palavras, e a cartilha chinesa Uma cartilha vertical com zhuyin à direita ajuda os pequenos leitores com leituras; um livro ilustrado japonês não usa kanji, por isso não precisa de furigana, e os espaços entre as frases guiam a leitura.

Créditos

Texto
  • かみの ふね (The Paper Boat), a picture-book story in hiragana written for this recipe · Postext Cookbook · CC BY 4.0
Imagens
  • The cover: a red paper boat on a river through green meadows, a clear sky on the right for the title · Generated With Diffusion Models · original
  • Mii-chan folding the red paper boat at a low table by the window, after the rain · Generated With Diffusion Models · original
  • Mii-chan waving goodbye to the boat on the stream · Generated With Diffusion Models · original
  • A frog on a stone talking to the boat · Generated With Diffusion Models · original
  • The boat under a wooden footbridge, little fish following it · Generated With Diffusion Models · original
  • A white heron on the bank watching the boat on the wide river · Generated With Diffusion Models · original
  • Dusk: a pink sky over the river mouth and the sea beyond · Generated With Diffusion Models · original
  • Night: the full moon's reflection lighting the boat's way · Generated With Diffusion Models · original
  • The boat at sea, greeted by seagulls · Generated With Diffusion Models · original
  • Mii-chan at her window, looking towards the distant sea · Generated With Diffusion Models · original
Fontes
Klee One (SIL OFL 1.1) · Zen Maru Gothic (SIL OFL 1.1)
SandboxPDF