跳转到内容

模板:图书排版/doc

勤求古训,博采众方
WikiBot​(留言 | 贡献)2026年9月19日 (六) 21:25的版本 (以 heti 官方规则为底补齐版式类,并把版式改为模板参数开关({{图书排版|行间注}} 等))

该模板用于书籍内容页(如“伤寒论/章节”页面)的正文排版,本身不输出任何可见内容,只通过 TemplateStyles 引入 Template:图书排版/styles.css。

用法

在页面顶部引入模板、在正文结束处闭合容器(153 个既有页面均已如此):

{{图书排版}}

(正文……)

{{图书排版/尾}}

头部与尾部必须成对。 头部模板总是输出一个基础容器 <div class="tushu-body">(不传参数时也一样,只是不带版式类),闭合靠 {{图书排版/尾}} 或文末手写 </div>。

  • 漏写尾部不会报错,但容器会自动延伸到页面末尾,把后续章节与页尾导航一并包进版式里。
  • 尾部应放在 ---- 与 <references /> 之上,使参考资料节留在容器内、页尾导航与分类留在容器外。

样式只作用于正文段落与标题:

  • 段落 <p>:字号、行高、字距、首行缩进、两端对齐、断行规则
  • 标题 <h1>–<h6>:字号阶梯、行高、字距、字重

表格、列表、链接、引用、代码块、mark/q/sup/sub 等元素不受影响——导航框、目录表、信息框的版式不会被改动。

默认排版效果

字体分派:中文 / 西文 / 标点

样式用两个 @font-face 配 unicode-range,把不同码位分给不同字体:

字符范围 实际字体 说明
拉丁字母、数字(ASCII) Georgia 等西文字体 保留原有西文观感
汉字、假名等 CJK Noto Serif SC → Source Han Serif SC → Songti SC → SimSun → PingFang SC Regular → … 宋体类优先(思源宋体 → macOS 宋体 → Windows 宋体),苹方、雅黑等黑体仅作最后兜底;可用名称因系统而异 —— Windows 上安装的苹方其注册名为 PingFang SC Regular,写成家族名 PingFang SC 或 macOS 的 PingFangSC-Regular 都不会匹配。(local() 只认字体全名 / PostScript 名)
中文标点(引号、破折号、顿号、书名号等) Noto Serif SC → Source Han Serif SC → Songti SC → SimSun(宋体类) 标点占满一个全角字身,两侧留白正常

为什么标点要单独处理:全角引号 “ ” 的码位是 U+201C / U+201D,Georgia、苹方、微软雅黑都含这两个字形,且做成西文风格的窄引号——此前因此出现“引号与后一个字贴在一起”。现在标点固定交给宋体类全角字体,任何设备上都不会再贴字。

字号阶梯

元素 字号 行高
<h1> 32px 48px
<h2> 28px 36px
<h3> 24px 36px
<h4> 20px 24px
<h5> 18px 24px
<h6> 16px 24px
正文 <p> 17px 继承皮肤(约 1.5–1.6)

段落与对齐

  • 字距 .02em(标题 h1–h3 为 .05em)
  • 首行缩进 2em
  • 两端对齐 text-align: justify
  • 行高:正文不固定,继承皮肤默认(Vector 2022 的 --line-height-content,约 1.5–1.6);标题行高固定为 48/36/36/24/24/24px
  • 非中文段落自动左对齐、取消缩进
  • 长串西文自动断行(overflow-wrap / hyphens)
  • 相邻标题自动收紧间距(h1+h2、h2+h3 … 上边距 12px)

实时效果(本页即为演示):

刻《仲景全书》序

岁乙未,吾邑疫疠大作,予家臧获率六七就枕席。予曰:“吾闻是书于家大夫之日久矣,而书肆间绝不可得。”君曰:“予诚有之。”Latin check: Georgia ABC abc 0123 — “quoted latin”。

可选版式(模板参数)

下列版式默认不生效;给模板传参数即可打开对应容器(英文别名等效)。

参数可以叠加——多写几个,类名会拼在同一个容器上,两种版式同时生效:{{图书排版|古籍|限宽}} → <div class="heti--ancient heti--line-length">。

