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

Receitas · Capítulo 1 · Página e grade

Uma folha xilográfica: moldura dupla, fios e faixa central

O comentário de Zhu Xi aos Analectos como uma matriz de madeira o imprimia: uma folha por página dupla, moldura dupla, fios e a faixa central na dobra.

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 120,8 × 213,1 mm
  • 1 coluna
  • Noto Serif TC 20/29
  • LXGW WenKai TC
  • 7 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 65 ms
  • 178 linhas de código

Em poucas palavras

Um clássico chinês composto como os antigos livros impressos com matrizes de madeira. Cada página tem uma borda dupla e linhas finas entre as colunas, e as notas vão em letra miúda dentro das linhas.

O que você vai compor

Três folhas do comentário de Zhu Xi aos Analectos (論語集註), o começo do livro 學而, compostas como uma matriz de madeira as imprimia, depois de uma folha de rosto. Cada página é meia folha, de 121 × 213 mm, e cada página dupla é uma folha inteira, lida a partir da direita: em cada metade, nove colunas de 17 caracteres em Noto Serif TC de 20 pt, uma moldura dupla, um fio fino entre cada duas colunas e, na dobra, a faixa central (版心) com o título, um rabo de peixe preto, o juan e o número da folha. As notas de Zhu Xi se dobram em duas fileiras de caracteres de 10 pt dentro da coluna, depois das palavras que explicam. A margem superior é o dobro da inferior.

Esta receita responde a

  • Como diagramo uma folha xilográfica, com moldura dupla, um fio entre as colunas e a faixa central?
  • Como defino a mancha em caracteres, tantos por linha e tantas linhas por página?
  • Como componho um livro chinês na vertical, encadernado à direita?

A resposta curta

script.js · linhas 46–64no código completo
// A block printed both halves of a leaf (葉) at once, the centre strip between them. Each
// page here is a half-leaf. Page 1, the title, is a recto: in a book bound on the right it
// stands alone left of the spine, and every spread after it is one leaf, read from the
// right. The grid sets the block's 9 columns of 17 characters; the text has no
// punctuation, so every column ends on its 17th character.
const page = {
  sizePreset: 'custom', width: pt(W), height: pt(H), dpi: 150,
  backgroundColor: col('paper'),
  // left is the inner margin, the half of the centre strip on this side of the fold
  margins: { top: pt(TOP), bottom: pt(BOTTOM), left: pt(HALF), right: pt(OUTER), mirror: true },
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' }; // bound on the right
const cjk = { grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES } };
// Postext numbers pages, not leaves. Each leaf opens with a hidden level-1 heading, which
// prints nothing and starts a right-hand page; the centre strip prints their count.
const leaf = {
  level: 1, hidden: true, numberingTemplate: '{1:一}', // 一, 二, 三
  breakBefore: { enabled: true, parity: 'even' }, // even pages lie on the right in this binding
};

Ingredientes

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

Preparo

#1 · Meia folha por página, uma folha por página dupla

O código é a resposta curta acima. Uma matriz imprimia a folha (葉) inteira de uma vez, com as duas metades de cada lado da faixa central; o impressor dobrava o papel na faixa, com o lado impresso para fora, e costurava as bordas abertas, de modo que a faixa virava o corte da frente do livro. Estas páginas ficam como a folha saía da matriz. Cada página é meia folha. Num livro encadernado pela direita, a página 1 fica sozinha à esquerda da lombada e cada página dupla seguinte junta uma página par à direita com a ímpar que vem depois, por isso, com a folha de rosto na página 1, cada página dupla contém uma folha. A grade de caracteres define o 行款 da matriz, nove colunas de 17 caracteres, e as margens que ela deixa são exatas: a interna mede metade da faixa.

O Postext numera páginas, não folhas. Cada folha abre com um título de nível 1 oculto: ele não imprime nada nem ocupa espaço, mas o breakBefore com parity: 'even' abre uma página direita, e o número, 一, 二, 三 por numberingTemplate: '{1:一}', é o {chapterNumber} da faixa.

#2 · Cortar o texto onde cada folha termina

