Skip to main content
Recipe number 125

Cookbook · Chapter 5 · Book structure

A Japanese research paper cited to SIST 02

A two-column A4 research note in Japanese: [@key] citations numbered (1), (2, 3) to SIST 02, a 参考文献 list in Japanese, page notes, 表1 and 図1.

p. 23 · 1 of 2

  • Trim 210 × 297 mm
  • 2 columns, 6.3 mm gutter
  • Noto Serif JP 9/15.5
  • Noto Sans JP
  • Shippori Mincho B1
  • 2 pages
  • Level
  • Postext 1.65.0
  • Laid out in 217 ms
  • 180 lines of code

In short

A short research article from a Japanese journal. The author writes a code for each source; Postext numbers them in the order they are cited and prints the reference list the way Japanese science journals ask for it.

What you'll build

Two pages of a research note, 号数活字の三つの系列 (“Three series of gōsū type sizes”), from an invented journal of type and typesetting, set as Japanese academic societies set their journals: A4, two columns of 25 characters by 45 lines of Noto Serif JP at 9 pt, the title in Shippori Mincho B1 on the journal’s green band. The citations follow SIST 02, the guide to references that Japanese science and technology journals use: each work is numbered in the order it is first cited, (1), (2, 3), and the list under 参考文献 gives Japanese names family first, the place before the publisher and the year last. A table of the nine type sizes, a figure drawing them to scale and two page notes come with Japanese labels. The Chinese paper cited to GB/T 7714 is its Chinese counterpart.

This recipe answers

  • How do I cite works and build the bibliography in APA, IEEE or another citation style?
  • How do I set the notes of a Japanese book: (1) at the chapter end, at the page foot or beside the text across the spread?

The short answer

script.js · lines 32–45in full code
// 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

SIST 02 in Japanese: numbered citations, the list under 参考文献

Ingredients

Type
Noto Serif JP, Noto Sans JP, Shippori Mincho B1 (SIL OFL 1.1)
Assets
  • Figure 1, the three series of type sizes, drawn in code to scale (Postext Cookbook, CC BY 4.0)

Method

#1 · The style, the locale and the notes

The code is the short answer above. postext-citeproc ships SIST 02 as 'sist02' and the CSL locale ja-JP, which writes the list’s terms in Japanese and joins two Japanese authors with と and more with ほか in a narrative citation (Citations). In the text, [@kawada1949; @suzuki2015] prints (2, 3), and 高橋[@takahashi2012]が puts the number after the name, 高橋(8)が, which the page sets with a quarter em on each side of the parentheses, as it does round any Western word in Japanese text. The style differs from the Chinese GB/T 7714 in the marker: SIST 02 sets the number in parentheses on the line, GB/T 7714 in square brackets raised. The notes need nothing: locale: 'ja' gives a horizontal document notes at the foot of the column, numbered from 1 on each page, with a superscript marker and a rule a third of the column long.

#2 · The references in a CSL-YAML block

The works are listed at the end of the Markdown in :::references{format=csl-yaml}, the format Zotero exports as CSL YAML (Citing). Japanese names go in as family and given, {family: 鈴木, given: 広光}, and SIST 02 prints them solid, 鈴木広光, while Kornicki keeps his comma: Kornicki, Peter. A book series goes in collection-title and prints in parentheses after the year; the two articles from 日本印刷学会誌 give volume, issue and pages as vol. 49, no. 2, p. 76–80. Every work is real; their entries can be checked in CiNii.

Page 24: entries (3) to (9), Japanese names family first, place before publisher, the year last.

#3 · The title on the journal’s band

script.js · lines 49–71in full code
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)),
] } };

The title block is the design of the H1, a heading style across both columns. The band is a box anchored to the trim; the label, the title and its English translation sit on it, each placed under the one before, so a three-line title pushes the English line down. The author and her affiliation come from heading attributes and sit under the band.

#4 · The abstract and its labels

