Pular para o conteúdo principal
Receita número 82

Receitas · Capítulo 1 · Página e grade

Um documento oficial chinês pela GB/T 9704

Um aviso de quatro páginas em A4 pela norma nacional: 28 × 22 caracteres de 三号, timbre vermelho, títulos 一、(一)1.(1), anexo e fólios “— 1 —”.

Nesta página
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licença
Atualizada em 10 de out. de 2026
Código MIT · Texto CC BY 4.0
  • Amostra em inglês: ainda sem edição em português
  • Refile 210 × 297 mm
  • 1 coluna
  • Noto Serif SC 15,8/29
  • LXGW WenKai TC
  • Noto Sans SC
  • 4 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 63 ms
  • 179 linhas de código

Em poucas palavras

Um aviso oficial chinês de quatro páginas. Segue as regras nacionais para esse tipo de documento, com cabeçalho vermelho, seções numeradas e números de página num formato fixo.

O que você vai compor

Um aviso de uma associação de editores inventada, numa cidade também inventada, 示例市 (“Cidade Exemplo”), composto como uma repartição da China continental compõe os papéis pela GB/T 9704—2012, 《党政机关公文格式》. São quatro páginas A4 de 28 caracteres por linha e 22 linhas por página. A página 1 abre com o nome do emissor em vermelho, o número do documento sobre um fio vermelho e um título de duas linhas em 二号. Os títulos são numerados 一、(一)1.(1), cada nível na fonte própria. A assinatura e a data ficam à direita, e um anexo numa página própria traz no pé o 版记 entre fios. Os fólios dizem “— 1 —”, à direita nas páginas ímpares e à esquerda nas pares. Cada folha avisa na margem superior que é um modelo. Carta comercial pela DIN 5008 faz o mesmo trabalho com uma norma europeia.

Esta receita responde a

  • Como diagramo um documento oficial chinês segundo a GB/T 9704, com o timbre vermelho, a grade e os fólios?
  • Como defino a mancha em caracteres, tantos por linha e tantas linhas por página?
  • Como numero os capítulos 第一回, 第二回 com numerais chineses?

A resposta curta

script.js · linhas 28–47no código completo
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

Tipografia
Noto Serif SC, Noto Sans SC, LXGW WenKai TC (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Uma mancha contada em casas

O código é a resposta curta lá em cima. A GB/T 9704 fixa a margem superior em 37 mm e a margem de encadernação em 28 mm, e enche uma mancha de 156 × 225 mm com 22 linhas de 28 caracteres de corpo 三号. cjk.grid toma os números como estão: 28 emes de 15,75 pt dão 155,6 mm, e 22 linhas de 29 pt dão 225,1 mm (grade de caracteres). No Word, o 三号 tem 16 pt, o que faria a linha ter 158 mm, mais larga que a mancha da norma; 15,75 pt é o valor das tabelas dos tipógrafos. Com a grade ativada, as margens são mínimas. Estas deixam 0,02 mm para distribuir, de modo que a mancha fica onde a norma a põe. A norma pede 仿宋 para o texto; a Fontsource não tem nenhuma Fangsong, por isso o texto é composto na Song da Noto Serif SC (veja Erros comuns).

Todo sinal ocupa uma casa inteira e não cede nada dela, por isso numa linha de chinês os caracteres ficam nas colunas da grade que a norma desenha. Os algarismos arábicos são mais estreitos que uma casa, de modo que numa linha como 版心156毫米×225毫米 os caracteres depois dos algarismos caem entre as colunas. Quando uma vírgula cai na 29ª casa, hangingPunctuation: 'allow' a deixa pendurada na margem em vez de mandar um caractere para a linha seguinte e espaçar o resto (pontuação pendente).

Página 2: a vírgula depois de 各一份 enche a 28ª casa; a que vem depois de 可自愿报名 pende numa 29ª, além da borda da mancha, e a linha seguinte começa na margem.

#2 · Quatro níveis de títulos, uma linha cada

script.js · linhas 51–60no código completo
// 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})'),
];