参数 英文别名 容器类 效果
行间注 annotation heti--annotation 行距 2.25、首行缩进 2em(夹批、行间标注)
古籍 ancient heti--ancient 标题居中、正文宋体(序跋)
诗词 poetry heti--poetry 居中、不缩进
楷体 kai heti--kai 楷体字体栈
限宽 line-length heti--line-length 正文限宽 42em 并居中(2026-09 改回参数触发,不再默认生效)
双栏 columns-2 heti--columns-2 三栏/|四栏 参数已于 2026-09 移除——很少用到;需要时手写 <div class="heti--columns-3"> 或 <div class="heti--columns-4">)

诗词体(参数 诗词)

正文居中、不缩进,适合诗词、铭文。

{{图书排版|诗词}}

(诗句,每句之间空一行)

{{图书排版/尾}}

静夜思

床前明月光,疑是地上霜。

举头望明月,低头思故乡。

分栏诗词(推荐配 <poem>)

Poem 扩展的 <poem> 负责把换行变成 <br>(因此诗句不必每句空行),|双栏 负责分栏并把诗句改为左对齐(|诗词|双栏 组合与参数顺序无关)。诗词名与作者放在分栏容器之外,只有诗块参与分栏。

{{图书排版|诗词|双栏}}

==静夜思==

<span class="heti-meta">唐·李白</span>

<poem>
床前明月光
疑是地上霜
举头望明月
低头思故乡
</poem>

{{图书排版/尾}}

该组合也可手写为 <div class="heti--poetry heti--columns-2">(与 |诗词|双栏 等价,参数顺序无关)。 注意 |双栏 自带 max-width: none(多栏需要宽度),不要再叠加 |限宽。

