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

Receitas · Capítulo 6 · Boxes e notas

Notas ao lado de um texto japonês vertical, na página dupla

O 1º capítulo de Brincadeiras de criança, de Ichiyō, com sete notas como 傍注: (1) à direita da linha e as notas da página dupla no corte da página esquerda.

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

p. 二–三 · 2–3 de 4

  • Amostra em inglês: ainda sem edição em português
  • Refile 127 × 188 mm
  • 1 coluna
  • Shippori Mincho 9,3/16,3
  • Noto Sans JP
  • 4 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 68 ms
  • 126 linhas de código

Em poucas palavras

Um conto clássico japonês com explicações curtas dos nomes de lugares antigos. Os numerozinhos ficam ao lado do texto, e as explicações das duas páginas abertas se juntam na borda externa da página esquerda.

O que você vai compor

Quatro páginas de uma edição 四六判 de Brincadeiras de criança (たけくらべ, 1895–96), de Higuchi Ichiyō, o primeiro capítulo, com sete notas sobre o antigo bairro de Yoshiwara que o conto descreve. As notas são 傍注 (bōchū), as notas laterais dos clássicos japoneses de bolso: um (1) pequeno fica à direita da linha, depois da palavra que explica, e as notas citadas nas duas páginas de uma página dupla são compostas no corte da frente da página esquerda, sob um fio de um terço da linha, num corpo um quinto menor. O leitor encontra cada nota sem virar a página. O texto, com 42 caracteres em 17 linhas de Shippori Mincho em 9,25 pt, mantém o único parágrafo longuíssimo de Ichiyō e as marcas de gergelim sobre ぎつちよんちよん. As notas no pé da coluna num romance europeu estão na Nº 071.

Esta receita responde a

  • Como componho as notas de um livro japonês: (1) no fim do capítulo, no pé da página ou ao lado do texto ao longo da página dupla?
  • Como faço notas de rodapé?
  • Como marco texto japonês com pontos de ênfase de gergelim ou uma linha lateral em vez de itálico?

A resposta curta

script.js · linhas 32–48no código completo
// placement 'spread' gathers the notes cited on the two pages of a spread at the end of the
// left-hand page's text, the fore-edge in a book bound on the right, under a rule a third of
// the line long, and numbers them per spread. The marker (1) stands small at the right of
// the line, its digits upright, and the note opens with its number and a full note-em.
const footnotes = {
  placement: 'spread', // 傍注; 'chapterEnd' sets 後注 after the chapter instead
  numbering: 'spread',
  markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
  numberGap: 'em', hangingIndent: em(2), // turnovers clear the number
  fontSize: em(0.8), lineHeight: em(1.5),
  separator: { width: 1 / 3, lineWidth: pt(0.5), color: col('plum') },
};
// Ichiyō's sesame marks (傍点) over ぎつちよんちよん: the mark Japan uses, right of the line.
const cjk = {
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
  emphasisMark: { style: 'sesame', position: 'over' },
};

Ingredientes

Tipografia
Shippori Mincho, Noto Sans JP (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Juntar as notas da página dupla no corte da página esquerda

O código é a resposta curta acima. footnotes.placement: 'spread' compõe as notas citadas nas páginas 2 e 3 no fim do texto da página 3, que num livro encadernado pela direita é o corte da frente, e numbering: 'spread' recomeça em (1) as notas de cada página dupla (Notas de rodapé). Uma nota citada na página direita espera pela esquerda; se as notas deixarem à página esquerda menos de uma linha de texto, as que sobram ficam no pé da página direita, como o JLReq permite. Um documento com a etiqueta ja já compõe as chamadas de um livro vertical como ({n}) à direita da linha, em 0,7 em, com os algarismos em pé: as duas linhas escritas aqui deixam isso à vista. numberGap: 'em' põe um caractere de nota inteiro depois do número, e hangingIndent: em(2) alinha as linhas seguintes depois dele.

#2 · Escrever as chamadas onde o japonês as põe

O Markdown escreve 見返り柳[^1] depois da palavra que a nota explica, e as notas como parágrafos [^1]: … no fim do capítulo. A chamada vem depois da palavra explicada; se fecha uma frase, vai antes do 。 (…先生[^1]。), e o motor nunca deixa um 。 ou uma chamada começar a linha. As sete notas foram escritas para esta receita: o que eram o 見返り柳 e a お齒ぐろ溝, onde ficava 大音寺前, o que se vendia no 酉の市, num japonês moderno e simples.

#3 · Manter as marcas de gergelim do original

cjk.emphasisMark decide o que *…* e :dots[…] imprimem neste livro: pontos de gergelim, à direita de uma linha vertical. Um documento ja já os usa; escritas por extenso, as marcas acionam o kenten na lista de recursos da receita. O texto do Aozora marca ぎつちよんちよん com 傍点, e aozora.py o escreveu como :dots[ぎつちよんちよん]{style=sesame}; os livros chineses põem os pontos embaixo da linha (Marcas, rubi e warichu).

#4 · Abrir numa página dupla

script.js · linhas 52–71no código completo
// Page-anchored design on a vertical page: x runs down the page from its top edge, y across
// it leftwards from its right edge. The title stands on the page's axis, the author lower.
const PT = 25.4 / 72; // mm in a point
const page = (down, across) => ({ anchor: { to: 'page', edge: 'top-left' },
  offset: { x: mm(down), y: mm(across) } });
const TITLE = 26; // pt
// parity 'any': the story opens on the next page, either side (the default waits for a recto).
const story = { level: 1, breakBefore: { enabled: true, parity: 'any' },
  advancedDesign: { enabled: true, minHeight: lines(LINES), slot: { elements: [
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: MINCHO, fontWeight: 700,
      fontSize: pt(TITLE), lineHeight: 1, letterSpacing: pt(TITLE / 2), color: col('ink'),
      placement: page(42, 127 / 2 - (TITLE * PT) / 2) },
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6), color: col('plum'),
      placement: { ...page(42, 127 / 2 + (TITLE * PT) / 2 + 5), size: { width: mm(24) } } },
    { kind: 'text', id: 'author', content: '{author}', fontFamily: MINCHO, fontSize: pt(12),
      letterSpacing: pt(4), color: col('ink'),
      placement: page(118, 127 / 2 + (TITLE * PT) / 2 + 3) },
  ] } } };
