跳到主要内容
食谱编号91

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

竖排中文:引文排成行内夹注

一章繁体竖排、右翻的书稿,按GB/T 7714注释体引用的文献排成正文行内的双行夹注。

本页内容
输出
Canvas · PDF
难度
高级
Postext
已用Postext 1.65.0测试
需要≥ 1.25.0 · postext-pdf ≥ 1.25.0
许可证
更新于2026年10月11日
代码MIT · 文本CC BY 4.0

页码四十六–四十七 · 第2–3页,共3页

  • 英文样例:尚无中文版本
  • 成品尺寸140 × 203 mm
  • 1栏
  • Noto Serif SC 10.5/19
  • LXGW WenKai TC
  • Noto Sans SC
  • 3页
  • 难度
  • Postext 1.65.0
  • 排版用时120 ms
  • 125行代码

简单来说

一本中文书的一章,文字从上到下竖排。每处引用的文献以两行小字的夹注排在正文行内,章末列出所引文献。

成品一览

一本虚构的印刷史小书《版刻丛谈》中一章的后半部分,繁体字,自上而下竖排、自右向左换行,大32开,140 × 203 mm,右翻。这一章讲宋刻本的版式,引了五种真实存在的著作。每处引文都按中国书籍沿用了几百年的办法处理:排成夹注,也就是正文行内两行半字号的小字。一行剩下的地方放不下的夹注,接到下一行的行首继续排,其中一条还跨了页。夹注采用GB/T 7714—2015《信息与文献 参考文献著录规则》的注释体,章末附编号的本章引用文献表,英文文献横倒排。同一章若把注释放到页脚,排法可参看脚注排在引用它的那一栏底部。

这道食谱解答

  • 怎样按GB/T 7714著录引用,竖排也一样?
  • 怎样按芝加哥注释体把引用排成脚注,并让后续引用用简略形式?

简短回答

script.js · 第29–43行在完整代码中
// The GB/T 7714 note style turns each citation into a note. notes: 'warichu' sets the note
// in the column where the citation stands, in two rows at half the text size, the right
// row read first; a note longer than what is left of the column goes on in the next one.
// The list at the chapter's end comes from :::bibliography{scope=chapter}, numbered in
// the order the works are cited. Latin words turn sideways in the notes and in the list.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'china-national-standard-gb-t-7714-2015-note',
  notes: 'warichu', // 夾注; 'footnote' sets the same notes at the foot of the page
  bibliography: { fontSize: em(0.9), entrySpacing: pt(0) },
};
const cjk = {
  grid: { enabled: true, charsPerLine: 36, linesPerPage: 15 },
  warichu: { fontSize: em(0.5), color: col('ink') }, // no brackets: the half size sets it off
};

用料

类型
Noto Serif SC, Noto Sans SC, LXGW WenKai TC(SIL OFL 1.1)
素材
无:所有图片都用代码绘制

做法

#1 · 注释体,排在行内

代码就是上面的简短回答。GB/T 7714的注释体(china-national-standard-gb-t-7714-2015-note)把每处引文变成一条注,注里写出文献的完整著录项目(引用)。注释体默认把注排在页脚。notes: 'warichu'让每条注留在原来的行里,排成夹注:两行,字号为cjk.warichu.fontSize,即正文的一半,在行中居中,先读右边一行(着重号、注音与夹注)。Markdown的写法和其他样式一样,[@su1999]跟在所依据的文字后面,夹注就排在引文的位置,在句末的“。”之前。

第1页:宿白一书的夹注从第三行行末开始,接到第四行行首,两处都是先读右边一行。

夹注是一段一段填的。第三行行末只容得下“宿白. 唐宋時期”,于是分成三格和四格两行;其余部分在下一行行首继续,仍然分成两行。第2页上,Twitchett那条夹注从最后一行行末开始,读者翻过页才能读完。

#2 · 章末的引用书目

:::bibliography{title="本章引用書目" scope=chapter}把参考文献表排在它所在的位置,只列本章引用的文献(参考文献表)。文献数据来自BibTeX块。每条文献都有langid字段,chinese或english,样式据此判断文献的语种;用汉字写的姓名保持完整。参考文献表按首次引用的顺序编号,每条文献转行时从编号下方开始。

#3 · 繁体字,按大陆规范排

locale: 'zh-Hant-CN'表示用繁体字、按大陆规范排版,北京、上海的出版社排古籍和文史著作多是这样:逗号、句号放在字格的右上角,竖排的书右翻。引文跟随这个标签:繁体字会选用zh-TW的CSL语言文件,所以样式添加的用语也是繁体。Noto Serif SC按大陆字形画繁体字,正合这个版本的需要;LXGW WenKai TC是台湾字形的字体,只用来排章题,章题里没有标点(数字怎样处理见竖排中的数字)。

