Saltar al contingut principal
Recepta número 81

Receptari · Capítol 1 · Pàgina i retícula

Dates i sigles dretes en text vertical

Dos documents de 1912 compostos en vertical i enquadernats per la dreta: els nombres de dues xifres es posen drets sols; :tcy i :upright marquen la resta.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 184 × 260 mm
  • 1 columna
  • Noto Serif TC 12/21
  • LXGW WenKai TC
  • Noto Sans TC
  • 7 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 62 ms
  • 181 línies de codi

En poques paraules

Dos documents xinesos de 1912 escrits en columnes de dalt a baix. Ensenya a col·locar dates, nombres i lletres llatines perquè es llegeixin bé dins del text vertical.

Què compondràs

Set pàgines amb dos textos fundacionals de la República de la Xina: la proclama amb què Sun Wen va assumir la presidència provisional l'1 de gener de 1912 i els dos primers capítols de la Constitució Provisional de l'11 de març. Tot va en vertical, en una pàgina de 184 × 260 mm enquadernada per la dreta. Els documents conserven els seus numerals xinesos, 民國元年三月十一日. Les presentacions i les notes, en lletra Kai, donen en xifres aràbigues les dates del calendari occidental, les quantitats i els números de sèrie, i aquestes xifres són el tema de la recepta: 10月10日 posa cada nombre dret a la seva casella, 1912 i Sun Yat-sen van girats, 民國115年 fica tres xifres en una casella i ROC apila les seves lletres. Una coberta vermelló amb doble filet, una banda vermelló a l'obertura de cada document i capçaleres al tall, amb folis en numerals xinesos, emmarquen el text.

Aquesta recepta respon a

  • Com poso drets dates i números dins d'un text vertical?
  • Com componc un llibre xinès en vertical, enquadernat per la dreta?
  • Com defineixo la caixa en caràcters, tants per línia i tantes línies per pàgina?

La resposta curta

script.js · línies 41–50al codi complet
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.

Ingredients

Tipografia
Noto Serif TC, Noto Sans TC, LXGW WenKai TC (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Deixa els nombres curts a la configuració

El codi és la resposta curta de més amunt. Amb cjk.uprightDigits: 2, qualsevol grup d'una o dues xifres d'un text vertical es posa dret en una casella d'un quadratí, amb les dues xifres l'una al costat de l'altra: 10月10日, 第35號 i 7章56條 no porten cap marca. Un nombre més llarg es compon sencer de costat, com una paraula llatina, que és com clreq compon els nombres de quatre xifres, així que 1912 i 1644 baixen per la línia girats un quart de volta. Si vols dret un nombre de tres xifres, marca'l: 民國:tcy[115]年 estreny el 115 fins que càpiga al quadratí. :upright[ROC] posa cada lletra dreta a la seva pròpia casella, l'una sota l'altra, i la línia mai no es talla a dins (nombres en text vertical).

Pàgina 4, les notes: 10月10日 i 2月12日 drets, 1911 i Sun Yat-sen de costat, 268 i 115 estrenyits amb :tcy, ROC apilada amb :upright.

Els textos de 1912 queden com es van imprimir. Les notes de l'editor segueixen les normes de Taiwan sobre els nombres, el 公文書橫式書寫數字使用原則 del Iuan Executiu, del 2004: les dates, els números de sèrie i les quantitats van en xifres aràbigues (1912年3月8日, 第35號, 7章56條), i els noms propis, les expressions fixes i les xifres rodones conserven els numerals xinesos (東三省, 四萬萬, 四億), igual que la data lunar, 辛亥年八月十九日. Quan una nota cita un títol o un terme dels documents, el deixa com és: 第一章, 二十二行省. Aquestes normes es van escriure per a documents en horitzontal; en vertical, les seves xifres són les que la recepta ha de posar dretes.

#2 · Obre cada document amb una banda a la dreta

script.js · línies 54–78al codi complet
// 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) } }) },
  ] },
};

