Saltar al contingut principal
Recepta número 82

Receptari · Capítol 1 · Pàgina i retícula

Un document oficial xinès segons la GB/T 9704

Un avís de quatre pàgines en A4 segons la norma nacional: 28 × 22 caràcters de 三号, membret vermell, títols 一、(一)1.(1), annex i folis «— 1 —».

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Llicència
Actualitzada el 10 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 210 × 297 mm
  • 1 columna
  • Noto Serif SC 15,8/29
  • LXGW WenKai TC
  • Noto Sans SC
  • 4 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 62 ms
  • 179 línies de codi

En poques paraules

Un avís oficial xinès de quatre pàgines. Segueix les normes nacionals per a aquests documents, amb un membret vermell, apartats numerats i números de pàgina amb un format fix.

Què compondràs

Un avís d'una associació d'editors inventada, en una ciutat també inventada, 示例市 («Ciutat Exemple»), compost com compon els seus papers una oficina de la Xina continental segons la GB/T 9704—2012, 《党政机关公文格式》. Són quatre pàgines A4 de 28 caràcters per línia i 22 línies per pàgina. La primera s'obre amb el nom de l'emissor en vermell, el número del document sobre un filet vermell i un títol de dues línies en 二号. Els títols es numeren 一、(一)1.(1), cada nivell amb la seva pròpia lletra. La signatura i la data van a la dreta, i un annex en pàgina pròpia porta al peu el 版记 entre filets. Els folis diuen «— 1 —», a la dreta a les pàgines senars i a l'esquerra a les parelles. Cada full avisa al marge superior que és una mostra. Carta comercial DIN 5008 fa la mateixa feina amb una norma europea.

Aquesta recepta respon a

  • Com componc un document oficial xinès segons la GB/T 9704, amb la seva capçalera vermella, la seva retícula i els seus folis?
  • Com defineixo la caixa en caràcters, tants per línia i tantes línies per pàgina?
  • Com numero els capítols 第一回, 第二回 amb numerals xinesos?

La resposta curta

script.js · línies 28–47al codi complet
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, // 左空二字,回行顶格
};

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 · Una caixa comptada en caselles

El codi és a la resposta curta, més amunt. La GB/T 9704 fixa el marge de cap en 37 mm i el de llom en 28 mm, i omple una caixa de 156 × 225 mm amb 22 línies de 28 caràcters de cos 三号. cjk.grid pren aquestes xifres tal qual: 28 em de 15,75 pt donen 155,6 mm, i 22 línies de 29 pt, 225,1 mm (Retícula de caràcters). A Word, el 三号 fa 16 pt, i amb aquest cos la línia tindria 158 mm, més ampla que la caixa de la norma; 15,75 pt és el valor de les taules dels caixistes. Amb la retícula activada, els marges són mínims. Aquests deixen 0,02 mm per repartir, així que la caixa es queda on la posa la norma. La norma demana 仿宋 per al text; Fontsource no té cap Fangsong, així que el text va en la Song de Noto Serif SC (mira Errors freqüents).

Cada signe ocupa una casella sencera i no en cedeix res, de manera que, en una línia de xinès, els caràcters s'alineen a les columnes de la retícula que dibuixa la norma. Les xifres aràbigues són més estretes que una casella, així que en una línia com 版心156毫米×225毫米 els caràcters que segueixen les xifres cauen entre les columnes. Quan una coma cau a la casella 29, hangingPunctuation: 'allow' la deixa penjar al marge en lloc d'enviar un caràcter a la línia següent i espaiar la resta (Puntuació penjada).

Pàgina 2: la coma que segueix 各一份 omple la casella 28; la que segueix 可自愿报名 penja en una casella 29, fora de la caixa, i la línia següent comença al marge.

#2 · Quatre nivells de títols, una línia cadascun

script.js · línies 51–60al codi complet
// 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 compon 一、 en 黑体, (一) en 楷体, i 1. i (1) en la lletra del text, tots al cos del text. {2:一} escriu el numeral xinès corrent en l'escriptura de locale (Numeració). Amb el cos i l'interlineat del text i sense marges, cada títol ocupa una línia de la retícula, i el text que el segueix tampoc no en surt. firstLineIndent: em(2) sagna cada títol dues caselles, comptades en quadratins del text, i un títol que passa a una segona línia la comença al marge, com demana la norma; el número va després del sagnat, de manera que l'índex i els marcadors del PDF diuen 一、 sense espais al davant (Configuració per nivell).

#3 · El membret, línia a línia

script.js · línies 64–90al codi complet
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 membret és el disseny de l'H1, i els atributs de l'H1 porten el número d'exemplar, l'emissor i el número del document: la configuració guarda el paper timbrat i el Markdown, el document. lineTop(n) dona la vora superior de la línia n de la retícula, així que cada element queda on el compta la norma: el número, dues línies en blanc per sota del nom de l'emissor; el títol, dues línies en blanc per sota del filet vermell. A 46 pt, la tinta del nom va des de 35 mm per sota de la vora superior de la caixa fins al peu de la línia 5, de manera que les línies 6 i 7 queden en blanc i el número cau a la 8; a 48 pt entraria a la línia 6 i baixaria una línia tota la resta. El \\ del títol el parteix després de 关于举办, una línia curta sobre una de llarga: un trapezi, una de les dues formes que admet la norma (l'altra és el rombe). minHeight reserva 13 línies i marginBottom una més, de manera que el destinatari comença a la línia 15 (Extensió i disseny avançat).