A norma compõe 一、 em 黑体, (一) em 楷体, e 1. e (1) na fonte do texto, todos no mesmo corpo que o texto. {2:一} imprime o numeral chinês informal na escrita de locale (numeração). Com o corpo e a entrelinha do texto e sem margens, um título ocupa uma linha da grade, e o texto embaixo dele também fica na grade. firstLineIndent: em(2) recua cada título duas casas, contadas em ems do corpo, e um título que passa para uma segunda linha a começa na margem, como a norma pede; o número vem depois do recuo, por isso o sumário e os marcadores do PDF leem 一、 sem espaços na frente (configurações por nível).

#3 · O timbre, linha por linha

script.js · linhas 64–90no código completo
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

O timbre é o design do H1, cujos atributos trazem o número de exemplar, o emissor e o número do documento: a configuração guarda o papel timbrado, e o Markdown, o documento. lineTop(n) dá o topo da linha n da grade, por isso cada elemento fica onde a norma o conta: o número, duas linhas em branco abaixo do nome do emissor; o título, duas linhas em branco abaixo do fio vermelho. A 46 pt, a tinta do nome vai de 35 mm abaixo do topo da mancha até o pé da linha 5, o que deixa as linhas 6 e 7 em branco e põe o número na linha 8; a 48 pt ela entraria na linha 6 e empurraria o resto da página uma linha para baixo. A \\ no título o quebra depois de 关于举办, uma linha curta sobre uma longa: um trapézio, uma das duas formas que a norma admite (a outra é o losango). minHeight reserva 13 linhas e marginBottom, mais uma, de modo que o destinatário começa na linha 15 (span e design avançado).

#4 · Fólios sob a mancha

script.js · linhas 94–103no código completo
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) } } }] };

No rodapé, a borda superior do contêiner é o pé da mancha, por isso offset.y mede para baixo a partir do texto (cabeçalhos e rodapés). Os travessões ficam 7 mm abaixo dela e a uma casa de 四号 da borda externa: parity põe os fólios ímpares à direita e os pares à esquerda. A margem superior imprime {subtitle}, do front matter. Essa linha e o colofão sob o 版记 são tudo o que muda entre a edição em inglês e a em espanhol.

#5 · O anexo e o 版记

script.js · linhas 107–125no código completo
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),
  ] } },
};

O título do anexo tem um estilo próprio: página nova, 附件 na linha 1, o título na linha 3 e nenhuma margem sob as três linhas que ele reserva. A linha 4 em branco é o espaço que todo recurso em linha mantém acima de si (inlineResourceGap, em layout), por isso o fio superior da tabela fica na linha 5. O 版记 faz parte do mesmo design, desenhado nas duas linhas da grade que terminam no pé da mancha. Os elementos têm reserve: false, de modo que não somam nada ao espaço que o título ocupa e a tabela não é empurrada para baixo deles. A norma põe o 版记 na última página, depois dos anexos; com um anexo de uma página, essa é a página do anexo. Um anexo mais longo precisaria que o 版记 fosse desenhado por um título na última página.

#6 · O bloco de assinatura

script.js · linhas 129–135no código completo
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) },
];

Um aviso sem carimbo põe o nome do emissor a duas casas da margem direita e a data embaixo, começando duas casas mais à direita. Uma data mais longa que o nome termina, em vez disso, a duas casas da margem direita, e o nome se desloca para a esquerda para manter o degrau de duas casas. A nossa mede 6,9 emes, um pouco menos que os 7 do nome, por isso, ao pé da letra, começaria duas casas à direita do nome e terminaria a 0,14 em da margem. Lemos a regra pelo que ela quer, uma data que nunca encosta na borda, e aplicamos o segundo caso: a data termina a pouco mais de duas casas da margem. indent põe as duas linhas em casas inteiras, a 17 e 19 emes da margem (estilos de parágrafo).

A receita 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 = 'en'; // @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

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Comprimir os sinais que se encontram

