Em poucas palavras
Um livrinho de poemas chineses da dinastia Tang, com uma tradução inglesa antiga na página da frente. Cada linha de versos chineses fica na altura dos versos ingleses que a traduzem.
O que você vai compor
Um pequeno livro bilíngue de poemas Tang, composto como as edições bilíngues compõem um clássico: o chinês na página da direita, numa folha tingida como papel antigo, e os versos rimados de Herbert A. Giles, de 1901, na página da esquerda, em frente. Quatro poemas de Li Bai, Du Fu e Wang Wei ocupam uma página dupla cada um, com título em cada língua e assinados com o nome do poeta. O chinês vai em LXGW WenKai, uma Kai desenhada a partir do pincel, com dois versos por linha, de modo que cada linha fica na altura dos dois versos ingleses que a traduzem. As notas, na língua do leitor, ficam no pé da página chinesa. Tradução lado a lado, estrofe por estrofe põe um poema espanhol ao lado da versão inglesa numa só página; aqui cada língua tem a página.
Esta receita responde a
- Como componho um poema e sua tradução em páginas opostas, com o original sempre na página ímpar?
- Como componho poesia: um verso por linha, espaço entre estrofes, recuo deslocado nos versos que quebram e sem hifenização?
- Como faço notas de rodapé?
- Como forço uma quebra de página ou de coluna e faço cada capítulo começar em página ímpar?
A resposta curta
const SINK = 6; // lines of LEAD under both titles, so the two poems start on the same line
const at = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) } });
// A title whose foot is 23 mm down at any size, and the poet's line under it at 24 mm.
const titled = (size, title, poet, under = []) => ({
enabled: true, minHeight: pt(SINK * LEAD),
slot: { elements: [...under,
{ kind: 'text', id: 'title', content: '{titleText}', fontSize: pt(size), lineHeight: 1.2,
align: 'center', overflow: 'wrap', color: col('ink'),
placement: at(23 - (size * 1.2 * 25.4) / 72), ...title },
{ kind: 'text', id: 'poet', align: 'center', overflow: 'wrap', color: col('seal'),
placement: at(24), ...poet },
] },
});
// Each style breaks to its own side of the spread (gotcha: style-inherits-break).
const english = { id: 'en', breakBefore: { enabled: true, parity: 'even' }, // a verso
advancedDesign: titled(19, { fontFamily: ROMAN, italic: true },
{ content: '{attr.kicker}', fontFamily: LABEL, fontSize: pt(7.5), fontWeight: 600,
letterSpacing: pt(1.5), textTransform: 'uppercase' }) };
// The original on a tinted leaf: span 'page' lets the tint reach past the text column.
const chinese = { id: 'zh', span: 'page', breakBefore: { enabled: true, parity: 'odd' },
advancedDesign: titled(28, { fontFamily: SERIF, fontWeight: 700, letterSpacing: pt(7) },
{ content: '{attr.poet}', fontFamily: HEI, fontSize: pt(9), letterSpacing: pt(1.5) },
[{ kind: 'box', id: 'leaf', reserve: false, style: { backgroundColor: col('leaf') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: 'fill' } } }]) };
Ingredientes
- Funcionalidades
- Capítulos que abrem em página ímparEstilos de títuloNotas de rodapéVerso linha a linhaEstilos de parágrafoGrade de caracteresFontes chinesas, japonesas e coreanasQuebra de linha em chinêsAberturas desenhadasAtributos de títuloTextos, fios e caixas nos designs de páginaCapas, folhas de rosto e colofõesCabeços e fóliosCabeços por seçãoMargens espelhadasCor do papelPaleta de cores semânticaEspaço vertical explícitoExportação para PDFFontes incorporadas ao PDF
- Também usa
- Cabeços por tipo de página
- Tipografia
- Noto Serif TC, LXGW WenKai TC, Noto Sans TC, Source Serif 4, Source Sans 3 (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Um estilo de título para cada lado da página dupla
O código é a resposta curta acima. Cada poema são dois títulos de nível 1: # Night Thoughts {style="en" …} com os versos de Giles e depois # 靜夜思 {style="zh" …} com o poema. O estilo en quebra para a próxima página par; o estilo zh, para a próxima ímpar, a que fica em frente. Enquanto cada poema couber na página, nenhuma página em branco entra; uma versão inglesa que passasse da página empurraria o original para a ímpar seguinte, atrás de uma par em branco (Quebrar antes). Os dois designs reservam seis linhas da grade, por isso o inglês e o chinês começam na mesma linha. O estilo chinês usa span: 'page' porque o primeiro elemento dele, uma caixa do tamanho da página, é a folha tingida, e um design preso à coluna para no pé da coluna (Span e design avançado).

#2 · Uma linha de chinês para dois versos de inglês
// Each English poem is a :::verse block: a line of verse a line of Markdown, Giles's indents
// as two leading spaces (two ems: bodyText.verse.indentStep), a blank line between stanzas.
// The block is centred on its longest line in the 103.7 mm measure, so a short poem and a
// long one both sit in the middle.
const verse = { id: 'verse', fontFamily: ROMAN, fontSize: pt(BODY), lineHeight: pt(LEAD) };
const shi = { id: 'shi', fontFamily: KAI, fontSize: pt(SHI), lineHeight: pt(2 * LEAD),
textAlign: 'left', firstLineIndent: pt(0), // two lines of verse to a row: 2 × LEAD
// Five characters and a full-width mark, twice: 12 ems, centred in the 28 of the grid.
// A fixed left edge, and the note numbers after each row's 。: every character keeps its column.
indent: pt((CHARS * BODY - 12 * SHI) / 2) };
As linhas chinesas têm o dobro da entrelinha dos versos ingleses, 32 pt contra 16, por isso uma linha de dois versos de cinco caracteres fica em frente ao dístico que Giles faz dela. No poema da lua, nas páginas 4 e 5, uma linha em branco entre as estrofes inglesas e um :::space{lines=1} entre as chinesas deixam uma linha cada um, e as três estrofes continuam niveladas na página dupla. A linha chinesa começa com um recuo de 51 pt, o que centraliza os doze emes nos 28 da grade, e cada chamada de nota fica depois do 。 da linha, fora dos doze: dentro da linha, ela empurraria para a direita seis décimos de eme todos os caracteres seguintes, que deixariam de cair sobre os da linha de baixo. Cada poema inglês é um bloco :::verse, centralizado pelo verso mais longo, de modo que nenhum recuo precisa ser medido. Giles recua um verso sim, outro não; o Markdown guarda os dois espaços dele, que bodyText.verse.indentStep transforma em dois emes de recuo.
#3 · Notas no pé da página chinesa
const footnotes = { placement: 'column', numbering: 'page', // the page foot; ① again on each page
numberFormat: 'circled-decimal', markerSize: em(0.6), fontSize: pt(8), lineHeight: pt(11),
color: col('ink'), textAlign: 'left', spaceAbove: pt(LEAD), spaceBelowRule: pt(5),
spaceBetween: pt(3), separator: { width: 0.12, lineWidth: pt(0.6), color: col('seal') },
wordBreak: 'keep-all' }; // a reading a note quotes (山月, 看月光) is never broken
As notas são notas de rodapé, uma por linha: 疑是地上霜。[^bed] fecha a primeira linha do poema e [^bed]: … vem depois dela, com cada palavra explicada em negrito, já que o número não fica mais ao lado delas. São numeradas como um livro chinês numera as notas (页下注): números em círculo sobre a linha de base, contados de novo a partir de ① em cada página (numberFormat: 'circled-decimal', numbering: 'page'). No verso, a chamada é composta a seis décimos do corpo do poema, markerSize: em(0.6), perto do corpo das notas; no pé da página, cada nota abre com o ① no corpo da nota (Notas de rodapé). As notas são compostas na fonte do texto corrido, e a deste livro é a Noto Serif TC porque uma nota mistura caracteres e pinyin; as letras latinas da Noto Serif TC vêm da Source Serif, e por isso as páginas em inglês são compostas em Source Serif 4. As notas são escritas na língua da edição: junto com o cabeço da página par e a nota sobre o texto, são o que muda na edição em espanhol.
#4 · Cabeços na língua de cada página
const head = (id, content, parity, edge, x, style) => ({ kind: 'text', id, content, parity,
pages: 'opener', // every poem page opens with its title; a blank page stays bare
fontFamily: LABEL, fontSize: pt(7.5), fontWeight: 600, color: col('muted'),
placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(12) } }, ...style });
const header = { elements: [
head('verso-folio', '{pageNumber}', 'even', 'top-left', EDGE, { color: col('ink') }),
head('verso-book', '{subtitle}', 'even', 'top-left', EDGE + 8,
{ letterSpacing: pt(1.2), textTransform: 'uppercase' }),
head('recto-poet', '{attr.name}', 'odd', 'top-right', -(EDGE + 8),
{ fontFamily: HEI, fontWeight: 400, fontSize: pt(8), letterSpacing: pt(3) }),
head('recto-folio', '{pageNumber}', 'odd', 'top-right', -EDGE, { color: col('ink') }),
] };
Todas as páginas deste livro abrem com um título, por isso todas são aberturas, e os cabeços usam pages: 'opener'. Uma página em branco criada por uma quebra ficaria limpa, e a folha de rosto os tira com um cabeçalho vazio próprio. A página par pega o título do livro no subtitle do front matter, que cada edição escreve na língua; a ímpar pega o nome do poeta no atributo name do título chinês (Cabeçalhos e rodapés).
#5 · Uma folha de rosto sobre uma lua
const onPage = (y, size) => ({ anchor: { to: 'page', edge: 'top' }, offset: { y: mm(y) },
...(size ? { size: { width: mm(size), height: mm(size) } } : {}) });
const [MOON_Y, MOON, HAN] = [36, 78, 60]; // mm: the moon's top and width; pt: the title
const UNDER = MOON_Y + MOON; // mm: the English lines start under the moon
const line = (id, content, y, style) => ({ kind: 'text', id, content, align: 'center',
overflow: 'wrap', color: col('ink'), placement: onPage(y), ...style });
const titlePage = { id: 'title', span: 'page', runningChapter: false,
header: { elements: [] }, footer: { elements: [] },
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'box', id: 'moon', placement: onPage(MOON_Y, MOON),
style: { backgroundColor: col('moon'), borderRadius: mm(MOON / 2) } },
line('han', '{titleText}', MOON_Y + MOON / 2 - (HAN * 25.4) / 144, { fontFamily: SERIF,
fontWeight: 900, fontSize: pt(HAN), letterSpacing: pt(HAN / 4), lineHeight: 1 }),
line('en', '{attr.en}', UNDER + 10, { fontFamily: LABEL, fontSize: pt(10), fontWeight: 600,
letterSpacing: pt(3), textTransform: 'uppercase', color: col('seal') }),
line('poets', '{attr.poets}', UNDER + 19, { fontFamily: ROMAN, fontSize: pt(12) }),
line('giles', '{attr.english}', UNDER + 26, { fontFamily: ROMAN, fontSize: pt(11),
italic: true }),
// A seal reading 明月, the bright moon of three of the four poems, set down its square.
{ kind: 'box', id: 'seal', placement: onPage(170, 13),
style: { backgroundColor: col('seal'), borderRadius: mm(1) } },
line('seal-text', '明月', 170, { placement: onPage(170, 13), writingMode: 'vertical-rl',
fontFamily: KAI, fontSize: pt(14), lineHeight: 1, color: col('paper'),
verticalAlign: 'middle' }),
] } },
};
A folha de rosto também é um estilo de título, com runningChapter: false para não nomear nenhum capítulo. A lua é uma caixa de design cujo raio de canto é metade do lado, e 唐詩 é centralizado sobre ela por aritmética: o meio da lua menos metade da altura do título. O selo compõe 明月 com writingMode: 'vertical-rl', um caractere sobre o outro, como se gravam os selos.
#6 · Cada fonte chinesa carrega o que compõe
const grab = (re) => (markdown.match(re) ?? []).join('');
// Each poem to its closing `:::` (not the `:::space` between stanzas), then the note numbers.
const poems = grab(/:::paragraphs\{style="shi"\}[\s\S]*?\n:::(?=\n|$)/g) + '①②③④⑤⑥⑦⑧⑨⑩';
await loadFonts(FONTS, markdown);
await Promise.all([
loadCjkFonts({ [SERIF]: ['400'] }, markdown + poems), // the notes and their ①, the heading blocks
loadCjkFonts({ [SERIF]: ['700'] }, grab(/^# \S+(?= \{style="zh")|\*\*[^*]+\*\*/gm)),
loadCjkFonts({ [SERIF]: ['900'] }, grab(/^# \S+(?= \{style="title")/gm)),
loadCjkFonts({ [KAI]: ['400'] }, `${poems}明月`),
loadCjkFonts({ [HEI]: ['400'] }, grab(/(?<=(?:poet|name)=")[^"]*/g)),
]);
O Fontsource corta cada fonte chinesa em cerca de cem arquivos por faixa de caracteres, e loadCjkFonts baixa só os arquivos de que o texto precisa (Fontes chinesas, japonesas e coreanas). A Kai recebe os poemas e o selo; a Hei, as linhas dos poetas e os nomes; a Song em negrito, os quatro títulos e as palavras explicadas nas notas; e o peso black dela, os dois caracteres da folha de rosto.
A receita completa
// ═══ Postext Cookbook · Nº 083 · Tang poems facing their English verse ═══════════════
// https://postext.dev/en/cookbook/tang-poems-facing-english
// Code: MIT · Text: Tang poems, zh.wikisource; H. A. Giles, 1901, Project Gutenberg (PD)
// Fonts: Noto Serif TC, LXGW WenKai TC, Noto Sans TC, Source Serif 4 (OFL) · Needs postext ≥ 1.28.0
import { buildDocument, withLoadedFonts, renderPageToCanvas } 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 = 'tang-poems-facing-english';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// Ink and seal red on a cream paper, and a pale moon for the title page.
const palette = {
ink: '#1f1b18', // text: a warm near-black
seal: '#ad3526', // the accent: vermilion seal paste, for the poets, the rules and the seal
moon: '#eadcb4', // the title page's moon
leaf: '#f2e8cf', // the recto's tint, under the Chinese
muted: '#6d655c', // running heads and the colophon
paper: '#faf6ed', // a cream paper
};
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: 'seal (defaults)', value: { hex: palette.seal, model: 'hex' } },
];
const SERIF = 'Noto Serif TC'; // 明: the Chinese titles and the notes
const KAI = 'LXGW WenKai TC'; // 楷: the poems
const HEI = 'Noto Sans TC'; // 黑: the poet lines and the recto's running head
const ROMAN = 'Source Serif 4'; // the English: the Latin that Noto Serif TC is built on
const LABEL = 'Source Sans 3'; // English labels and folios
const [BODY, LEAD, SHI] = [10.5, 16, 16]; // pt: 五号 on a 16 pt pitch; the poems' size
const [CHARS, LINES] = [28, 30]; // the character grid: 28 ems by 30 lines
const TRIM = { width: 148, height: 210 }; // mm: 25開, a Taiwan trade trim
const [INNER, OUTER] = [18, 21]; // mm: minimum sides; the grid centres its measure between them
const MEASURE = (CHARS * BODY * 25.4) / 72; // 103.7 mm: 28 ems of 五号
const EDGE = OUTER + (TRIM.width - INNER - OUTER - MEASURE) / 2; // 23.6 mm: the outer text edge
// #region answer: the English opens the next verso, the Chinese the recto that faces it
const SINK = 6; // lines of LEAD under both titles, so the two poems start on the same line
const at = (y) => ({ anchor: { to: 'container', edge: 'top' }, offset: { y: mm(y) } });
// A title whose foot is 23 mm down at any size, and the poet's line under it at 24 mm.
const titled = (size, title, poet, under = []) => ({
enabled: true, minHeight: pt(SINK * LEAD),
slot: { elements: [...under,
{ kind: 'text', id: 'title', content: '{titleText}', fontSize: pt(size), lineHeight: 1.2,
align: 'center', overflow: 'wrap', color: col('ink'),
placement: at(23 - (size * 1.2 * 25.4) / 72), ...title },
{ kind: 'text', id: 'poet', align: 'center', overflow: 'wrap', color: col('seal'),
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
#Pôr o original na página par
As edições Loeb e muitos livros bilíngues de chinês e inglês põem o original à esquerda: troque as paridades dos dois estilos de título e dos dois cabeços que nomeiam o livro e o poeta, e escreva no Markdown cada título e poema chineses antes da versão inglesa.
-const english = { id: 'en', breakBefore: { enabled: true, parity: 'even' }, // a verso
+const english = { id: 'en', breakBefore: { enabled: true, parity: 'odd' }, // a recto
-const chinese = { id: 'zh', span: 'page', breakBefore: { enabled: true, parity: 'odd' },
+const chinese = { id: 'zh', span: 'page', breakBefore: { enabled: true, parity: 'even' },
- head('verso-book', '{subtitle}', 'even', 'top-left', EDGE + 8,
+ head('verso-book', '{subtitle}', 'odd', 'top-right', -(EDGE + 8),
- head('recto-poet', '{attr.name}', 'odd', 'top-right', -(EDGE + 8),
+ head('recto-poet', '{attr.name}', 'even', 'top-left', EDGE + 8,#Pôr as notas logo abaixo do poema
As antologias chinesas anotadas (注釋本) imprimem as notas depois de cada poema. Aqui as notas de fim de capítulo fazem isso, já que cada poema é um capítulo.
-const footnotes = { placement: 'column', numbering: 'page', // the page foot; ① again on each page
+const footnotes = { placement: 'chapterEnd', chapterEndAlign: 'text',Erros comuns
Erro comum
Um estilo de título herda a quebra de página do seu nível
Uma entrada de headingStyles recebe do seu nível de título todos os campos que não define, inclusive breakBefore. Um sumário ou um colofão com estilo sobre um H1 depois de um :::pagebreak herda a paridade 'odd' e cai depois de uma página em branco. Dê a esse estilo breakBefore: { enabled: false }. Estilos de título →
Erro comum
A página 1 é ímpar: planeje com os números físicos
A página 1 fica à direita e a 2 é a primeira página par, então planeje as páginas duplas com os números físicos de página: uma abertura em página par fica de frente para a ímpar que vem depois dela. Quebras de página e de coluna →
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
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
Uma fonte chinesa compõe aspas e apóstrofos em largura inteira, também em texto latino
A Noto Serif TC e as outras fontes de chinês tradicional desenham ‘ ’ “ ” com um eme de largura, como o texto chinês as usa, e esse é o glifo que recebe uma palavra latina composta com a fonte: Li Bai’s sai com um espaço largo depois do apóstrofo, e uma citação em inglês abre e fecha com um eme inteiro em branco. Uma fonte CJK também não tem itálico, e a inclinação simulada na tela sai reta no PDF. Texto que mistura chinês e uma língua latina em uma só fonte (as notas de rodapé, que usam a fonte do corpo, ou glosas com pinyin) fica melhor sem apóstrofos, aspas curvas e itálicos; « » e os sinais do Latin-1 mantêm a largura. Quando o texto latino vem à parte, dê a ele uma fonte latina com um estilo de parágrafo. Fontes chinesas, japonesas e coreanas →
Créditos
- Receita
- Ignacio Ferro
- Texto
- Three Tang poems in traditional characters, Li Bai’s 靜夜思 and 月下獨酌 and Wang Wei’s 竹里館, as Three Hundred Tang Poems (1763) gives them · Li Bai, Wang Wei · domínio público
- Du Fu’s 絕句, the second of his 絕句二首, as the Complete Tang Poems (1705, juan 228) prints it · Du Fu · domínio público
- The English verse translations, from A History of Chinese Literature (1901), Project Gutenberg eBook 43711 · Herbert A. Giles · domínio público
- The notes, the English titles, the note on the text and the colophon · Postext Cookbook · original
- Fontes
- Noto Serif TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · Source Serif 4 (SIL OFL 1.1) · Source Sans 3 (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)


