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

Receitas · Capítulo 5 · Estrutura do livro

Um artigo científico japonês citado pela SIST 02

Uma nota de pesquisa japonesa em A4 a duas colunas: citações [@key] numeradas (1), (2, 3) pela SIST 02, lista 参考文献 em japonês, notas, 表1 e 図1.

p. 23 · 1 de 2

  • Amostra em inglês: ainda sem edição em português
  • Refile 210 × 297 mm
  • 2 colunas, medianiz de 6,3 mm
  • Noto Serif JP 9/15,5
  • Noto Sans JP
  • Shippori Mincho B1
  • 2 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 217 ms
  • 180 linhas de código

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

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

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.

Página 24: as entradas (3) a (9), nomes japoneses com o sobrenome primeiro, o local antes da editora e o ano no fim.

#3 · O título na faixa da revista

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

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

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

Sandbox
// ═══ 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 family e given, ou como um único literal sem 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

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