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

Receitas · Capítulo 5 · Estrutura do livro

Chinês vertical com citações em notas dentro da linha

Um capítulo vertical em caracteres tradicionais, encadernado pela direita, cujas citações em nota GB/T 7714 são compostas como 夾注 dentro da coluna.

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

p. 四十六–四十七 · 2–3 de 3

  • Amostra em inglês: ainda sem edição em português
  • Refile 140 × 203 mm
  • 1 coluna
  • Noto Serif SC 10,5/19
  • LXGW WenKai TC
  • Noto Sans SC
  • 3 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 120 ms
  • 125 linhas de código

Em poucas palavras

Um capítulo de livro chinês composto em colunas de cima para baixo. Cada fonte é citada numa notinha de duas linhas dentro da coluna, e as obras citadas vêm listadas no fim.

O que você vai compor

O fim de um capítulo de um livro inventado sobre a imprensa chinesa, 版刻叢談 (“Conversas sobre a impressão xilográfica”), composto em caracteres tradicionais, de cima para baixo, em colunas lidas a partir da direita, numa página 大32開 de 140 × 203 mm encadernada pela direita. O capítulo trata da diagramação das edições Song e cita cinco obras reais. Cada citação é composta como os livros chineses compõem o comentário há séculos: como um 夾注, uma nota em duas fileiras com metade do corpo, dentro da coluna onde está a citação. A nota que não cabe no que resta de uma coluna continua na cabeça da seguinte, e uma delas atravessa a virada de página. As notas seguem a forma de nota da GB/T 7714—2015, a norma de referências da China continental, e o capítulo termina com uma lista numerada das obras citadas, com as inglesas giradas de lado. O mesmo capítulo com as notas no pé da página seria composto como na Nº 071.

Esta receita responde a

  • Como cito segundo a norma chinesa GB/T 7714, também em texto vertical?
  • Como coloco as citações em notas de rodapé, no estilo Chicago, com forma abreviada nas citações seguintes?

A resposta curta

script.js · linhas 29–43no código completo
// The GB/T 7714 note style turns each citation into a note. notes: 'warichu' sets the note
// in the column where the citation stands, in two rows at half the text size, the right
// row read first; a note longer than what is left of the column goes on in the next one.
// The list at the chapter's end comes from :::bibliography{scope=chapter}, numbered in
// the order the works are cited. Latin words turn sideways in the notes and in the list.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'china-national-standard-gb-t-7714-2015-note',
  notes: 'warichu', // 夾注; 'footnote' sets the same notes at the foot of the page
  bibliography: { fontSize: em(0.9), entrySpacing: pt(0) },
};
const cjk = {
  grid: { enabled: true, charsPerLine: 36, linesPerPage: 15 },
  warichu: { fontSize: em(0.5), color: col('ink') }, // no brackets: the half size sets it off
};

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 · Um estilo de notas, composto dentro da linha

O código é a resposta curta acima. O estilo de notas da GB/T 7714 (china-national-standard-gb-t-7714-2015-note) é um estilo de notas: cada citação vira uma nota que nomeia a obra por inteiro (Citações). Por padrão, um estilo de notas manda as notas para o pé da página. notes: 'warichu' mantém cada nota na coluna, composta como warichu: duas fileiras em cjk.warichu.fontSize, metade do corpo, centralizadas na coluna, lendo-se primeiro a fileira da direita (Marcas, rubi e warichu). O Markdown é o de qualquer estilo, [@su1999] depois das palavras que a citação sustenta, e a nota ocupa o lugar da citação, antes do 。 que fecha a frase.

Página 1: a nota sobre o livro de 宿白 começa no pé da terceira coluna e continua na cabeça da quarta, sempre com a fileira da direita primeiro.

As fileiras são preenchidas por trechos. No pé da terceira coluna só cabem 宿白. 唐宋時期, que se dividem em duas fileiras de três e quatro casas; o resto da nota preenche a cabeça da coluna seguinte, de novo em duas fileiras. Na página 2, a nota de Twitchett começa no pé da última coluna, e o leitor vira a página para terminá-la.

#2 · As obras citadas, no fim do capítulo

:::bibliography{title="本章引用書目" scope=chapter} põe a lista onde ela está no texto e inclui só as obras que este capítulo cita (A bibliografia). As referências vêm de um bloco BibTeX. Cada entrada traz um langid, chinese ou english, que o estilo lê como a língua da obra, e os nomes escritos em caracteres ficam inteiros. A lista é numerada pela ordem da primeira citação, e as colunas de continuação de cada entrada começam abaixo do rótulo.

