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

Receitas · Capítulo 6 · Boxes e notas

Comentário em tinta vermelha na linha e na margem superior

Uma página chinesa comentada, na vertical: os comentários laterais do manuscrito em duas fileiras vermelhas dentro da linha, e os da margem, sobre o texto.

Nesta página
Saída
Canvas · PDF
Nível
Avançado
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Licença
Atualizada em 11 de out. de 2026
Código MIT · Texto CC BY 4.0

p. 四–五 · 4–5 de 6

  • Amostra em inglês: ainda sem edição em português
  • Refile 184 × 260 mm
  • Coluna e meia, medianiz de 8,5 mm
  • Noto Serif TC 12/21
  • LXGW WenKai TC
  • Noto Sans TC
  • 6 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 101 ms
  • 156 linhas de código

Em poucas palavras

Seis páginas de um romance clássico chinês, impresso em colunas que se leem de cima para baixo. As notas antigas de um leitor aparecem em vermelho dentro das linhas e numa faixa acima do texto.

O que você vai compor

O começo do capítulo 1 da História da pedra no manuscrito Jiaxu, a cópia que traz os comentários de Zhiyan Zhai, recomposto em seis páginas de uma edição comentada no formato 16开, de 184 × 260 mm, na vertical e encadernado pela direita. O texto de Cao Xueqin vai em Noto Serif TC, com 36 caracteres por coluna e 18 colunas por página. O manuscrito escreve em vermelho, ao lado das colunas, os 61 comentários laterais (側批) deste trecho. O Postext não compõe nada entre duas colunas, por isso esta edição leva cada um para dentro da linha, dobrado em duas fileiras vermelhão com metade do corpo, logo depois das palavras que ele comenta, como as edições comentadas impressas compõem os 雙行夾批. Os dez comentários da margem superior (眉批) ficam em Kai vermelha numa faixa de 42 mm acima do texto, sobre o trecho que discutem, e o leitor acompanha o texto e o comentário de uma só vez.

Esta receita responde a

  • Como componho uma edição comentada, com pequenas notas em duas linhas dentro da linha e comentários na margem superior?
  • Como componho um livro chinês na vertical, encadernado à direita?

A resposta curta

script.js · linhas 38–65no código completo
const layout = {
  writingMode: 'vertical-rl', // columns down the page, read from the right; bound on the right
  layoutType: 'oneAndHalf', // a text tier and a narrow tier for the comments
  sideColumnRole: 'floats', // no text runs into it: only boxes fenced with span="side"
  sideColumnSide: 'left', // in vertical text 'left' is the top tier: the head margin (天頭)
  sideColumnPercent: 19, // the grid rounds it to 10 characters of the body, 42 mm
  gutterWidth: mm(8), // rounded to 2 characters
  columnRule: { enabled: true, lineWidth: pt(0.5), color: col('rule') },
};
const cjk = {
  grid: { enabled: true, charsPerLine: 36, linesPerPage: 18 }, // 版心: 36 字 × 18 行
  // :warichu[…] folds a side comment into two rows at half the body size, in red
  // and with no brackets, as the manuscripts write their 雙行夾批.
  warichu: { color: col('vermilion') },
};
// A 眉批 is :::callout{type="meipi" span="side"}: span="side" sends it to the head
// margin, level with the column the text has reached at its fence, so the fence goes
// just before the passage it discusses (gotcha: side-box-starts-at-fence).
const meipi = {
  id: 'meipi', backgroundEnabled: false,
  border: { enabled: false }, stripe: { enabled: false },
  padding: { top: pt(0), right: pt(0), bottom: pt(0), left: pt(0) },
  // 17 characters of 7 pt down the 120 pt tier, a column every 10 pt. The next comment
  // starts on a text column at least one body column (21 pt) further on, whatever the margin.
  snapToGrid: false, marginBottom: pt(0),
  body: { fontFamily: KAI, fontSize: pt(7), lineHeight: pt(10), color: col('vermilion'),
    textAlign: 'left', firstLineIndent: pt(0) },
};

