Em poucas palavras
O chinês clássico como os leitores japoneses o aprendem: pequenas marcas vermelhas ao lado dos caracteres dizem em que ordem lê-los e que terminações japonesas acrescentar, e a leitura japonesa completa vem depois de cada trecho.
O que você vai compor
Três páginas de um livro escolar japonês de 漢文 (kanbun), o chinês clássico lido como japonês, numa página A5 encadernada pela direita: três ditos dos Analectos e a quadra Amanhecer de primavera, de Meng Haoran. Cada trecho é composto em Zen Old Mincho de 15 pt na ordem chinesa, com os 訓点 (kunten) ao lado dos caracteres, em vermelhão e com metade do tamanho deles: as marcas de retorno (返り点), embaixo à esquerda de um caractere, dizem ao leitor que siga adiante e volte a ele, e o okurigana (送り仮名) à direita acrescenta as terminações japonesas. Sob cada trecho, o 書き下し文 (yomikudashi), o mesmo texto escrito como japonês, vem em Klee One, uma letra escolar, com furigana onde a leitura é difícil. Os clássicos chineses com os próprios auxílios de leitura estão na Nº 080.
Esta receita responde a
- Como imprimo kanbun com suas marcas de retorno e okurigana?
- Como coloco furigana sobre os kanji, uma leitura por caractere ou uma para a palavra inteira?
A resposta curta
// :kunten[習]{kaeri="レ" okuri="フ"} sets the return mark small at the character's lower
// left and the okurigana at its lower right, down the line; the text keeps its Chinese
// order, which the reader follows by the marks. cjk.kunten sizes and colours them: half
// the character, in vermilion. The Japanese reading under each passage is plain kana and
// kanji with furigana: {君子|くん|し} gives each character its reading (jukugo ruby).
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
};
const paragraphStyles = [
// The text: 15 pt on a pitch of two grid lines, room for the okurigana beside it. A
// quatrain takes two lines, a couplet to the line with a space between its verses.
{ id: 'kanbun', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
firstLineIndent: em(0), textAlign: 'justify' },
{ id: 'shi', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
indent: em(2), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
// The reading (書き下し文), two characters down in a school-book hand.
{ id: 'kudashi', indent: em(2), firstLineIndent: em(0), marginTop: pt(LEAD) },
{ id: 'kudashi-shi', indent: em(4), firstLineIndent: em(0), marginTop: pt(0),
marginBottom: pt(0) },
];
Ingredientes
- Funcionalidades
- Marcas de leitura do kanbun (kunten)Furigana: leituras em kana sobre os kanjiTexto verticalLivros encadernados pela direitaRubi: leituras em pinyin e zhuyinEstilos de parágrafoTítulos sobre linhas do texto (gyōdori)Kana, kanji e rōmajiQuebra de linha em japonês (kinsoku)Numerais japoneses e contadores em kanaGrade de caracteresFontes chinesas, japonesas e coreanasEstilos de títuloAberturas desenhadasCabeços e fóliosCabeços por tipo de páginaMargens espelhadasPaleta de cores semânticaExportação para PDF
- Também usa
- Quebra de linha em chinêsAtributos de títuloCor do papelFontes incorporadas ao PDFElementos pré-textuais em romanosCabeços por seção
- Tipografia
- Zen Old Mincho, Klee One, Noto Sans JP (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Marque cada caractere com :kunten
O código é a resposta curta logo acima. :kunten[習]{kaeri="レ" okuri="フ"} dá a 習 a marca de retorno レ e o okurigana フ; o texto mantém o caractere, de modo que a busca, a cópia e o PDF leem o trecho como foi escrito, e as marcas não ocupam nenhum caractere dele (Marcas, rubi e warichu). Leia 学ビテ而時ニ習フレ之ヲ: a レ em 習 manda o leitor a 之 primeiro e de volta, 之を習ふ; 而 não tem marca e não é lido. No texto vertical, a marca de retorno fica embaixo à esquerda do caractere e ocupa meio caractere da linha, e o okurigana fica à direita, começando na metade da altura do caractere, como o JIS X 4051 os compõe. cjk.kunten define o tamanho deles, metade do texto, e a cor, o vermelhão em que um leitor os escreve; um trecho tem 15 pt em duas linhas da grade, o que deixa 27 pt ao lado de cada linha para o okurigana.
#2 · Salte com 一 二 e com 一レ
Os números levam o leitor mais para trás. Em 不二亦タ説バシカラ一乎, o leitor pula 不, que tem 二, lê 亦た説ばしから e, no 一, volta a 不: 亦た説ばしからずや. Em 為政, a marca combinada 一レ em 為 faz as duas coisas: 可二以テ為一レ師ト矣 se lê 以て, 師と (レ), 為る e então de volta a 可 (de 一 a 二), 以て師と為るべし. Os pontos de código de kanbun ㆑ ㆒ ㆓ são lidos como os caracteres que representam, por isso um texto copiado de outro lugar mantém as marcas.
#3 · Deixe um okurigana longo empurrar o caractere seguinte
Um okurigana mais longo que o caractere não corre ao lado do seguinte: em 花落ツルコト知ル多少, os quatro kana de ツルコト ocupam o comprimento de dois caracteres, e 知 desce para começar depois deles, como o JIS X 4051 os compõe (§5.6.4). A linha cresce, e a quebra seguinte se desloca com ela.
#4 · Dê a cada trecho um rótulo de duas linhas
const at = (down, across) => ({ anchor: { to: 'container', edge: 'top-left' },
offset: { x: pt(down), y: pt(across) } });
const TITLE = 26; // pt
const part = { level: 1, breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: pt(5 * LEAD), slot: { elements: [
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: MINCHO, fontWeight: 700,
fontSize: pt(TITLE), lineHeight: 1, letterSpacing: pt(TITLE / 2), color: col('ink'),
placement: at(2 * BODY, 2 * LEAD - TITLE / 2) },
{ kind: 'text', id: 'kicker', content: '{attr.kicker}', fontFamily: GOTHIC, fontSize: pt(8.5),
letterSpacing: pt(2), color: col('vermilion'), placement: at(2 * BODY + 3 * TITLE + 18,
2 * LEAD - 8.5 / 2) },
] } } };
// 2行取り, the passage's book and number in gothic, two characters down.
const passage = { level: 2, fontFamily: GOTHIC, fontWeight: 700, fontSize: pt(9.5),
color: col('muted'), lineSpan: 2, indent: em(2) };
Cada livro da antologia abre uma página com o título, 論語 ou 唐詩, o primeiro com uma pequena nota em vermelhão sobre o que contém; cada trecho leva um rótulo em gótica com a altura de duas linhas do texto (2行取り), 学而第一 ou 春暁 孟浩然, para que os trechos abaixo dele fiquem na grade. A leitura é um bloco :::paragraphs{style="kudashi"} dois caracteres mais abaixo, na fonte e no corpo do texto corrido, com furigana jukugo: {君子|くん|し} dá a cada caractere a própria leitura, e assim uma linha poderia quebrar entre eles.
#5 · Carregue cada voz com os seus caracteres
const FENCE = /:::paragraphs\{style="([\w-]+)"\}\n([\s\S]*?)\n:::/g;
const fence = (style) => [...markdown.matchAll(FENCE)].filter((m) => m[1] === style)
.map((m) => m[2]).join('');
const kanbun = `${fence('kanbun')}${fence('shi')}`; // the text and its marks' kana
const reading = `${fence('kudashi')}${fence('kudashi-shi')}`;
const heads = markdown.match(/^#+ [^{\n]*/gm).join('');
const colophon = markdown.match(/colophon="([^"]*)"/)[1];
await loadFonts(FONTS, markdown); // the Latin files: the colophon
await loadCjkFonts({ [MINCHO]: ['400'] }, kanbun, { vertical: true });
await loadCjkFonts({ [MINCHO]: ['700'] }, heads);
await loadCjkFonts({ [KYOKASHO]: ['400'] }, reading, { vertical: true });
await loadCjkFonts({ [GOTHIC]: ['400', '700'] },
`${heads}${colophon}${markdown.match(/kicker="([^"]*)"/)[1]}漢文訓読一二三四五六七八九十`,
{ vertical: true });
O texto clássico e a leitura são compostos em fontes diferentes, por isso cada uma carrega os arquivos dos próprios caracteres: Zen Old Mincho para os trechos e as marcas, cujos kana ficam dentro dos atributos de :kunten; Klee One para as leituras e o furigana; Noto Sans JP para os rótulos. A quadra é composta com dois versos por linha e um espaço ideográfico entre eles, um modo comum de imprimi-la, para que o poema e a leitura caibam na página sob o título.
A receita completa
// ═══ Postext Cookbook · Nº 122 · Kanbun with its reading marks, and the Japanese reading ═══
// https://postext.dev/en/cookbook/kanbun-kundoku
// Code: MIT · Text: 論語, 孟浩然「春暁」 (public domain); kunten and readings CC BY 4.0
// Fonts: Zen Old Mincho, Klee One, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.25.0
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 colophon; the page is Japanese in both
const RECIPE = 'kanbun-kundoku';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, the vermilion of hand-written kunten, a school-book paper
const palette = {
ink: '#1e1c1a', // the text
vermilion: '#c0392b', // 朱: the reading marks, as a reader adds them by hand
muted: '#6a635c', // the headings' labels, the folios
paper: '#fcfbf7',
};
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: 'defaults', value: { hex: palette.vermilion, model: 'hex' } },
];
// #endregion
const [MINCHO, KYOKASHO, GOTHIC] = ['Zen Old Mincho', 'Klee One', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [10.5, 21, 36, 16]; // pt, pt: 36字 × 16行, a 2 em pitch
const KANBUN = 15; // pt: the classical text, set larger on two lines of the grid
// #region answer: kanbun with 返り点 and 送り仮名, its yomikudashi beside it in furigana
// :kunten[習]{kaeri="レ" okuri="フ"} sets the return mark small at the character's lower
// left and the okurigana at its lower right, down the line; the text keeps its Chinese
// order, which the reader follows by the marks. cjk.kunten sizes and colours them: half
// the character, in vermilion. The Japanese reading under each passage is plain kana and
// kanji with furigana: {君子|くん|し} gives each character its reading (jukugo ruby).
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
};
const paragraphStyles = [
// The text: 15 pt on a pitch of two grid lines, room for the okurigana beside it. A
// quatrain takes two lines, a couplet to the line with a space between its verses.
{ id: 'kanbun', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
firstLineIndent: em(0), textAlign: 'justify' },
{ id: 'shi', fontFamily: MINCHO, fontSize: pt(KANBUN), lineHeight: pt(2 * LEAD),
indent: em(2), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
// The reading (書き下し文), two characters down in a school-book hand.
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 as marcas em preto
Um livro impresso compõe os kunten na tinta do texto; tire a cor.
- kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
+ kunten: { fontSize: em(0.5), placement: 'inline' },#Ponha as marcas entre as linhas
placement: 'interlinear' tira as marcas de retorno da linha e as leva para o espaço ao lado da metade inferior do caractere, e o trecho mantém o espaçamento do texto sem marcas (白文). O JIS as põe na linha, que é o padrão.
- kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'inline' },
+ kunten: { fontSize: em(0.5), color: col('vermilion'), placement: 'interlinear' },Erros comuns
Erro comum
Marque um texto japonês como 'ja', nunca com zh-Hans nem LANG
As edições de uma receita são en e es, mas uma amostra japonesa é japonesa nas duas: `locale: LANG` a marcaria como inglês ou espanhol, e uma marcação chinesa a comporia pelas regras chinesas (pontuação Kaiming, kana pequeno livre para começar linha, 图 no lugar de 図, formas chinesas dos glifos no PDF). 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 qualquer marcação que não seja 'ja' dá outras formas de glifo que não as japonesas (as chinesas, sob uma marcação chinesa) e outras quebras de linha. Escreva 'ja': isso escolhe a região do Japão (quebra de linha e pontuação da JLReq, pontos de ênfase em gergelim, espaçamento dos furigana, rótulos 図 e 表) e desativa a hifenização. O lint reprova um texto com kana sob uma marcação zh ou ko. Quebra de linha em japonês (kinsoku) →
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 →
Créditos
- Receita
- Ignacio Ferro
- Texto
- 論語 (the Analects of Confucius), 學而 1 and 3, 爲政 11, and 孟浩然「春曉」 (Spring Dawn), in shinjitai; the kunten (返り点, 送り仮名) and the yomikudashi follow the usual Japanese school reading and were set for this recipe (CC BY 4.0) · Confucius and his disciples; Meng Haoran; Ignacio Ferro (kunten and reading) · domínio público
- Fontes
- Zen Old Mincho (SIL OFL 1.1) · Klee One (SIL OFL 1.1) · Noto Sans JP (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)


