Em poucas palavras
O começo de um clássico japonês como livro de bolso: o texto corre em colunas de cima para baixo, lidas da direita para a esquerda, com kana pequenos ao lado dos caracteres mais difíceis.
O que você vai compor
Nove páginas de um livro de bolso japonês (文庫, bunko) com Dez noites de sonhos, de Natsume Sōseki, a primeira e a segunda noites, numa página A6 de 105 × 148 mm encadernada pela direita. A folha de rosto fica sozinha à esquerda da lombada; a partir da página 2, o texto corre de cima para baixo em linhas lidas a partir da direita, 38 caracteres por linha e 15 linhas por página, em Shippori Mincho B1 de 9 pt com um passo de 1,75 em. As leituras que o Aozora Bunko dá para os kanji mais difíceis ficam ao lado deles em kana de meio corpo, o título de cada noite ocupa três linhas da grade, e as páginas da esquerda levam o título do livro descendo junto ao corte, sobre um fólio em numerais kanji. O livro de bolso europeu com a mesma estrutura é a Nº 104, e o romance chinês em vertical é a Nº 075.
Esta receita responde a
- Como componho um romance japonês na vertical, encadernado à direita, como um livro de bolso bunko?
- Como coloco furigana sobre os kanji, uma leitura por caractere ou uma para a palavra inteira?
- Como transformo um texto do Aozora Bunko em um livro do Postext?
- Como faço um título japonês ocupar três linhas do texto (3行取り) para que o texto continue na grade?
A resposta curta
// 'vertical-rl' sets each line top to bottom and the lines from right to left; with the
// binding left to 'auto' the book opens from the right, so page 1 is a left-hand page and
// the spreads read [3 | 2]. locale 'ja' gives the cjk settings Japan's values: they are
// written out below so you can see them, and leaving them out sets the same page.
const page = {
sizePreset: 'custom', width: mm(105), height: mm(148), dpi: 200, // 文庫判 A6
backgroundColor: col('paper'),
// 天 above 地; left is the spine side (the right edge of a left-hand page). The grid
// grows the margins of each pair alike, so the head stays deeper than the foot.
margins: { top: mm(15), bottom: mm(11), left: mm(9), right: mm(12), mirror: true },
pageNumbering: { format: 'japanese-informal' }, // folios 一, 二 … 十, 十一
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
lineBreak: 'ja-very-strict', // 行頭禁則: no 、。」ー or small kana at the head of a line
hangingPunctuation: 'allow', // ぶら下げ: a 、。 that would open a line hangs below the last
paragraphStartBracket: 'half', // ③: a 「 that opens a paragraph fills the indent cell
ruby: { align: 'jis', overhang: 'kana' }, // JIS 1:2:1, a reading may run onto kana only
};
Ingredientes
- Funcionalidades
- Texto verticalFurigana: leituras em kana sobre os kanjiTítulos sobre linhas do texto (gyōdori)Livros encadernados pela direitaQuebra de linha em japonês (kinsoku)Espaçamento da pontuação japonesa (yakumono)Grade de caracteresNumerais japoneses e contadores em kanaImportação do Aozora BunkoKana, kanji e rōmajiFontes chinesas, japonesas e coreanasRubi: leituras em pinyin e zhuyinCabeços e fóliosCabeços por tipo de páginaMargens espelhadasEstilos de títuloNíveis de títuloCor do papelPaleta de cores semânticaExportação para PDF
- Também usa
- Quebra de linha em chinêsLargura da pontuação chinesaAtributos de títuloAberturas desenhadasFontes incorporadas ao PDFElementos pré-textuais em romanosCabeços por seçãoCapítulos sem número
- Tipografia
- Shippori Mincho B1, Noto Sans JP (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Girar a página, contá-la em caracteres e marcá-la como ja
O código está na resposta curta, mais acima. layout.writingMode: 'vertical-rl' diagrama cada página como uma página horizontal girada um quarto de volta no sentido horário, e page.binding, deixado em 'auto', encaderna um livro vertical pela direita: a página 1 continua sendo a ímpar, mas fica à esquerda da lombada, e mirror: true põe a margem interna dela à direita (Escrita vertical, Encadernação). A grade de caracteres faz a mancha ter 38 caracteres de 9 pt de altura (120,7 mm) e 15 linhas de 15,75 pt de largura (83,3 mm); as margens em page são mínimas, e a grade aumenta cada par na mesma medida, por isso a margem superior continua 4 mm mais funda que a inferior. Peça mais linhas do que as margens comportam e a grade tira uma sem alarde (cjkGridClamped em doc.configWarnings): são a lombada de 9 mm e o corte de 12 mm que deixam caber 15 linhas.
locale: 'ja' ajusta o resto como os livros japoneses são compostos, por isso as quatro linhas de cjk escritas aqui não mudam nada; elas mostram o que a marcação escolhe. ja-very-strict é a regra de início de linha da JIS X 4051 (行頭禁則): nenhuma linha abre com 、。」, ー ou um kana pequeno como っ. hangingPunctuation: 'allow' deixa um 、 ou 。 que abriria uma linha pendurado abaixo do último caractere (ぶら下げ), que é o que os bunko fazem em vez de apertar a linha. paragraphStartBracket: 'half' é o padrão ③ do JLReq: um parágrafo que abre com 「 põe o colchete na segunda metade do recuo de um caractere, e o primeiro caractere da fala fica onde fica o de qualquer outro parágrafo (Tipografia do Leste Asiático). Os livros chineses diferem nos dois pontos: não penduram nenhum sinal por padrão e recuam o parágrafo dois caracteres, com colchete ou sem.
#2 · Dar ao título de cada noite três linhas da grade
// lineSpan sets the heading in a band of three body lines, its characters centred in it, so
// the text after it stands on the grid's lines. Aozora marks the titles 5字下げ (中見出し);
// indent counts body characters, whatever the heading's own size.
const night = {
level: 1, fontFamily: MINCHO, fontWeight: 600, fontSize: pt(12.5),
lineSpan: 3, indent: em(5), // JLReq §4.1.3
breakBefore: { enabled: false }, // the nights run on
};
Um título japonês ocupa um número inteiro de linhas do texto, 行取り (gyōdori), para que as linhas depois dele fiquem na mesma grade que as anteriores. lineSpan: 3 compõe 第一夜 numa faixa de três linhas de 15,75 pt com os caracteres centralizados nela; os 12,5 pt do título não deslocam a grade, e na página 6 第二夜 ocupa as três primeiras linhas da página, de modo que o texto seguinte começa na quarta linha da grade. indent: em(5) conta caracteres do texto (五字下げ), que é como o texto do Aozora marca um 中見出し e como o JLReq conta os recuos de títulos (Ajustes por nível).
#3 · Trazer o texto e as leituras do Aozora Bunko
As duas noites vêm da ficha 799 do Aozora Bunko, convertida com o aozora.py da skill postext-port. O conversor lê o arquivo como CP932, transforma cada leitura escrita 仰向《あおむき》 numa leitura de grupo {仰向|あおむき}, uma única sequência de kana sobre a palavra inteira, e cada [#5字下げ]…[#「第一夜」は中見出し] num título. Num documento ja, as leituras seguem a JIS X 4051: uma leitura mais curta que a base se distribui ao longo dela em 1:2:1, e uma mais longa pode avançar sobre um kana vizinho, mas nunca sobre um kanji (Marcas, rubi e warichu). A entrelinha de 1,75 em deixa 6,75 pt entre as linhas, espaço para as leituras de 4,5 pt.
#4 · Pôr o hashira junto ao corte e os fólios em kanji
// anchor 'outer' is the fore-edge: the left margin of an odd page, the right of an even one
// in a book bound on the right. The 柱 starts two characters below the head of the text.
const foreEdge = (id, content, parity, edge, y, pages) => ({
kind: 'text', id, content, parity, pages, writingMode: 'vertical-rl',
fontFamily: GOTHIC, fontSize: pt(7), letterSpacing: pt(1), color: col('muted'),
overflow: 'clip', placement: { anchor: { to: 'outer', edge }, offset: { y: em(y) } },
});
const header = { elements: [
foreEdge('hashira', '{title}', 'odd', 'top', 2, 'body'), // never on the opening page
foreEdge('folio', '{pageNumber}', 'all', 'bottom', -2, 'all'),
] };
const none = { elements: [] };
Num bunko vertical, o cabeço (柱, hashira) é pequeno e fica na margem externa. anchor.to: 'outer' põe um elemento ali, na margem esquerda de uma página ímpar e na direita de uma par num livro encadernado pela direita, e writingMode: 'vertical-rl' o compõe de cima para baixo (Elementos de texto verticais). O título 夢十夜 aparece só nas páginas da esquerda (parity: 'odd'), e pages: 'body' o tiraria de qualquer página que abra um capítulo. pageNumbering.format: 'japanese-informal' imprime os fólios 二, 三 … 九 (Numeração).
#5 · Centralizar a folha de rosto no formato
// A design on a vertical page is laid out in the flow frame: x runs down the page and y
// across it, leftwards from the right edge. Anchored to the page (the trim), the frame and
// the title stand on the page's axis, 52.5 mm in, whichever side the spine is on.
const at = (down, across) => ({ anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(down), y: mm(across) } });
const AXIS = 105 / 2; // mm
const TITLE = 28 * PT; // mm: 夢十夜 in 28 pt, three characters and two 8 pt gaps down
const frame = { kind: 'box', id: 'frame', placement: { ...at(30, AXIS - 23),
size: { width: mm(88), height: mm(46) } }, // 88 mm down, 46 mm across
style: { borderColor: col('vermilion'), borderWidth: pt(0.75) } };
const titlePage = {
id: 'title', numbered: false, toc: false, span: 'page', header: none, footer: { elements: [
// The colophon across the foot, in the edition's language: each \n in the attribute
// starts a line; the box hangs from the foot of the page, centred.
// Noto Sans JP: Shippori Mincho B1 has no ō or ū for the rōmaji.
{ kind: 'text', id: 'colophon', content: '{attr.colophon}', fontFamily: GOTHIC,
fontSize: pt(5.25), lineHeight: 1.45, color: col('muted'), overflow: 'wrap',
align: 'center', placement: { anchor: { to: 'page', edge: 'bottom' },
offset: { y: mm(-4) }, size: { width: mm(84) } } }] },
breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: lines(LINES), slot: { elements: [
frame,
{ kind: 'text', id: 'book', content: '{titleText}', fontFamily: MINCHO, fontWeight: 800,
fontSize: pt(28), lineHeight: 1, letterSpacing: pt(8), color: col('ink'),
placement: at(44, AXIS - TITLE / 2) },
{ kind: 'text', id: 'author', content: '{author}', fontFamily: MINCHO, fontSize: pt(11),
letterSpacing: pt(4), color: col('ink'), placement: at(92, AXIS + TITLE / 2 + 4) },
] } },
};
A folha de rosto é um título de nível 1 com estilo próprio, # 夢十夜 {style="title" …}, cujo design ocupa a página. Os elementos dele são ancorados na própria página, não na mancha, porque a mancha de uma página espelhada fica 1,5 mm fora do centro: x desce pela página e y a atravessa a partir da borda direita, de modo que AXIS é metade da largura da página, de qualquer lado da lombada. O colofão do rodapé é composto em Noto Sans JP: a Shippori Mincho B1 não tem ō nem ū, e o PDF desenharia caixas vazias em Sōseki.
#6 · Carregar cada peso com os caracteres que ele compõe
// Fontsource cuts a Japanese face into about 120 files; loadCjkFonts fetches the ones the
// text touches (gotcha: cjk-fonts-slices). vertical: true loads the face's vertical forms
// for the canvas: 、。「」ー and small kana such as っ stand differently down a line.
const title = markdown.match(/^title: "(.*)"$/m)[1];
const author = markdown.match(/^author: "(.*)"$/m)[1];
const heads = markdown.match(/^# [^{\n]*/gm).join('');
await loadFonts(FONTS, markdown); // the Latin files: the colophon, with ō and ū
await loadCjkFonts({ [MINCHO]: ['400'] }, markdown, { vertical: true });
await loadCjkFonts({ [MINCHO]: ['600', '800'] }, `${heads}${title}${author}`);
await loadCjkFonts({ [GOTHIC]: ['400'] }, `${title}一二三四五六七八九十`, { vertical: true });
A Fontsource serve cada peso de uma fonte japonesa em uns 120 arquivos, cada um cobrindo uma faixa de caracteres, e loadCjkFonts baixa os arquivos que o texto recebido toca. O peso do texto recebe a amostra inteira com vertical: true, que também carrega as formas verticais da fonte para o canvas: 、。「」 e ー, e os kana pequenos, que no texto vertical ficam no canto superior direito da casa. renderToPdf recebe cjkPdfProvider, que incorpora os mesmos arquivos como subconjuntos.
A receita completa
// ═══ Postext Cookbook · Nº 117 · A bunko novel set vertically, with furigana ════════
// https://postext.dev/en/cookbook/bunko-novel-furigana
// Code: MIT · Text: 夏目漱石『夢十夜』, Aozora Bunko 799 (public domain) · Pictures: none
// Fonts: Shippori Mincho B1, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.28.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the colophon; the novel is Japanese in both
const RECIPE = 'bunko-novel-furigana';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: sumi ink on a cream bunko stock, one vermilion
const palette = {
ink: '#1f1b18', // the text: a warm sumi black
vermilion: '#a8392b', // 朱: the frame of the title page
muted: '#6b635b', // the hashira and the folios
paper: '#fbf7ee', // bunko paper is cream, not white
};
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: 'defaults', value: { hex: palette.vermilion, model: 'hex' } },
];
// #endregion
const [MINCHO, GOTHIC] = ['Shippori Mincho B1', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [9, 15.75, 38, 15]; // pt, pt: 38字 × 15行 at 1.75 em
const lines = (n) => pt(n * LEAD); // n lines across the page
const PT = 25.4 / 72; // mm in a point
// #region answer: a bunko page, 38 characters down 15 lines, bound on the right
// 'vertical-rl' sets each line top to bottom and the lines from right to left; with the
// binding left to 'auto' the book opens from the right, so page 1 is a left-hand page and
// the spreads read [3 | 2]. locale 'ja' gives the cjk settings Japan's values: they are
// written out below so you can see them, and leaving them out sets the same page.
const page = {
sizePreset: 'custom', width: mm(105), height: mm(148), dpi: 200, // 文庫判 A6
backgroundColor: col('paper'),
// 天 above 地; left is the spine side (the right edge of a left-hand page). The grid
// grows the margins of each pair alike, so the head stays deeper than the foot.
margins: { top: mm(15), bottom: mm(11), left: mm(9), right: mm(12), mirror: true },
pageNumbering: { format: 'japanese-informal' }, // folios 一, 二 … 十, 十一
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
lineBreak: 'ja-very-strict', // 行頭禁則: no 、。」ー or small kana at the head of a line
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
#Marcar as palavras que o original destaca
As duas primeiras noites de Sōseki não têm 傍点, mas muitos textos do Aozora têm, e o conversor os escreve como :dots[…]{style=sesame}. Num documento ja, *…* dá as mesmas marcas de gergelim ao lado da linha, nunca itálico.
-こんな夢を見た。
+こんな*夢*を見た。#Pôr todo colchete um caractere inteiro abaixo
O padrão ① mantém o recuo de um caractere e põe o colchete depois dele, como fazem muitos romances para leitores jovens.
- paragraphStartBracket: 'half', // ③: a 「 that opens a paragraph fills the indent cell
+ paragraphStartBracket: 'indent', // ①: the bracket after the one-character indent#Apertar em vez de pendurar
Com hangingPunctuation: 'none', um 、 ou 。 que abriria uma linha entra na linha anterior apertando os colchetes e vírgulas dela (追い込み), ou o último caractere dessa linha desce junto (追い出し), e nenhum sinal fica abaixo da linha.
- hangingPunctuation: 'allow', // ぶら下げ: a 、。 that would open a line hangs below the last
+ hangingPunctuation: 'none',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 →
Erro comum
Um livro encadernado pela direita mostra as páginas duplas com showBook
Em um livro encadernado pela direita (texto árabe, hebraico ou persa, chinês vertical, ou page.binding 'right') a página 1 continua sendo a ímpar, mas fica à esquerda da lombada, e os pares se leem [3 | 2]. showPages dispõe todos os livros como se fossem encadernados pela esquerda; showBook, do bloco book (o bloco cjk traz a mesma função), lê doc.binding e espelha os pares. capture.hero continua nomeando uma página dupla em ordem de leitura, [par, ímpar]: [2, 3]. Livros encadernados pela direita →
Erro comum
Leia os arquivos do Aozora como CP932, não como Shift_JIS
Os arquivos de texto do Aozora Bunko estão em Windows-31J (CP932). Decodificados como Shift_JIS puro, o travessão ―― sai como travessões U+2014, ~ como o til ondulado 〜, e alguns caracteres da NEC e da IBM falham. Leia-os como cp932 e depois converta a marcação: o rubi entre 《》, as notas [#…] e os gaiji ※[#…] não são Markdown e saem impressos como estão se forem mantidos. O aozora.py da skill faz as duas coisas. Importação do Aozora Bunko →
Erro comum
Um intervalo do Fontsource pode citar caracteres que o seu arquivo não tem
O Fontsource dá a cada arquivo um unicode-range, e loadCjkFonts carrega os arquivos cujos intervalos cobrem a amostra, mas um intervalo pode prometer mais do que o arquivo contém. O fragmento da Zen Old Mincho para U+3028–303F não tem 〻 nem as marcas de repetição longas 〳〴〵, e a fonte também não tem as vogais com mácron ō ū ā; o arquivo latin-ext da Shippori Mincho B1 tem poucos caracteres, e nenhum deles é ō, ū ou ā. Nada falha enquanto a receita roda: na tela, esses caracteres vêm de uma fonte do sistema e são medidos com ela, e o PDF imprime a caixa .notdef da fonte, que só a verificação C25 aponta depois. Procure na fonte um sinal raro ou uma palavra em rōmaji antes de escolhê-la (fontTools sobre o arquivo do Fontsource) e componha esse texto com uma fonte que o tenha: Shippori Mincho B1 e Noto Serif JP têm 〻 e 〳〴〵; Noto Serif JP e Noto Sans JP, as vogais com mácron. Fontes chinesas, japonesas e coreanas →
Erro comum
Uma página vertical tem dois sistemas de referência: o do texto girado e o da folha
Um documento vertical-rl compõe o texto como uma página horizontal girada um quarto de volta no sentido horário, e o design de um título (os elementos de advancedDesign.slot) é posicionado nesse sistema girado: x desce pela página, y a atravessa para a esquerda a partir da borda direita, e a largura de um elemento é medida para baixo. Os elementos do cabeçalho e do rodapé continuam na folha: x avança para a direita a partir da borda esquerda e y desce a partir do alto. Uma moldura desenhada no cabeçalho e um título posicionado no design do título tomam, portanto, os seus deslocamentos em eixos diferentes. Em uma folha de rosto vertical, ancore os elementos a `page` e meça a partir das bordas dela: ancorados a `container`, os elementos do rodapé ficam alguns milímetros (cerca de 5 mm) fora do centro da mancha. Texto vertical →
Créditos
- Receita
- Ignacio Ferro
- Texto
- 夏目漱石『坊っちゃん』 (Botchan, 1906), the opening of chapter one; Aozora Bunko card 752, from 「ちくま日本文学全集 夏目漱石」 (Chikuma Shobō, 1992), input 真先芳秋, proofreading 柳沢成雄, converted with aozora.py · Natsume Sōseki; Aozora Bunko volunteers · domínio público
- Fontes
- Shippori Mincho B1 (SIL OFL 1.1) · Noto Sans JP (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)


