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

Receitas · Capítulo 2 · Tipo e texto

Um livro de leitura vertical com zhuyin à direita

Um livro escolar de Taiwan composto na vertical: {守株|ㄕㄡˇ|ㄓㄨ} põe uma coluna de zhuyin à direita de cada caractere, com figuras e notas num andar de cima.

Nesta página
Saída
Canvas · PDF
Nível
Avançado
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

p. 86–87 · 1–2 de 4

  • Amostra em inglês: ainda sem edição em português
  • Refile 184 × 260 mm
  • Coluna e meia, medianiz de 11,3 mm
  • Iansui 16/32
  • Noto Sans TC
  • Noto Serif TC
  • 4 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 124 ms
  • 184 linhas de código

Em poucas palavras

Um livro de leitura escolar de Taiwan, impresso em colunas de cima para baixo. Cada caractere chinês tem ao lado um pequeno guia de pronúncia, para as crianças lerem palavras que ainda não aprenderam.

O que você vai compor

A lição 12 do livro 9 de 國語, um livro de leitura inventado de quinto ano de Taiwan: duas fábulas do Han Feizi, a do lavrador de Song que espera junto a um toco por outra lebre e a do homem de Zheng que confia mais na medida que tirou do que nos próprios pés. Os livros de leitura de Taiwan são compostos na vertical, em letra Kai, com o zhuyin de cada caractere numa coluna à direita dele, para que a criança consiga ler um caractere antes de aprendê-lo. A lição abre numa página dupla encadernada pela direita. Em cima, um andar guarda as figuras, as notas, o autor e os caracteres novos; embaixo, a lição corre em Iansui de 16 pt, 23 caracteres por linha. A versão em escrita latina é o livro didático com coluna na margem, cuja coluna lateral só de flutuantes é aqui o andar de cima, girado um quarto de volta.

Esta receita responde a

  • Como coloco zhuyin ao lado de cada caractere de um texto chinês vertical?
  • Como componho um livro chinês na vertical, encadernado à direita?

A resposta curta

script.js · linhas 35–56no código completo
const layout = {
  writingMode: 'vertical-rl', // lines run down the page, read from the right; bound on the right
  layoutType: 'oneAndHalf', // two tiers: the text below, pictures and notes above
  sideColumnRole: 'floats', sideColumnSide: 'left', // 'left' is the top tier in vertical text
  sideColumnPercent: 34,
  gutterWidth: pt(2 * SIZE),
};
const cjk = {
  // The lower tier: 23 characters down, 13 lines across the page.
  grid: { enabled: true, charsPerLine: 23, linesPerPage: 13 },
  // Readings at half the text size; zhuyin sets its symbols at 60 % of that, 0.3 em,
  // so three symbols fit beside one character, and beside each of two in a row.
  ruby: { fontFamily: ZHUYIN, fontSize: em(0.5) },
};
// The line pitch is twice the size: a gap of one em, which the zhuyin and its tone
// marks half fill. clreq asks for 1.5 em; one em keeps 13 lines of 23 on the page.
const LINE = 2 * SIZE;
const bodyText = {
  fontFamily: KAI, fontSize: pt(SIZE), lineHeight: pt(LINE), color: col('ink'),
  boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
  textAlign: 'justify', firstLineIndent: em(2), indentAfterHeading: true,
};

Ingredientes

Tipografia
Iansui, LXGW WenKai TC, Noto Serif TC, Noto Sans TC (SIL OFL 1.1)
Materiais
  • plate-1-1500.jpg
  • plate-2-1500.jpg
  • The farmer waiting by the stump, a brush painting (Generated With Diffusion Models, original)
  • The man of Zheng hurrying home from the shoe stall, a brush painting (Generated With Diffusion Models, original)

Preparo

#1 · Uma coluna de zhuyin ao lado de cada caractere

