Em poucas palavras
Dois documentos chineses de 1912, impressos em colunas de cima para baixo. Mostra como compor datas, números e letras latinas para que se leiam bem dentro do texto vertical.
O que você vai compor
Uma antologia de sete páginas com dois textos fundadores da República da China: a proclamação com que Sun Wen assumiu o cargo em 1º de janeiro de 1912 e os dois primeiros capítulos da Constituição Provisória de 11 de março. As páginas são compostas na vertical, numa página de 184 × 260 mm encadernada pela direita. Os documentos mantêm os numerais chineses, 民國元年三月十一日. As apresentações e as notas, em letra Kai, dão em algarismos arábicos as datas do calendário ocidental, as quantidades e os números de série, e são esses algarismos que a receita compõe: 10月10日 põe cada número em pé na casa, 1912 e Sun Yat-sen vão deitados de lado, 民國115年 encaixa três algarismos numa casa e ROC empilha as letras. Uma capa vermelhão dentro de um fio duplo, uma faixa vermelhão onde cada documento abre e cabeços na margem externa com fólios em numerais chineses emolduram o texto.
Esta receita responde a
- Como deixo datas e números em pé dentro de um texto vertical?
- Como componho um livro chinês na vertical, encadernado à direita?
- Como defino a mancha em caracteres, tantos por linha e tantas linhas por página?
A resposta curta
const layout = { layoutType: 'single', writingMode: 'vertical-rl' }; // binding 'auto': right
const cjk = {
// 10月10日: each number of up to two digits stands upright in one cell (tate-chu-yoko);
// 1912 and Sun Yat-sen stay on their side, as clreq sets long numbers and Latin words.
uprightDigits: 2,
// The type area in characters: 44 down each line, 19 lines to the page.
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: 19 },
};
// By hand, in the Markdown: 民國:tcy[115]年 puts three digits in one cell, :upright[ROC]
// stands each letter of an acronym upright, :sideways[…] turns any run with the line.
Ingredientes
- Funcionalidades
- Números em pé no texto verticalTexto verticalLivros encadernados pela direitaGrade de caracteresNumeração chinesaFontes chinesas, japonesas e coreanasLargura da pontuação chinesaQuebra de linha em chinêsAberturas desenhadasEstilos de títuloAtributos de títuloEstilos de parágrafoCabeços e fóliosTextos, fios e caixas nos designs de páginaCor do papelPaleta de cores semânticaExportação para PDFFontes incorporadas ao PDF
- Também usa
- Bibliografias e glossáriosCabeços por tipo de páginaElementos pré-textuais em romanosCabeços por seçãoCapítulos sem número
- Tipografia
- Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Deixar os números curtos para a configuração
O código é a resposta curta lá em cima. Com cjk.uprightDigits: 2, toda sequência de um ou dois algarismos num texto vertical fica em pé numa casa de um eme, os dois algarismos lado a lado: 10月10日, 第35號 e 7章56條 não precisam de marcação. Um número mais longo é composto inteiro de lado, como uma palavra latina, que é como o clreq compõe os números de quatro algarismos, de modo que 1912 e 1644 descem pela linha girados um quarto de volta. Um número de três algarismos que deva ficar em pé leva uma marca: 民國:tcy[115]年 comprime o 115 dentro do eme. :upright[ROC] põe cada letra em pé numa casa própria, uma embaixo da outra, e a linha nunca quebra no meio (números em texto vertical).

