En pocas palabras
Un aviso oficial chino de cuatro páginas. Sigue las normas nacionales para estos documentos, con un encabezado rojo, apartados numerados y números de página con un formato fijo.
Lo que vas a componer
Un aviso de una asociación de editores inventada, en una ciudad también inventada, 示例市 («Ciudad Ejemplo»), compuesto como compone sus papeles una oficina de la China continental según la GB/T 9704—2012, 《党政机关公文格式》. Son cuatro páginas A4 de 28 caracteres por línea y 22 líneas por página. La primera abre con el nombre del emisor en rojo, el número del documento sobre un filete rojo y un título de dos líneas en 二号. Los títulos se numeran 一、(一)1.(1), cada nivel con su propia letra. La firma y la fecha van a la derecha, y un anexo en página propia lleva al pie el 版记 entre filetes. Los folios dicen «— 1 —», a la derecha en las páginas impares y a la izquierda en las pares. Cada hoja avisa en el margen superior de que es una muestra. Carta comercial DIN 5008 hace el mismo trabajo con una norma europea.
Esta receta responde a
- ¿Cómo compongo un documento oficial chino según la GB/T 9704, con su membrete rojo, su retícula y sus folios?
- ¿Cómo defino la mancha en caracteres, tantos por línea y tantas líneas por página?
- ¿Cómo numero los capítulos 第一回, 第二回 con numerales chinos?
La respuesta corta
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES }, // 28 ems × 22 lines
// Every mark takes a whole cell, as on the standard's grid, and never gives any of it up.
punctuationWidth: 'fullwidth', compressAdjacent: false, trimLineStart: false,
hangingPunctuation: 'allow', // a , that may not open a line hangs past the 28th cell
latinSpacing: em(0), // 〔2026〕7号 and 2026年9月28日 set solid, as the standard prints them
};
const page = {
width: mm(210), height: mm(297), dpi: 150, backgroundColor: col('paper'),
// With the grid on, margins are minimums. These leave 28 × 22 cells and 0.02 mm to share,
// so the type area sits 37 mm under the head and 28 mm from the binding edge.
margins: { top: mm(TOP), bottom: mm(297 - TOP - AREA.h - 0.02), left: mm(INNER),
right: mm(210 - INNER - AREA.w - 0.02), mirror: true },
};
const bodyText = {
fontFamily: SONG, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', // a short line spreads between its characters, never between words
firstLineIndent: em(2), indentAfterHeading: true, // 左空二字,回行顶格
};
Ingredientes
- Funciones
- Retícula de caracteresNumeración chinaTítulos numeradosAnchura de la puntuación chinaCorte de líneas en chinoJustificación entre caracteresEspacio entre chino y latínFuentes chinas, japonesas y coreanasFormato de páginaMárgenes simétricosAperturas diseñadasTextos, filetes y cajas en los diseños de páginaAnclaje de elementos de diseñoCabeceras y foliosEstilos de títuloAtributos de títuloSaltos de línea en los títulosEstilos de párrafoEstilo de tablasExportación a PDF
- También usa
- Figuras justo aquíBanda de capítulo a todo el anchoColor del papelFuentes incrustadas en el PDFTipos de recurso propiosTablas a partir de datosCapítulos sin número
- 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 · Una mancha contada en casillas
El código está en la respuesta corta, más arriba. La GB/T 9704 fija el margen de cabeza en 37 mm y el de lomo en 28 mm, y llena una caja de texto de 156 × 225 mm con 22 líneas de 28 caracteres de cuerpo 三号. cjk.grid toma esas cifras tal cual: 28 em de 15,75 pt dan 155,6 mm, y 22 líneas de 29 pt, 225,1 mm (Retícula de caracteres). En Word, el 三号 mide 16 pt, y con él la línea tendría 158 mm, más ancha que la caja de texto de la norma; 15,75 pt es el valor de las tablas de los cajistas. Con la retícula activada, los márgenes son mínimos. Estos dejan 0,02 mm que repartir, así que la caja de texto se queda donde la pone la norma. La norma pide 仿宋 para el texto; Fontsource no tiene ninguna Fangsong, así que el texto va en la Song de Noto Serif SC (mira Errores frecuentes).
Cada signo ocupa una casilla entera y no cede nada de ella, de modo que, en una línea de chino, los caracteres se alinean en las columnas de la retícula que dibuja la norma. Las cifras arábigas son más estrechas que una casilla, así que en una línea como 版心156毫米×225毫米 los caracteres que siguen a las cifras caen entre las columnas. Cuando una coma cae en la casilla 29, hangingPunctuation: 'allow' la deja colgar en el margen en lugar de mandar un carácter a la línea siguiente y espaciar el resto (Puntuación colgada).