O copista que passava um texto a limpo para o entalhador o ajustava à matriz, folha por folha. O Markdown faz o mesmo: o título de uma folha vai onde termina a nona coluna da metade esquerda da folha anterior, mesmo no meio de uma frase ou de uma nota. Uma nota cortada ali é fechada e aberta de novo, e como cada coluna dobra o próprio trecho de nota em duas fileiras, as fileiras saem como eram:

子曰巧言令色鮮矣仁:warichu[巧好令善也好其言善其色致飾於]
 
# 學而
 
:warichu[外務以悦人則人欲肆而本心之德亡矣…]

A matriz não tem pontuação, por isso nenhuma regra de quebra de linha move um caractere, e toda coluna termina no 17º: as quebras de folha são contadas uma vez e não saem do lugar. As notas de Zhu Xi são trechos :warichu[…] com metade do corpo, o padrão, 34 caracteres pequenos por fileira, com um ○ entre a leitura e a glosa, como na matriz.

#3 · Desenhar a matriz com os números da grade

script.js · linhas 68–113no código completo
// Header elements are placed on the sheet, pt from the page's top left corner. Both halves
// read right to left: a right-hand page (even) from the outer frame to the fold, a
// left-hand page (odd) from the fold to the outer frame.
const at = (x, y) => ({ anchor: { to: 'page', edge: 'top-left' }, offset: { x: pt(x), y: pt(y) } });
// A column of characters stands in the middle of its pitch, so the rules between columns
// fall on whole pitches. The k-th, counted from the right edge of the type area:
const line = (parity, k) =>
  (parity === 'even' ? HALF + LINES * PITCH : W - HALF) - k * PITCH;
const [Y0, Y1] = [TOP - GAP, TOP + CHARS * BODY + GAP]; // the inner frame's top and foot
// A rule is drawn from its x, a box's border inside the box: each is set so that the line
// is centred where it belongs.
const rule = (id, x, parity) => ({ kind: 'rule', id, parity, direction: 'vertical',
  thickness: pt(0.6), color: col('rule'),
  placement: { ...at(x - 0.3, Y0), size: { height: pt(Y1 - Y0) } } });
const frame = (id, [x0, x1], parity) => [[RULES, 1.8], [0, 0.6]].map(([out, t], i) => ({
  kind: 'box', id: `${id}-${i}`, parity, style: { borderColor: col('rule'), borderWidth: pt(t) },
  placement: { ...at(x0 - out - t / 2, Y0 - out - t / 2),
    size: { width: pt(x1 - x0 + 2 * out + t), height: pt(Y1 - Y0 + 2 * out + t) } } }));
// The middle of the strip, where its text stands: the fold, halfway between its two rules.
// Both pages draw the text whole, and each shows its half.
const mid = (parity) => (parity === 'even' ? 0 : W);
const strip = (id, content, parity, y) => ({ kind: 'text', id: `${id}-${parity}`, parity,
  content, writingMode: 'vertical-rl', fontFamily: SONG, fontSize: pt(11), color: col('ink'),
  align: 'left', overflow: 'clip',
  placement: { ...at(mid(parity) - HALF, TOP + y),
    size: { width: pt(2 * HALF), height: pt(CHARS * BODY - y) } } });
