En pocas palabras
Un artículo breve de una revista científica china. El autor escribe un código para cada fuente; Postext numera las fuentes por orden de cita y compone la lista de referencias como la piden las revistas chinas.
Lo que vas a componer
Dos páginas de un artículo de investigación en una revista inventada de estudios editoriales, 示例出版研究 («Investigación Editorial de Ejemplo»), compuesto como compone sus artículos una revista universitaria china. La página es un 16开 de 184 × 260 mm, con dos columnas de 23 caracteres de 小五 sobre una retícula de 15 pt. Un bloque de título cruza la página: el nombre de la revista sobre una banda añil, el título en Hei negrita, los autores, sus filiaciones y un resumen con sus palabras clave. Las citas siguen la GB/T 7714—2015, la norma nacional china de referencias, en su sistema numérico (顺序编码制): cada obra recibe un número por el orden en que se cita por primera vez, el número sale volado entre corchetes y tres o más números seguidos se unen en un rango. La lista de referencias da a cada entrada su código de tipo de documento y escribe 等 tras los tres primeros autores de una obra china y «et al.» tras los de una occidental. Un capítulo de tesis citado en APA 7 usa el mismo marcado de citas en un estilo autor-fecha.
Esta receta responde a
- ¿Cómo cito según la norma china GB/T 7714, también en texto vertical?
- ¿Cómo cito obras y compongo la bibliografía en APA, IEEE u otro estilo de cita?
La respuesta corta
// 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
};
Ingredientes
- Funciones
- Citas en un estilo de citaBibliografía a partir de las referenciasRetícula de caracteresFuentes chinas, japonesas y coreanasAnchura de la puntuación chinaUna o dos columnasAperturas diseñadasAnclaje de elementos de diseñoTítulos numeradosEstilos de títuloCapítulos sin númeroRecuadrosChips en líneaCabeceras y foliosPaleta de color semánticaExportación a PDF
- También usa
- Corte de líneas en chinoEquilibrado de columnasAtributos de títuloCabeceras según el tipo de páginaEstilos de párrafoFuentes incrustadas en el PDFPreliminares en romanosSaltos de línea en los títulos
- Tipografía
- Noto Serif SC, Noto Sans SC, LXGW WenKai TC (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · El estilo, y su plantilla para las obras occidentales
El código es la respuesta corta de arriba. El motor de citas se registra una vez, antes de la primera composición, y postext-citeproc trae los tres estilos de la GB/T 7714: numérico, autor-fecha y de notas (Citas). En el texto, una cita es una clave entre corchetes. [@tinker1963] imprime un [1] volado, y [@rayner2016; @dyson2001; @lin2023] imprime [2–4]. Dos números seguidos quedan como lista, [5,6]. Una obra citada de nuevo conserva su primer número: [4] en el tercer párrafo, y [1] y [2] más adelante.
La norma pide «et al.» tras los tres primeros autores de una obra occidental y 等 tras los de una china. El archivo CSL incluido trae dos plantillas para eso, una de ellas para las obras en inglés, y cada entrada toma la suya según su propio campo language: Rayner y cuatro coautores quedan en «RAYNER K, SCHOTTER E R, MASSON M E J, et al.», y 林岚 y tres coautores en «林岚, 周明远, 陈思齐, 等». locale: 'zh-CN' escribe en chino el resto de las palabras de la lista.
#2 · Las referencias en un bloque CSL-YAML
Las obras van en un bloque :::references{format=csl-yaml} al final del Markdown, en el formato que Zotero exporta como CSL YAML (Citar). El tipo CSL decide el código: book imprime [M], article-journal [J], thesis [D], paper-conference [C] tras su // y las actas, y webpage [EB/OL] con la fecha de consulta entre corchetes. Un artículo con DOI pasa a [J/OL] y conserva el DOI, como pide la norma. Los nombres chinos van en literal, para que el estilo no los parta en apellido y nombre. :::bibliography{title=""} coloca la lista bajo el título sin número 参考文献, y labelWidth alinea las líneas siguientes de cada entrada con su texto, no más adentro.

#3 · El bloque de título 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 bloque de título es el diseño del H1, con un estilo de encabezado que ocupa las dos columnas. La banda es una caja anclada al corte, y el nombre de la revista va encima en blanco. El título, los autores y las filiaciones salen del título y sus atributos, cada uno colocado bajo el anterior (#title, below), de modo que un título de tres líneas empuja el resto hacia abajo (Apertura a toda página y diseño avanzado).
#4 · El resumen y sus etiquetas
// 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 resumen es un recuadro a todo el ancho, sangrado dos caracteres por cada lado. Sus etiquetas son chips: :chip[摘 要:]{style="label"} compone la palabra en Hei negrita, en el añil de la revista, sin caja (Estilos de chip). Las revistas chinas suelen componer el resumen en 楷体; esta lo deja en Song, por lo que se explica en Errores frecuentes.
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 receta 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 },
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Números en la línea en vez de volados
Algunas revistas imprimen los números de cita en la línea, al cuerpo del texto. marker cambia cómo se marca el número y deja el estilo intacto: 'brackets' da [1] en la línea; 'corner', 〔1〕.
locale: 'zh-CN', // 等, 卷, 版 and the other terms of the list
+ marker: 'brackets',#Las obras chinas primero
Las bibliografías mixtas se ordenan a veces con las obras chinas delante de las occidentales. En un estilo numérico los números dejarían de correr en orden por la lista, así que conviene más el estilo autor-fecha.
- 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),Errores frecuentes
Error frecuente
Etiqueta el documento zh-Hans o zh-Hant, no con LANG
Las ediciones de una receta son en y es, pero una muestra china es china en las dos: `locale: LANG` la etiquetaría como inglés o español, separaría sus palabras latinas, llamaría Figure o Figura a sus figuras y daría al PDF un idioma equivocado. Desde postext 1.30 la etiqueta es además el idioma en el que se compone el texto (en el que se mide, se pinta y se incrusta), así que bajo una etiqueta inglesa o española una fuente china compone con otras formas sus cifras y la puntuación que comparte con el texto latino, y las líneas se parten por otro sitio. Escribe tú la etiqueta: 'zh-Hans' (convenciones de la China continental: corte GB, puntuación Kaiming) o 'zh-Hant' (Taiwán: puntuación de ancho completo centrada); 'zh-HK' para Hong Kong. Un 'zh' a secas se lee como chino simplificado continental. Una muestra japonesa lleva 'ja' (gotcha ja-locale-tag). Corte de líneas en chino →
Error frecuente
Las fuentes chinas se cargan por fragmentos, con el bloque cjk
Fontsource sirve una familia china, japonesa o coreana en un centenar de archivos por peso, cada uno con un intervalo de caracteres. loadFonts solo descarga el archivo latin, así que en pantalla los caracteres chinos salen de una fuente del sistema y se miden mal, y fontsourceProvider entrega al PDF ese archivo latin, que los imprime como cajas vacías. Añade el bloque cjk del kit, llama a loadCjkFonts(FONTS, markdown) después de loadFonts (una vez por voz, con el texto que compone, si el libro usa varias fuentes chinas) y pasa a renderToPdf fontProvider: cjkPdfProvider: ambos toman los archivos que contienen los caracteres del texto. Fuentes chinas, japonesas y coreanas →
- Una cita narrativa,
@zhou2019sin corchetes, nombra a los autores y añade el número, pero la clave sigue por los caracteres chinos que vengan detrás, así que@zhou2019认为se lee como una clave que no existe. Escribe el nombre en el texto y la cita detrás,周明远[@zhou2019]认为, como hacen de todos modos los artículos chinos. - El estilo numérico incluido no imprime localizadores:
[@zhou2019, 页 45]da [5] sin la página. La GB/T 7714 pone la página tras el corchete, dentro del volado, [5]45; mientras el estilo no lo haga, escribe la página en la frase. - LXGW WenKai TC, la única Kai de Fontsource, es una fuente de Taiwán: dibuja ,y 。 en el centro de la casilla, y con
zh-Hansel motor recorta la mitad derecha de la casilla, que corta el signo. El resumen va en Noto Serif SC, y la Kai se queda para los nombres de los autores, que no llevan puntuación. - En una retícula de caracteres el equilibrado de columnas está desactivado por defecto: cada línea se queda en la retícula y la columna que no admite el título siguiente acaba antes. Sin él, la segunda columna de la página 1 acabaría tres líneas antes (el título 2 结果 necesita sus dos líneas y dos de texto debajo, así que abre la página 2) y la última página llenaría la primera columna y dejaría la segunda a medias. La receta pone
headings.balancing.enabled: true: la columna corta recibe líneas enteras de la retícula sobre sus títulos, sin sacar nunca un carácter de su casilla, y las dos columnas de la última página acaban a la misma altura.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Fuentes
- Noto Serif SC (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