O código é a resposta curta acima. {宋人|ㄙㄨㄥˋ|ㄖㄣˊ} dá a cada caractere a leitura, uma por |; a pontuação fica fora das chaves, por isso 。e , não recebem nenhuma. No texto vertical, uma leitura em bopomofo vai à direita da coluna, com os símbolos empilhados, a marca de tom à direita do último e o ponto do tom neutro acima do primeiro. Com metade do corpo, cjk.ruby.fontSize deixa os símbolos com 0,3 em, de modo que três símbolos cabem ao lado de um caractere, e duas leituras assim seguidas, como em 就像, ficam a pelo menos um quarto de símbolo uma da outra sem alargar nenhum dos dois caracteres; com 0,6 em, ㄇㄧㄥˊ fica mais alta que 明 e afasta os dois 明 de 明明. O passo de 32 pt entre linhas deixa um vão de um quadratim, que o zhuyin e as marcas de tom preenchem pela metade. O clreq pede 1,5 em quando o zhuyin fica entre linhas verticais; isso dá um passo de 40 pt e dez linhas por página, por isso esta página fica com um quadratim para ter 13 linhas de 23, e cada leitura fica a cerca de 8 pt da linha vizinha.

#2 · Figuras e notas no andar de cima

script.js · linhas 60–74no código completo
const resourceTypes = [{ id: 'plate', name: '插圖', shortLabel: '圖', numberingTemplate: '{n}',
  resetOn: 'never', counterFormat: 'decimal', captionPrefix: '' }]; // no prefix, no caption
const box = (id, title, body) => ({ id, title, background: col('tint'),
  padding: { top: mm(3), right: mm(3), bottom: mm(3), left: mm(3) },
  titleStyle: { fontFamily: HEI, fontSize: pt(11), fontWeight: 700, color: col('accent') },
  body: { color: col('ink'), firstLineIndent: pt(0), textAlign: 'left', boldColor: col('ink'),
    italicColor: col('ink'), ...body } });
// Zhuyin is 0.3 em of the text it reads: at 13 pt the notes' readings are 3.9 pt.
const calloutStyles = [ // fenced :::callout{type="notes" span="side"} in the text
  box('notes', '注釋', { fontFamily: MING, fontSize: pt(13), lineHeight: pt(24) }),
  box('author', '作者', { fontFamily: MING, fontSize: pt(13), lineHeight: pt(24),
    textAlign: 'justify', firstLineIndent: em(2) }),
  box('chars', '生字', { fontFamily: KAI, fontSize: pt(22), lineHeight: pt(40),
    textAlign: 'center' }),
];

No texto vertical, as colunas de um layout oneAndHalf são andares, e sideColumnSide: 'left' põe em cima o que só aceita flutuantes. ::resource{id="plate-1"} no texto manda a primeira figura para lá; o tipo plate não tem prefixo de legenda, e as figuras não têm legenda, por isso nada sai embaixo delas. Um boxe aberto com span="side" cai no andar a partir da linha em que foi aberto, e o texto dele desce pelo andar. As notas das duas fábulas são um único boxe, numerado ao longo da lição e aberto depois do primeiro original, que termina na página 86: ele preenche o andar da página 87, e assim as notas das duas fábulas ficam na página dupla que contém os originais. O zhuyin mede 0,3 em do texto que lê, e cjk.ruby é uma configuração única para o livro, de modo que as notas e o boxe do autor são compostos em 13 pt para manter as leituras deles em 3,9 pt.

#3 · Quatro fontes, cada uma carregada com o seu texto

script.js · linhas 270–289no código completo
// {株|ㄓㄨ}: the characters are the text, the readings go to the zhuyin face.
const BOXES = /^:::callout\{type="(?:notes|author)"[^}]*\}\n([\s\S]*?)^:::$/gm;
const bases = (md) => md.replace(/\{([^|{}]+)((?:\|[^|{}]+)+)\}/g, '$1');
const readings = [...markdown.matchAll(/\{[^|{}]+((?:\|[^|{}]+)+)\}/g)].map((m) => m[1]).join('');
await loadFonts(FONTS, markdown);
await loadCjkFonts({ [KAI]: ['400'] }, bases(markdown.replace(BOXES, '')), { vertical: true });
const notesText = [...markdown.matchAll(BOXES)].map((m) => m[1]).join('\n');
await loadCjkFonts({ [MING]: ['400'] }, bases(notesText), { vertical: true });
await loadCjkFonts({ [ZHUYIN]: ['400'] }, readings.replaceAll('|', ''), { vertical: true });
await loadCjkFonts({ [HEI]: ['400', '700'] }, LABELS, { vertical: true });
await Promise.all(Object.values(plates).map((fileId) => loadImage(fileId, asset(fileId))));
// Lesson 12 of a reader: page 86 is a verso, so the lesson opens on a spread.
const continuation = { pageIndexOffset: 1, pageNumbering: { startAt: 86 } };
const doc = await withLoadedFonts(
  () => buildDocument({ markdown, resources, continuation }, config()),
  { ...kitFonts(FONTS), text: markdown });
