Em poucas palavras
Dois contos como os imprime uma coleção de obras completas japonesa: o texto desce pela página em duas faixas empilhadas, cada conto abre numa página da esquerda com o título na altura toda, e a última página não é nivelada.
O que você vai compor
Sete páginas de um volume de obras completas (全集) numa página A5 encadernada pela direita: O fio da aranha e A fé de Bisei, de Akutagawa Ryūnosuke, compostos em dois andares (二段組) de 25 caracteres de altura e 21 linhas de largura, em Noto Serif JP de 9 pt, com um fio fino entre os andares. Cada conto abre numa página ímpar, a da esquerda, com o título em 20 pt descendo pelos dois andares e o nome do autor perto do pé; os fólios continuam a partir da página 211. As seções 一 二 三 ocupam três linhas do andar. Quando um conto termina, a última página fica como o texto cai, o 成り行き (nariyuki) japonês: na página 214, o conto termina no andar de cima com a data, uma linha antes de enchê-lo, e o de baixo fica vazio. O jornal chinês em andares verticais é a Nº 084, e um título de capítulo sobre duas colunas horizontais é a Nº 017.
Esta receita responde a
- Como coloco o título do capítulo na largura da página enquanto o texto segue em duas colunas abaixo?
- Como forço uma quebra de página ou de coluna e faço cada capítulo começar em página ímpar?
- Como defino a mancha em caracteres, tantos por linha e tantas linhas por página?
A resposta curta
// On a vertical page two columns are two tiers (段), filled from the upper right: the
// gutter is the gap between them and the column rule a hairline across the page. The grid
// counts characters down one tier, so each tier is exactly 25 em long and the gutter 2 em.
const layout = {
layoutType: 'double', writingMode: 'vertical-rl', // binding 'auto' becomes 'right'
gutterWidth: pt(2 * BODY),
columnRule: { enabled: true, color: col('rule'), lineWidth: pt(0.4) },
};
const cjk = { grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES } };
// 成り行き (nariyuki): the text fills the upper tier across the whole page before the
// lower one, and a work's last page is not levelled: its lower tier ends where the text
// does. trailing: false is that choice (vertical tiers are not balanced by default either).
const balancing = { trailing: false };
// Each work opens on an odd page, the left-hand one in a book bound on the right, with a
// blank page before it when the last work ended on an odd page.
const work = { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' } };
// 一 二 三 take three lines of their tier (3行取り), eight characters down.
const section = { level: 2, fontSize: pt(11), fontWeight: 600, lineSpan: 3, indent: em(8) };
Ingredientes
- Funcionalidades
- Uma ou duas colunasTexto verticalEquilíbrio de colunasLivros encadernados pela direitaCapítulos que abrem em página ímparTítulos sobre linhas do texto (gyōdori)Grade de caracteresFio entre colunasQuebra de linha em japonês (kinsoku)Espaçamento da pontuação japonesa (yakumono)Furigana: leituras em kana sobre os kanjiImportação do Aozora BunkoFontes chinesas, japonesas e coreanasCabeços e fóliosCabeços por tipo de páginaEstilos de títuloAberturas desenhadasEstilos de parágrafoPaleta de cores semânticaExportação para PDF
- Também usa
- Quebra de linha em chinêsAtributos de títuloFaixa de capítulo em largura totalCor do papelFontes incorporadas ao PDFElementos pré-textuais em romanosRubi: leituras em pinyin e zhuyinCabeços por seçãoEspaço vertical explícito
- Tipografia
- Noto Serif JP, Noto Sans JP (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Duas colunas giradas um quarto de volta são dois andares
O código é a resposta curta acima. Numa página com writingMode: 'vertical-rl', layoutType: 'double' empilha as duas colunas: a primeira enche o andar de cima a partir da direita, depois o de baixo, e a medianiz é a faixa entre eles (Escrita vertical). A grade de caracteres conta os caracteres de cima para baixo num andar, por isso cada andar tem 25 caracteres de 9 pt e a medianiz é arredondada para dois caracteres inteiros; as 21 linhas de 15,75 pt na largura ocupam 116,7 mm dos 148 mm da página. O fio entre os andares atravessa a página, com 0,4 pt num cinza quente.
O equilíbrio do Postext terminaria os dois andares da última página de um conto na mesma linha, que é como os jornais chineses e a maioria dos livros europeus em duas colunas fecham um capítulo. Um livro japonês em andares deixa o texto cair: o andar de cima percorre a página toda antes de o de baixo começar. balancing.trailing: false é essa escolha, e os andares verticais nem chegam a ser equilibrados, a menos que enabled: true ative o equilíbrio (Balanceamento de colunas).
#2 · Descer o título da obra pelos dois andares
// A page-span heading is laid out across the whole height of the page, both tiers and the
// gutter, in the flow frame: x runs down the page, y across it leftwards from the right
// edge of the type area. The design reserves seven lines (七行取り); the tiers start after it.
const at = (down, across) => ({ anchor: { to: 'container', edge: 'top-left' },
offset: { x: pt(down), y: pt(across) } });
const TITLE = 20; // pt
const opener = { enabled: true, minHeight: lines(7), slot: { elements: [
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: MINCHO, fontWeight: 600,
fontSize: pt(TITLE), lineHeight: 1, letterSpacing: pt(TITLE / 2), color: col('ink'),
placement: at(5 * BODY, 2.5 * LEAD - TITLE / 2) },
{ kind: 'text', id: 'author', content: '{author}', fontFamily: MINCHO, fontSize: pt(10.5),
letterSpacing: pt(3), color: col('ink'),
placement: at(HEIGHT - 5 * 10.5 - 4 * 3 - 3 * BODY, 4.5 * LEAD - 10.5 / 2) },
] } };
Um nível de título com span: 'page' é diagramado na altura toda da página, os dois andares e a medianiz, no começo do fluxo, à direita de uma página vertical; os andares começam depois das sete linhas que o design dele reserva. Um título assim sempre abre uma página, e breakBefore.parity: 'odd' faz dela a da esquerda: O fio da aranha termina na página 214, uma página par, de modo que A fé de Bisei abre na 215 sem página em branco entre os dois (Span e design avançado). No design, x desce pela página e y a atravessa a partir da borda direita da mancha; o nome do autor é posicionado a partir do pé do andar de baixo, três caracteres acima.
#3 · Numerar as seções em três linhas do seu andar
O segundo nível, lineSpan: 3 com indent: em(8), compõe 一 二 三 oito caracteres abaixo do topo do andar, numa faixa de três linhas, como o texto do Aozora as marca (八字下げ, 中見出し), de modo que o texto depois de um número de seção continua nas linhas do andar ao lado (Ajustes por nível). As datas que fecham os contos, (大正七年四月十六日), ficam erguidas um caractere acima do pé do andar (地から一字上げ) com :::paragraphs{align=end endIndent=1}; o conversor do Aozora as escreve como um estilo aozora-end1 que as encosta no pé, e os atributos do bloco acrescentam a subida de um caractere.
#4 · Pôr o volume e a obra na margem do corte
// anchor 'outer' is the fore-edge: the left margin of an odd page and the right one of an
// even page in a book bound on the right. The volume's name on the right-hand page, the
// work on the left; the folios count on from the volume's page 211.
const foreEdge = (id, content, parity, edge, y, extra = {}) => ({
kind: 'text', id, content, parity, pages: 'body', 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) } },
...extra,
});
const header = { elements: [
foreEdge('volume', '{title}', 'even', 'top', 2),
foreEdge('work', '{chapterTitle}', 'odd', 'top', 2),
// The folio in Arabic digits, set across the margin: down the fore-edge they would lie
// on their side.
foreEdge('folio', '{pageNumber}', 'all', 'bottom', -1, { pages: 'all', writingMode: undefined,
letterSpacing: pt(0.5) }),
] };
const none = { elements: [] };
// The first work's opening page carries the colophon across the foot, in the edition's
// language (a style's footer serves every page of its section: gotcha style-header-whole-section).
const first = { id: 'first', footer: { elements: [{ kind: 'text', id: 'colophon', pages: 'opener',
content: '{attr.colophon}', fontFamily: GOTHIC, fontSize: pt(5.5), lineHeight: 1.45,
color: col('muted'), overflow: 'wrap', align: 'center',
placement: { anchor: { to: 'page', edge: 'bottom' }, offset: { y: mm(-6) },
size: { width: mm(118) } } }] } };
anchor.to: 'outer' põe o hashira na margem do corte, o nome do volume, 芥川龍之介集, nas páginas da direita e o título da obra nas da esquerda, e pages: 'body' os deixa fora das páginas onde uma obra abre (Elementos de texto verticais). O fólio é composto atravessado na margem, em algarismos arábicos, como muitas obras completas o imprimem: descendo pela margem do corte, três algarismos ficariam deitados. pageNumbering.startAt: 211 numera as páginas como o volume as numera. O estilo de título da primeira obra traz o colofão com pages: 'opener', porque o rodapé de um estilo serve a todas as páginas da seção.
A receita completa
// ═══ Postext Cookbook · Nº 118 · A Japanese story in two tiers, its title across both ═══
// https://postext.dev/en/cookbook/two-tier-tankobon
// Code: MIT · Text: 芥川龍之介『蜘蛛の糸』『尾生の信』, Aozora Bunko 92, 24 (PD) · Pictures: none
// Fonts: Noto Serif JP, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.25.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 stories are Japanese in both
const RECIPE = 'two-tier-tankobon';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, one deep indigo, a warm book paper
const palette = {
ink: '#1d1b19', // the text
indigo: '#2f3d63', // 藍: the cloth of the case; the engine's defaults
rule: '#8c857b', // the hairline between the two tiers
muted: '#655e56', // the hashira and the folios
paper: '#fcfaf4',
};
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.indigo, model: 'hex' } },
];
// #endregion
const [MINCHO, GOTHIC] = ['Noto Serif JP', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [9, 15.75, 25, 21]; // pt, pt: 2 段 × 25字 × 21行
const HEIGHT = 2 * CHARS * BODY + 2 * BODY; // pt: two tiers and a gutter of two characters
const lines = (n) => pt(n * LEAD); // n lines across the page
// #region answer: two tiers of 25 characters, the last page of a work left as it falls
// On a vertical page two columns are two tiers (段), filled from the upper right: the
// gutter is the gap between them and the column rule a hairline across the page. The grid
// counts characters down one tier, so each tier is exactly 25 em long and the gutter 2 em.
const layout = {
layoutType: 'double', writingMode: 'vertical-rl', // binding 'auto' becomes 'right'
gutterWidth: pt(2 * BODY),
columnRule: { enabled: true, color: col('rule'), lineWidth: pt(0.4) },
};
const cjk = { grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES } };
// 成り行き (nariyuki): the text fills the upper tier across the whole page before the
// lower one, and a work's last page is not levelled: its lower tier ends where the text
// does. trailing: false is that choice (vertical tiers are not balanced by default either).
const balancing = { trailing: false };
// Each work opens on an odd page, the left-hand one in a book bound on the right, with a
// blank page before it when the last work ended on an odd page.
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
#Nivelar a última página
Ative o equilíbrio e a última página de cada obra é cortada nivelada: a página 214 termina com 10 linhas no andar de cima e 10 no de baixo, o fechamento que um livro chinês ou europeu em colunas usa. Na grade de caracteres o equilíbrio só acrescenta linhas inteiras, por isso cada caractere fica na casa.
-const balancing = { trailing: false };
+const balancing = { enabled: true }; // the closing band is cut level#Abrir cada obra na página seguinte
parity: 'any' começa uma obra na página que vier, como fazem as revistas e as antologias de textos muito curtos.
-const work = { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'odd' } };
+const work = { level: 1, span: 'page', breakBefore: { enabled: true, parity: 'any' } };#Compor o conto num só andar
Romances e bunko compõem o texto num só andar, sem medianiz; a Nº 117 compõe um bunko assim.
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
Um título na largura da página sempre abre uma página nova
Um título cujo nível ou estilo define span: 'page' é composto como abertura no alto de uma página, tenha ou não breakBefore. Colocado depois de outro texto, ou de outra abertura na mesma página, ele passa para a página seguinte e deixa vazio o resto da atual. Uma manchete que atravessa as duas colunas (ou os dois andares de uma página vertical) sob o cabeçalho do jornal vai no design da própria abertura, ao lado do cabeçalho, ou dentro de um boxe :::callout{span="page"} como título sem span, que é como newspaper-front-page compõe as suas manchetes. Aberturas desenhadas →
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 →
Créditos
- Receita
- Ignacio Ferro
- Texto
- 芥川龍之介「蜘蛛の糸」 (The Spider’s Thread, 1918); Aozora Bunko card 92, from 「芥川龍之介全集2」 (Chikuma Bunko, 1986), input 平山誠 and 野口英司, proofreading もりみつじゅんじ, converted with aozora.py · Akutagawa Ryūnosuke; Aozora Bunko volunteers · domínio público
- 芥川龍之介「尾生の信」 (Bisei’s Faith, 1920); Aozora Bunko card 24, from 「芥川龍之介全集3」 (Chikuma Bunko, 1986), input j.utiyama, proofreading かとうかおり, converted with aozora.py; the rule before the coda shortened to fit a tier · Akutagawa Ryūnosuke; Aozora Bunko volunteers · domínio público
- Fontes
- Noto Serif JP (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)


