Em poucas palavras
Um artigo curto de uma revista científica japonesa. O autor escreve um código para cada fonte; o Postext as numera na ordem em que são citadas e imprime a lista de referências como as revistas científicas japonesas pedem.
O que você vai compor
Duas páginas de uma nota de pesquisa, 号数活字の三つの系列 (“As três séries de corpos gōsū”), de uma revista inventada sobre tipos e composição, composta como as sociedades acadêmicas japonesas compõem as revistas: A4, duas colunas de 25 caracteres por 45 linhas de Noto Serif JP em 9 pt, e o título em Shippori Mincho B1 sobre a faixa verde da revista. As citações seguem a SIST 02, o guia de referências que as revistas japonesas de ciência e tecnologia usam: cada obra é numerada na ordem em que é citada pela primeira vez, (1), (2, 3), e a lista sob 参考文献 dá os nomes japoneses com o sobrenome primeiro, o local antes da editora e o ano no fim. Uma tabela dos nove corpos, uma figura que os desenha em escala e duas notas de rodapé vêm com rótulos japoneses. O artigo chinês citado pela GB/T 7714 é o equivalente chinês.
Esta receita responde a
- Como cito obras e monto a bibliografia em APA, IEEE ou outro estilo de citação?
- Como componho as notas de um livro japonês: (1) no fim do capítulo, no pé da página ou ao lado do texto ao longo da página dupla?
A resposta curta
// Register the engine once, before the first build. SIST 02, the standard Japanese science
// and technology journals cite to, numbers works in the order they are first cited; the
// ja-JP locale writes the list's words and joins authors with と and ほか. The document's
// own locale 'ja' gives the notes their Japanese defaults: at the foot of the column,
// numbered per page, a superscript marker and a rule a third of the column.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'sist02',
locale: 'ja-JP',
bibliography: { fontSize: em(8 / BODY), lineHeight: pt(13), entrySpacing: pt(1),
labelWidth: em(2.2) }, // turnovers under the text of the entry, past the (n)
};
const footnotes = { fontSize: pt(7.5), lineHeight: pt(11.5), color: col('ink'),
separator: { color: col('rule') } }; // placement, numbering and marker: the 'ja' defaults
Ingredientes
- Funcionalidades
- Citações em um estilo de citaçãoBibliografia a partir das referênciasNotas nos livros japonesesNotas de rodapéLegendas numeradasFigura e Tabela no seu idiomaEstilo de tabelaEstilo de legendaFiguras e tabelas como recursosFiguras exatamente aquiTítulos numeradosTítulos sobre linhas do texto (gyōdori)Uma ou duas colunasGrade de caracteresAberturas desenhadasEstilos de títuloFontes chinesas, japonesas e coreanasChips no textoCabeços e fóliosExportação para PDF
- Também usa
- BoxesQuebra de linha em chinêsEquilíbrio de colunasReferências cruzadasAtributos de títuloCabeços por tipo de páginaEstilos de parágrafoFontes incorporadas ao PDFTipos de recurso personalizadosElementos pré-textuais em romanosTabelas a partir de dadosQuebras de linha nos títulosCapítulos sem número
- Tipografia
- Noto Serif JP, Noto Sans JP, Shippori Mincho B1 (SIL OFL 1.1)
- Materiais
- Figure 1, the three series of type sizes, drawn in code to scale (Postext Cookbook, CC BY 4.0)
Preparo
#1 · O estilo, o locale e as notas
O código é a resposta curta lá em cima. O postext-citeproc traz a SIST 02 como 'sist02' e o locale CSL ja-JP, que escreve os termos da lista em japonês e liga dois autores japoneses com と e mais de dois com ほか numa citação narrativa (citações). No texto, [@kawada1949; @suzuki2015] imprime (2, 3), e 高橋[@takahashi2012]が põe o número depois do nome, 高橋(8)が, que a página compõe com um quarto de em de cada lado dos parênteses, como em volta de qualquer palavra ocidental num texto japonês. O estilo difere da norma chinesa GB/T 7714 no marcador: a SIST 02 põe o número entre parênteses na linha, e a GB/T 7714, entre colchetes e elevado. As notas não precisam de nada: locale: 'ja' dá a um documento horizontal notas ao pé da coluna, numeradas a partir de 1 em cada página, com marcador sobrescrito e um fio de um terço da largura da coluna.
#2 · As referências num bloco CSL-YAML
As obras são listadas no fim do Markdown em :::references{format=csl-yaml}, o formato que o Zotero exporta como CSL YAML (citar). Os nomes japoneses entram como family e given, {family: 鈴木, given: 広光}, e a SIST 02 os imprime juntos, 鈴木広光, enquanto Kornicki mantém a vírgula: Kornicki, Peter. Uma coleção de livros vai em collection-title e sai entre parênteses depois do ano; os dois artigos do 日本印刷学会誌 dão volume, número e páginas como vol. 49, no. 2, p. 76–80. Todas as obras existem; as entradas podem ser conferidas no CiNii.