Pares como ),e 》( ocupam uma casa e meia em vez de duas, como na maioria dos livros; os caracteres que vêm depois saem das colunas da grade.

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

#Mostrar a grade enquanto você compõe a página

O canvas desenha um quadrado cinza para cada casa da grade de 28 × 22, e o PDF não o inclui a não ser que renderToPdf receba characterGrid: true.

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

Erros comuns

Erro comum

O Fontsource não tem nenhuma fonte Fangsong (仿宋)

A GB/T 9704 e a maioria dos formulários da China continental compõem o texto em 仿宋, uma fonte Song desenhada com os traços finos e levemente ascendentes do pincel. Nenhuma das famílias chinesas do Fontsource é Fangsong, então uma receita compõe o texto com a Song disponível, a Noto Serif SC, e informa isso. Uma Fangsong para a qual você tenha licença entra como fonte própria: registre o arquivo com FontFace, indique a família em bodyText.fontFamily e passe a renderToPdf um fontProvider que devolva os bytes dela. Fontes chinesas, japonesas e coreanas →

Erro comum

Fontes chinesas são carregadas em fatias, pelo bloco cjk

O Fontsource serve uma família chinesa, japonesa ou coreana em cerca de cem arquivos por peso, cada um com um intervalo de caracteres. loadFonts baixa só o arquivo latin, então na tela os caracteres chineses vêm de uma fonte do sistema e são medidos errado, e o fontsourceProvider entrega ao PDF esse arquivo latin, que os imprime como caixas vazias. Inclua o bloco cjk do kit, chame loadCjkFonts(FONTS, markdown) depois de loadFonts (uma vez por voz, com o texto que ela compõe, quando o livro usa várias fontes CJK) e passe a renderToPdf fontProvider: cjkPdfProvider: os dois pegam os arquivos que contêm os caracteres do texto. Fontes chinesas, japonesas e coreanas →

Erro comum

Marque o documento como zh-Hans ou zh-Hant, não com LANG

As edições de uma receita são en e es, mas uma amostra chinesa é chinesa nas duas: `locale: LANG` a marcaria como inglês ou espanhol, hifenizaria as suas palavras latinas, chamaria as suas figuras de Figure ou Figura e daria ao PDF o idioma errado. Desde o postext 1.30 a marcação é também o idioma em que o texto é composto (em que é medido, pintado e incorporado), então, sob uma marcação inglesa ou espanhola, uma fonte chinesa compõe com outras formas os algarismos e a pontuação que divide com o texto latino, e as linhas quebram em outro ponto. Escreva você mesmo a marcação: 'zh-Hans' (convenções da China continental: quebra de linha GB, pontuação Kaiming) ou 'zh-Hant' (Taiwan: pontuação de largura inteira centralizada); 'zh-HK' para Hong Kong. Um 'zh' sozinho é lido como chinês simplificado continental. Uma amostra japonesa leva 'ja' (armadilha ja-locale-tag). Quebra de linha em chinês →

Erro comum

Células mescladas precisam de hiddenBy: use mergeCells

As células são posicionadas pela posição no array da linha, então uma célula mesclada precisa de células de preenchimento marcadas com hiddenBy onde ela se estende; omiti-las, como no HTML, desloca todas as colunas seguintes. Crie as mesclagens com mergeCells. Desde o postext 1.5, uma tabela com grade irregular é informada em doc.contentWarnings como raggedTableGrid, e parseTSV(text, { headerRows }) marca as linhas de cabeçalho. Tabelas a partir de dados →

Aviso de diagramação · cjkGridClamped

Grade de caracteres grande demais

Por quê. `cjk.grid` pede mais caracteres por linha ou mais linhas por página do que cabem entre as margens com esse corpo e essa entrelinha; por isso, a grade é composta com o máximo que cabe.

Correção. Reduza `charsPerLine` ou `linesPerPage`, estreite as margens (elas são mínimas) ou use um `bodyText.fontSize` ou um `lineHeight` menor. Docs →

  • Uma linha justificada distribui a folga entre os caracteres chineses e os espaços que tiver, e o espaço leva mais do que lhe cabe: na página 2, o de GB/T 15834 abriu quase o dobro da largura do de GB/T 9704, logo acima. O conteúdo escreve os dois números com um espaço não separável (U+00A0), que mantém cada número inteiro, e a folga vai para entre os caracteres.

Créditos

Texto
  • 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
Fontes
Noto Serif SC (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
SandboxPDF