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

Receitas · Capítulo 1 · Página e grade

Datas e siglas em pé no texto vertical

Dois documentos de 1912 em escrita vertical, encadernados pela direita: números de dois algarismos ficam em pé sozinhos, e :tcy e :upright marcam o resto.

Nesta página
Saída
Canvas · PDF
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. 一 · 1 de 7

  • Amostra em inglês: ainda sem edição em português
  • Refile 184 × 260 mm
  • 1 coluna
  • Noto Serif TC 12/21
  • LXGW WenKai TC
  • Noto Sans TC
  • 7 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 59 ms
  • 181 linhas de código

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

script.js · linhas 41–50no código completo
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

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).

Página 4, as notas: 10月10日 e 2月12日 em pé, 1911 e Sun Yat-sen de lado, 268 e 115 comprimidos com :tcy, ROC empilhada com :upright.

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

script.js · linhas 54–78no código completo
// 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.

Página 2: o título a partir do alto da mancha, a data no pé da faixa, o 10 de 晚上10時 e o 29 de 同月29日 em pé na apresentação.

#3 · Pôr os cabeços na margem externa

script.js · linhas 82–90no código completo
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

script.js · linhas 94–119no código completo
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

script.js · linhas 317–322no código completo
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

Sandbox
// ═══ 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 mostram 1912 年; um número numa casa só não leva espaço, como um caractere chinês.

Créditos

Texto
Fontes
Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
SandboxPDF