跳到主要内容
食谱编号125

排版食谱 · 第5章 · 图书结构

按SIST 02著录参考文献的日文论文

一篇A4双栏的日文研究笔记:正文写[@key],按SIST 02排成(1)、(2, 3),参考文献表用日文著录,另有脚注、表1和図1。

页码23 · 第1页,共2页

  • 英文样例:尚无中文版本
  • 成品尺寸210 × 297 mm
  • 2栏, 栏间距6.3 mm
  • Noto Serif JP 9/15.5
  • Noto Sans JP
  • Shippori Mincho B1
  • 2页
  • 难度
  • Postext 1.65.0
  • 排版用时217 ms
  • 180行代码

简单来说

日本学术期刊上的一篇短论文。作者给每条文献起一个代号,Postext按引用的先后给文献编号,再按日本科技期刊的要求排出参考文献表。

成品一览

一本虚构的活字与排版研究期刊上一篇研究笔记的两页,题为《号数活字の三つの系列》(号数活字的三个系列),按日本学会会刊的常见版式排出:A4开本,双栏,每栏每行25字,每页45行,正文是9 pt的Noto Serif JP,标题用Shippori Mincho B1,排在期刊的绿色色带上。引文遵循SIST 02,即日本科技期刊使用的参考文献著录指南:每条文献按在正文中首次被引用的先后编号,写作(1)、(2, 3);参考文献下的文献表里,日本人名姓在前,出版地在出版者之前,出版年放在最后。一张九种号数字号的表格、一幅按实际大小画出这些字号的图和两条脚注都用日文标签。它对应的中文食谱是按GB/T 7714著录参考文献的中文论文。

这道食谱解答

  • 怎样按APA、IEEE或其他引用样式引用文献并生成参考文献表?
  • 日文书的注释怎样排:(1)放在章末、页脚,还是跨页排在正文旁边?

简短回答

script.js · 第32–45行在完整代码中
// 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

用料

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

做法

#1 · 样式、语言区域和脚注

代码就是上面的简短回答。postext-citeproc自带SIST 02样式'sist02'和CSL语言文件ja-JP,后者用日文写出文献表里的用语;在叙述式引文中,两位日本著者之间用と连接,三位以上用ほか(引用)。正文里,[@kawada1949; @suzuki2015]印出(2, 3),高橋[@takahashi2012]が把序号放在人名之后,排成高橋(8)が,页面上括号两侧各留四分之一个字宽,与日文里任何西文单词两侧的间距相同。这个样式与中文的GB/T 7714区别在序号的标注:SIST 02把序号放在圆括号里,与正文平排;GB/T 7714放在方括号里,排成上标。脚注无须设置:locale: 'ja'让横排文档的注文排在栏底,每页从1编号,序号为上标,注线长为栏宽的三分之一。

#2 · 用CSL-YAML块提供文献数据

文献数据写在Markdown末尾的:::references{format=csl-yaml}块里,格式与Zotero导出的CSL YAML相同(引用)。日本人名分成family和given写,{family: 鈴木, given: 広光},SIST 02把姓和名连排成鈴木広光,Kornicki则保留逗号:Kornicki, Peter。丛书名写在collection-title里,印在出版年后的圆括号中;《日本印刷学会誌》的两篇文章写出卷、号和页码:vol. 49, no. 2, p. 76–80。所有文献都真实存在,可以在CiNii上核对。

第24页:第(3)至(9)条文献,日本人名姓在前,出版地在出版者之前,出版年放在最后。

#3 · 期刊色带上的题名

script.js · 第49–71行在完整代码中
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)),
] } };

题名区是一级标题的设计,所用标题样式跨两栏通排。色带是锚定在裁切边上的方框;标签、题名及其英文译名排在色带上,每一项放在上一项之下,所以题名排成三行时,英文那一行会随之下移。作者和她的单位取自标题属性,放在色带下方。

#4 · 摘要及其标签