用法(尾部可选,见#容器与闭合):

{{图书排版|行间注}}
(正文)
{{图书排版/尾}}

下方各节仍可用手写 class 的方式实现同样效果。

古籍体(参数 古籍)

标题居中、正文宋体,适合序跋。

{{图书排版|古籍}}

(正文)

{{图书排版/尾}}

刻《仲景全书》序 予曰:“吾闻是书于家大夫之日久矣,而书肆间绝不可得。”君曰:“予诚有之。”

多栏(参数 双栏)

把正文排成两栏。注意不要叠加 |限宽——多栏自带 max-width: none(分栏需要宽度),限宽 42em 再分两栏每栏只剩约 350px。栏宽类(heti--columns-16em 到 heti--columns-48em)无参数入口,需要时手写。

{{图书排版|双栏}}

(较长的正文)

{{图书排版/尾}}

予曰:“吾闻是书于家大夫之日久矣,而书肆间绝不可得。”君曰:“予诚有之。”吾吴和缓明卿沈君南昉在海虞,藉其力而起死亡殆遍,予家得大造于沈君矣。不知沈君操何术而若斯之神,因询之。

字体族切换

class 中文字体
heti--hei(默认) 黑体(PingFang SC / Microsoft YaHei UI)
heti--song / heti--serif / heti--classic 宋体(Songti SC / SimSun)
heti--kai 楷体(Kaiti SC / STKaiti / KaiTi)

字体族类是这套样式里少数没有模板参数入口的(例外出:|楷体 即 heti--kai),需要时这样手写。注意只写这一个类名,不要写成 class="heti heti--song"——本站没有引入 heti 的 .heti 容器类。

宋体示例:予曰:“吾闻是书于家大夫之日久矣。”

楷体示例:予曰:“吾闻是书于家大夫之日久矣。”

辅助类速查

class 用途
heti-meta 落款、副题(块级、不缩进)
heti-verse 诗句(居中、不缩进)
heti-large / heti-x-large / heti-small / heti-x-small 字号微调 18px / 20px / 14px / 12px
heti-fn 文末注释区
heti-hang 悬挂缩进
heti-em 已移除(2026-09):着重号改由 {{着重}} 提供(类名 em-cjk,样式独立在 Template:着重/styles.css)
heti-list-latin 用在 <ol> 上:A B C…(其内层 ol 为罗马数字,再内层为小写字母)
heti-list-han 暂不可用:汉字编号(cjk-ideographic)不在 TemplateStyles 白名单内,规则已被剔除,仅剩 ol 的数字回退

辅助类演示

下面每个类的效果都是本页实时渲染的。

heti-meta(落款、副题:块级、不缩进)

<div class="heti-meta">万历己亥三月谷旦 海虞清常道人赵开美序</div>
万历己亥三月谷旦 海虞清常道人赵开美序

heti-verse(诗句:居中、不缩进)

<div class="heti-verse">床前明月光,疑是地上霜。</div>
床前明月光,疑是地上霜。

heti-large / heti-x-large / heti-small / heti-x-small(四档字号)

<div class="heti-large">……</div>
heti-large(18px):予曰:“吾闻是书于家大夫之日久矣。”
heti-x-large(20px):予曰:“吾闻是书于家大夫之日久矣。”
heti-small(14px):予曰:“吾闻是书于家大夫之日久矣。”
heti-x-small(12px):予曰:“吾闻是书于家大夫之日久矣。”

heti-fn(文末注释区)

<div class="heti-fn">
<ol>
<li>……</li>
</ol>
</div>
  1. 赵开美,字清常,海虞(今江苏常熟)人,明代刻书家。
  2. 所刻《仲景全书》为《伤寒论》传世重要版本之一。

着重号(已独立为模板) heti-em 类已于 2026-09 从本样式表移除,着重号改由 {{着重}} 提供(类名 em-cjk,样式在 Template:着重/styles.css)——好处是不再依赖本模板。

{{着重|成无己}}

予读而知其为成无己所解之书也。

heti-list-latin(列表编号:拉丁字母)

<ol class="heti-list-latin">
<li>……</li>
</ol>
  1. 太阳病
  2. 阳明病
  3. 少阳病

heti-hang(悬挂:用于标题内落款。此类为 position:absolute 且未设偏移量,单独使用没有视觉变化,需按具体版式配合定位属性)

<h2>刻《仲景全书》序<span class="heti-hang">赵开美</span></h2>


行间注版式 行间注

需要整段留出较大行间空间时(夹批、行间标注等)使用,把段落行距放大到 2.25、首行缩进 2em:

{{图书排版|行间注}}
(正文)
{{图书排版/尾}}

容器由头部模板打开、由尾部模板闭合;尾部不可省(也可在文末直接手写 </div>)。不传参数时本模板不输出任何可见内容。

作用范围与限制

  • 只影响 p、h1–h6 与各版式容器(如行间注的 .heti--annotation);其余标签一律不碰。
  • 段落规则会命中模板输出里的 p(少数模板会生成段落),影响很小但存在。
  • 纸色背景 #f6f4f0 需要选中内容容器自身,TemplateStyles 无法做到,需站点级 CSS。
  • 未引入 heti 的 JavaScript 增强(中西文自动间距、标点挤压):需要改站点 JS,且其挤压方向与“标点要有留白”相反。

容器与闭合

{{图书排版}} 会输出一个基础容器 <div class="tushu-body">,正文限宽(42em + 居中)就挂在这个容器上——容器继承正文字号,因此 em 的基准就是正文,标题与段落因而同宽对齐。(若把 max-width 分别写在 p 与 h1–h6 上,em 会按各元素自身字号计算,h1 的 42em 宽达 1344px,标题反而无法与正文对齐。)

写上 {{图书排版/尾}} 显式闭合(等价于手写 </div>)。153 个既有页面已于 2026-09 全部加上。

尾部应放在 ---- 与 <references /> 之上,这样参考资料节留在容器内,而页尾导航、目录、分类留在容器外。若两者都不存在,则放在 {{daohang-f}} 之上。

若不写尾部,容器会由 HTML5 解析器自动闭合到内容区末尾:页面不会报错,但页末的导航、目录也会被一并限宽。

  • 传了版式参数也一样:容器始终只有一个,参数是它的附加类,例如 class="tushu-body heti--ancient"。
  • 本版式仅用于页面正文内容;本站阅读器(Gadget BookVerticalReader)是独立的书籍阅读器,与本模板的版式开关无关。
  • 版式类名沿用 heti(sivan/heti)的官方命名;本站样式表以 heti 官方规则为底、按需补齐,全部内容都在 Template:图书排版/styles.css 内,不加载任何外部 heti 文件。

参见