En poques paraules
Un article breu d'una revista científica xinesa. L'autor escriu un codi per a cada font; Postext numera les fonts per ordre de citació i compon la llista de referències com la demanen les revistes xineses.
Què compondràs
Dues pàgines d'un article de recerca en una revista inventada d'estudis editorials, 示例出版研究 («Recerca Editorial d'Exemple»), compost com compon els articles una revista universitària xinesa. La pàgina és un 16开 de 184 × 260 mm, amb dues columnes de 23 caràcters de 小五 sobre una retícula de 15 pt. Un bloc de títol travessa la pàgina: el nom de la revista sobre una banda anyil, el títol en Hei negreta, els autors, les seves filiacions i un resum amb les paraules clau. Les citacions segueixen la GB/T 7714—2015, la norma nacional xinesa de referències, en el sistema numèric (顺序编码制): cada obra rep un número per l'ordre en què se cita per primera vegada, el número surt volat entre claudàtors i tres o més números seguits s'uneixen en un interval. La llista de referències dona a cada entrada el seu codi de tipus de document i escriu 等 després dels tres primers autors d'una obra xinesa i «et al.» després dels d'una occidental. Un capítol de tesi citat en APA 7 fa servir el mateix marcatge de citacions en un estil autor-any.
Aquesta recepta respon a
- Com cito segons la norma xinesa GB/T 7714, també en text vertical?
- Com cito obres i componc la bibliografia en APA, IEEE o un altre estil de cita?
La resposta curta
// Register the engine once, before the first build. The GB/T 7714 numeric style writes
// superscript [n] in the order works are first cited, joins three or more in a row into a
// range and sets the list with its type codes: [M] book, [J] article, [D] thesis, [C]
// conference paper, [EB/OL] web page. Its CSL file holds a second layout for works whose
// language is English, with "et al." for 等: a Western entry takes "et al." and a Chinese
// one keeps 等, each chosen by the entry's `language`.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'china-national-standard-gb-t-7714-2015-numeric',
locale: 'zh-CN', // 等, 卷, 版 and the other terms of the list
bibliography: { fontSize: em(7.5 / BODY), lineHeight: pt(12), entrySpacing: pt(1.5),
labelWidth: em(1.7) }, // turnovers under the text, not past it: [1] and a space
};
Ingredients
- Funcions
- Cites en un estil de citaBibliografia a partir de les referènciesRetícula de caràctersFonts xineses, japoneses i coreanesAmplada de la puntuació xinesaUna o dues columnesObertures dissenyadesAncoratge d'elements de dissenyTítols numeratsEstils de títolCapítols sense númeroRequadresChips en líniaCapçaleres i folisPaleta de color semànticaExportació a PDF
- També fa servir
- Tall de línies en xinèsEquilibri de columnesAtributs de títolCapçaleres segons el tipus de pàginaEstils de paràgrafFonts incrustades al PDFPreliminars en romansSalts de línia als títols
- 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 · L'estil, i la seva plantilla per a les obres occidentals
El codi és la resposta curta de més amunt. El motor de citacions es registra una vegada, abans de la primera composició, i postext-citeproc porta els tres estils de la GB/T 7714: numèric, autor-any i de notes (Citacions). Al text, una citació és una clau entre claudàtors. [@tinker1963] imprimeix un [1] volat, i [@rayner2016; @dyson2001; @lin2023] imprimeix [2–4]. Dos números seguits queden com a llista, [5,6]. Una obra citada de nou conserva el primer número: [4] al tercer paràgraf, i [1] i [2] més endavant.
La norma demana «et al.» després dels tres primers autors d'una obra occidental i 等 després dels d'una xinesa. El fitxer CSL inclòs porta dues plantilles per a això, una de les quals per a les obres en anglès, i cada entrada pren la seva segons el seu propi camp language: Rayner i quatre coautors queden en «RAYNER K, SCHOTTER E R, MASSON M E J, et al.», i 林岚 i tres coautors en «林岚, 周明远, 陈思齐, 等». locale: 'zh-CN' escriu en xinès la resta de paraules de la llista.
#2 · Les referències en un bloc CSL-YAML
Les obres van en un bloc :::references{format=csl-yaml} al final del Markdown, en el format que Zotero exporta com a CSL YAML (Citar). El tipus CSL decideix el codi: book imprimeix [M], article-journal [J], thesis [D], paper-conference [C] després de la seva // i les actes, i webpage [EB/OL] amb la data de consulta entre claudàtors. Un article amb DOI passa a [J/OL] i conserva el DOI, com demana la norma. Els noms xinesos van a literal, perquè l'estil no els parteixi en cognom i nom. :::bibliography{title=""} col·loca la llista sota el títol sense número 参考文献, i labelWidth alinea les línies següents de cada entrada amb el seu text, no més endins.

