Saltar al contingut principal
Recepta número 91

Receptari · Capítol 5 · Estructura del llibre

Xinès vertical amb citacions en notes dins de la línia

Un capítol vertical en caràcters tradicionals, enquadernat per la dreta, amb les citacions de nota GB/T 7714 compostes com a 夾注 dins de la columna.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Avançat
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 11 d’oct. del 2026
Codi MIT · Text CC BY 4.0

pp. 四十六–四十七 · 2–3 de 3

  • Mostra en castellà: encara no hi ha edició en català
  • Format 140 × 203 mm
  • 1 columna
  • Noto Serif SC 10,5/19
  • LXGW WenKai TC
  • Noto Sans SC
  • 3 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 123 ms
  • 125 línies de codi

En poques paraules

Un capítol d'un llibre xinès compost en columnes de dalt a baix. Cada font es cita en una nota petita de dues línies dins de la columna, i al final es llisten les obres citades.

Què compondràs

El final d'un capítol d'un llibre inventat sobre la impremta xinesa, 版刻叢談 («Converses sobre la impressió xilogràfica»), compost en caràcters tradicionals, de dalt a baix en columnes que es llegeixen des de la dreta, en una pàgina 大32開 de 140 × 203 mm enquadernada per la dreta. El capítol tracta de la disposició de les edicions Song i cita cinc obres reals. Cada citació es compon com els llibres xinesos han compost el comentari durant segles: com un 夾注, una nota en dues files a mig cos, dins de la columna on és la citació. Una nota que no cap en el que queda de columna continua al capdamunt de la següent, i una d'elles continua després del pas de pàgina. Les notes segueixen la forma de nota de la GB/T 7714—2015, la norma de referències de la Xina continental, i el capítol acaba amb una llista numerada de les obres que cita, les angleses girades. El mateix capítol amb les notes a peu de pàgina es compondria com Notes al peu de la columna que les cita.

Aquesta recepta respon a

  • Com cito segons la norma xinesa GB/T 7714, també en text vertical?
  • Com poso les cites en notes a peu de pàgina, a l'estil de Chicago, amb forma breu en les següents?

La resposta curta

script.js · línies 29–43al codi complet
// The GB/T 7714 note style turns each citation into a note. notes: 'warichu' sets the note
// in the column where the citation stands, in two rows at half the text size, the right
// row read first; a note longer than what is left of the column goes on in the next one.
// The list at the chapter's end comes from :::bibliography{scope=chapter}, numbered in
// the order the works are cited. Latin words turn sideways in the notes and in the list.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'china-national-standard-gb-t-7714-2015-note',
  notes: 'warichu', // 夾注; 'footnote' sets the same notes at the foot of the page
  bibliography: { fontSize: em(0.9), entrySpacing: pt(0) },
};
const cjk = {
  grid: { enabled: true, charsPerLine: 36, linesPerPage: 15 },
  warichu: { fontSize: em(0.5), color: col('ink') }, // no brackets: the half size sets it off
};

Ingredients

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

Elaboració

#1 · Un estil de notes, compost dins de la línia

El codi és la resposta curta de més amunt. L'estil de notes de la GB/T 7714 (china-national-standard-gb-t-7714-2015-note) converteix cada citació en una nota que anomena l'obra sencera (Citacions). Per defecte, un estil de notes envia les notes a peu de pàgina. notes: 'warichu' deixa cada nota a la columna, composta com a warichu: dues files a cjk.warichu.fontSize, mig cos del text, centrades a la columna, i es llegeix primer la fila dreta (Marques, ruby i warichu). El Markdown és el de qualsevol estil, [@su1999] després de les paraules que avala, i la nota ocupa el lloc de la citació, abans del 。 que tanca la frase.

Pàgina 1: la nota del llibre de 宿白 comença al peu de la tercera columna i continua al capdamunt de la quarta, cada vegada amb la fila dreta primer.

Les files s'omplen per trams. Al peu de la tercera columna només hi caben 宿白. 唐宋時期, que es reparteixen en dues files de tres i quatre caselles; la resta de la nota omple el capdamunt de la columna següent, altra vegada en dues files. A la pàgina 2 la nota de Twitchett comença al peu de l'última columna, i el lector passa la pàgina per acabar-la.

#2 · Les obres citades, al final del capítol