En un flux vertical, el cap de la pàgina és la vora dreta del full, on comença la lectura. Un disseny de títol ancorat al cap de la sang és, per tant, una banda que baixa per la vora dreta, i el seu size.height és la seva amplada sobre el paper. Els desplaçaments giren amb el flux: x es mesura cap avall i y cap a l'esquerra. La retícula centra la taca entre els marges, i HEAD repeteix aquest càlcul perquè el títol comenci a l'altura del primer caràcter de cada línia. align: 'right' porta la data al peu de la seva línia, on acaben les línies de text, i cjk.uprightDigits arriba també al text del disseny: l'11 de 3月11日 ocupa una sola casella, com al cos. La banda és la de Obertura de capítol sobre banda a sang, girada un quart de volta.

Un disseny de títol no distingeix pàgines parelles i senars, així que la banda baixa sempre per la vora dreta del full. A la pàgina 2, que queda a la dreta, aquesta vora és el tall; a la pàgina 5, que en un llibre enquadernat per la dreta queda a l'esquerra, és el llom, i el títol comença a 8 mm del llom, dins del marge interior de 21,6 mm. Un quadernet grapat s'obre prou per a això. En un llibre cosit o encolat, obre cada document en una pàgina de la dreta amb breakBefore.parity: 'even', que deixa en blanc la pàgina 5.

Pàgina 2: el títol des del cap de la taca, la data al peu de la banda, el 10 de 晚上10時 i el 29 de 同月29日 drets a la presentació.

#3 · Porta les capçaleres al tall

script.js · línies 82–90al codi complet
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' és el marge del costat oposat al llom, així que en un llibre enquadernat per la dreta les capçaleres baixen per la vora esquerra de la pàgina senar i per la dreta de la parella. El títol queda quatre caràcters per sota del cap de la taca i el foli acaba cinc per damunt del seu peu, tots dos en vertical, al 80 % del cos del text (elements de text verticals). pageNumbering.format: 'trad-chinese-informal' imprimeix els folis 三, 四, 六 i 七, i pages: 'body' els treu de les dues obertures.

#4 · Porta la coberta a sang amb un disseny de pàgina

script.js · línies 94–119al codi complet
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'),
  ] } },
};

Un disseny de títol en una columna es talla al peu de la columna, i en una pàgina vertical aquest peu és el marge esquerre: un camp ancorat a la sang es quedava a 21,6 mm del tall esquerre. Amb span: 'page' el títol es compon com a banda de pàgina, que no es talla, i el camp arriba a les dues vores. Els dos marcs dibuixen el filet doble, gruixut i prim, dels llibres impresos xinesos: 1,6 pt i 0,5 pt, separats 2 mm.

#5 · Carrega cada veu amb el text que compon

script.js · línies 317–322al codi complet
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日一二三四五六七八九十';

Fontsource serveix cada gruix d'aquestes fonts en un centenar de fitxers, cadascun amb un tram de caràcters, i loadCjkFonts carrega els fitxers que toca un text. Amb només els títols, els avisos de segell, el colofó, les línies de la coberta i els folis, cada gruix de Noto Sans TC carrega 10 fitxers; amb la mostra sencera en carregaria 35, i són tres gruixos. LXGW WenKai TC rep les presentacions i les notes, i en carrega 16. Una font que rep menys text del que compon fa fallar la captura (C12), que anomena els caràcters que ha hagut de prendre d'una altra font.

La recepta 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 = 'es'; // @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 },
};

L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)

Variants

#Posa drets també els nombres de tres xifres

Amb 3, el 268 i el 115 de les notes ocupen la seva casella sense marca, igual que qualsevol número d'article o de pàgina fins al 999; 1912 continua de costat.

-  uprightDigits: 2,
+  uprightDigits: 3,

#Gira tots els nombres

Amb 0 cap nombre es posa dret per si sol: 10月10日 es gira com 1912, i només el 268, el 115 i ROC, que porten marca, continuen drets.

