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
// 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
- Funcions
- Cites en notesCites en un estil de citaWarichu: notes a dues línies dins de la líniaBibliografia a partir de les referènciesText verticalLlibres enquadernats per la dretaRetícula de caràctersNumeració xinesaAmplada de la puntuació xinesaFonts xineses, japoneses i coreanesObertures dissenyadesTítols numeratsCapçaleres i folisCapçaleres segons el tipus de pàginaMarges simètricsPaleta de color semànticaExportació a PDF
- També fa servir
- Tall de línies en xinèsAtributs de títolColor del paperFonts incrustades al PDFPreliminars en romans
- 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.

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
// 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).
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
// ═══ 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 textErrors 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
- Recepta
- Ignacio Ferro
- 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)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