:::bibliography{title="本章引用書目" scope=chapter} col·loca la llista on és i només inclou les obres que cita aquest capítol (La bibliografia). Les referències surten d'un bloc BibTeX. Cada entrada porta un langid, chinese o english, que l'estil llegeix com a llengua de l'obra, i els noms escrits en caràcters queden sencers. La llista es numera per ordre de primera citació, i les columnes següents de cada entrada comencen sota la seva etiqueta.

#3 · Caràcters tradicionals amb les regles del continent

locale: 'zh-Hant-CN' demana caràcters tradicionals amb les regles de la Xina continental, com componen els editors de Pequín i Xangai els estudis clàssics: la coma i el punt van a la cantonada superior dreta de la seva casella, i un llibre vertical s'enquaderna per la dreta. Les citacions segueixen l'etiqueta: l'escriptura tradicional tria el locale CSL zh-TW, així que les paraules que afegeix l'estil també van en caràcters tradicionals. Noto Serif SC dibuixa els caràcters tradicionals amb les formes del continent, que és el que demana aquesta edició; LXGW WenKai TC, una font de Taiwan, només compon el títol del capítol, que no porta puntuació (Números en text vertical explica què passa amb les xifres).

A les notes i a la llista, un títol llatí i un any de quatre xifres es giren i baixen per la columna. Un número curt al costat de text xinès, com l'1 d'una etiqueta, queda dret a la seva casella.

#4 · L'obertura entre filets

script.js · línies 47–64al codi complet
// In the flow frame x runs down the column and y across the page, right to left, so a
// 'horizontal' rule is a vertical line on the sheet: three of them rule the two columns.
const [TITLE, PITCH] = [15, 1.6 * LEAD]; // pt: the title's size and its column pitch
const rule = (n) => ({ kind: 'rule', id: `rule-${n}`, direction: 'horizontal',
  thickness: pt(n === 1 ? 0.4 : 0.8), color: col('vermilion'),
  placement: { anchor: { to: 'container', edge: 'top-left' },
    offset: { y: pt(LEAD + n * PITCH) }, size: { width: 'fill' } } });
// A line of PITCH in column n (0, 1), its characters centred between two rules.
const title = (id, content, n, family, size, weight) => ({ kind: 'text', id, content,
  fontFamily: family, fontWeight: weight, fontSize: pt(size), lineHeight: PITCH / size,
  color: col('ink'), letterSpacing: pt(size * 0.25), align: 'left',
  placement: { anchor: { to: 'container', edge: 'top-left' },
    offset: { x: pt(2 * BODY), y: pt(LEAD + n * PITCH) } } }); // two characters down
const opener = { enabled: true, minHeight: cols(5), slot: { elements: [
  rule(0), rule(1), rule(2),
  title('number', '{number}', 0, HEI, 12, 700), // 第三章 in the first column, in 黑
  title('title', '{titleText}', 1, KAI, TITLE, 400), // the title in the second, in 楷
] } };

En una pàgina vertical, un disseny de títol es col·loca en el marc del flux: x baixa per la columna i y travessa la pàgina des de la vora dreta, així que un filet 'horizontal' és una línia vertical al full. Tres filets emmarquen dues columnes a 30,4 pt. 第三章 va a la primera en Hei negreta, i el títol a la segona en Kai (Extensió i disseny avançat). El número del capítol surt de startAt=3 al títol i de la plantilla 第{1:一}章, i els folis de pageNumbering: trad-chinese-informal des de 45. Les capçaleres i els folis baixen pel marge exterior com a Una novel·la xinesa vertical, enquadernada per la dreta (Elements de text verticals).

script.js · línies 17–22al codi complet
const palette = {
  ink: '#22201c', vermilion: '#a8352a', muted: '#6d665d', paper: '#fbf8f1',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.vermilion })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

La recepta completa

Sandbox
// ═══ Postext Cookbook · Nº 091 · Vertical Chinese with citations in inline notes ══════
// https://postext.dev/en/cookbook/vertical-book-with-jiazhu-citations
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Noto Serif SC, Noto Sans SC, LXGW WenKai TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerCitationEngine,
  loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
import { createCiteprocEngine, STYLES, LOCALES } from 'https://esm.sh/postext-citeproc';

const LANG = 'es'; // @lang: the language of the frame; the chapter is Chinese in both editions
const RECIPE = 'vertical-book-with-jiazhu-citations';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black ink, one vermilion for the opener's rules, the paper of the page
const palette = {
  ink: '#22201c', vermilion: '#a8352a', muted: '#6d665d', paper: '#fbf8f1',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.vermilion })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SONG, HEI, KAI] = ['Noto Serif SC', 'Noto Sans SC', 'LXGW WenKai TC']; // 宋, 黑, 楷