#3 · Caracteres tradicionais com as regras do continente

locale: 'zh-Hant-CN' pede caracteres tradicionais com as regras da China continental, como as editoras de Pequim e Xangai compõem os estudos clássicos: a vírgula e o ponto ficam no canto superior direito da casa, e um livro vertical é encadernado pela direita. As citações seguem a etiqueta: a escrita tradicional escolhe o locale CSL zh-TW, por isso as palavras que o estilo acrescenta também saem em caracteres tradicionais. A Noto Serif SC desenha os caracteres tradicionais nas formas do continente, que é o que esta edição pede; a LXGW WenKai TC, uma fonte de Taiwan, compõe só o título do capítulo, que não tem pontuação (Números em texto vertical explica o que acontece com os algarismos).

Nas notas e na lista, um título latino e um ano de quatro algarismos giram de lado e descem pela coluna. Um número curto ao lado de texto chinês, como o 1 de um rótulo, fica em pé na casa.

#4 · A abertura entre fios

script.js · linhas 47–64no código completo
// In the flow frame x runs down the column and y across the page, right to left, so a
// 'horizontal' rule is a vertical line on the sheet: three of them rule the two columns.
const [TITLE, PITCH] = [15, 1.6 * LEAD]; // pt: the title's size and its column pitch
const rule = (n) => ({ kind: 'rule', id: `rule-${n}`, direction: 'horizontal',
  thickness: pt(n === 1 ? 0.4 : 0.8), color: col('vermilion'),
  placement: { anchor: { to: 'container', edge: 'top-left' },
    offset: { y: pt(LEAD + n * PITCH) }, size: { width: 'fill' } } });
// A line of PITCH in column n (0, 1), its characters centred between two rules.
const title = (id, content, n, family, size, weight) => ({ kind: 'text', id, content,
  fontFamily: family, fontWeight: weight, fontSize: pt(size), lineHeight: PITCH / size,
  color: col('ink'), letterSpacing: pt(size * 0.25), align: 'left',
  placement: { anchor: { to: 'container', edge: 'top-left' },
    offset: { x: pt(2 * BODY), y: pt(LEAD + n * PITCH) } } }); // two characters down
const opener = { enabled: true, minHeight: cols(5), slot: { elements: [
  rule(0), rule(1), rule(2),
  title('number', '{number}', 0, HEI, 12, 700), // 第三章 in the first column, in 黑
  title('title', '{titleText}', 1, KAI, TITLE, 400), // the title in the second, in 楷
] } };

Numa página vertical, o desenho de um título é disposto no quadro do fluxo: x desce pela coluna e y atravessa a página a partir da borda direita, de modo que um fio 'horizontal' é uma linha vertical na folha. Três fios emolduram duas colunas a 30,4 pt uma da outra. 第三章 fica na primeira, em Hei negrito, e o título na segunda, em Kai (Span e design avançado). O número do capítulo vem de startAt=3 no título e do modelo 第{1:一}章, e os fólios de pageNumbering: trad-chinese-informal a partir de 45. Os cabeços e os fólios descem pela margem externa, como na Nº 075 (Elementos de texto vertical).

script.js · linhas 17–22no código completo
const palette = {
  ink: '#22201c', vermilion: '#a8352a', muted: '#6d665d', paper: '#fbf8f1',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.vermilion })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 091 · Vertical Chinese with citations in inline notes ══════
// https://postext.dev/en/cookbook/vertical-book-with-jiazhu-citations
// 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.25.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerCitationEngine,
  loadVerticalAlternates,
} 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 chapter is Chinese in both editions
const RECIPE = 'vertical-book-with-jiazhu-citations';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black ink, one vermilion for the opener's rules, the paper of the page
const palette = {
  ink: '#22201c', vermilion: '#a8352a', muted: '#6d665d', paper: '#fbf8f1',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.vermilion })
  .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] = [10.5, 19]; // pt: 五號 on a column pitch of 1.8 em
const cols = (n) => pt(n * LEAD); // n columns across the page