// The fish tail (魚尾): a black band with a notch, from one side of the strip to the other.
const FISH = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 18">
  <path d="M0 0H32V13L16 6L0 13Z" fill="${palette.rule}"/></svg>`;
const resources = [{ id: 'fish', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
  svg: { fileId: 'fish.svg', width: 32, height: 18 } }];
const fish = (parity) => ({ kind: 'image', id: `fish-${parity}`, parity, resourceId: 'fish',
  decorative: true, placement: { ...at(mid(parity) - HALF + 0.3, TOP + 3.4 * BODY),
    size: { width: pt(2 * HALF - 0.6), height: 'auto' } } });
const furniture = (parity) => [
  // The frame runs 40 pt past the fold, where the other half of the leaf takes it on.
  ...frame(`frame-${parity}`, parity === 'even' ? [-40, line(parity, 0)]
    : [line(parity, LINES), W + 40], parity),
  // Nine rules: eight between the columns (界行) and the side of the strip.
  ...Array.from({ length: LINES }, (_, i) =>
    rule(`rule-${i}-${parity}`, line(parity, parity === 'even' ? i + 1 : i), parity)),
  strip('book', '{title}', parity, 0.7 * BODY), // 書名, above the fish tail
  fish(parity),
  strip('juan', '卷一', parity, 5.2 * BODY), // 卷次, under it
  strip('leaf', '{chapterNumber}', parity, 11.5 * BODY), // 葉碼, the leaf's number
];

O cabeço é disposto sobre a folha de papel, de modo que a moldura, os fios e a faixa são posicionados em pontos a partir do canto da página com os mesmos números que definem a grade: um elemento de fio a cada 29 pt na largura da mancha, uma caixa a 4,5 pt do texto para a linha fina e outra 4,5 pt mais para fora para a grossa. Cada coluna de caracteres fica no meio do passo, por isso os fios caem a meio caminho entre as colunas. O texto da faixa desce a página em elementos de texto vertical, e o rabo de peixe é um SVG num elemento de imagem, os dois centralizados entre os dois fios da faixa, sobre a dobra: cada página mostra 17 pt da faixa. Cada página desenha inteiros o texto da faixa e o rabo de peixe e mostra a parte do lado, e lado a lado as partes se encontram. As molduras passam da dobra pelo mesmo motivo.

#4 · Dar à folha de rosto um estilo próprio

script.js · linhas 117–143no código completo
// A heading style of its own: hidden and unnumbered, so the leaves still count from 一, and
// its header replaces the leaves' furniture on its page. Its attributes hold the byline,
// this edition's note in red and the colophon, the one line that changes with the language.
const CELLS = [0, 2, LINES - 2, LINES]; // the byline, title and note, in pitches from the right
const cell = (i) => [CELLS[i], CELLS[i + 1]];
const column = (id, content, [k0, k1], style) => ({ kind: 'text', id, content,
  writingMode: 'vertical-rl', color: col('ink'), overflow: 'clip', verticalAlign: 'middle',
  placement: { ...at(line('odd', k1), TOP),
    size: { width: pt((k1 - k0) * PITCH), height: pt(CHARS * BODY) } }, ...style });
const titlePage = {
  id: 'title', numbered: false, hidden: true, breakBefore: { enabled: true, parity: 'any' },
  footer: { elements: [] },
  header: { elements: [
    ...frame('title-frame', [line('odd', LINES), line('odd', 0)]),
    rule('title-rule-1', line('odd', CELLS[1])), rule('title-rule-2', line('odd', CELLS[2])),
    column('byline', '{attr.byline}', cell(0), { fontFamily: SONG, fontSize: pt(14),
      align: 'left' }),
    column('book', '{title}', cell(1), { fontFamily: KAI, fontSize: pt(60),
      letterSpacing: pt(20), align: 'center' }),
    column('note', '{attr.note}', cell(2), { fontFamily: KAI, fontSize: pt(11),
      lineHeight: pt(0.6 * PITCH), color: col('vermilion'), align: 'right' }), // 3 in 2 pitches
    { kind: 'text', id: 'colophon', content: '{attr.colophon}', fontFamily: SONG,
      fontSize: pt(6.5), lineHeight: 1.4, color: col('muted'), align: 'left', overflow: 'wrap',
      placement: { ...at(line('odd', LINES) - RULES - 0.9, Y1 + RULES + 16),
        size: { width: pt(LINES * PITCH) } } },
  ] },
};

A folha de rosto (內封) é um título de nível 1 com um estilo de título oculto e sem número, por isso as folhas continuam contando a partir de 一. Um estilo governa as páginas da seção, e o header dele substitui ali o do documento: a folha de rosto ganha uma moldura fechada dividida em três colunas em vez dos elementos da meia folha. A autoria, a nota desta edição em Kai vermelho e o colofão vêm dos atributos do título; o colofão é a única linha que muda com a língua da edição. \n num atributo começa uma coluna nova.

#5 · Carregar cada fonte com os caracteres que ela compõe

script.js · linhas 200–205no código completo
// Song sets the leaves, the strip and its leaf numbers; Kai only the title page's title
// and note (gotcha: cjk-fonts-slices). No punctuation: no vertical forms to load.
const note = markdown.match(/note="([^"]*)"/)?.[1].replaceAll('\\n', '') ?? '';
await loadFonts(FONTS, markdown); // their Latin files: the colophon
await loadCjkFonts({ [SONG]: FONTS[SONG] }, `${markdown}論語集註卷一二三四五六七八九十`);
await loadCjkFonts({ [KAI]: FONTS[KAI] }, `論語集註${note}`);

O Fontsource serve cada fonte chinesa em cerca de cem arquivos por peso. A Song compõe as folhas, a faixa e os números de folha, de modo que a chamada dela recebe a amostra e esses caracteres; a Kai compõe só o título e a nota. A matriz não tem pontuação, por isso nenhuma das duas precisa das formas verticais de loadCjkFonts(…, { vertical: true }).

#6 · Uma tinta sobre um papel quente

script.js · linhas 19–30no código completo
const palette = {
  ink: '#1f1b17', // the text, as the block printed it
  rule: '#1f1b17', // the frame, the column rules and the fish tail: the same block, same ink
  vermilion: '#a3301f', // 朱: this edition's note, on the title page; 5.9 : 1 on the paper
  muted: '#6d6358', // the colophon
  paper: '#f2ead8',
};
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.ink, model: 'hex' } },
];

O texto e as linhas da matriz são impressos no mesmo preto quente, com contraste de 14 : 1 sobre o papel. Mesmo assim são duas entradas da paleta, ink e rule, para que os fios possam mudar de cor sem mexer no texto. O vermelho fica reservado para o que esta edição acrescenta.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 085 · A woodblock leaf: double frame, rules and centre strip ═══
// https://postext.dev/en/cookbook/woodblock-leaf
// Code: MIT · Text: 論語集註 卷一, 四庫全書 copy, zh.wikisource (CC BY-SA 4.0) · Pictures: none
// Fonts: Noto Serif TC, LXGW WenKai TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// A title page and three leaves of Zhu Xi's commentary on the Analects, set as a woodblock
// printed them: each spread is one leaf, its two halves either side of the centre strip
// (版心), the text in a double frame with a rule between every two columns, the commentary
// folded into two small rows inside the column.
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'en'; // @lang: the language of the colophon; the leaves are Chinese in both
const RECIPE = 'woodblock-leaf';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: one ink on a warm paper, and a red for the editor's note
const palette = {
  ink: '#1f1b17', // the text, as the block printed it
  rule: '#1f1b17', // the frame, the column rules and the fish tail: the same block, same ink
  vermilion: '#a3301f', // 朱: this edition's note, on the title page; 5.9 : 1 on the paper
  muted: '#6d6358', // the colophon
  paper: '#f2ead8',
};
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.ink, model: 'hex' } },
];
// #endregion
const [SONG, KAI] = ['Noto Serif TC', 'LXGW WenKai TC']; // 宋: the block's face; 楷: the title
// The leaf in points: 半葉九行,行十七字, a 20 pt character on a column pitch of 29 pt.
const [BODY, PITCH, CHARS, LINES] = [20, 29, 17, 9];
const HALF = 17; // half the centre strip, from the fold to the column rule beside it
const GAP = 4.5; // the text to the inner frame line, as a character to a column rule
const RULES = 4.5; // the thin inner frame line to the heavy outer one (文武線)
const [HEAD, FOOT, SIDE] = [164, 82, 60]; // paper outside the frame: 天頭 twice 地腳
const TOP = HEAD + RULES + GAP; // the page's margins
const BOTTOM = FOOT + RULES + GAP;
const OUTER = SIDE + RULES;
const W = HALF + LINES * PITCH + OUTER; // a half-leaf, 121 × 213 mm
const H = TOP + CHARS * BODY + BOTTOM;

// #region answer: a half-leaf to a page, so that every spread is one whole leaf
// A block printed both halves of a leaf (葉) at once, the centre strip between them. Each
// page here is a half-leaf. Page 1, the title, is a recto: in a book bound on the right it
// stands alone left of the spine, and every spread after it is one leaf, read from the

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

#Pautar as colunas em vermelho

As cópias feitas para o 四庫全書 foram escritas em papel pautado em vermelho (朱絲欄). Mude a cor dos fios; o rabo de peixe acompanha.

-  rule: '#1f1b17', // the frame, the column rules and the fish tail: the same block, same ink
+  rule: '#b3412e', // 朱絲欄: red rules under black text

#Entalhar outra matriz

As matrizes tinham muitas contagens, e 半葉十行,行二十字 é uma das mais comuns. As molduras, a faixa, as três casas da folha de rosto e o recuo da autoria saem todos destes números, por isso se ajustam sozinhos; as quebras de folha no Markdown precisam ser contadas de novo.

-const [BODY, PITCH, CHARS, LINES] = [20, 29, 17, 9];
+const [BODY, PITCH, CHARS, LINES] = [17, 24.5, 20, 10];

#Comparar com uma página europeia sobre uma grade

Uma página de livro sobre a grade de linhas de base constrói a mancha a partir de uma contagem de linhas, como esta folha constrói a sua com colunas e caracteres; o diploma desenha a borda no cabeço de um estilo de título, como a folha de rosto aqui.

Erros comuns

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 →

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

Transcrições em chinês tradicional trazem caracteres simplificados soltos

Textos copiados do Wikisource ou de outra edição na web de um livro em chinês tradicional às vezes trazem uma forma simplificada (颙 no lugar de 顒 no capítulo 1 de 三國演義), e uma fonte TC como a Noto Serif TC pode não tê-la. loadCjkFonts interrompe a receita e informa o caractere na mensagem; na página, ele sairia em uma fonte substituta. Restaure a forma tradicional na amostra e registre isso nos créditos. Fontes chinesas, japonesas e coreanas →

  • As quebras de folha moram no Markdown. Se você mudar o texto, o corpo ou o 行款, uma folha que transborda empurra o título seguinte uma página adiante, e as páginas duplas deixam de coincidir com as folhas; uma que fica curta deixa colunas em branco antes da dobra. Confira a última coluna de cada página esquerda.
  • A transcrição do 四庫全書 digita 巳 tanto por 已 quanto por 己; esta amostra decide cada caso pela frase. A página ainda pede revisão contra os fac-símiles, e isso aparece: o comentário de 張敬夫 traz 必開其政 onde os Analectos, que ele repete, trazem 必聞其政, e dois caracteres vêm como imagens do glifo. A amostra compõe 聞, 傳 e 邦. Confira um trecho com uma segunda edição antes de compô-lo.
  • A mesma transcrição traz formas para as quais a Noto Serif TC não tem glifo (廹 徳 絶 逺 専 内). Cinco delas caem dentro da faixa de um arquivo do Fontsource, de modo que loadCjkFonts as deixa passar, e aí o canvas as desenha com uma fonte do sistema e o postext-pdf imprime uma caixa vazia e avisa. 廹 não cai na faixa de nenhum arquivo, e loadCjkFonts para com um erro. A amostra compõe 迫 德 絕 遠 專 內.

Créditos

Texto
  • 論語集註 (Collected Commentaries on the Analects), juan 1, the book 學而 from its opening to the end of its tenth section, in the copy made for the 四庫全書 (Siku quanshu, 1773–1782); Wikisource transcription, revision 523110. 巳 is read as 已 or 己 by its sentence; 開 in 張敬夫's 必開其政 is corrected to 聞, as in the words of the Analects he repeats and in Wikisource's other edition (論語集注卷一, revision 2598582); the two characters the transcription gives as glyph images are set as 傳 (以忠信為傳習之本) and 邦 (夫子至於是邦也); and six variant forms Noto Serif TC does not draw (廹 徳 絶 逺 専 内) are set in their standard forms · Zhu Xi (1130–1200); transcription by Wikisource editors · CC BY-SA 4.0
  • The title page, the division into leaves and the note on this edition (據四庫全書本錄文…) · Ignacio Ferro · CC BY 4.0
Fontes
Noto Serif TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
SandboxPDF