const [BODY, LEAD] = [10.5, 19]; // pt: 五號 on a column pitch of 1.8 em
const cols = (n) => pt(n * LEAD); // n columns across the page

// #region answer: a note style set as 夾注, two half-size rows inside the column
// The GB/T 7714 note style turns each citation into a note. notes: 'warichu' sets the note
// in the column where the citation stands, in two rows at half the text size, the right
// row read first; a note longer than what is left of the column goes on in the next one.
// The list at the chapter's end comes from :::bibliography{scope=chapter}, numbered in
// the order the works are cited. Latin words turn sideways in the notes and in the list.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'china-national-standard-gb-t-7714-2015-note',
  notes: 'warichu', // 夾注; 'footnote' sets the same notes at the foot of the page
  bibliography: { fontSize: em(0.9), entrySpacing: pt(0) },
};
const cjk = {
  grid: { enabled: true, charsPerLine: 36, linesPerPage: 15 },
  warichu: { fontSize: em(0.5), color: col('ink') }, // no brackets: the half size sets it off
};
// #endregion

// #region opener: 第三章 and the title in two ruled columns, the text after a blank one
// In the flow frame x runs down the column and y across the page, right to left, so a
// 'horizontal' rule is a vertical line on the sheet: three of them rule the two columns.

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

#Claudàtors al voltant de cada nota

Algunes edicions tanquen el 夾注 entre claudàtors al cos del text. cjk.warichu els posa a totes les notes, també a les de les citacions.

-  warichu: { fontSize: em(0.5), color: col('ink') }, // no brackets: the half size sets it off
+  warichu: { fontSize: em(0.5), color: col('ink'), open: '〔', close: '〕' },

#Números a la columna en lloc de notes

L'estil numèric de la GB/T 7714 amb claudàtors de cantonada imprimeix 〔1〕 dret a la columna, i la llista no canvia.

-  style: 'china-national-standard-gb-t-7714-2015-note',
-  notes: 'warichu', // 夾注; 'footnote' sets the same notes at the foot of the page
+  style: 'china-national-standard-gb-t-7714-2015-numeric',
+  marker: 'corner', // 〔1〕, upright in vertical text

Errors freqüents

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

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

Compon la puntuació de cada regió amb una font d'aquella regió

Les amplades de la puntuació mouen el blanc de cada signe al costat on el posa la regió del document, no al costat on el dibuixa la font: amb zh-Hans, una coma Kaiming conserva la meitat esquerra de la seva caixa, on una font simplificada dibuixa el signe, i cedeix la dreta. Una font tradicional centra ,。 a la caixa, de manera que la meitat que se'n va s'emporta part del signe i la coma s'enganxa al caràcter següent. LXGW WenKai TC, l'única Kai de text de Fontsource, ho fa en text simplificat. Compon el text, les notes i les cites continentals en Noto Serif SC o Noto Sans SC, deixa les fonts TC per a zh-Hant i fes servir una lletra de pinzell simplificada (Ma Shan Zheng) només en línies d'exhibició, on el text de disseny no aplica amplades de puntuació. A més, dibuixa formes heretades que no imprimeix ni l'estàndard continental ni el de Taiwan, 為 amb el 爫 de 爲 i 令 (a 冷, 領) amb el peu de 卩: revisa els caràcters que compon a cada pàgina. Amplada de la puntuació xinesa →

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 →

  • Un estil de notes abreuja la segona citació d'una obra, i el de la GB/T 7714 la redueix a 同1, «com a la nota 1». Un warichu no té número, així que el lector no troba la nota 1. Aquest capítol cita cada obra una vegada; un text que torni a citar una obra ha d'escriure la segona citació a mà o fer servir l'estil numèric de la segona variant.
  • L'estil escriu puntuació occidental a les entrades xineses, 宿白. 唐宋時期的雕版印刷[M]. 北京: 文物出版社, 1999., tal com les imprimeix la norma. En una columna vertical aquests signes conserven la forma occidental: es giren i ocupen menys d'una casella, a diferència del 。 i la , del text.
  • Una fila de warichu va a mig cos: amb un text de 10,5 pt, cada fila fa 5,25 pt, la lletra més petita de la pàgina. Compon el text a 五號 o més gran, o puja cjk.warichu.fontSize; les dues files comparteixen sempre l'amplada d'una columna.

Crèdits

Text
Text original, CC BY 4.0
Fonts
Noto Serif SC (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
SandboxPDF