script.js · lines 75–82in full code
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) }];

The abstract is a callout across the page under a green top stripe, its labels chips in bold gothic in the journal’s colour. An ideographic space after each label, typed in the Markdown, keeps 要 旨 apart from the text.

#5 · 表1 and 図1 where they are cited

script.js · lines 279–301in full code
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') gives 図 and 表; the paper numbers them through, 表1 and 図1, not by chapter, so the template is '{n}'. Both are placed 'here', under the paragraph that cites them, inside the column. The squares of the figure are drawn at the size of the type they stand for, 42 pt for 初号 down to 4 pt for 八号, so the halving can be seen on the page.

The whole recipe

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

The composed script.js runs as it is: paste it into any page’s module script, or open the recipe on CodePen. Recipe folder on GitHub ↗ (opens in a new tab)

Variations

#Superscript citation numbers

Many Japanese journals raise the number above the line. marker: 'superscript' prints it raised, with no parentheses, and leaves the list alone.

   locale: 'ja-JP',
+  marker: 'superscript',

#Notes numbered through the paper

A paper of a few pages may count its notes from 1 to the end instead of per page.

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

Pitfalls

Pitfall

Tag a Japanese text 'ja', never zh-Hans or LANG

A recipe's editions are en and es, but a Japanese sample is Japanese in both: `locale: LANG` would tag it English or Spanish, and a Chinese tag would set it by the Chinese rules (Kaiming punctuation, small kana free to start a line, 图 for 図, Chinese glyph forms in the PDF). From postext 1.30 the tag is also the language the text is shaped in (measured, painted and embedded), so any tag but 'ja' gives other glyph forms than the Japanese ones (the Chinese ones under a Chinese tag) and other line breaks. Write 'ja': it picks the Japan region (JLReq line breaking and punctuation, sesame emphasis marks, furigana spacing, 図 and 表 labels) and turns hyphenation off. The lint fails a text with kana under a zh or ko tag. Japanese line breaking (kinsoku) →

Pitfall

Set Japanese in a Japanese face

Noto Serif SC and TC have kana, but they draw the kanji in Chinese forms (直, 骨 and 角 differ) and the kana in a Chinese design. Set the text in Noto Serif JP or Shippori Mincho B1 and the heads in Noto Sans JP, loaded with loadCjkFonts. Fontsource's Japanese files hold no hentaigana or other historic kana (U+1B000–1B16F): loadCjkFonts fails on them and the PDF prints boxes, so write the modern kana or ship a face that has them in the recipe's assets. Shippori Mincho also lacks the macron vowels ō and ū: set rōmaji in a Latin face. Kana, kanji and rōmaji →

Pitfall

Chinese faces load by slices, through the cjk block

Fontsource serves a Chinese, Japanese or Korean family as about a hundred files per weight, each covering a range of characters. loadFonts fetches only the latin file, so on screen the Han characters come from a system face and measure wrong, and fontsourceProvider hands the PDF that latin file, which prints them as empty boxes. List the cjk kit block, call loadCjkFonts(FONTS, markdown) after loadFonts (once per voice, with the text it sets, when the book uses several CJK faces) and give renderToPdf fontProvider: cjkPdfProvider: both take the files that hold the text's characters. Chinese, Japanese and Korean fonts →

  • Write a Japanese name as family and given, or as one literal with no space. A name typed as one string with a space between family and given name, as BibTeX often carries it (author = {夏目 漱石}), is read family first, but a romanised one, Natsume Soseki, is read as given name then family name, as English names are.
  • The bundled SIST 02 prints no DOI; an article whose DOI matters needs it in the text or a note.

Credits

Text
Original prose, CC BY 4.0
Images
  • Figure 1, the three series of type sizes, drawn in code to scale · Postext Cookbook · CC BY 4.0
Fonts
Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1) · Shippori Mincho B1 (SIL OFL 1.1)
SandboxPDF