#2 · Cuatro niveles de títulos, una línea cada uno
// One line each at the body size, nothing above or below: every head stays on the grid.
const level = (n, fontFamily, fontWeight, numberingTemplate) => ({ level: n, fontFamily,
fontWeight, numberingTemplate, numberSeparator: '', fontSize: pt(BODY), lineHeight: pt(LEAD),
marginTop: pt(0), marginBottom: pt(0), firstLineIndent: em(2) }); // 空二字,回行顶格
const levels = [
level(2, HEI, 500, '{2:一}、'), // 一 is the informal numeral in the document's script
level(3, KAI, 400, '({3:一})'),
level(4, SONG, 400, '{4}.'),
level(5, SONG, 400, '({5})'),
];
La norma compone 一、 en 黑体, (一) en 楷体, y 1. y (1) en la letra del texto, todos al cuerpo del texto. {2:一} escribe el numeral chino corriente en la escritura de locale (Numeración). Con el cuerpo y el interlineado del texto y sin márgenes, cada título ocupa una línea de la retícula, y el texto que lo sigue tampoco se sale de ella. firstLineIndent: em(2) sangra cada título dos casillas, contadas en cuadratines del texto, y un título que pasa a una segunda línea la empieza en el margen, como pide la norma; el número va después de la sangría, así que el índice y los marcadores del PDF dicen 一、 sin espacios delante (Configuración por nivel).
#3 · El membrete, línea a línea
const LINE = LEAD * MM; // 10.23 mm
const lineTop = (n) => (n - 1) * LINE; // mm from the top of the type area to grid line n
const face = (fontFamily, size, fontWeight, colour, lineHeight = LEAD / size) => ({
fontFamily, fontSize: pt(size), fontWeight, color: col(colour), lineHeight });
// A text y mm down the type area, x mm in from its edge, as wide as the type area.
const text = (id, content, look, y, { edge = 'top-left', x = 0, width = AREA.w, ...more } = {},
) => ({ kind: 'text', id, content, ...look, align: 'center', overflow: 'wrap', ...more,
placement: { anchor: { to: 'container', edge }, offset: { x: mm(x), y: mm(y) },
size: { width: width === 'auto' ? 'auto' : mm(width) } } }); // wrap, not '…'
const rule = (id, y, thickness, colour = 'ink', reserve = false) => ({ kind: 'rule', id, reserve,
direction: 'horizontal', thickness, color: col(colour), placement: { anchor: { to: 'container',
edge: 'top-left' }, offset: { y: mm(y) }, size: { width: mm(AREA.w) } } });
const PAD = { left: pt(5), right: pt(5) }; // the specimen stamp's: not a GB/T 9704 element
const letterhead = { enabled: true, minHeight: pt(13 * LEAD), slot: { elements: [
text('copy', '{attr.copy}', face(SONG, BODY, 400, 'ink'), lineTop(1), { align: 'left' }),
text('stamp', '样 张', face(HEI, BODY, 500, 'red', 1.3), lineTop(1) + 1.5, { edge: 'top-right',
width: 'auto', box: { borderColor: col('red'), borderWidth: pt(1), padding: PAD } }),
// The name's ink starts 35 mm down, 0.07 em over its box; at 46 pt it ends in line 5.
text('issuer', '{attr.issuer}文件', face(SONG, 46, 900, 'red', 1), 35 + 0.07 * 46 * MM),
// The number two blank lines under the name; the red rule 4 mm under its characters.
text('number', '{attr.number}', face(SONG, BODY, 400, 'ink'), lineTop(8)),
rule('red-rule', lineTop(8) + ((LEAD + BODY) / 2) * MM + 4, mm(0.5), 'red', true),
text('title', '{titleText}', face(SONG, 22, 900, 'ink'), lineTop(12)), // 二号, 2 lines under
] } };
const notice = { level: 1, span: 'page', advancedDesign: letterhead,
marginTop: pt(0), marginBottom: pt(LEAD), // 空一行: a blank line, then the addressee
breakBefore: { enabled: true, parity: 'any' } }; // a notice opens on the next page
El membrete es el diseño del H1, cuyos atributos llevan el número de ejemplar, el emisor y el número del documento: la configuración guarda el papel timbrado y el Markdown, el documento. lineTop(n) da el borde superior de la línea n de la retícula, así que cada elemento queda donde lo cuenta la norma: el número, dos líneas en blanco por debajo del nombre del emisor; el título, dos líneas en blanco por debajo del filete rojo. A 46 pt, la tinta del nombre va desde 35 mm por debajo del borde superior de la caja de texto hasta el pie de la línea 5, de modo que las líneas 6 y 7 quedan en blanco y el número cae en la 8; a 48 pt entraría en la línea 6 y bajaría una línea todo lo demás. El \\ del título lo parte después de 关于举办, una línea corta sobre una larga: un trapecio, una de las dos formas que admite la norma (la otra es el rombo). minHeight reserva 13 líneas y marginBottom una más, de modo que el destinatario empieza en la línea 15 (Apertura a toda página y diseño avanzado).
#4 · Folios bajo la mancha
const FOLIO = 14; // pt: 四号
const folio = (id, parity, edge, x) => ({ kind: 'text', id, parity, content: '— {pageNumber} —',
...face(SONG, FOLIO, 400, 'ink', 1), align: edge.endsWith('left') ? 'left' : 'right',
overflow: 'clip', placement: { anchor: { to: 'container', edge }, // the type area's foot
offset: { x: pt(x), y: mm(7 - (FOLIO / 2) * MM) } } }); // the dashes 7 mm down
const footer = { elements: [folio('recto', 'odd', 'top-right', -FOLIO),
folio('verso', 'even', 'top-left', FOLIO)] };
const header = { elements: [{ kind: 'text', id: 'specimen', content: '{subtitle}', // 样张 …
...face(HEI, 7.5, 400, 'muted', 1.2), align: 'center', overflow: 'wrap',
placement: { anchor: { to: 'container', edge: 'top' }, offset: { y: mm(16) } } }] };
En el pie, el borde superior del contenedor es el pie de la caja de texto, así que offset.y se mide hacia abajo desde el texto (Cabeceras y pies). Las rayas quedan 7 mm por debajo y a una casilla de 四号 del borde exterior: parity pone los folios impares a la derecha y los pares a la izquierda. El margen superior imprime {subtitle}, del frontmatter. Esa línea y el colofón que va bajo el 版记 son lo único que cambia entre la edición inglesa y la española.
#5 · El anexo y el 版记
const IMPRINT = AREA.h - 2 * LINE; // mm: two rows of the grid, ending on the type area's foot
const small = face(SONG, FOLIO, 400, 'ink', LEAD / FOLIO); // 四号
const inset = { x: FOLIO * MM, width: AREA.w - 2 * FOLIO * MM, reserve: false }; // 左右各空一字
const annex = {
id: 'annex', numbered: false, toc: false, breakBefore: { enabled: true, parity: 'any' },
span: 'page', marginTop: pt(0), marginBottom: pt(0), // line 4 is the table's float gap
advancedDesign: { enabled: true, minHeight: pt(3 * LEAD), slot: { elements: [
text('label', '{attr.label}', face(HEI, BODY, 500, 'ink'), lineTop(1), { align: 'left' }),
text('title', '{titleText}', face(SONG, 22, 900, 'ink'), lineTop(3)),
// reserve: false keeps the 版记 out of the room the heading takes: the table goes on.
rule('imprint-top', IMPRINT, mm(0.35)),
text('cc', '抄送:{attr.cc}', small, IMPRINT, { ...inset, align: 'left' }),
rule('imprint-mid', IMPRINT + LINE, mm(0.25)),
text('office', '{attr.office}', small, IMPRINT + LINE, { ...inset, align: 'left' }),
text('printed', '{attr.printed}', small, IMPRINT + LINE, { ...inset, align: 'right' }),
rule('imprint-foot', AREA.h - 0.35 / 2, mm(0.35)),
text('colophon', '{attr.colophon}', face(HEI, 7, 400, 'muted'), AREA.h + 16, inset),
] } },
};
El título del anexo tiene un estilo propio: página nueva, 附件 en la línea 1, el título en la 3 y ningún margen bajo las tres líneas que reserva. La línea 4 en blanco es el hueco que todo recurso en línea deja encima (inlineResourceGap, en Disposición), así que el filete superior de la tabla cae en la línea 5. El 版记 forma parte del mismo diseño y ocupa las dos líneas de la retícula que acaban en el pie de la caja de texto. Sus elementos llevan reserve: false, así que no suman nada al espacio que reserva el título y no empujan la tabla hacia abajo. La norma pone el 版记 en la última página, detrás de los anexos; con un anexo de una página, esa es la del anexo. Un anexo más largo pediría que dibujara el 版记 un título de su última página.
#6 · La firma y la fecha
const paragraphStyles = [
{ id: 'flush', firstLineIndent: pt(0) }, // 主送机关:居左顶格
{ id: 'annexes', marginTop: pt(LEAD) }, // 附件说明:正文下空一行,左空二字
// The date, 6.9 ems, starts two cells right of the name and ends two short: 右空二字.
{ id: 'signature', indent: em(17), firstLineIndent: pt(0), marginTop: pt(LEAD) },
{ id: 'date', indent: em(19), firstLineIndent: pt(0) },
];
Un aviso sin sello pone el nombre del emisor a dos casillas del margen derecho y la fecha debajo, dos casillas más a la derecha. Si la fecha es más larga que el nombre, acaba a dos casillas del margen derecho y el nombre se desplaza a la izquierda para conservar el escalón de dos casillas. La nuestra mide 6,9 em, algo menos que los 7 del nombre, así que, al pie de la letra, empezaría dos casillas a la derecha del nombre y acabaría a 0,14 em del margen. Leemos la regla por lo que busca, que la fecha no llegue nunca al borde, y aplicamos el segundo caso: la fecha acaba a poco más de dos casillas del margen. indent coloca las dos líneas en casillas enteras, a 17 y 19 em del margen (Estilos de párrafo).
La receta completa
// ═══ Postext Cookbook · Nº 082 · A Chinese official document to GB/T 9704 ═════════
// https://postext.dev/en/cookbook/chinese-official-document
// Code: MIT · Text: a fictitious notice written for the recipe (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, parseTSV, mergeCells,
} 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-official-document';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// GB/T 9704 prints everything black but the letterhead: the issuer's name and a rule in red.
const palette = { ink: '#161616', red: '#d2161e', muted: '#8a8580', paper: '#ffffff' };
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.red })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
const SONG = 'Noto Serif SC'; // 宋: the text (in place of 仿宋, see the write-up) and 小标宋
const HEI = 'Noto Sans SC'; // 黑: the 一、 heads, the annex label, the specimen stamp
const KAI = 'LXGW WenKai TC'; // 楷: the (一) heads
const MM = 25.4 / 72; // mm per pt
const [BODY, LEAD, CHARS, LINES] = [15.75, 29, 28, 22]; // 三号 on 29 pt lines, 28 × 22 of them
const AREA = { w: CHARS * BODY * MM, h: LINES * LEAD * MM }; // 155.6 × 225.1 mm: the 版心
const [TOP, INNER] = [37, 28]; // mm: 天头 and 订口, the head and binding margins
// #region answer: A4, 28 characters × 22 lines of 三号, full-width marks on the grid
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES }, // 28 ems × 22 lines
// Every mark takes a whole cell, as on the standard's grid, and never gives any of it up.
punctuationWidth: 'fullwidth', compressAdjacent: false, trimLineStart: false,
hangingPunctuation: 'allow', // a , that may not open a line hangs past the 28th cell
latinSpacing: em(0), // 〔2026〕7号 and 2026年9月28日 set solid, as the standard prints them
};
const page = {
width: mm(210), height: mm(297), dpi: 150, backgroundColor: col('paper'),
// With the grid on, margins are minimums. These leave 28 × 22 cells and 0.02 mm to share,
// so the type area sits 37 mm under the head and 28 mm from the binding edge.
margins: { top: mm(TOP), bottom: mm(297 - TOP - AREA.h - 0.02), left: mm(INNER),
right: mm(210 - INNER - AREA.w - 0.02), mirror: true },
};
const bodyText = {
fontFamily: SONG, fontSize: pt(BODY), lineHeight: pt(LEAD), color: col('ink'),
boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'),
textAlign: 'justify', // a short line spreads between its characters, never between words
firstLineIndent: em(2), indentAfterHeading: true, // 左空二字,回行顶格
};
// #endregion
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
#Comprime los signos que se tocan
Parejas como ),y 》( ocupan casilla y media en lugar de dos, como en la mayoría de los libros; los caracteres que las siguen se salen de las columnas de la retícula.
- punctuationWidth: 'fullwidth', compressAdjacent: false, trimLineStart: false,
+ punctuationWidth: 'fullwidth', compressAdjacent: true, trimLineStart: true,#Muestra la retícula mientras compones
El canvas dibuja un cuadrado gris por cada casilla de la retícula de 28 × 22, y el PDF no lo incluye salvo que renderToPdf reciba characterGrid: true.
- grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
+ grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES, show: true },Errores frecuentes
Error frecuente
Fontsource no tiene ninguna fuente Fangsong (仿宋)
La GB/T 9704 y casi todos los impresos de la China continental componen el texto en 仿宋, una letra Song dibujada con los trazos finos y algo ascendentes del pincel. Ninguna de las familias chinas de Fontsource es una Fangsong, así que una receta compone el texto con la Song que hay, Noto Serif SC, y lo dice. Una Fangsong con licencia entra como fuente propia: registra su archivo con FontFace, nombra la familia en bodyText.fontFamily y pasa a renderToPdf un fontProvider que devuelva sus bytes. Fuentes chinas, japonesas y coreanas →
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 →
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 →
Aviso de maquetación · cjkGridClamped
Retícula de caracteres demasiado grande
Por qué. `cjk.grid` pide más caracteres por línea o más líneas por página de los que caben entre los márgenes con ese cuerpo e interlineado, así que la retícula se compone con los que caben.
Solución. Baja `charsPerLine` o `linesPerPage`, estrecha los márgenes (son mínimos) o reduce `bodyText.fontSize` o `lineHeight`. Documentación →
- Una línea justificada reparte lo que le sobra entre los caracteres chinos y los espacios que contenga, y el espacio se lleva más de lo que le toca: en la página 2, el de GB/T 15834 llegó casi al doble de ancho que el de GB/T 9704, más arriba. El contenido escribe los dos números con un espacio de no separación (U+00A0), que mantiene cada número de una pieza, y el sobrante va entre los caracteres.
Créditos
- Receta
- Ignacio Ferro
- Texto
- Un aviso de una asociación de editores ficticia, escrito para la receta con la forma que fija la GB/T 9704—2012 · Postext Cookbook · 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)