showBook(doc, { title: t({ en: 'A vertical reader with zhuyin',
  es: 'Un libro de lectura vertical con zhuyin' }) });
offerPdf(() => renderToPdf(doc, { fontProvider: cjkPdfProvider, resourceBytes: imageBytes }),
  `${RECIPE}.pdf`);

A lição é composta em Iansui, uma letra Kai desenhada a partir da Klee One nas formas padrão de caracteres de Taiwan, as que as crianças aprendem a escrever. As leituras ficam em LXGW WenKai TC, cujo ponto de tom neutro continua redondo em 4,8 pt, as notas em Noto Serif TC e os rótulos em Noto Sans TC. Cada fonte carrega os arquivos que contêm os caracteres que ela compõe: as leituras são separadas dos caracteres, e os boxes de notas vão só para a fonte Ming. vertical: true acrescenta as formas verticais, para que 「」 e 、 fiquem em pé como devem ao longo da coluna. pageIndexOffset: 1 faz da página 86 uma página par, e assim a lição abre numa página dupla.

#4 · A aba e os fólios na borda externa

script.js · linhas 78–103no código completo
// The verso lies on the right of the spread, so even pages carry both at the right edge.
const tab = (parity, edge) => [
  { kind: 'box', id: `tab-${parity}`, parity, pages: 'all',
    placement: { anchor: { to: 'page', edge }, offset: { y: mm(24) },
      size: { width: mm(9), height: mm(64) } }, style: { backgroundColor: col('accent') } },
  { kind: 'text', id: `unit-${parity}`, content: '第三單元 寓言故事', parity, pages: 'all',
    writingMode: 'vertical-rl', fontFamily: HEI, fontSize: pt(9), fontWeight: 700,
    color: col('paper'), align: 'center', verticalAlign: 'middle',
    placement: { anchor: { to: `#tab-${parity}`, edge: 'align-top' },
      size: { width: mm(9), height: mm(64) } } },
];
const foot = (id, parity, edge, x, content, extra = {}) => ({
  kind: 'text', id, content, parity, pages: 'all', fontFamily: HEI, fontSize: pt(8),
  color: col('muted'), placement: { anchor: { to: 'page', edge }, offset: { x: mm(x), y: mm(-9) } },
  ...extra,
});
const folio = { fontSize: pt(9), fontWeight: 700 };
const header = { elements: [...tab('even', 'top-right'), ...tab('odd', 'top-left')] };
const footer = {
  elements: [
    foot('folio-even', 'even', 'bottom-right', -16, '{pageNumber}', folio),
    foot('book', 'even', 'bottom-right', -26, '國語 第九冊'),
    foot('folio-odd', 'odd', 'bottom-left', 16, '{pageNumber}', folio),
    foot('lesson', 'odd', 'bottom-left', 26, '{chapterNumber} {chapterTitle}'),
  ],
};

Num livro encadernado pela direita, a página par fica à direita da página dupla, por isso as páginas pares levam a aba da unidade e o fólio na borda direita, e as ímpares na esquerda. A aba é uma caixa com um elemento de texto por cima; writingMode: 'vertical-rl' no elemento compõe 第三單元 寓言故事 descendo pela aba, enquanto os fólios e as linhas do pé continuam horizontais. Os números da lição e das fábulas vêm do numberingTemplate dos títulos (第{1:一}課 e {2:一}, com um espaço ideográfico como numberSeparator e {startAt=12} na lição), separados do título, de modo que o zhuyin de 寓 fica sobre 寓; a linha do pé das ímpares imprime {chapterNumber} {chapterTitle}, porque {chapterTitle} deixa o número de fora.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 080 · A vertical reader with zhuyin to the right ═════════
// https://postext.dev/en/cookbook/zhuyin-vertical-reader
// Code: MIT · Text: Han Feizi, zh.wikisource (CC BY-SA 4.0) · Pictures: diffusion models
// Fonts: Iansui, LXGW WenKai TC, Noto Serif TC, Noto Sans TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerResourceImage, 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 = 'zhuyin-vertical-reader';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: semantic colours, every one linked by id
const palette = {
  ink: '#2b2520', // text and zhuyin
  accent: '#b83f28', // lesson title, labels, the unit's tab (4.9:1 on the tint)
  tint: '#f7efdf', // the boxes of the upper tier
  muted: '#72675b', // lead, folios, colophon
  paper: '#ffffff', // the lettering on the tab
};
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: 'accent (defaults)', value: { hex: palette.accent, model: 'hex' } },
];
// #endregion
const KAI = 'Iansui'; // 楷: the lesson, drawn to Taiwan's standard forms (為, not 爲)
const ZHUYIN = 'LXGW WenKai TC'; // the readings: a round dot for the neutral tone
const MING = 'Noto Serif TC'; // 明: notes and the author box
const HEI = 'Noto Sans TC'; // 黑: labels, folios, the tab
const SIZE = 16; // the text size (三號)

