Em poucas palavras
Páginas de amostra de um clássico da história chinesa. Mostra como marcar nomes com uma linha reta vermelha e títulos de livros com uma linha ondulada, em texto vertical e horizontal.
O que você vai compor
Três páginas de amostra para uma antologia dos Registros do Grande Historiador, no formato de 140 × 203 mm de um livro chinês 大32開. O trecho é o começo dos Anais básicos de Xiang Yu com a pontuação completa de uma edição de clássicos: uma linha reta ao lado de cada pessoa, lugar, Estado e dinastia, e uma linha ondulada ao lado de cada título de livro ou de capítulo, as duas em vermelhão. A página 1 traz a apresentação e as convenções do editor em letra Kai. As páginas 2 e 3 compõem duas vezes o mesmo Markdown, na vertical e na horizontal, e a página dupla mostra onde vai cada marca: à esquerda do nome nas linhas verticais, embaixo dele nas horizontais. O livro é encadernado pela direita, e uma faixa anil leva cada título. A receita Nº 044, Lycidas no texto de 1645, destaca os nomes à maneira europeia, em itálico.
Esta receita responde a
- Como marco nomes próprios e títulos de livros em texto chinês com uma linha reta e uma ondulada?
- Por que a ênfase do meu texto chinês sai inclinada, e o que devo usar no lugar?
- Como componho um livro chinês na vertical, encadernado à direita?
A resposta curta
// :name[項梁] draws the proper-name line, :book[史記] the book-title mark, :dots[…] dots.
const cjk = {
bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
annotationColor: col('mark'), // unset, the marks print in the colour of the text
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
};
// The book runs down the page, bound on the right: the lines stand left of the names.
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
// # 項羽本紀 {style="across"} sets the same Markdown across the page, 28 characters to
// the line: the lines run under the names. Its margins set its grid; the book's grid
// counts down the page.
const MEASURE = 28 * SIZE * PT; // mm
const across = {
id: 'across',
layout: { layoutType: 'single', writingMode: 'horizontal-tb' },
margins: { top: mm(SIDE), bottom: mm(H - SIDE - 25 * LEAD * PT), // 25 lines
left: mm((W - MEASURE) / 2), right: mm((W - MEASURE) / 2) },
};
Ingredientes
- Funcionalidades
- Pontos de ênfase e linhas de nome e de títuloTexto verticalLivros encadernados pela direitaLargura da pontuação chinesaQuebra de linha em chinêsGrade de caracteresFontes chinesas, japonesas e coreanasFontes incorporadas ao PDFExportação para PDFNumeração chinesaEstilos de títuloGeometria por seçãoAberturas desenhadasFaixa de capítulo em largura totalAtributos de títuloListas numeradasRecuos, alinhamento e espaço entre parágrafosEstilos de parágrafoPaleta de cores semântica
- Tipografia
- Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · A marcação põe as marcas; a direção da escrita escolhe o lado
O código é a resposta curta logo acima. :name[項梁] e :book[史記] mantêm seus caracteres no texto, por isso a busca, o texto copiado e o PDF leem 項梁 e 史記, e acrescentam as marcas ao lado (Marcas chinesas, rubi e warichu). Só a direção da escrita decide o lado: layout.writingMode: 'vertical-rl' põe as linhas à esquerda dos caracteres, e o estilo de título across, cuja disposição é 'horizontal-tb', as põe embaixo. bookTitleMark: 'wavy' é o que um documento zh-Hant recebe por padrão; fica escrito porque, numa troca para zh-Hans, os títulos sairiam entre 《》. Quando duas marcas do mesmo tipo se encostam, como em 東漢班固 ou 史記項羽本紀, cada uma cede um oitavo de eme na ponta em que se encontram, e as linhas se leem como dois nomes.
#2 · Uma entrelinha com espaço para as marcas
const [SONG, HEI, KAI] = ['Noto Serif TC', 'Noto Sans TC', 'LXGW WenKai TC']; // 宋, 黑, 楷
const PT = 25.4 / 72; // mm in a point
const [W, H] = [140, 203]; // mm: 大32開
const SIZE = 10.5; // pt: 五號
// A gap of 7.5 pt (0.71 em) between lines: a line of marks needs half an em of it, dots on
// one side and lines on the other five eighths. At 15 pt the build reports every marked
// paragraph (cjkMarksExceedLeading: gap 0.43 em).
const LEAD = 18; // pt
const [CHARS, LINES] = [42, 17]; // the vertical grid: characters down a line, lines across
const SIDE = (W - LINES * LEAD * PT) / 2; // mm: the side margins of a vertical page
As marcas ficam no vão entre as linhas e nunca mudam o passo da linha (Marcas, rubi e warichu). Com 10,5 pt sobre 18 pt, o vão é de 0,71 eme, e nele cabem as linhas de nome de uma coluna e os pontos da seguinte, como na quinta convenção da página 1. A grade conta a página em caracteres, 42 ao longo de cada linha e 17 linhas no sentido transversal, e desloca as margens para que a mancha meça exatamente isso: 25,7 mm de margem no alto e 21,7 mm no pé (Grade de caracteres).
#3 · Uma abertura que gira com a página
// The grid centres the text between the minimum margins; the band stops at its foot.
const FOOT = 20 + (H - 24 - 20 - CHARS * SIZE * PT) / 2; // mm, with minimums of 24 and 20
const BAND = SIDE + 3.5 * LEAD * PT; // mm from the trim, which is the right edge down the page
const onBand = { align: 'left', overflow: 'wrap' }; // design text centres and cuts by default
const next = (id, y) => ({ anchor: { to: `#${id}`, edge: 'below' }, offset: { y: mm(y) } });
const opener = {
enabled: true,
minHeight: pt(4 * LEAD), // the text starts on the fifth line, half a line clear of the band
slot: { elements: [
// Across the page the band's length runs past the trim; down it, it ends at the text's
// foot, clear of the folio.
{ kind: 'box', id: 'band', style: { backgroundColor: col('band') },
placement: { anchor: { to: 'bleed', edge: 'top-left' },
size: { width: mm(H - FOOT), height: mm(BAND) } } },
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', ...onBand, fontFamily: HEI,
fontWeight: 700, fontSize: pt(8), letterSpacing: pt(1.6), color: col('tint'),
placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(6 - SIDE) } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: SONG,
fontWeight: 700, fontSize: pt(46), lineHeight: 1, letterSpacing: pt(3),
color: col('paper'), placement: next('kicker', 2) },
{ kind: 'text', id: 'byline', content: '{attr.byline}', ...onBand, fontFamily: KAI,
fontSize: pt(10), color: col('tint'), placement: next('title', 2) },
] },
};
O design de um título é diagramado no fluxo da página, de modo que um mesmo conjunto de elementos serve às duas direções (Escrita vertical). Ancorada ao canto superior esquerdo da sangria, a faixa atravessa o alto da página horizontal e desce pela borda direita das verticais, onde a leitura começa. O antetítulo, o título e o autor também se empilham no fluxo: um embaixo do outro na horizontal, um à esquerda do outro na vertical. O comprimento da faixa é medido ao longo do fluxo: 181,3 mm a fazem parar no pé do texto vertical, longe do fólio, e na página horizontal passam do refile.
#4 · Fólios para um livro encadernado pela direita
const foot = (id, content, parity, edge, x, extra) => ({ kind: 'text', id, content, parity,
fontFamily: HEI, fontSize: pt(7), color: col('muted'), ...extra,
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(-11) } } });
const folio = { fontFamily: SONG, fontSize: pt(9) };
// Bound on the right, a recto (odd) lies left of the spine: its outer edge is its left one.
const footer = { elements: [
foot('folio-odd', '{pageNumber}', 'odd', 'bottom-left', SIDE, folio),
foot('folio-even', '{pageNumber}', 'even', 'bottom-right', -SIDE, folio),
foot('slug', '{attr.slug}', 'all', 'bottom', 0, { letterSpacing: pt(0.4) }),
] };
O texto vertical encaderna o livro pela direita (Encadernação): a página 1 fica à esquerda da lombada, e a borda externa de uma página ímpar é a esquerda. O fólio ímpar vai embaixo à esquerda e o par embaixo à direita, ao contrário de um livro ocidental, e pageNumbering.format: 'trad-chinese-informal' os imprime como 一, 二, 三. A linha de identificação entre os dois vem de um atributo de cada título, slug="…"; junto com o colofão, é tudo o que muda entre a edição inglesa e a espanhola.
#5 · Uma segunda tinta
const palette = {
ink: '#221e1b', // the text
band: '#23394b', // the opener band and the small heads
mark: '#b5412c', // the name, title and emphasis marks: the second ink
tint: '#c7d2da', // kickers and bylines on the band
muted: '#6f6a64', // folios, slug lines, the colophon
paper: '#ffffff',
};
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: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];
Uma edição de clássicos imprime as marcas na tinta do texto. Uma antologia escolar pode imprimi-las numa segunda cor, para que se destaquem dos traços dos caracteres: annotationColor as liga à entrada mark da paleta, o vermelhão dos comentários em tinta vermelha, e uma única mudança nessa entrada muda o tom de todas as linhas e de todos os pontos do livro.
A receita completa
// ═══ Postext Cookbook · Nº 077 · Proper-name and book-title marks, across and down ═════
// https://postext.dev/en/cookbook/proper-name-marks
// Code: MIT · Text: Sima Qian, Shiji 7 (PD) · Punctuation, headnote, conventions: CC BY 4.0
// Fonts: Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// Specimen pages for a classical reader: the opening of the Basic Annals of Xiang Yu with
// its proper-name lines and wavy title lines, set down the page and then across it.
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 slug lines and the colophon ('en' | 'es')
const RECIPE = 'proper-name-marks';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: the indigo of a thread-bound cover, vermilion for the marks
const palette = {
ink: '#221e1b', // the text
band: '#23394b', // the opener band and the small heads
mark: '#b5412c', // the name, title and emphasis marks: the second ink
tint: '#c7d2da', // kickers and bylines on the band
muted: '#6f6a64', // folios, slug lines, the colophon
paper: '#ffffff',
};
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: 'band (defaults)', value: { hex: palette.band, model: 'hex' } },
];
// #endregion
// #region type: 五號 on 18 pt, 42 characters by 17 lines down the page
const [SONG, HEI, KAI] = ['Noto Serif TC', 'Noto Sans TC', 'LXGW WenKai TC']; // 宋, 黑, 楷
const PT = 25.4 / 72; // mm in a point
const [W, H] = [140, 203]; // mm: 大32開
const SIZE = 10.5; // pt: 五號
// A gap of 7.5 pt (0.71 em) between lines: a line of marks needs half an em of it, dots on
// one side and lines on the other five eighths. At 15 pt the build reports every marked
// paragraph (cjkMarksExceedLeading: gap 0.43 em).
const LEAD = 18; // pt
const [CHARS, LINES] = [42, 17]; // the vertical grid: characters down a line, lines across
const SIDE = (W - LINES * LEAD * PT) / 2; // mm: the side margins of a vertical page
// #endregion
// #region answer: marks by the markup, their side by the writing mode
// :name[項梁] draws the proper-name line, :book[史記] the book-title mark, :dots[…] dots.
const cjk = {
bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
annotationColor: col('mark'), // unset, the marks print in the colour of the text
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 títulos entre 《》
Os livros da China continental que não são clássicos põem os títulos entre colchetes angulares: o Markdown fica como está, e os colchetes saem como pontuação do texto.
- bookTitleMark: 'wavy', // zh-Hant's default; mainland editions of the classics use it too
+ bookTitleMark: 'brackets', // 《史記》《項羽本紀》#Imprima as marcas na tinta do texto
Sem annotationColor, cada marca assume a cor do bloco que marca.
- annotationColor: col('mark'), // unset, the marks print in the colour of the textErros 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
O chinês não tem itálico
As famílias CJK não trazem itálico, e a tipografia chinesa marca a ênfase com pontos ao lado dos caracteres, não com inclinação. Em um documento marcado como chinês, *…* coloca pontos de ênfase nos caracteres chineses que abrange e deixa o itálico para as palavras latinas (cjk.emphasis: 'dots', o padrão para o chinês); :dots[…] os coloca em qualquer lugar. Com cjk.emphasis: 'italic', ou em um documento marcado como en ou es, *…* faz o canvas inclinar os glifos redondos, um oblíquo sintético que a tipografia chinesa nunca usa (o PDF recorre à fonte redonda): mantenha a marcação chinesa ou faça a ênfase em negrito ou em uma fonte Kai (LXGW WenKai) com um estilo de parágrafo ou de chip. Fontes chinesas, japonesas e coreanas →
Aviso de diagramação · cjkMarksExceedLeading
Marcas encostam na linha vizinha
Por quê. Um parágrafo com pontos de ênfase ou com fios de nome próprio e de título de obra tem um vão entre linhas menor que meio eme (cinco oitavos com marcas dos dois lados): as marcas ficam na entrelinha, cuja altura não aumenta por causa delas e por isso encostam na linha vizinha.
Correção. Dê ao parágrafo um estilo de parágrafo com mais entrelinha ou aumente `bodyText.lineHeight`. Docs →
- Um título desenhado por um design imprime o texto através do design, e o texto de design perde as marcas:
# :book[項羽本紀]não mostraria nenhuma linha ondulada na faixa. Cabeços, legendas e células de tabela também imprimem o texto sem marcas. - O Postext não para por causa de
cjkMarksExceedLeading: a composição o registra emdoc.contentWarningse o painel Verificações do Sandbox o mostra, mas as páginas são impressas assim mesmo, com as marcas espremidas contra a linha vizinha. Quando mudar a entrelinha, leia essa lista; com 15 pt ela reúne todos os parágrafos marcados destas páginas.
Créditos
- Receita
- Ignacio Ferro
- Texto
- The opening of the Basic Annals of Xiang Yu (項羽本紀), Records of the Grand Historian (史記), chapter 7; characters from the zh.wikisource transcription · Sima Qian (司馬遷) · domínio público
- The punctuation, the paragraphs and the marks of the passage, the headnote (題解), the conventions (凡例), the slug lines and the colophon · Ignacio Ferro · CC BY 4.0
- Fontes
- Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai TC (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)