Ingredientes

Tipografia
Noto Serif TC, LXGW WenKai TC, Noto Sans TC (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Transforme a coluna lateral na margem superior

O código é a resposta curta logo acima. Uma página vertical é uma página horizontal girada um quarto de volta, de modo que a coluna lateral de uma diagramação em coluna e meia vira uma faixa que atravessa a página, e sideColumnSide: 'left' põe essa faixa no alto (Escrita vertical). A grade de caracteres arredonda sideColumnPercent: 19 para 10 caracteres do corpo, 120 pt, e a medianiz para dois; o fio de coluna passa a separar os comentários do texto. O estilo dos comentários não tem caixa: Kai de 7 pt, 17 caracteres por coluna, um corpo em que nenhum dos dez comentários termina numa coluna de um só caractere, e snapToGrid: false, para que os comentários se empilhem no próprio passo de 10 pt em vez dos 21 pt do corpo.

Os dois tipos de comentário são marcados onde o manuscrito os tem. Um comentário lateral é um trecho :warichu[…], que cjk.warichu colore; um comentário da margem superior é um box delimitado com span="side" logo antes do trecho que ele discute:

:::callout{type="meipi" span="side"}
妙!自謂落墮情根,故無補天之用。
:::
 
原來女媧氏煉石補天之時,:warichu[補天濟世,勿認真,用常言。]于大荒山:warichu[荒唐也。]…

#2 · Componha o número do capítulo e o dístico pelas primeiras colunas

script.js · linhas 69–81no código completo
const opener = { enabled: true, minHeight: mm(46), slot: { elements: [
  { kind: 'text', id: 'book', content: '{title}', fontFamily: HEI, fontWeight: 500,
    fontSize: pt(10), letterSpacing: pt(3), color: col('vermilion'), align: 'left',
    placement: { anchor: { to: 'container', edge: 'top-left' } } },
  { kind: 'text', id: 'number', content: '{titleText}', fontFamily: SONG, fontWeight: 700,
    fontSize: pt(30), letterSpacing: pt(6), color: col('ink'), align: 'left',
    placement: { anchor: { to: '#book', edge: 'below' }, offset: { x: em(2), y: mm(4) } } },
  ...['a', 'b'].map((half, i) => ({ kind: 'text', id: `couplet-${half}`,
    content: `{attr.${half}}`, fontFamily: SONG, fontSize: pt(15), letterSpacing: pt(3),
    color: col('ink'), align: 'left',
    placement: { anchor: { to: i ? '#couplet-a' : '#number', edge: 'below' },
      offset: { x: i ? pt(0) : em(4), y: mm(i ? 1.5 : 4) } } })),
] } };

Numa página vertical, a abertura é diagramada no quadro do fluxo: o texto desce, below quer dizer à esquerda e um deslocamento x move um elemento coluna abaixo. Primeiro vem o título do livro em Hei vermelha, depois 第一回 em 30 pt, dois dos próprios caracteres mais abaixo, e então as duas metades do dístico, tiradas dos atributos de título {a="…" b="…"}, mais abaixo ainda, e assim o número e o dístico descem a página em degraus, como num 回目 impresso. minHeight: mm(46) deixa uma coluna livre entre o dístico e o texto.

#3 · Leve os cabeços pela borda externa

script.js · linhas 85–96no código completo
// 'outer' is the margin away from the spine: a recto's left, a verso's right.
const edge = (id, content, edgeOf, y, extra = {}) => ({ kind: 'text', id, content,
  writingMode: 'vertical-rl', fontFamily: HEI, fontWeight: 500, fontSize: pt(9.5),
  letterSpacing: pt(2), color: col('muted'), overflow: 'clip', align: 'left',
  placement: { anchor: { to: 'outer', edge: edgeOf }, offset: { y: em(y) } }, ...extra });
const header = { elements: [
  // Four characters below the head: the book on a verso, the chapter on a recto,
  // never on the opener.
  edge('head-verso', '{title}', 'top', 4, { pages: 'body', parity: 'even' }),
  edge('head-recto', '{chapterTitle}', 'top', 4, { pages: 'body', parity: 'odd' }),
  edge('folio', '{pageNumber}', 'bottom', -5), // 一, 二, 三…: page.pageNumbering below
] };

São os cabeços da borda externa de Elementos de texto verticais: anchor.to: 'outer' é a margem do lado oposto à lombada, a esquerda de uma página ímpar e a direita de uma par num livro encadernado pela direita, e writingMode: 'vertical-rl' compõe o texto de cima para baixo. A mancha aqui inclui a faixa dos comentários, por isso os “quatro caracteres abaixo do alto” são medidos a partir do topo dos comentários vermelhos. trad-chinese-informal imprime os fólios de 一 a 六.

#4 · Carregue cada voz com o texto que ela compõe

script.js · linhas 246–258no código completo
// Song sets the whole sample and its bold only 第一回, Kai the head-margin comments and
// the edition's note, Hei the running heads, the folios and the colophon
// (gotcha: cjk-fonts-slices).
const blocks = (style) => [...markdown.matchAll(
  new RegExp(`:::(?:callout|paragraphs)\\{[^}]*"${style}"[^}]*\\}\\n([^]*?)\\n:::`, 'g'))]
  .map((m) => m[1]).join('');
const numerals = '一二三四五六七八九十';
await loadFonts(FONTS, markdown);
await loadCjkFonts({ [SONG]: ['400'] }, markdown, { vertical: true });
await loadCjkFonts({ [SONG]: ['700'] }, '第一回'); // the bold weight sets three characters
await loadCjkFonts({ [KAI]: FONTS[KAI] }, blocks('meipi') + blocks('note'), { vertical: true });
await loadCjkFonts({ [HEI]: FONTS[HEI] }, `脂硯齋重評石頭記第一回${numerals}${blocks('colophon')}`,
  { vertical: true });

O Fontsource serve cada fonte chinesa em cerca de cem arquivos por peso. A Song compõe a amostra inteira no peso regular e só 第一回 em negrito; a Kai, só os comentários da margem superior e a nota da edição; e a Hei, só os cabeços, os fólios e o colofão, por isso cada chamada baixa os arquivos de que os próprios caracteres precisam. vertical: true carrega também a pontuação vertical de cada fonte para o canvas.

#5 · Duas tintas

script.js · linhas 18–31no código completo
const palette = {
  ink: '#231d18', // the text: a warm black
  vermilion: '#b0362a', // 朱: every comment, the chapter's kicker; 5.5 : 1 on the paper
  rule: '#b9a78f', // the line under the head margin
  muted: '#6f6356', // folios, the colophon
  paper: '#f7f1e3',
};
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' } })),
  // The engine's defaults link to main-color: aimed at the vermilion, nothing prints blue.
  { id: 'main-color', name: 'vermilion (defaults)',
    value: { hex: palette.vermilion, model: 'hex' } },
];