// #region answer: vertical text with a zhuyin column right of every character
const layout = {
  writingMode: 'vertical-rl', // lines run down the page, read from the right; bound on the right
  layoutType: 'oneAndHalf', // two tiers: the text below, pictures and notes above
  sideColumnRole: 'floats', sideColumnSide: 'left', // 'left' is the top tier in vertical text
  sideColumnPercent: 34,
  gutterWidth: pt(2 * SIZE),
};
const cjk = {
  // The lower tier: 23 characters down, 13 lines across the page.
  grid: { enabled: true, charsPerLine: 23, linesPerPage: 13 },
  // Readings at half the text size; zhuyin sets its symbols at 60 % of that, 0.3 em,
  // so three symbols fit beside one character, and beside each of two in a row.
  ruby: { fontFamily: ZHUYIN, fontSize: em(0.5) },
};

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

#Imprimir o zhuyin numa segunda cor

Alguns livros de leitura imprimem as leituras mais claras que o texto, para que os caracteres fiquem em primeiro plano.

-  ruby: { fontFamily: ZHUYIN, fontSize: em(0.5) },
+  ruby: { fontFamily: ZHUYIN, fontSize: em(0.5), color: col('muted') },

#Pôr as leituras sobre texto horizontal

A cartilha com pinyin põe uma sílaba sobre cada caractere em linhas horizontais, como fazem as primeiras cartilhas da China continental e de Hong Kong.

Erros comuns

Erro comum

As leituras são impressas no texto, não em designs, legendas nem células

As leituras rubi são desenhadas em parágrafos, títulos, itens de lista, citações e boxes. Um elemento de texto de design (uma abertura, um cabeço, um selo), uma legenda, uma nota de rodapé e uma célula de tabela imprimem os caracteres-base sem as leituras. Um título que precisa do seu pinyin é um título sem design próprio: desenhe o que está em volta dele (uma faixa, o número da lição) com o design do título anterior, cujos elementos com reserve: false são pintados sob o texto de uma abertura span: 'page'. Rubi: leituras em pinyin e zhuyin →

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 →

  • Tire as leituras do dicionário de Taiwan. Ferramentas feitas sobre dicionários do continente, entre elas o pypinyin, dão 度 duó, 寧 nìng, 時候 shíhou e 市場 shìchǎng; o Dicionário Revisado de Chinês Mandarim do Ministério da Educação, que os livros de leitura de Taiwan seguem, lê ㄉㄨㄛˋ, ㄋㄧㄥˊ, ㄕˊ ㄏㄡˋ e ㄕˋ ㄔㄤˊ, e põe em tom neutro a segunda sílaba de 故事, 家裡 e 過來. O moedict.tw o oferece palavra por palavra. Ele mantém 一 e 不 no tom próprio, e esta lição também.

  • Desenhe alguns caracteres em cada fonte antes de misturá-las. A LXGW WenKai TC segue as formas herdadas e desenha 為 (U+70BA) como 爲, por isso uma lição composta nela imprimia 爲宋國笑 no texto e 為宋國笑 na nota em Ming da mesma página dupla. A Iansui desenha o 為 padrão.

  • A Iansui tem um só peso. Os títulos se destacam pelo tamanho, e as entradas das expressões idiomáticas pela cor: o estilo idiom define boldFontWeight: 400 com a cor de destaque como boldColor, de modo que **…** muda a cor e não a letra.

Créditos

Texto
Imagens
  • The farmer waiting by the stump, a brush painting · Generated With Diffusion Models · original
  • The man of Zheng hurrying home from the shoe stall, a brush painting · Generated With Diffusion Models · original
Fontes
Iansui (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1) · Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1)
SandboxPDF