Os textos de 1912 ficam como foram impressos. As notas do editor seguem as normas de Taiwan para números, os 公文書橫式書寫數字使用原則 do Yuan Executivo, de 2004: datas, números de série e quantidades levam algarismos arábicos (1912年3月8日, 第35號, 7章56條), enquanto nomes próprios, expressões fixas e números redondos mantêm os numerais chineses (東三省, 四萬萬, 四億), assim como a data lunar, 辛亥年八月十九日. Quando uma nota cita um título ou um termo dos documentos, mantém a forma deles, 第一章 e 二十二行省. Essas normas foram escritas para documentos horizontais; compostos na vertical, os algarismos são justamente os que a receita precisa pôr em pé.
#2 · Abrir cada documento com uma faixa à direita
// The margins are minimums: the grid centres the 44 characters (186.3 mm) between them,
// so the type area starts HEAD mm down the sheet. The band's title starts there too.
const HEAD = MARGIN.top + (TRIM.h - MARGIN.top - MARGIN.bottom - LINE) / 2;
const BAND = 42; // mm from the right trim edge: where a reader of vertical text starts
const onBand = { color: col('paper'), overflow: 'wrap' };
// In the flow of a vertical page x runs down the sheet and y leftward from its right edge.
const at = (x, y, extra = {}) => ({ anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(x), y: mm(y) }, ...extra });
const opener = {
enabled: true,
minHeight: mm(BAND - 15), // past the side margin (21.6 mm), 6 mm of paper before the text
slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('seal') },
placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { height: mm(BAND) } } },
{ kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: HEI,
fontWeight: 700, fontSize: pt(34), lineHeight: 1.2, letterSpacing: pt(4), align: 'left',
placement: at(HEAD, 8) },
{ kind: 'text', id: 'latin', content: '{attr.latin}', ...onBand, fontFamily: HEI,
fontSize: pt(9), lineHeight: 1.6, align: 'left', placement: at(HEAD, 25) },
// The date ends where the lines of text end: align 'right' is the foot of a vertical line.
{ kind: 'text', id: 'date', content: '{attr.date}', ...onBand, fontFamily: HEI,
fontWeight: 500, fontSize: pt(13), lineHeight: 1.2, align: 'right',
placement: at(HEAD, 24, { size: { width: mm(LINE) } }) },
] },
};
Num fluxo vertical, o alto da página é a borda direita da folha, onde a leitura começa. Um design de título ancorado no alto da sangria é, portanto, uma faixa que desce pela borda direita, e o size.height é a largura no papel. Os deslocamentos giram com o fluxo: x mede para baixo na folha, y para a esquerda. A grade centra a mancha entre as margens, e HEAD repete essa conta, para que o título comece na altura do primeiro caractere de cada linha. align: 'right' leva a data ao pé da linha, onde as linhas de texto terminam, e cjk.uprightDigits alcança também o texto do design: o 11 de 3月11日 fica numa casa só, como no corpo. A faixa é a de Abertura de capítulo sobre uma faixa sangrada, girada um quarto de volta.
Um design de título não tem paridade, por isso a faixa sempre desce pela borda direita da folha. Na página 2, uma página da direita, essa borda é o corte dianteiro; na página 5, uma página da esquerda num livro encadernado pela direita, é a lombada, e o título começa a 8 mm da dobra, dentro da margem interna de 21,6 mm. Um caderno grampeado abre o bastante para isso. Num livro costurado ou colado, abra cada documento numa página da direita com breakBefore.parity: 'even', que deixa a página 5 em branco.