A página é impressa em duas cores, como o manuscrito foi escrito: um preto quente para o texto e um vermelhão para cada comentário, o antetítulo do capítulo e nada mais. O vermelhão tem contraste de 5,5 : 1 com o papel, o bastante para as fileiras de 6 pt dos comentários laterais. main-color aponta para ele, de modo que qualquer valor padrão que a configuração não redefine sai vermelho, nunca azul.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 078 · Red-ink commentary in the line and the head margin ═══
// https://postext.dev/en/cookbook/red-ink-commentary
// Code: MIT · Text: 脂硯齋重評石頭記, Jiaxu manuscript, Wikisource (CC BY-SA 4.0) · Pictures: none
// Fonts: Noto Serif TC, LXGW WenKai TC, Noto Sans TC (SIL OFL 1.1) · Needs postext ≥ 1.28.0
// The first chapter of the Stone as a commentary edition: the text set vertically, the
// comments the manuscript writes beside the columns folded into two small red rows inside
// the line, the head-margin comments in red Kai above the columns they gloss.
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 sample document ('en' | 'es')
const RECIPE = 'red-ink-commentary';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black ink and vermilion on a warm paper
const palette = {
  ink: '#231d18', // the text: a warm black
  vermilion: '#b0362a', // 朱: every comment, the chapter's kicker; 5.5 : 1 on the paper
  rule: '#b9a78f', // the line under the head margin
  muted: '#6f6356', // folios, the colophon
  paper: '#f7f1e3',
};
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' } })),
  // The engine's defaults link to main-color: aimed at the vermilion, nothing prints blue.
  { id: 'main-color', name: 'vermilion (defaults)',
    value: { hex: palette.vermilion, model: 'hex' } },
];
// #endregion
const [SONG, KAI, HEI] = ['Noto Serif TC', 'LXGW WenKai TC', 'Noto Sans TC']; // 宋, 楷, 黑
const BODY = 12; // pt, 小四: the notes fold to two rows of 6 pt in the same em
const LEAD = 21; // pt between columns, 1.75 × the body