在夹注和参考文献表中,拉丁字母的书名和四位数的年份横倒排,顺着行往下走。紧挨汉字的短数字,比如编号里的1,在字格里直立。

#4 · 朱线之间的章首

script.js · 第47–64行在完整代码中
// In the flow frame x runs down the column and y across the page, right to left, so a
// 'horizontal' rule is a vertical line on the sheet: three of them rule the two columns.
const [TITLE, PITCH] = [15, 1.6 * LEAD]; // pt: the title's size and its column pitch
const rule = (n) => ({ kind: 'rule', id: `rule-${n}`, direction: 'horizontal',
  thickness: pt(n === 1 ? 0.4 : 0.8), color: col('vermilion'),
  placement: { anchor: { to: 'container', edge: 'top-left' },
    offset: { y: pt(LEAD + n * PITCH) }, size: { width: 'fill' } } });
// A line of PITCH in column n (0, 1), its characters centred between two rules.
const title = (id, content, n, family, size, weight) => ({ kind: 'text', id, content,
  fontFamily: family, fontWeight: weight, fontSize: pt(size), lineHeight: PITCH / size,
  color: col('ink'), letterSpacing: pt(size * 0.25), align: 'left',
  placement: { anchor: { to: 'container', edge: 'top-left' },
    offset: { x: pt(2 * BODY), y: pt(LEAD + n * PITCH) } } }); // two characters down
const opener = { enabled: true, minHeight: cols(5), slot: { elements: [
  rule(0), rule(1), rule(2),
  title('number', '{number}', 0, HEI, 12, 700), // 第三章 in the first column, in 黑
  title('title', '{titleText}', 1, KAI, TITLE, 400), // the title in the second, in 楷
] } };

竖排页面上的标题设计按排版流的坐标放置:x沿行往下,y从页面右边缘横向往左,所以'horizontal'的线在纸面上是一条竖线。三条线隔出两行,行距30.4 pt。第一行是黑体粗体的“第三章”,第二行是楷体的章题(通栏与高级设计)。章号来自标题上的startAt=3和模板第{1:一}章,页码来自pageNumbering:trad-chinese-informal,从45起。书眉和页码沿书口一侧的页边竖排,做法与右翻的竖排中文小说相同(竖排文本元素)。

script.js · 第17–22行在完整代码中
const palette = {
  ink: '#22201c', vermilion: '#a8352a', muted: '#6d665d', paper: '#fbf8f1',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.vermilion })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));

完整食谱

沙盒
// ═══ Postext Cookbook · Nº 091 · Vertical Chinese with citations in inline notes ══════
// https://postext.dev/en/cookbook/vertical-book-with-jiazhu-citations
// Code: MIT · Text: original (CC BY 4.0) · Pictures: none
// Fonts: Noto Serif SC, Noto Sans SC, LXGW WenKai TC (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, registerCitationEngine,
  loadVerticalAlternates,
} 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 chapter is Chinese in both editions
const RECIPE = 'vertical-book-with-jiazhu-citations';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: black ink, one vermilion for the opener's rules, the paper of the page
const palette = {
  ink: '#22201c', vermilion: '#a8352a', muted: '#6d665d', paper: '#fbf8f1',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = Object.entries({ ...palette, 'main-color': palette.vermilion })
  .map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } }));
// #endregion
const [SONG, HEI, KAI] = ['Noto Serif SC', 'Noto Sans SC', 'LXGW WenKai TC']; // 宋, 黑, 楷
const [BODY, LEAD] = [10.5, 19]; // pt: 五號 on a column pitch of 1.8 em
const cols = (n) => pt(n * LEAD); // n columns across the page

// #region answer: a note style set as 夾注, two half-size rows inside the column
// The GB/T 7714 note style turns each citation into a note. notes: 'warichu' sets the note
// in the column where the citation stands, in two rows at half the text size, the right
// row read first; a note longer than what is left of the column goes on in the next one.
// The list at the chapter's end comes from :::bibliography{scope=chapter}, numbered in
// the order the works are cited. Latin words turn sideways in the notes and in the list.
registerCitationEngine(createCiteprocEngine({ styles: STYLES, locales: LOCALES }));
const citations = {
  style: 'china-national-standard-gb-t-7714-2015-note',
  notes: 'warichu', // 夾注; 'footnote' sets the same notes at the foot of the page
  bibliography: { fontSize: em(0.9), entrySpacing: pt(0) },
};
const cjk = {
  grid: { enabled: true, charsPerLine: 36, linesPerPage: 15 },
  warichu: { fontSize: em(0.5), color: col('ink') }, // no brackets: the half size sets it off
};
// #endregion