// #region answer: a note style set as 夾注, two half-size rows inside the column
// The GB/T 7714 note style turns each citation into a note. notes: 'warichu' sets the note
// in the column where the citation stands, in two rows at half the text size, the right
// row read first; a note longer than what is left of the column goes on in the next one.
// The list at the chapter's end comes from :::bibliography{scope=chapter}, numbered in
// the order the works are cited. Latin words turn sideways in the notes and in the list.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'china-national-standard-gb-t-7714-2015-note',
  notes: 'warichu', // 夾注; 'footnote' sets the same notes at the foot of the page
  bibliography: { fontSize: em(0.9), entrySpacing: pt(0) },
};
const cjk = {
  grid: { enabled: true, charsPerLine: 36, linesPerPage: 15 },
  warichu: { fontSize: em(0.5), color: col('ink') }, // no brackets: the half size sets it off
};
// #endregion

// #region opener: 第三章 and the title in two ruled columns, the text after a blank one
// In the flow frame x runs down the column and y across the page, right to left, so a
// 'horizontal' rule is a vertical line on the sheet: three of them rule the two columns.

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 em volta de cada nota

Algumas edições fecham o 夾注 entre colchetes no corpo do texto corrido. cjk.warichu aplica os colchetes a todas as notas, inclusive às das citações.

-  warichu: { fontSize: em(0.5), color: col('ink') }, // no brackets: the half size sets it off
+  warichu: { fontSize: em(0.5), color: col('ink'), open: '〔', close: '〕' },

#Números na coluna em vez de notas

O estilo numérico da GB/T 7714 com colchetes de canto imprime 〔1〕 em pé na coluna, e a lista não muda.

-  style: 'china-national-standard-gb-t-7714-2015-note',
-  notes: 'warichu', // 夾注; 'footnote' sets the same notes at the foot of the page
+  style: 'china-national-standard-gb-t-7714-2015-numeric',
+  marker: 'corner', // 〔1〕, upright in vertical text

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 →

Erro comum

Componha a pontuação de cada região com uma fonte dessa região

As larguras da pontuação levam o branco de cada sinal para o lado em que a região do documento o coloca, não para o lado em que a fonte o desenha: com zh-Hans, uma vírgula Kaiming mantém a metade esquerda da sua caixa, onde uma fonte simplificada desenha o glifo, e cede a metade direita. Uma fonte tradicional centraliza ,。 na caixa, então a metade que sai leva parte do glifo e a vírgula fica colada no caractere seguinte. LXGW WenKai TC, a única Kai de texto do Fontsource, faz isso em texto simplificado. Componha o texto, as notas e as citações continentais em Noto Serif SC ou Noto Sans SC, deixe as fontes TC para zh-Hant e use uma fonte de pincel simplificada (Ma Shan Zheng) só em linhas de destaque, onde o texto de design não aplica larguras de pontuação. Ela também desenha formas herdadas que nem o padrão continental nem o de Taiwan imprimem, 為 com o topo 爫 de 爲 e 令 (em 冷, 領) com o pé de 卩: confira os caracteres que uma página compõe com ela. Largura da pontuação chinesa →

Erro comum

Um livro encadernado pela direita mostra as páginas duplas com showBook

Em um livro encadernado pela direita (texto árabe, hebraico ou persa, chinês vertical, ou page.binding 'right') a página 1 continua sendo a ímpar, mas fica à esquerda da lombada, e os pares se leem [3 | 2]. showPages dispõe todos os livros como se fossem encadernados pela esquerda; showBook, do bloco book (o bloco cjk traz a mesma função), lê doc.binding e espelha os pares. capture.hero continua nomeando uma página dupla em ordem de leitura, [par, ímpar]: [2, 3]. Livros encadernados pela direita →

  • Um estilo de notas escreve a segunda citação de uma obra de forma abreviada, e o estilo de notas da GB/T 7714 a reduz a 同1, “como na nota 1”. Um warichu não tem número, por isso o leitor não acha a nota 1. Este capítulo cita cada obra uma única vez; num texto que volte a citar uma obra, escreva a segunda citação à mão ou use o estilo numérico da segunda variação.
  • O estilo escreve pontuação ocidental nas entradas chinesas, 宿白. 唐宋時期的雕版印刷[M]. 北京: 文物出版社, 1999., como a norma as imprime. Numa coluna vertical, esses sinais mantêm a forma ocidental: giram de lado e ocupam menos de uma casa, ao contrário do 。 e da , do texto.
  • Uma fileira de warichu tem metade do corpo: com o texto em 10,5 pt, cada fileira fica com 5,25 pt, o menor tipo da página. Componha o texto em 五號 ou maior, ou aumente cjk.warichu.fontSize; as duas fileiras sempre dividem a largura de uma coluna.

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