Em poucas palavras
Um informativo de bairro japonês impresso em linhas de cima para baixo. Mostra os diferentes jeitos de escrever números em japonês e como as datas continuam fáceis de ler no texto vertical.
O que você vai compor
Quatro páginas verticais de um informativo de bairro, 東若葉台だより, número 第百二十号, numa página B5 encadernada pela direita: o aviso da festa de verão, o calendário de agosto, as mensalidades com um recibo de doação e uma breve história da associação. A associação é inventada; os números estão escritos como um editor japonês os escreve. O número do informativo, o 第三十二回 da festa e os 二千四百人 que compareceram são contados com 十 百 千; os anos são escritos dígito a dígito, 二〇二六年 e 一九六〇年; o valor do recibo está em daiji (大字), 壱萬弐阡, que não pode ser adulterado com um traço; os horários e as datas estão em algarismos arábicos, e o 22 fica em pé numa só célula. As listas descem 一、 → (一) → イ → あ, e o calendário ocupa a contracapa.
Esta receita responde a
- Como numero capítulos 第一章 com numerais kanji, ou itens de lista あ い う e イ ロ ハ?
- Por que meu texto japonês sai com regras chinesas: rótulos 图, kana pequenos no início da linha, kanji em formas chinesas?
A resposta curta
// formatNumeral is the counter the engine numbers pages, lists and headings with.
const ISSUE = 120;
const kan = (n) => formatNumeral(n, 'japanese-informal'); // 120 → 百二十: counted
const pos = (n) => formatNumeral(n, 'cjk-decimal'); // 2026 → 二〇二六: digit by digit
const daiji = (n) => formatNumeral(n, 'japanese-formal'); // 12000 → 壱萬弐阡: on money
// {{daiji:12000}} in the text: the amount of a receipt in the hard-to-alter daiji.
const withDaiji = (md) => md.replace(/\{\{daiji:(\d+)\}\}/g, (_, n) => daiji(Number(n)));
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
uprightDigits: 2, // 8月22日: one or two Arabic digits stand in one cell (the default)
};
// Sections 一、二、三、, items (一)(二), then イ ロ ハ and あ い う beneath them.
const sectionLevel = { level: 2, numberingTemplate: '{2:一}、', numberSeparator: '',
fontFamily: GOTHIC, fontWeight: 700, fontSize: pt(12), color: col('leaf'), lineSpan: 2 }; // 二行取り
const level = (n, numberFormat, prefix, separator) => ({ level: n, numberFormat, prefix,
separator }); // each level starts where the text of the one above starts
const orderedLists = {
fontFamily: GOTHIC, color: col('leaf'), fontWeight: 700, gap: em(0.5),
marginTop: pt(0), marginBottom: pt(0), itemSpacing: pt(0),
levels: [level(1, 'japanese-informal', '(', ')'), level(2, 'katakana-iroha', '', ''),
level(3, 'hiragana', '', '、')],
};
Ingredientes
- Funcionalidades
- Numerais japoneses e contadores em kanaNúmeros em pé no texto verticalListas numeradasTexto verticalLivros encadernados pela direitaGrade de caracteresKana, kanji e rōmajiFontes chinesas, japonesas e coreanasEspaçamento da pontuação japonesa (yakumono)Títulos sobre linhas do texto (gyōdori)Títulos numeradosAberturas desenhadasEstilos de títuloEstilos de parágrafoBoxesEstilos de tabela com nomeTipos de recurso personalizadosCor do papelPaleta de cores semânticaExportação para PDF
- Também usa
- Bibliografias e glossáriosQuebra de linha em chinêsAtributos de títuloFiguras exatamente aquiCabeços por tipo de páginaFontes incorporadas ao PDFElementos pré-textuais em romanosCapítulos sem número
- Tipografia
- Noto Serif JP, Noto Sans JP, Zen Maru Gothic (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Escolha a grafia pelo lugar onde o número está
O código é a resposta curta logo acima. formatNumeral é o contador com que o motor numera páginas, listas e títulos, e o pen o chama para os números que ele mesmo compõe: japanese-informal conta (120 → 百二十, sem 一 antes de 十 百 千), cjk-decimal escreve dígito a dígito (2026 → 二〇二六) e japanese-formal dá o daiji de um valor (12000 → 壱萬弐阡). Um {{daiji:12000}} no texto vira o valor do recibo, por isso o número é digitado uma vez só, em algarismos. Os mesmos estilos dão nome aos contadores: as seções são {2:一}、, e orderedLists.levels define (一), depois katakana-iroha (イ ロ ハ) e depois hiragana com 、 (あ、い、う). cjk.uprightDigits: 2 põe 8月22日 e 23日 em pé sem marcação, e o !? de 「雨が降ったら中止!?」 divide uma célula, um padrão do japonês (números em texto vertical).

#2 · Ponha o cabeçalho numa faixa pela borda direita
const BAND = 46; // mm from the right trim edge
const at = (x, y, extra = {}) => ({ anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(x), y: mm(y) }, ...extra }); // x down the sheet, y leftward from its right
const onBand = { color: col('paper'), overflow: 'wrap', align: 'left' };
// The date of issue, composed from kan() and pos() as the issue number is: design text the
// contentInConfig check allows, since spelling it is what the recipe shows (#849).
const ISSUED = `${pos(2026)}年(令和${kan(8)}年)${kan(8)}月${kan(1)}日発行`;
const masthead = {
id: 'masthead', numbered: false, toc: false, runningChapter: false,
breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: mm(BAND - 15), slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('leaf') },
placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { height: mm(BAND) } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: ROUND,
fontWeight: 700, fontSize: pt(36), lineHeight: 1.1, letterSpacing: pt(3),
placement: at(HEAD, 9) },
{ kind: 'text', id: 'issue', content: `第${kan(ISSUE)}号`, ...onBand, fontFamily: GOTHIC,
fontWeight: 700, fontSize: pt(12), letterSpacing: pt(2), placement: at(HEAD, 26) },
{ kind: 'text', id: 'date', content: ISSUED,
...onBand, fontFamily: GOTHIC, fontSize: pt(10), align: 'right',
placement: at(HEAD, 26, { size: { width: mm(LINE) } }) },
{ kind: 'text', id: 'publisher', content: '{author}', ...onBand, fontFamily: GOTHIC,
fontSize: pt(10), align: 'right', placement: at(HEAD, 33, { size: { width: mm(LINE) } }) },
{ kind: 'text', id: 'latin', content: '{attr.latin}', ...onBand, fontFamily: GOTHIC,
fontSize: pt(7.5), placement: at(HEAD, 40) },
] } },
};
Numa página vertical, o alto do fluxo é a borda direita da folha, por isso um design de título ancorado ao alto da sangria é uma faixa ao longo dessa borda, e o size.height é a largura dela na folha. O número e a data são texto de design montado com kan() e pos(), e a data termina no pé da mancha com align: 'right'.
#3 · Dê ao calendário uma página só dele
const DAYS = { 2: '訓練', 9: '清掃', 13: 'お盆', 18: '練習会', 19: '練習会',
22: '夏祭り', 23: '夏祭り', 30: '役員会' };
const day = (d) => (d ? { content: `**${d}**\n${DAYS[d] ?? '\u00a0'}`, align: 'center',
...(DAYS[d] ? { background: col(d === 22 || d === 23 ? 'blush' : 'tint') } : {}) }
: { content: '' });
const weeks = []; // 1 August 2026 is a Saturday
for (let d = -5; d <= 31; d += 7) weeks.push([0, 1, 2, 3, 4, 5, 6].map((k) => day(d + k > 0
&& d + k <= 31 ? d + k : 0)));
const calendar = { id: 'calendar', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
// An upright table takes every line of the vertical page it stands on (gap:
// vertical-tables): the calendar is the back page, cited at the end of the text.
placement: { position: 'top', span: 'page' },
caption: '八月の行事。13日から16日まではごみの収集がありません。',
table: { model: { headerRowCount: 1, rows: [[...'日月火水木金土'].map((c) => ({ content: c,
isHeader: true, align: 'center' })), ...weeks] } } };
const resourceTypes = [{ id: 'table', name: '表', shortLabel: '表', captionPrefix: '表',
numberingTemplate: '{n}', counterFormat: '一', resetOn: 'never' }]; // 表一, 表二…
Uma tabela fica em pé numa página vertical e se lê na horizontal, como os livros japoneses imprimem as tabelas; ela ocupa todas as linhas da página onde está. O calendário é citado depois do último parágrafo, como flutuante na largura da página, e por isso vira a contracapa enquanto o texto anterior preenche as páginas. resourceTypes o numera com o token 一 (表一), e um documento ja compõe sozinho o rótulo 表一 : rótulo e número sem espaço e um espaço ideográfico depois.
#4 · Carregue cada voz com o texto que ela compõe
const heads = (markdown.match(/^#+ .*$/gm) ?? []).join('');
const gothicText = `${heads}${markdown}第号年月日発行令和${kan(ISSUE)}${pos(2026)}${
calendar.caption}日月火水木金土${Object.values(DAYS).join('')}領収証(記入例)表一`;
A Noto Serif JP compõe o texto; a Noto Sans JP, os títulos, as listas, o calendário e o rótulo do recibo; e a Zen Maru Gothic, só o título. Cada uma carrega os arquivos do Fontsource dos próprios caracteres, mais os números que o pen compõe.
A receita completa
// ═══ Postext Cookbook · Nº 129 · Kanji numerals, counters and dates in vertical text ═══
// https://postext.dev/en/cookbook/kanji-numerals-and-dates
// Code: MIT · Text: written for the recipe (CC BY 4.0)
// Fonts: Noto Serif JP, Noto Sans JP, Zen Maru Gothic (SIL OFL 1.1) · Needs postext ≥ 1.34.0
// A neighbourhood newsletter set vertically: every way Japanese writes a number.
import {
buildDocument, withLoadedFonts, renderPageToCanvas, loadVerticalAlternates, formatNumeral,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'en'; // @lang: the language of the frame; the newsletter is Japanese in both
const RECIPE = 'kanji-numerals-and-dates';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, the green of young leaves, its tint, a festival red and its blush
const palette = {
ink: '#1f2420', // the text
leaf: '#2f6b3f', // masthead band, section numbers (6.4:1 on the paper)
tint: '#e4efdf', // the calendar's marked days, the receipt
red: '#b4362b', // the receipt's amount
blush: '#f4d4cc', // the festival days in the calendar
muted: '#5f665f', // folios, the colophon
paper: '#fdfdf9',
};
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: 'leaf (defaults)', value: { hex: palette.leaf, model: 'hex' } },
];
// #endregion
const MINCHO = 'Noto Serif JP'; // the text
const GOTHIC = 'Noto Sans JP'; // section heads, labels, the calendar
const ROUND = 'Zen Maru Gothic'; // the masthead's title
const [BODY, LEAD] = [11, 20]; // pt: large print for every age on the street
const [CHARS, LINES] = [44, 20];
const PT = 25.4 / 72; // mm in a point
const TRIM = { w: 182, h: 257 }; // mm, B5
const LINE = CHARS * BODY * PT; // mm: 170.7, the length of a line
const HEAD = 30 + (TRIM.h - 30 - 24 - LINE) / 2; // mm: the head of the type area
// #region answer: one number, four spellings, chosen by where it stands
// formatNumeral is the counter the engine numbers pages, lists and headings with.
const ISSUE = 120;
const kan = (n) => formatNumeral(n, 'japanese-informal'); // 120 → 百二十: counted
const pos = (n) => formatNumeral(n, 'cjk-decimal'); // 2026 → 二〇二六: digit by digit
const daiji = (n) => formatNumeral(n, 'japanese-formal'); // 12000 → 壱萬弐阡: on money
// {{daiji:12000}} in the text: the amount of a receipt in the hard-to-alter daiji.
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
#Escreva todos os anos por extenso
Há quem prefira 二千二十六年 a 二〇二六年 no texto corrido; mude o estilo de pos.
-const pos = (n) => formatNumeral(n, 'cjk-decimal'); // 2026 → 二〇二六: digit by digit
+const pos = (n) => formatNumeral(n, 'japanese-informal'); // 2026 → 二千二十六#Ponha três algarismos em pé
Com 3, um 100 ou um 365 no texto também ocupam uma só célula.
- uprightDigits: 2, // 8月22日: one or two Arabic digits stand in one cell (the default)
+ uprightDigits: 3,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
Componha o japonês com uma fonte japonesa
A Noto Serif SC e a TC têm kana, mas desenham os kanji com formas chinesas (直, 骨 e 角 mudam) e o kana com desenho chinês. Componha o texto em Noto Serif JP ou Shippori Mincho B1 e os títulos em Noto Sans JP, carregadas com loadCjkFonts. Os arquivos japoneses do Fontsource não têm hentaigana nem outros kana históricos (U+1B000–1B16F): loadCjkFonts falha com eles e o PDF imprime caixas, então escreva o kana moderno ou inclua nos recursos da receita uma fonte que os tenha. A Shippori Mincho também não tem as vogais com mácron ō e ū: componha o rōmaji com uma fonte latina. Kana, kanji e rōmaji →
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 →
- O calendário ocupa uma página porque uma tabela em pé toma todas as linhas de uma página vertical (lacuna: tabelas compostas em texto vertical). Uma tabela que deva dividir a página com texto precisa de uma página horizontal, ou de um desenho SVG posto por um design de título.
- Em chinês, o mesmo contador escreve 一百二十 e 一千零一; em japonês, 百二十 e 千一. Escreva
locale: 'ja', senão o token 一 escolhe o estilo chinês. O livro chinês Datas e siglas em pé no texto vertical compõe as datas com o mesmouprightDigits.
Créditos
- Receita
- Ignacio Ferro
- Texto
- The newsletter of a fictional neighbourhood association, written in Japanese for this recipe · Postext Cookbook · CC BY 4.0
- Fontes
- Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1) · Zen Maru Gothic (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)