// #region opener: 第三章 and the title in two ruled columns, the text after a blank one
// In the flow frame x runs down the column and y across the page, right to left, so a
// 'horizontal' rule is a vertical line on the sheet: three of them rule the two columns.

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

变化

#给夹注加括号

有些版本给夹注加上与正文同字号的括号。cjk.warichu为所有夹注设置括号,引文的夹注也在内。

-  warichu: { fontSize: em(0.5), color: col('ink') }, // no brackets: the half size sets it off
+  warichu: { fontSize: em(0.5), color: col('ink'), open: '〔', close: '〕' },

#行内只排序号

改用GB/T 7714的顺序编码制并加六角括号,行内只印直立的〔1〕,参考文献表不变。

-  style: 'china-national-standard-gb-t-7714-2015-note',
-  notes: 'warichu', // 夾注; 'footnote' sets the same notes at the foot of the page
+  style: 'china-national-standard-gb-t-7714-2015-numeric',
+  marker: 'corner', // 〔1〕, upright in vertical text

常见问题

易错点

用zh-Hans或zh-Hant标记文档,不要用LANG

食谱的版本是en和es,但中文示例在两个版本里都是中文:`locale: LANG`会把它标记为英文或西班牙文,给其中的拉丁文词断词,把图标注为Figure或Figura,并给PDF标上错误的语言。postext 1.30起,这个标记也是文字成形所用的语言(测量、绘制和嵌入都按它进行),所以标记成英文或西班牙文时,中文字体的数字和与拉丁文共用的标点会换成另一套字形,断行的位置也随之改变。自己写出标记:'zh-Hans'(大陆规范:GB断行规则、开明式标点)或'zh-Hant'(台湾:全角居中标点);香港用'zh-HK'。单写'zh'按简体、大陆规范处理。日文示例写'ja'(见gotcha ja-locale-tag)。 中文断行 →

易错点

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

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

易错点

各地区的标点要用该地区的字体排

标点宽度调整会把每个标点旁的空白移到文档所属地区规定的一侧,而不是字体绘制时的那一侧:在zh-Hans下,开明式的逗号保留字框的左半部分(简体字体把字形画在这里),让出右半部分。繁体字体把,。画在字框中央,所以让出的那一半含有部分字形,逗号就挤到了下一个字上。LXGW WenKai TC是Fontsource上唯一的楷体正文字体,在简体文字中就会这样。大陆的正文、注释和引文用Noto Serif SC或Noto Sans SC排,TC字体留给zh-Hant,简体毛笔字体(Ma Shan Zheng)只用于展示行,因为设计文本不做标点宽度调整。LXGW WenKai TC还会画出大陆和台湾标准都不采用的传承字形:為用爲的爫头,令(在冷、領中)用卩底。要检查页面上用它排的字。 中文标点宽度 →

易错点

右装订的书用showBook显示跨页

在右装订的书中(阿拉伯文、希伯来文或波斯文,竖排中文,或page.binding 'right'),第1页仍是奇数页(recto),但它位于书脊左侧,跨页读作[3 | 2]。showPages把所有书都按左装订排列;book块中的showBook(cjk块中也有同一个函数)读取doc.binding,把跨页左右镜像。capture.hero仍按阅读顺序[偶数页, 奇数页]指定跨页:[2, 3]。 右翻书 →

  • 同一文献第二次被引用时,注释体会改用简略形式,GB/T 7714注释体写成“同1”,意思是“同注1”。夹注没有编号,读者找不到注1。本章每种文献只引一次;需要再次引用的文本,第二处请手写,或者改用第二种变化里的顺序编码制。
  • 样式在中文条目里用西文标点,如宿白. 唐宋時期的雕版印刷[M]. 北京: 文物出版社, 1999.,这是标准规定的写法。在竖排行里这些标点保持西文的样子:横倒排,占不满一格,与正文的“。”“,”不同。
  • 夹注的每一行是正文字号的一半:正文10.5 pt时每行只有5.25 pt,是全页最小的字。正文宜用五号或更大,或者调大cjk.warichu.fontSize;两行夹注总是合占一行的宽度。

致谢

文本
原创文字, CC BY 4.0
字体
Noto Serif SC (SIL OFL 1.1) · Noto Sans SC (SIL OFL 1.1) · LXGW WenKai TC (SIL OFL 1.1)
沙盒PDF