const section = { level: 2, fontFamily: MINCHO, fontWeight: 700, fontSize: pt(11),
  lineSpan: 3, indent: em(7) }; // 3行取り, seven characters down, as the Aozora text marks it

A primeira frase do capítulo cita quatro notas nas três primeiras linhas. Sob um título na página 1, elas deixariam espaço para três linhas de texto: a página esquerda leva só as próprias notas. Uma folha de rosto sozinha na página 1 leva o capítulo para a página 2, uma página direita, e a primeira página dupla reúne o texto e todas as notas. A folha de rosto é um título de nível 1 cujo desenho ocupa a página, ancorado ao refile para que o título fique no eixo da página.

#5 · Pôr o hashira e os fólios no corte da frente

script.js · linhas 75–89no código completo
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'),
  foreEdge('folio', '{pageNumber}', 'all', 'bottom', -2, 'body'),
] };
// The title page carries the colophon across the foot, in the edition's language.
const footer = { elements: [{ kind: 'text', id: 'colophon', content: '{attr.colophon}',
  pages: 'opener', 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(100) } } }] };

O título desce pela margem externa das páginas esquerdas, por fora das notas, e os fólios em kanji ficam no pé de todas as páginas, menos na folha de rosto.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 121 · Notes beside a vertical Japanese text, across the spread ══
// https://postext.dev/en/cookbook/vertical-notes-and-sidenotes
// Code: MIT · Text: 樋口一葉『たけくらべ』, Aozora Bunko 389 (PD); notes CC BY 4.0 · Pictures: none
// Fonts: Shippori Mincho, 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 story is Japanese in both
const RECIPE = 'vertical-notes-and-sidenotes';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, a muted plum for the note numbers' rule, cream paper
const palette = {
  ink: '#211d1b', // the text and the notes
  plum: '#6b3a55', // 紫: the rule over the notes, the engine's defaults
  muted: '#6b645d', // the hashira and the folios
  paper: '#fbf7ef',
};
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.plum, model: 'hex' } },
];
// #endregion
const [MINCHO, GOTHIC] = ['Shippori Mincho', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [9.25, 16.25, 42, 17]; // pt, pt: 四六判 42字 × 17行
const lines = (n) => pt(n * LEAD);

// #region answer: 傍注, the notes of both pages of a spread at the fore-edge of the left one
// placement 'spread' gathers the notes cited on the two pages of a spread at the end of the
// left-hand page's text, the fore-edge in a book bound on the right, under a rule a third of
// the line long, and numbers them per spread. The marker (1) stands small at the right of
// the line, its digits upright, and the note opens with its number and a full note-em.
const footnotes = {
  placement: 'spread', // 傍注; 'chapterEnd' sets 後注 after the chapter instead
  numbering: 'spread',
  markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
  numberGap: 'em', hangingIndent: em(2), // turnovers clear the number
  fontSize: em(0.8), lineHeight: em(1.5),
  separator: { width: 1 / 3, lineWidth: pt(0.5), color: col('plum') },
};
// Ichiyō's sesame marks (傍点) over ぎつちよんちよん: the mark Japan uses, right of the line.
const cjk = {
  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
  emphasisMark: { style: 'sesame', position: 'over' },
};

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

#Juntar as notas no fim do capítulo

Sem placement, um livro ja vertical compõe as notas como 後注 (kōchū): depois do texto do capítulo, sob o mesmo fio, numeradas ao longo do capítulo. Aqui elas ocupam a metade esquerda da página 4.

-  placement: 'spread', // 傍注; 'chapterEnd' sets 後注 after the chapter instead
-  numbering: 'spread',
+  placement: 'chapterEnd', // 後注, the default for a vertical ja book
+  numbering: 'chapter',

#Pôr a chamada ao lado da palavra

markerPosition: 'side' compõe uma chamada menor no espaço ao lado da linha, como um rubi entre linhas, e assim ela não ocupa nada da linha.

-  markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
+  markerPosition: 'side', markerTemplate: '{n}',

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 →

Créditos

Texto
  • 樋口一葉「たけくらべ」 (Child’s Play, 1895–96), chapter one; Aozora Bunko card 389, from 「日本現代文學全集10 樋口一葉集」 (Kōdansha, 1962), input 青空文庫, proofreading 米田進 and 小林繁雄, converted with aozora.py; the seven notes were written for this recipe (CC BY 4.0) · Higuchi Ichiyō; Aozora Bunko volunteers · domínio público
Fontes
Shippori Mincho (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
SandboxPDF