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
// 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
- Features
- Citations in a citation styleBibliography from the referencesNotes in Japanese booksFootnotesNumbered captionsFigure and Table in your languageTable styleCaption styleFigures and tables as resourcesFigures exactly hereNumbered headingsHeadings over body lines (gyōdori)One or two columnsCharacter gridDesigned openersHeading stylesChinese, Japanese and Korean fontsInline chipsRunning heads and foliosPDF export
- Also uses
- Callout boxesChinese line breakingColumn balancingCross-referencesHeading attributesHeads by page roleParagraph stylesFonts embedded in the PDFCustom resource typesRoman front matterTables from dataLine breaks in titlesUnnumbered chapters
- 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.

#3 · The title on the journal’s band
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
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
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
// ═══ 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
familyandgiven, or as oneliteralwith 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
- Recipe
- Ignacio Ferro
- 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)
Edit this write-up ↗ (opens in a new tab)Recipe folder on GitHub ↗ (opens in a new tab)


