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

Receitas · Capítulo 5 · Estrutura do livro

Um artigo chinês citado pela GB/T 7714

Um artigo de revista chinesa em duas colunas: as citações [@key] saem como [1] e [2–4] sobrescritos, e as referências levam [M], [J], [D] e [EB/OL].

Nesta página
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.34.0 · postext-pdf ≥ 1.34.0
Licença
Atualizada em 16 de out. de 2026
Código MIT · Texto CC BY 4.0

p. 41 · 1 de 2

  • Amostra em inglês: ainda sem edição em português
  • Refile 184 × 260 mm
  • 2 colunas, medianiz de 6,3 mm
  • Noto Serif SC 9/15
  • LXGW WenKai TC
  • Noto Sans SC
  • 2 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 151 ms
  • 149 linhas de código

Em poucas palavras

Um artigo curto de uma revista científica chinesa. O autor escreve um código para cada fonte; o Postext numera as fontes na ordem em que são citadas e imprime a lista de referências como as revistas chinesas exigem.

O que você vai compor

Duas páginas de um artigo de pesquisa numa revista inventada de estudos editoriais, 示例出版研究 (“Pesquisa Editorial de Exemplo”), composto como uma revista universitária chinesa compõe os artigos. A página é um 16开, 184 × 260 mm, com duas colunas de 23 caracteres de 小五 numa grade de 15 pt. Um bloco de título atravessa a página: o nome da revista numa faixa anil, o título em Hei negrito, os autores, as filiações e um resumo com as palavras-chave. As citações seguem a GB/T 7714—2015, a norma nacional chinesa de referências, no sistema numérico (顺序编码制): cada obra recebe um número na ordem em que é citada pela primeira vez, o número sai sobrescrito entre colchetes e três ou mais números seguidos viram um intervalo. A lista de referências dá a cada entrada o código de tipo de documento e escreve 等 depois de três autores de uma obra chinesa e “et al.” depois dos de uma ocidental. Um capítulo de tese citado em APA 7 usa a mesma marcação de citações num estilo autor-data.

Esta receita responde a

  • Como cito segundo a norma chinesa GB/T 7714, também em texto vertical?
  • Como cito obras e monto a bibliografia em APA, IEEE ou outro estilo de citação?

A resposta curta

script.js · linhas 31–43no código completo
// 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

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 · O estilo, e o seu modelo para obras ocidentais

O código está na resposta curta, mais acima. O motor de citações é registrado uma vez, antes da primeira composição, e o postext-citeproc traz os três estilos da GB/T 7714: numérico, autor-data e de notas (Citações). No texto, uma citação é uma chave entre colchetes. [@tinker1963] imprime um [1] sobrescrito, e [@rayner2016; @dyson2001; @lin2023] imprime [2–4]. Dois números seguidos continuam como lista, [5,6]. Uma obra citada de novo mantém o primeiro número: [4] no terceiro parágrafo, e [1] e [2] mais adiante no artigo.

A norma pede “et al.” depois dos três primeiros autores de uma obra ocidental e 等 depois dos de uma chinesa. O arquivo CSL incluído tem dois modelos para isso, um deles para obras em inglês, e cada entrada tira o seu do próprio campo language: Rayner e quatro coautores viram “RAYNER K, SCHOTTER E R, MASSON M E J, et al.”, e 林岚 e três coautores viram “林岚, 周明远, 陈思齐, 等”. locale: 'zh-CN' escreve em chinês as demais palavras da lista.

#2 · As referências num bloco CSL-YAML

As obras ficam num bloco :::references{format=csl-yaml} no fim do Markdown, no formato que o Zotero exporta como CSL YAML (Referências). O tipo CSL decide o código: book imprime [M], article-journal [J], thesis [D], paper-conference [C] depois do // e dos anais, e webpage [EB/OL] com a data de acesso entre colchetes. Um artigo de revista com DOI vira [J/OL] e mantém o DOI, como a norma pede. Os nomes chineses vão em literal, para que o estilo não os separe em sobrenome e nome. :::bibliography{title=""} põe a lista sob o título sem número 参考文献, e labelWidth alinha as linhas seguintes com o texto da entrada, e não além dele.

Página 2: entradas ocidentais em maiúsculas com et al., entradas chinesas com 等, cada uma com o código de tipo.

#3 · O bloco de título numa faixa

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

O bloco de título é o design do H1, um estilo de título que ocupa as duas colunas. A faixa é uma caixa ancorada ao refile, e o nome da revista fica sobre ela em branco. O título, os autores e as filiações vêm do título e dos atributos, cada um posicionado embaixo do anterior (#title, below), por isso um título de três linhas empurra o resto para baixo (Largura e design avançado).

#4 · O resumo e os seus rótulos

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

O resumo é um boxe na largura da página, recuado dois caracteres de cada lado. Os rótulos são chips: :chip[摘 要:]{style="label"} compõe a palavra em Hei negrito, no anil da revista, sem caixa (Estilos de chip). As revistas chinesas costumam compor o resumo em 楷体; esta o mantém em Song, pelo motivo explicado em “Erros comuns”.

script.js · linhas 16–22no código completo
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' } }));

A receita completa

Sandbox
// ═══ 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 = 'en'; // @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 },

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

#Colchetes de canto em vez de sobrescritos

Algumas revistas imprimem os números das citações na linha, no mesmo corpo que o texto. marker muda o jeito de marcar o número e não mexe no estilo: 'brackets' dá [1] na linha, 'corner' dá 〔1〕.

   locale: 'zh-CN', // 等, 卷, 版 and the other terms of the list
+  marker: 'brackets',

#Obras chinesas primeiro

Bibliografias mistas às vezes são ordenadas com as obras chinesas antes das ocidentais. Num estilo numérico os números deixam então de correr em ordem pela lista, por isso isto combina melhor com o estilo autor-data.

-  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),

Erros comuns

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

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 →

  • Uma citação narrativa, @zhou2019 sem colchetes, nomeia os autores e acrescenta o número, mas a chave continua pelos caracteres chineses que vierem depois, de modo que @zhou2019认为 é lido como uma chave que não existe. Escreva o nome no texto e a citação depois dele, 周明远[@zhou2019]认为, como os artigos chineses já fazem.
  • O estilo numérico incluído não imprime localizadores: [@zhou2019, 页 45] dá [5] sem a página. A GB/T 7714 põe a página depois do colchete, dentro do sobrescrito, [5]45; enquanto o estilo não fizer isso, escreva a página na frase.
  • A LXGW WenKai TC, a única Kai do Fontsource, é uma fonte de Taiwan: desenha ,e 。 no meio da casa, e com zh-Hans o motor apara a metade direita da casa, o que corta o glifo. O resumo é composto em Noto Serif SC, e a Kai fica para os nomes dos autores, que não têm pontuação.
  • Numa grade de caracteres o equilíbrio de colunas vem desativado por padrão: cada linha fica na grade e a coluna que não comporta o título seguinte termina antes. Desativado, a segunda coluna da página 1 terminaria três linhas mais curta (o título 2 结果 precisa das duas linhas e de duas de texto embaixo, por isso abre a página 2) e a última página encheria a primeira coluna e deixaria a segunda pela metade. A receita define headings.balancing.enabled: true: a coluna curta recebe linhas inteiras da grade acima dos títulos, sem nunca tirar um caractere da casa, e as duas colunas da última página terminam na mesma altura.

Créditos

Texto
Texto original, 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