#4 · Folis sota la caixa

script.js · línies 94–103al codi complet
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) } } }] };

Al peu, la vora superior del contenidor és el peu de la caixa, així que offset.y es mesura cap avall des del text (Capçaleres i peus). Les ratlles queden 7 mm per sota i a una casella de 四号 de la vora exterior: parity posa els folis senars a la dreta i els parells a l'esquerra. El marge superior imprimeix {subtitle}, del frontmatter. Aquesta línia i el colofó que va sota el 版记 són l'única cosa que canvia entre l'edició anglesa i la castellana.

#5 · L'annex i el 版记

script.js · línies 107–125al codi complet
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ítol de l'annex té un estil propi: pàgina nova, 附件 a la línia 1, el títol a la 3 i cap marge sota les tres línies que reserva. La línia 4 en blanc és l'espai que tot recurs en línia deixa a sobre (inlineResourceGap, a Disposició), així que el filet superior de la taula cau a la línia 5. El 版记 forma part del mateix disseny i ocupa les dues línies de la retícula que acaben al peu de la caixa. Els seus elements porten reserve: false, així que no sumen res a l'espai que reserva el títol i no empenyen la taula cap avall. La norma posa el 版记 a l'última pàgina, darrere dels annexos; amb un annex d'una pàgina, aquesta és la de l'annex. Un annex més llarg demanaria que dibuixés el 版记 un títol de la seva última pàgina.

#6 · La signatura i la data

script.js · línies 129–135al codi complet
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 avís sense segell posa el nom de l'emissor a dues caselles del marge dret i la data a sota, dues caselles més a la dreta. Si la data és més llarga que el nom, acaba a dues caselles del marge dret i el nom es desplaça a l'esquerra per conservar el graó de dues caselles. La nostra fa 6,9 em, una mica menys que els 7 del nom, així que, al peu de la lletra, començaria dues caselles a la dreta del nom i acabaria a 0,14 em del marge. Llegim la regla pel que busca, que la data no arribi mai a la vora, i apliquem el segon cas: la data acaba a poc més de dues caselles del marge. indent col·loca les dues línies en caselles senceres, a 17 i 19 em del marge (Estils de paràgraf).

La recepta completa

Sandbox
// ═══ 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

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

#Comprimeix els signes que es toquen

Parelles com ),i 》( ocupen casella i mitja en lloc de dues, com a la majoria dels llibres; els caràcters que les segueixen surten de les columnes de la retícula.

-  punctuationWidth: 'fullwidth', compressAdjacent: false, trimLineStart: false,
+  punctuationWidth: 'fullwidth', compressAdjacent: true, trimLineStart: true,

#Mostra la retícula mentre compons

El canvas dibuixa un quadrat gris per cada casella de la retícula de 28 × 22, i el PDF no l'inclou llevat que renderToPdf rebi characterGrid: true.

-  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
+  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES, show: true },

Errors freqüents

Error freqüent

Fontsource no té cap font Fangsong (仿宋)

La GB/T 9704 i gairebé tots els impresos de la Xina continental componen el text en 仿宋, una lletra Song dibuixada amb els traços fins i una mica ascendents del pinzell. Cap de les famílies xineses de Fontsource no és una Fangsong, de manera que una recepta compon el text amb la Song que hi ha, Noto Serif SC, i ho diu. Una Fangsong amb llicència entra com a font pròpia: registra'n el fitxer amb FontFace, anomena la família a bodyText.fontFamily i passa a renderToPdf un fontProvider que en retorni els bytes. Fonts xineses, japoneses i coreanes →

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

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 cel·les combinades necessiten hiddenBy: fes servir mergeCells

Les cel·les es col·loquen segons la seva posició a la fila, així que una cel·la combinada necessita cel·les de farciment marcades amb hiddenBy on s'estén; ometre-les, com en HTML, desplaça totes les columnes següents. Combina cel·les amb mergeCells. Des de postext 1.5 una taula amb una graella irregular s'anota a doc.contentWarnings com a raggedTableGrid, i parseTSV(text, { headerRows }) marca les files de capçalera. Taules a partir de dades →

Avís de maquetació · cjkGridClamped

Retícula de caràcters massa gran

Per què. `cjk.grid` demana més caràcters per línia o més línies per pàgina dels que hi caben entre els marges amb aquest cos i aquest interlineat, de manera que la retícula es compon amb els que hi caben.

Solució. Abaixa `charsPerLine` o `linesPerPage`, estreny els marges (són mínims) o redueix `bodyText.fontSize` o `lineHeight`. Documentació →

  • Una línia justificada reparteix el que li sobra entre els caràcters xinesos i els espais que contingui, i l'espai s'emporta més del que li toca: a la pàgina 2, el de GB/T 15834 va arribar gairebé al doble d'amplada que el de GB/T 9704, més amunt. El contingut escriu els dos números amb un espai de no separació (U+00A0), que manté cada número d'una peça, i el sobrant va entre els caràcters.

Crèdits

Text
  • A notice from a fictitious publishers’ association, written for the recipe in the form GB/T 9704—2012 sets out · Postext Cookbook · 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