script.js · 第75–82行在完整代码中
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) }];

摘要是一个通栏标注框,上方有一条绿色细带,标签是行内标签,用期刊颜色的黑体粗体排。每个标签后面有一个全角空格,写在Markdown里,把要 旨和正文隔开。

#5 · 表1和図1排在引述它们的地方

script.js · 第279–301行在完整代码中
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')提供図和表两种类型;这篇论文全文连续编号,表1和図1,不按章编,所以模板是'{n}'。两者都放在'here',即栏内引述它们的段落下方。图中的方块按它们所代表的字号实际大小画出,从初号的42 pt到八号的4 pt,每一级减半在页面上一眼可见。

完整食谱

沙盒
// ═══ 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

组合好的script.js可以直接运行:把它粘贴到任何页面的模块脚本中,或在CodePen上打开这道食谱。 GitHub上的食谱文件夹 ↗ (在新标签页中打开)

变化

#引文序号排成上标

许多日本期刊把序号排成上标。marker: 'superscript'把序号升到行上,不加圆括号,文献表不变。

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

#脚注全文连续编号

只有几页的论文,可以从1编到最后,不按页重新编号。

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

常见问题

易错点

日文文本标记为'ja',不要用zh-Hans或LANG

食谱的版本是en和es,但日文示例在两个版本里都是日文:`locale: LANG`会把它标记为英文或西班牙文,中文标记则会按中文规则排它(开明式标点、小假名可以出现在行首、图代替図、PDF中用中文字形)。postext 1.30起,这个标记也是文字成形所用的语言(测量、绘制和嵌入都按它进行),所以'ja'以外的标记给出的不是日文字形(中文标记给出中文字形),断行的位置也不同。写'ja':它选用日本地区(JLReq断行和标点、芝麻着重号、振假名的分布、図和表标签),并关闭断词。lint会让带假名却标记为zh或ko的文本失败。 日文禁则处理 →

易错点

日文要用日文字体排

Noto Serif SC和TC里有假名,但汉字是中文字形(直、骨、角都不同),假名也是中文字体的设计。正文用Noto Serif JP或Shippori Mincho B1,标题用Noto Sans JP,用loadCjkFonts加载。Fontsource的日文文件里没有变体假名等历史假名(U+1B000–1B16F):loadCjkFonts遇到它们会失败,PDF里印出空框,所以要写现代假名,或者把含有这些字的字体放进食谱的assets。Shippori Mincho也没有带长音符号的ō和ū:罗马字要用拉丁字体排。 假名、汉字与罗马字 →

易错点

中文字体通过cjk块分片加载

Fontsource把一个中文、日文或韩文字体家族按每个字重约一百个文件提供,每个文件覆盖一段字符范围。loadFonts只获取latin文件,所以屏幕上的汉字来自系统字体,测量不准;fontsourceProvider交给PDF的也是这个latin文件,汉字印出来是空框。列出kit中的cjk块,在loadFonts之后调用loadCjkFonts(FONTS, markdown)(书中用到几种CJK字体时,每种字体调用一次,并传入它所排的文字),并给renderToPdf传fontProvider: cjkPdfProvider:两者都会取用包含文中字符的那些文件。 中日韩字体 →

  • 日本人名要分成family和given写,或者写成一个不带空格的literal。写成一个字符串、姓和名之间有空格的人名,就像BibTeX里常见的author = {夏目 漱石},会按姓在前读;但罗马字写法Natsume Soseki会像英文人名那样按名在前、姓在后读。
  • 随包的SIST 02样式不印DOI;如果某篇文章的DOI必须给出,请写进正文或脚注。

致谢

文本
原创文字, CC BY 4.0
图片
  • Figure 1, the three series of type sizes, drawn in code to scale · Postext Cookbook · CC BY 4.0
字体
Noto Serif JP (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1) · Shippori Mincho B1 (SIL OFL 1.1)
沙盒PDF