-  uprightDigits: 2,
+  uprightDigits: 0,

Errors freqüents

Error freqüent

Les fonts xineses es carreguen per fragments, amb el bloc cjk

Fontsource serveix una família xinesa, japonesa o coreana en un centenar de fitxers per pes, cadascun amb un interval de caràcters. loadFonts només baixa el fitxer latin, així que a la pantalla els caràcters xinesos surten d'una font del sistema i es mesuren malament, i fontsourceProvider lliura al PDF aquest fitxer latin, que els imprimeix com a caixes buides. Afegeix el bloc cjk del kit, crida loadCjkFonts(FONTS, markdown) després de loadFonts (una vegada per veu, amb el text que compon, si el llibre fa servir diverses fonts xineses) i passa a renderToPdf fontProvider: cjkPdfProvider: tots dos agafen els fitxers que contenen els caràcters del text. Fonts xineses, japoneses i coreanes →

Error freqüent

Etiqueta el document zh-Hans o zh-Hant, no amb LANG

Les edicions d'una recepta són en i es, però una mostra xinesa és xinesa en totes dues: `locale: LANG` l'etiquetaria com a anglès o castellà, separaria les seves paraules llatines, anomenaria Figure o Figura les seves figures i donaria al PDF una llengua equivocada. Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que sota una etiqueta anglesa o castellana una font xinesa compon amb altres formes les xifres i la puntuació que comparteix amb el text llatí, i les línies es parteixen per un altre lloc. Escriu tu l'etiqueta: 'zh-Hans' (convencions de la Xina continental: tall GB, puntuació Kaiming) o 'zh-Hant' (Taiwan: puntuació d'amplada completa centrada); 'zh-HK' per a Hong Kong. Un 'zh' tot sol es llegeix com a xinès simplificat continental. Una mostra japonesa porta 'ja' (gotcha ja-locale-tag). Tall de línies en xinès →

Error freqüent

Un llibre enquadernat per la dreta mostra els seus plecs amb showBook

En un llibre enquadernat per la dreta (text àrab, hebreu o persa, xinès vertical, o page.binding 'right') la pàgina 1 continua sent senar, però queda a l'esquerra del llom, i els plecs es llegeixen [3 | 2]. showPages compon tots els llibres com si s'enquadernessin per l'esquerra; showBook, del bloc book (el bloc cjk porta la mateixa funció), llegeix doc.binding i reflecteix els plecs. capture.hero continua anomenant un plec en ordre de lectura, [parella, senar]: [2, 3]. Llibres enquadernats per la dreta →

  • Noto Serif TC, tal com la serveix Fontsource, no té 爲 ni 敎: el seu full d'estils els declara, però cap fitxer no porta el glif. La constitució, tal com es va imprimir el 1912, fa servir aquestes formes per a 為 i 教. El canvas va dibuixar 敎 amb una font del sistema i el PDF no en tenia el glif, cosa que va advertir la captura (C25). L'edició compon 為 i 教, porta amb ells 靑 i 决 a 青 i 決, i la presentació ho diu.
  • LXGW WenKai TC, tal com la serveix Fontsource, dibuixa 即, 為, 青 i 教 amb les seves formes antigues, 卽, 爲, 靑 i 敎, que desentonen al costat dels mateixos caràcters del text en Song. Les notes es van redactar sense aquests quatre; només la presentació que enumera les formes antigues de la constitució els vol. Llegeix a mida real el text en Kai de les teves pròpies notes.
  • Un nombre compost de costat se separa del xinès que l'envolta com una paraula llatina, un quart de quadratí a cada costat (cjk.latinSpacing), i per això les presentacions mostren 1912 年; un nombre en una casella no porta espai, com un caràcter xinès.

Crèdits

Text
Fonts
Noto Serif TC (SIL OFL 1.1) · Noto Sans TC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
SandboxPDF