// #region answer: side comments inside the line, head-margin comments above it
const layout = {
  writingMode: 'vertical-rl', // columns down the page, read from the right; bound on the right
  layoutType: 'oneAndHalf', // a text tier and a narrow tier for the comments
  sideColumnRole: 'floats', // no text runs into it: only boxes fenced with span="side"
  sideColumnSide: 'left', // in vertical text 'left' is the top tier: the head margin (天頭)
  sideColumnPercent: 19, // the grid rounds it to 10 characters of the body, 42 mm
  gutterWidth: mm(8), // rounded to 2 characters
  columnRule: { enabled: true, lineWidth: pt(0.5), color: col('rule') },
};
const cjk = {
  grid: { enabled: true, charsPerLine: 36, linesPerPage: 18 }, // 版心: 36 字 × 18 行

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

#Imprima os comentários numa só tinta

Para uma impressão em uma cor, componha as notas em preto entre colchetes e os comentários da margem superior na tinta apagada; os colchetes saem no corpo do texto corrido, antes da primeira fileira da nota e depois da última.

-  warichu: { color: col('vermilion') },
+  warichu: { color: col('ink'), open: '〔', close: '〕' },
-  body: { fontFamily: KAI, fontSize: pt(7), lineHeight: pt(10), color: col('vermilion'),
+  body: { fontFamily: KAI, fontSize: pt(7), lineHeight: pt(10), color: col('muted'),

#Compare com uma edição em alfabeto latino

A mesma técnica numa página horizontal é o clássico anotado com glosas na margem: a coluna lateral fica na borda externa (sideColumnSide: 'outer'), e cada glosa fica ao lado do parágrafo que explica em vez de acima dele.

Erros comuns

Erro comum

Um boxe lateral começa na altura do bloco que vem depois do seu delimitador

No postext 1.4.1, um boxe com span: 'side' fica na coluna lateral na altura a que o texto chegou no seu delimitador, na linha seguinte da grade e abaixo dos boxes que já estiverem ali. Abra o delimitador de uma glosa logo antes do parágrafo que ela explica: se vier depois, a glosa começa ao lado do parágrafo seguinte. Um boxe que passaria do pé da coluna sobe até seu pé coincidir com o da coluna, se o boxe de cima permitir; se mesmo assim não couber, espera pela coluna lateral da página seguinte. Notas na margem →

Erro comum

Em texto vertical, a coluna lateral é um andar, e 'left' é o de cima

Com layout.writingMode 'vertical-rl', a página é uma página horizontal girada um quarto de volta, então a coluna lateral de um layout oneAndHalf vira um andar que atravessa a página: sideColumnSide 'left' a coloca no alto, onde ficam os comentários da margem superior (眉批), e 'right' no pé. 'outer' e 'inner' são lidos como 'right' e 'left' (um andar não tem borda externa), então o 'outer' da coluna de notas de um livro didático manda as notas para o pé. sideColumnPercent é uma fração da altura da página. Coluna de margem para flutuantes →

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

Marque o documento como zh-Hans ou zh-Hant, não com LANG

As edições de uma receita são en e es, mas uma amostra chinesa é chinesa nas duas: `locale: LANG` a marcaria como inglês ou espanhol, hifenizaria as suas palavras latinas, chamaria as suas figuras de Figure ou Figura e daria ao PDF o idioma errado. 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, sob uma marcação inglesa ou espanhola, uma fonte chinesa compõe com outras formas os algarismos e a pontuação que divide com o texto latino, e as linhas quebram em outro ponto. Escreva você mesmo a marcação: 'zh-Hans' (convenções da China continental: quebra de linha GB, pontuação Kaiming) ou 'zh-Hant' (Taiwan: pontuação de largura inteira centralizada); 'zh-HK' para Hong Kong. Um 'zh' sozinho é lido como chinês simplificado continental. Uma amostra japonesa leva 'ja' (armadilha ja-locale-tag). Quebra de linha em chinês →

  • Um comentário da margem superior fica na altura da coluna a que o texto chegou no delimitador, por isso o delimitador vai logo antes do trecho que ele discute; posto depois, o comentário começa ao lado do parágrafo seguinte. Um delimitador fica entre dois blocos, nunca dentro de um parágrafo, por isso, quando o manuscrito comenta uma frase no meio de um parágrafo longo, esta edição quebra o parágrafo ali: antes de 石頭聽了, antes de 廟傍住着 e uma vez dentro da fala da pedra, antes de 竟不如我, onde o novo parágrafo abre de novo com 「, como faz uma citação que se estende por dois parágrafos.
  • A faixa comporta o que a página comporta. Um comentário longo demais para o que resta dela volta para a direita até que a última coluna encontre a borda esquerda do texto, e um que ainda assim não caiba espera a página seguinte, junto com todos os comentários delimitados depois dele. Cada comentário começa numa coluna do texto e deixa uma coluna do corpo livre depois do anterior. Os três comentários do manuscrito sobre a fala da pedra ocupam onze colunas da faixa: com o delimitador antes de 今之人, onde a transcrição os põe, o último deles, 斯亦太過, esperava a página 5 e empurrava um passo adiante os comentários de lá. Esta edição quebra a fala uma frase antes, antes de 竟不如我, e os três ficam na página 4.
  • A grade enche cada página com as 18 colunas sem nenhum ajuste: numa grade de caracteres avoidWidows vem desativado, por isso um parágrafo pode abrir na última coluna de uma página. Ativado, ele passaria esse parágrafo inteiro para a seguinte, a página terminaria com uma coluna a menos e um comentário delimitado antes do parágrafo ficaria para trás. avoidOrphans continua ativado, como uma grade chinesa o tem por padrão: a última coluna de um parágrafo sozinha no alto de uma página (孤行) é o que um editor chinês evita.
  • Dois comentários laterais escritos um logo depois do outro se dobram em fileiras que se leem como uma só nota. O Markdown mantém um espaço ideográfico (U+3000) entre eles.
  • A Noto Serif TC não tem glifo para algumas formas do manuscrito, como 縂, 竒 e 数. O canvas as preenche com uma fonte do sistema, e o PDF as deixa em branco e as lista em C25. Esta edição usa as formas padrão e mantém as variantes que as fontes têm.

Créditos

Texto
  • 脂硯齋重評石頭記 (The Story of the Stone, re-annotated by Zhiyan Zhai), Jiaxu manuscript (1754), chapter 1 from its opening to the Zhen household, with the commentary; Wikisource transcription, revision 2644544 · Cao Xueqin and Zhiyan Zhai; transcription by Wikisource editors · CC BY-SA 4.0
  • The note on this edition (本編說明) and the paragraph breaks added for the head-margin comments · Ignacio Ferro · CC BY 4.0
Fontes
Noto Serif TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1)
SandboxPDF