#3 · El bloc de títol sobre una banda
const BAND = 30; // mm from the trim's top
const at = (id, edge, y) => ({ anchor: { to: id ? `#${id}` : 'container', edge },
offset: { y: mm(y) }, size: { width: mm(AREA) } });
const line = (id, content, family, size, color, placement, extra) => ({ kind: 'text', id,
content, fontFamily: family, fontSize: pt(size), color: col(color), align: 'center',
overflow: 'wrap', placement, ...extra });
const onBand = (x, y) => ({ anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(x), y: mm(y) }, size: { width: mm(AREA) } });
const [JOURNAL, ISSUE] = ['示例出版研究', '第44卷 第3期 2026年9月']; // the journal's band
const masthead = { enabled: true, minHeight: pt(9 * LEAD), slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('indigo') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: mm(BAND) } } },
line('journal', JOURNAL, HEI, 15, 'paper', onBand(15.8, 13),
{ fontWeight: 700, align: 'left', letterSpacing: pt(3) }),
line('issue', ISSUE, HEI, 8, 'mist', onBand(15.8, 16),
{ align: 'right' }),
line('title', '{titleText}', HEI, 17, 'ink', at('', 'top-left', 14),
{ fontWeight: 700, lineHeight: 1.45 }),
line('authors', '{attr.authors}', KAI, 12, 'ink', at('title', 'below', 4)),
line('affiliations', '{attr.affiliations}', SONG, 7.5, 'muted', at('authors', 'below', 2)),
] } };
El bloc de títol és el disseny de l'H1, amb un estil d'encapçalament que ocupa les dues columnes. La banda és una caixa ancorada al tall, i el nom de la revista hi va a sobre en blanc. El títol, els autors i les filiacions surten del títol i els seus atributs, cadascun col·locat sota l'anterior (#title, below), de manera que un títol de tres línies empeny la resta cap avall (Extensió i disseny avançat).
#4 · El resum i les seves etiquetes
// In 宋, not 楷: the one Kai on Fontsource is a Taiwan face (gotcha: cjk-face-region).
const calloutStyles = [{ id: 'abstract', span: 'page', backgroundEnabled: false,
padding: { top: pt(0), bottom: pt(0), left: em(2), right: em(2) },
marginTop: pt(0), marginBottom: pt(LEAD),
body: { fontFamily: SONG, fontSize: pt(BODY), lineHeight: pt(LEAD), firstLineIndent: pt(0),
textAlign: 'justify' } }];
const chipStyles = [{ id: 'label', fontFamily: HEI, bold: true, color: col('indigo'),
backgroundEnabled: false, borderWidth: pt(0), paddingX: em(0), gap: em(0.5) }];
El resum és un requadre a tota l'amplada, sagnat dos caràcters per cada costat. Les etiquetes són xips: :chip[摘 要:]{style="label"} compon la paraula en Hei negreta, en l'anyil de la revista, sense caixa (Estils de chip). Les revistes xineses solen compondre el resum en 楷体; aquesta el deixa en Song, pel motiu que s'explica a Errors freqüents.
const palette = {
ink: '#1a1a1a', indigo: '#24427a', mist: '#b8c6e0', rule: '#9aa3b5', muted: '#5f6470',
paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.indigo })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
La recepta completa
// ═══ Postext Cookbook · Nº 090 · A Chinese paper cited to GB/T 7714 ═════════════════
// https://postext.dev/en/cookbook/gbt7714-chinese-paper
// 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.34.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerCitationEngine,
} 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 paper is Chinese in both editions
const RECIPE = 'gbt7714-chinese-paper';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black text, one indigo for the journal's name, its rules and its labels
const palette = {
ink: '#1a1a1a', indigo: '#24427a', mist: '#b8c6e0', rule: '#9aa3b5', muted: '#5f6470',
paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.indigo })
.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] = [9, 15]; // pt: 小五 on a 15 pt line, the grid both columns share
const [CHARS, LINES] = [23, 40]; // characters to a column's line, lines to a column
const PT = 25.4 / 72; // mm in a point
const AREA = (2 * CHARS + 2) * BODY * PT; // mm: two columns and a 2-em gutter, 152.4
// #region answer: GB/T 7714 numbered: [1] in citation order, [2–4], 等 or et al. by language
// Register the engine once, before the first build. The GB/T 7714 numeric style writes
// superscript [n] in the order works are first cited, joins three or more in a row into a
// range and sets the list with its type codes: [M] book, [J] article, [D] thesis, [C]
// conference paper, [EB/OL] web page. Its CSL file holds a second layout for works whose
// language is English, with "et al." for 等: a Western entry takes "et al." and a Chinese
// one keeps 等, each chosen by the entry's `language`.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'china-national-standard-gb-t-7714-2015-numeric',
locale: 'zh-CN', // 等, 卷, 版 and the other terms of the list
bibliography: { fontSize: em(7.5 / BODY), lineHeight: pt(12), entrySpacing: pt(1.5),
labelWidth: em(1.7) }, // turnovers under the text, not past it: [1] and a space
};
// #endregion
// #region masthead: the journal's name on an indigo band, then title, authors, affiliations
const BAND = 30; // mm from the trim's top
const at = (id, edge, y) => ({ anchor: { to: id ? `#${id}` : 'container', edge },
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
#Números a la línia en lloc de volats
Algunes revistes imprimeixen els números de citació a la línia, al cos del text. marker canvia com es marca el número i deixa l'estil intacte: 'brackets' dona [1] a la línia; 'corner', 〔1〕.
locale: 'zh-CN', // 等, 卷, 版 and the other terms of the list
+ marker: 'brackets',#Les obres xineses primer
Les bibliografies mixtes s'ordenen a vegades amb les obres xineses davant de les occidentals. En un estil numèric els números deixarien de córrer en ordre per la llista, així que convé més l'estil autor-any.
- style: 'china-national-standard-gb-t-7714-2015-numeric',
+ style: 'china-national-standard-gb-t-7714-2015-author-date',
locale: 'zh-CN', // 等, 卷, 版 and the other terms of the list
- bibliography: { fontSize: em(7.5 / BODY), lineHeight: pt(12), entrySpacing: pt(1.5),
+ bibliography: { groupByLanguage: true, fontSize: em(7.5 / BODY), lineHeight: pt(12),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 →
- Una citació narrativa,
@zhou2019sense claudàtors, anomena els autors i afegeix el número, però la clau continua pels caràcters xinesos que vinguin darrere, així que@zhou2019认为es llegeix com una clau que no existeix. Escriu el nom al text i la citació darrere,周明远[@zhou2019]认为, com fan de tota manera els articles xinesos. - L'estil numèric inclòs no imprimeix localitzadors:
[@zhou2019, 页 45]dona [5] sense la pàgina. La GB/T 7714 posa la pàgina després del claudàtor, dins del volat, [5]45; mentre l'estil no ho faci, escriu la pàgina a la frase. - LXGW WenKai TC, l'única Kai de Fontsource, és una font de Taiwan: dibuixa ,i 。 al centre de la casella, i amb
zh-Hansel motor retalla la meitat dreta de la casella, cosa que talla el signe. El resum va en Noto Serif SC, i la Kai es queda per als noms dels autors, que no porten puntuació. - En una retícula de caràcters l'equilibratge de columnes està desactivat per defecte: cada línia es queda a la retícula i la columna que no admet el títol següent acaba abans. Sense ell, la segona columna de la pàgina 1 acabaria tres línies abans (el títol 2 结果 necessita les seves dues línies i dues de text a sota, així que obre la pàgina 2) i l'última pàgina ompliria la primera columna i deixaria la segona a mitges. La recepta posa
headings.balancing.enabled: true: la columna curta rep línies senceres de la retícula sobre els seus títols, sense treure mai cap caràcter de la seva casella, i les dues columnes de l'última pàgina acaben a la mateixa alçada.
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)


