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
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
- Funcionalidades
- Rubi: leituras em pinyin e zhuyinTexto verticalLivros encadernados pela direitaFontes chinesas, japonesas e coreanasLargura da pontuação chinesaGrade de caracteresColuna e meiaColuna de margem para flutuantesNotas na margemNumeração chinesaListas numeradasTipos de recurso personalizadosBoxesEstilos de parágrafoEstilos de títuloTextos, fios e caixas nos designs de páginaCabeços e fóliosExportação para PDF
- Também usa
- Quebra de linha em chinêsAtributos de títuloTítulos numeradosFiguras exatamente aquiCabeços por tipo de páginaFontes incorporadas ao PDFFiguras e tabelas como recursosNúmeros em pé no texto verticalCapítulos sem número
- Tipografia
- Iansui, LXGW WenKai TC, Noto Serif TC, Noto Sans TC (SIL OFL 1.1)
- Materiais
plate-1-1500.jpgplate-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
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
// {株|ㄓㄨ}: 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
// 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
// ═══ 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
idiomdefineboldFontWeight: 400com a cor de destaque comoboldColor, de modo que**…**muda a cor e não a letra.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Han Feizi, chapter 49, “Wu du” (The five vermin): the man of Song who waited by the stump · Han Fei; transcription and punctuation by Wikisource editors (爲 set as 為, the Taiwan standard form) · CC BY-SA 4.0
- Han Feizi, chapter 32, “Wai chu shuo zuo shang”: the man of Zheng who went to buy shoes · Han Fei; transcription and punctuation by Wikisource editors · CC BY-SA 4.0
- The zhuyin (checked against the Ministry of Education's Revised Mandarin Chinese Dictionary), the modern Chinese versions, the notes, the author box, the lead and the exercises, written for this recipe · Postext Cookbook · CC BY 4.0
- 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)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