#3 · Pôr os cabeços na margem externa
const foreEdge = (id, content, edge, y) => ({
kind: 'text', id, content, writingMode: 'vertical-rl', pages: 'body', align: 'left',
fontFamily: HEI, fontSize: pt(9.6), color: col('muted'), overflow: 'clip',
placement: { anchor: { to: 'outer', edge }, offset: { y: em(y) } },
});
const header = { elements: [
foreEdge('head', '{chapterTitle}', 'top', 4), // four characters below the type area
foreEdge('folio', '{pageNumber}', 'bottom', -5), // ends five characters above its foot
] };
anchor.to: 'outer' é a margem do lado oposto à lombada, por isso num livro encadernado pela direita os cabeços descem pela borda esquerda do recto e pela borda direita do verso. O título fica quatro caracteres abaixo do alto da mancha e o fólio termina cinco acima do pé, ambos na vertical, a 80 % do corpo (elementos de texto verticais). pageNumbering.format: 'trad-chinese-informal' imprime os fólios 三, 四, 六 e 七, e pages: 'body' os tira das duas aberturas.
#4 · Sangrar a capa com um design na largura da página
const frame = (id, inset, width) => ({ kind: 'box', id,
style: { borderColor: col('tint'), borderWidth: pt(width) },
placement: at(inset, inset, { size: { width: mm(TRIM.h - 2 * inset),
height: mm(TRIM.w - 2 * inset) } }) });
const coverLine = (id, content, y, align) => ({ kind: 'text', id, content, ...onBand,
fontFamily: HEI, fontWeight: 500, fontSize: pt(18), lineHeight: 1.2, align,
placement: at(HEAD, y, { size: { width: mm(LINE) } }) });
const cover = {
id: 'cover', numbered: false, toc: false, runningChapter: false,
span: 'page', // a page-wide design is not cut at the foot of the column: the field bleeds
header: { elements: [] }, footer: { elements: [] },
advancedDesign: { enabled: true, slot: { elements: [
{ kind: 'box', id: 'field', style: { backgroundColor: col('seal') },
placement: { anchor: { to: 'bleed', edge: 'top-left' }, size: { height: mm(TRIM.w) } } },
frame('rule-outer', 11, 1.6), frame('rule-inner', 13, 0.5), // 文武線: thick, then thin
{ kind: 'text', id: 'title', content: '{titleText}', ...onBand, fontFamily: HEI,
fontWeight: 700, fontSize: pt(56), lineHeight: 1.1, letterSpacing: pt(5.6), align: 'left',
placement: at(HEAD, 26) },
{ kind: 'text', id: 'latin', content: '{attr.latin}', ...onBand, fontFamily: HEI,
fontSize: pt(11), lineHeight: 1.4, align: 'left', placement: at(HEAD, 51) },
coverLine('first', '臨時大總統宣言書', 104, 'left'),
coverLine('first-date', '1912年1月1日', 104, 'right'),
coverLine('second', '中華民國臨時約法', 118, 'left'),
coverLine('second-date', '1912年3月11日', 118, 'right'),
] } },
};
Um design de título dentro de uma coluna é cortado no pé da coluna, e numa página vertical esse pé é a margem esquerda: um campo ancorado na sangria parava a 21,6 mm do refile esquerdo. Com span: 'page', o título é composto como faixa de página, que não é cortada, e o campo chega às duas bordas. As duas molduras desenham o fio duplo, grosso e fino, dos livros impressos chineses: 1,6 pt e 0,5 pt, a 2 mm um do outro.
#5 · Carregar cada voz com o texto que ela compõe
const voice = (styles) => (markdown.match(
new RegExp(`:::paragraphs\\{style="(?:${styles})"\\}[\\s\\S]*?:::`, 'g')) ?? []).join('');
const kaiText = voice('headnote|note');
// Hei: headings and their attributes, seals, colophon, the cover's lines, folios 一 to 十.
const heiText = (markdown.match(/^#.*$/gm) ?? []).join('') + voice('seal|colophon')
+ '臨時大總統宣言書1912年1月1日中華民國臨時約法1912年3月11日一二三四五六七八九十';
A Fontsource serve cada peso destas fontes em cerca de cem arquivos, cada um cobrindo uma faixa de caracteres, e loadCjkFonts carrega os arquivos que um texto toca. Recebendo só os títulos, os avisos de selo, o colofão, as linhas da capa e os fólios, cada peso da Noto Sans TC carrega 10 arquivos; com a amostra inteira, carregaria 35, e são três pesos. A LXGW WenKai TC recebe as apresentações e as notas e carrega 16. Uma fonte que recebe texto de menos faz a captura falhar (C12), e a captura indica os caracteres que precisou pegar de uma fonte de reserva.
A receita completa
// ═══ Postext Cookbook · Nº 081 · Dates and acronyms upright in vertical text ═══════
// https://postext.dev/en/cookbook/chinese-dates-upright
// Code: MIT · Text: 1912 documents, zh.wikisource (CC BY-SA 4.0); notes (CC BY 4.0)
// Fonts: Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
// Two founding documents of the Republic of China, 1912, set vertically as a reader.
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 sample document ('en' | 'es')
const RECIPE = 'chinese-dates-upright';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, the vermilion of a seal, and the paper of a gazette
const palette = {
ink: '#1e1a17', // text: a warm near-black
seal: '#b1291f', // the one accent: the bands, the seal notes, the chapter heads
tint: '#f6dccf', // the cover's double rule, a pale vermilion
muted: '#6d645b', // fore-edge heads, the colophon
paper: '#fffdf8',
};
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' } },
];
// #endregion
const SONG = 'Noto Serif TC'; // 宋/明: the documents
const HEI = 'Noto Sans TC'; // 黑: titles, heads, labels
const KAI = 'LXGW WenKai TC'; // 楷: the editor's headnotes and notes
const BODY = 12; // pt, 小四
const LEAD = 21; // pt: a line gap of 0.75 em
const CHARS = 44; // characters to a line
const LINE = (CHARS * BODY * 25.4) / 72; // mm: the length of a line, 186.3
const TRIM = { w: 184, h: 260 }; // mm, 16开
const MARGIN = { top: 30, bottom: 22, side: 20 }; // mm, minimums: 天头 deeper than 地脚
// #region answer: vertical text where numbers of one or two digits stand upright
const layout = { layoutType: 'single', writingMode: 'vertical-rl' }; // binding 'auto': right
const cjk = {
// 10月10日: each number of up to two digits stands upright in one cell (tate-chu-yoko);
// 1912 and Sun Yat-sen stay on their side, as clreq sets long numbers and Latin words.
uprightDigits: 2,
// The type area in characters: 44 down each line, 19 lines to the page.
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: 19 },
};
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 em pé também os números de três algarismos
Com 3, o 268 e o 115 das notas ocupam a casa sem marcação, como faria qualquer número de artigo ou de página até 999; 1912 continua de lado.
- uprightDigits: 2,
+ uprightDigits: 3,#Deitar todos os números de lado
Com 0, nenhum número fica em pé sozinho: 10月10日 gira como 1912, e só o 268, o 115 e ROC, que estão marcados, continuam em pé.
- uprightDigits: 2,
+ uprightDigits: 0,Erros comuns
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
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 →
- A Noto Serif TC, do jeito que a Fontsource a serve, não tem 爲 nem 敎: a folha de estilo declara os dois, mas nenhum arquivo traz o glifo. A impressão de 1912 da constituição escreve 為 e 教 nessas formas. O canvas desenhou 敎 com uma fonte do sistema e o PDF não tinha glifo para ele, o que a captura acusou (C25). A antologia compõe 為 e 教, leva junto 靑 e 决 para 青 e 決, e a apresentação avisa.
- A LXGW WenKai TC, do jeito que a Fontsource a serve, desenha 即, 為, 青 e 教 nas formas antigas 卽, 爲, 靑 e 敎, que destoam ao lado dos mesmos caracteres no texto em Song. As notas foram redigidas sem esses quatro; só a apresentação que lista as formas antigas da constituição precisa deles. Leia em tamanho real o texto em Kai das próprias notas.
- Um número composto de lado se separa do chinês ao redor como uma palavra latina, um quarto de eme de cada lado (
cjk.latinSpacing), e por isso as apresentações mostram1912 年; um número numa casa só não leva espaço, como um caractere chinês.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Sun Wen (Sun Yat-sen), proclamation on taking office as Provisional President, 1 January 1912, from the original in the Guangzhou Museum · Sun Wen; transcription and punctuation by Wikisource editors · CC BY-SA 4.0
- Provisional Constitution of the Republic of China, 11 March 1912 (Linshi zhengfu gongbao no. 35), chapters 1 and 2, with its promulgation order; four old character forms set in their current forms · Provisional Senate, Nanjing; transcription by Wikisource editors · CC BY-SA 4.0
- The headnotes and notes in Chinese, written for this recipe · Postext Cookbook · CC BY 4.0
- Fontes
- Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai 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)