#3 · O título na faixa da revista
const BAND = 78; // mm from the trim's top: the title sits on the journal's green
const at = (id, y) => ({ anchor: { to: `#${id}`, edge: 'below' }, 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 top = (y) => ({ anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(y) },
size: { width: mm(AREA) } });
const masthead = { enabled: true, minHeight: pt(10 * PITCH), slot: { elements: [
{ kind: 'box', id: 'band', style: { backgroundColor: col('green') },
placement: { anchor: { to: 'page', edge: 'top-left' },
size: { width: 'fill', height: mm(BAND) } } },
line('journal', '活字と組版の研究', GOTHIC, 13, 'paper', top(-13), { fontWeight: 700,
align: 'left', letterSpacing: pt(2) }),
line('issue', '第12巻 第2号(2026)', GOTHIC, 8, 'mist', top(-12), { align: 'right' }),
line('kind', '{attr.kind}', GOTHIC, 8, 'mist', top(2), { fontWeight: 700,
letterSpacing: pt(2) }),
line('title', '{titleText}', TITLE, 20, 'paper', at('kind', 3), { fontWeight: 700,
lineHeight: 1.45 }),
line('english', '{attr.english}', MINCHO, 8.5, 'mist', at('title', 3)),
line('author', '{attr.authors}', MINCHO, 11, 'ink', top(BAND - 16)),
line('affiliation', '{attr.affiliation}', MINCHO, 8, 'muted', at('author', 1.5)),
] } };
O bloco do título é o design do H1, um estilo de título que atravessa as duas colunas. A faixa é uma caixa ancorada no refile; o rótulo, o título e a tradução para o inglês ficam sobre ela, cada um posicionado embaixo do anterior, de modo que um título de três linhas empurra a linha em inglês para baixo. A autora e a filiação vêm de atributos do título e ficam sob a faixa.
#4 · O resumo e os seus rótulos
const calloutStyles = [{ id: 'abstract', span: 'page', backgroundEnabled: false,
stripe: { enabled: true, side: 'top', width: pt(1.5), color: col('green') },
padding: { top: mm(2.5), bottom: mm(2.5), left: em(2), right: em(2) },
marginTop: pt(0), marginBottom: pt(PITCH),
body: { fontFamily: MINCHO, fontSize: pt(8.5), lineHeight: pt(14), firstLineIndent: pt(0),
textAlign: 'justify' } }];
const chipStyles = [{ id: 'label', fontFamily: GOTHIC, bold: true, color: col('green'),
backgroundEnabled: false, borderWidth: pt(0), paddingX: em(0), gap: em(1) }];
O resumo é um boxe na largura da página sob uma tarja verde no alto, e os rótulos são chips em gótica negrito na cor da revista. Um espaço ideográfico depois de cada rótulo, digitado no Markdown, separa 要 旨 do texto.
#5 · 表1 e 図1 onde são citados
const SIZES = `号数\t旧号数(pt)\t新号数(pt)\t系列
初号\t42\t42\t初号系
一号\t27.5\t26.25\t一号系
二号\t21\t21\t初号系
三号\t16\t15.75\t三号系
四号\t13.75\t13.125\t一号系
五号\t10.5\t10.5\t初号系
六号\t8\t7.875\t三号系
七号\t5.25\t5.25\t初号系
八号\t4\t3.9375\t三号系`;
const SERIES = [[42, 21, 10.5, 5.25], [27.5, 13.75], [16, 8, 4]]; // old values, pt
const resources = [
{ id: 'tbl:sizes', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0,
placement: { position: 'here' },
caption: '号数活字の大きさ。新号数はJIS Z 8305(1962)による',
table: { model: { ...parseTSV(SIZES), headerRowCount: 1, columnWidths: [16, 28, 28, 28] } } },
{ id: 'fig:series', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0,
placement: { position: 'here' },
caption: '号数活字の三つの系列。上から初号系、一号系、三号系。正方形は旧号数の大きさを実寸で示す',
altText: 'Three rows of squares drawn to scale: 42, 21, 10.5 and 5.25 pt; 27.5 and 13.75 pt; '
+ '16, 8 and 4 pt. Each square is half the one before it.',
svg: { fileId: 'series.svg', width: 790, height: 520 } },
];
defaultResourceTypes('ja') dá 図 e 表; o artigo os numera em sequência, 表1 e 図1, e não por capítulo, por isso o modelo é '{n}'. Os dois são posicionados 'here', sob o parágrafo que os cita, dentro da coluna. Os quadrados da figura são desenhados no tamanho do tipo que representam, de 42 pt no 初号 a 4 pt no 八号, para que a redução pela metade se veja na página.
A receita completa
// ═══ Postext Cookbook · Nº 125 · A Japanese research paper cited to SIST 02 ═══════════
// https://postext.dev/en/cookbook/sist02-research-paper
// Code: MIT · Text: original (CC BY 4.0) · Pictures: drawn in code
// Fonts: Noto Serif JP, Noto Sans JP, Shippori Mincho B1 (SIL OFL 1.1) · Needs postext ≥ 1.34.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, registerCitationEngine, defaultResourceTypes,
parseTSV, registerResourceImage, inlineSvgFonts,
} 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 Japanese in both
const RECIPE = 'sist02-research-paper';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black text, one deep green for the journal, its rules and its labels
const palette = {
ink: '#1b1d1c', green: '#1f5a46', mist: '#cfe0d8', rule: '#a7b3ad', muted: '#5d6662',
paper: '#ffffff',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.green })
.map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [MINCHO, GOTHIC, TITLE] = ['Noto Serif JP', 'Noto Sans JP', 'Shippori Mincho B1'];
const [BODY, PITCH] = [9, 15.5]; // pt: 9 pt text on a 15.5 pt line
const [CHARS, LINES] = [25, 45]; // 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, 165
// #region answer: SIST 02 in Japanese: numbered citations, the list under 参考文献
// Register the engine once, before the first build. SIST 02, the standard Japanese science
// and technology journals cite to, numbers works in the order they are first cited; the
// ja-JP locale writes the list's words and joins authors with と and ほか. The document's
// own locale 'ja' gives the notes their Japanese defaults: at the foot of the column,
// numbered per page, a superscript marker and a rule a third of the column.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
style: 'sist02',
locale: 'ja-JP',
bibliography: { fontSize: em(8 / BODY), lineHeight: pt(13), entrySpacing: pt(1),
labelWidth: em(2.2) }, // turnovers under the text of the entry, past the (n)
};
const footnotes = { fontSize: pt(7.5), lineHeight: pt(11.5), color: col('ink'),
separator: { color: col('rule') } }; // placement, numbering and marker: the 'ja' defaults
// #endregion
// #region masthead: the journal, the paper's kind, its title and English title on a band
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
#Números de citação sobrescritos
Muitas revistas japonesas elevam o número acima da linha. marker: 'superscript' o imprime elevado, sem parênteses, e não mexe na lista.
locale: 'ja-JP',
+ marker: 'superscript',#Notas numeradas ao longo do artigo
Um artigo de poucas páginas pode contar as notas de 1 até o fim em vez de por página.
-const footnotes = { fontSize: pt(7.5), lineHeight: pt(11.5), color: col('ink'),
+const footnotes = { numbering: 'document', fontSize: pt(7.5), lineHeight: pt(11.5),
+ color: col('ink'),Erros comuns
Erro comum
Marque um texto japonês como 'ja', nunca com zh-Hans nem LANG
As edições de uma receita são en e es, mas uma amostra japonesa é japonesa nas duas: `locale: LANG` a marcaria como inglês ou espanhol, e uma marcação chinesa a comporia pelas regras chinesas (pontuação Kaiming, kana pequeno livre para começar linha, 图 no lugar de 図, formas chinesas dos glifos no PDF). 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 qualquer marcação que não seja 'ja' dá outras formas de glifo que não as japonesas (as chinesas, sob uma marcação chinesa) e outras quebras de linha. Escreva 'ja': isso escolhe a região do Japão (quebra de linha e pontuação da JLReq, pontos de ênfase em gergelim, espaçamento dos furigana, rótulos 図 e 表) e desativa a hifenização. O lint reprova um texto com kana sob uma marcação zh ou ko. Quebra de linha em japonês (kinsoku) →
Erro comum
Componha o japonês com uma fonte japonesa
A Noto Serif SC e a TC têm kana, mas desenham os kanji com formas chinesas (直, 骨 e 角 mudam) e o kana com desenho chinês. Componha o texto em Noto Serif JP ou Shippori Mincho B1 e os títulos em Noto Sans JP, carregadas com loadCjkFonts. Os arquivos japoneses do Fontsource não têm hentaigana nem outros kana históricos (U+1B000–1B16F): loadCjkFonts falha com eles e o PDF imprime caixas, então escreva o kana moderno ou inclua nos recursos da receita uma fonte que os tenha. A Shippori Mincho também não tem as vogais com mácron ō e ū: componha o rōmaji com uma fonte latina. Kana, kanji e rōmaji →
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 →
- Escreva um nome japonês como
familyegiven, ou como um únicoliteralsem espaço. Um nome digitado como uma só string com um espaço entre sobrenome e nome, como o BibTeX costuma trazer (author = {夏目 漱石}), é lido com o sobrenome primeiro, mas um nome romanizado,Natsume Soseki, é lido como nome e depois sobrenome, como os nomes ingleses. - A SIST 02 incluída não imprime DOI; um artigo cujo DOI importa precisa dele no texto ou numa nota.
Créditos
- Receita
- Ignacio Ferro
- Texto
- Texto original, CC BY 4.0
- Imagens
- Figure 1, the three series of type sizes, drawn in code to scale · Postext Cookbook · CC BY 4.0
- Fontes
- Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1) · Shippori Mincho B1 (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


