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

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

Poemas Tang diante da sua versão inglesa

Cada poema Tang abre uma página ímpar tingida, e o inglês de Giles fica na par em frente: um estilo de título quebra para página par, o outro para ímpar.

Nesta página
Gênero
Poesia
Saída
Canvas · PDF
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 MIT

p. 2–3 de 10

  • Amostra em inglês: ainda sem edição em português
  • Refile 148 × 210 mm
  • 1 coluna
  • Noto Serif TC 10,5/16
  • LXGW WenKai TC
  • Noto Sans TC
  • Source Sans 3
  • Source Serif 4
  • 10 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 123 ms
  • 180 linhas de código

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

script.js · linhas 39–63no código completo
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

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).

Página 2: o inglês abre a página par seis linhas abaixo, na mesma linha da grade em que o chinês abre na página 3.

#2 · Uma linha de chinês para dois versos de inglês

script.js · linhas 67–76no código completo
// 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

script.js · linhas 80–84no código completo
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

script.js · linhas 117–128no código completo
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

script.js · linhas 88–113no código completo
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

script.js · linhas 306–316no código completo
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

Sandbox
// ═══ 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

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)
SandboxPDF