Template:图书排版/doc

该模板用于书籍内容页（如「伤寒论/章节」页面）的正文排版，本身不输出任何可见内容，只通过 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>`	`2.25rem`（36px）	`1.4`
`<h2>`	`1.875rem`（30px）	`1.4`
`<h3>`	`1.625rem`（26px）	`1.4`
`<h4>`	`1.5rem`（24px）	`1.4`
`<h5>`	`1.375rem`（22px）	`1.4`
`<h6>`	`1.25rem`（20px）	`1.4`
正文 `<p>`	`1.25rem`（20px）	`2.25`

单位策略（2026-09 起）：正文与标题用 rem——相对根字号（html { font-size: 100% } = 16px），嵌套时不会叠乘，与 MediaWiki 的 --font-size-medium 做法一致；辅助类字号用 em——相对所在元素的字号，随环境自动缩放（如 .heti-large 为 1.1em、.heti-small 为 0.8em）。此前这些值都是固定 px（正文 17px、标题 32/28/24/20/18/16px），不随字号或视口缩放，且正文放大后会与标题失衡。

段落与对齐

字号 1.25rem（= 20px；2026-09 起由固定 17px 放大并改用相对单位）
字距 .02em（标题 h1–h3 为 .05em）
段距 0.4em 上 / 0.5em 下（2026-09 起：改为与 MediaWiki 默认一致；此前为 heti 的 12px/24px，段间距约为站点默认的 2.35 倍）
首行缩进 2em
两端对齐 text-align: justify
行高 2.25（2026-09 起为默认——此前正文行高不固定、继承皮肤的值；原「行间注」参数的行距即此值）；标题行高固定为 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">。

参数	英文别名	容器类	效果
`古籍`	`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>

赵开美，字清常，海虞（今江苏常熟）人，明代刻书家。
所刻《仲景全书》为《伤寒论》传世重要版本之一。

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

{{着重|成无己}}

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

heti-list-latin（列表编号：拉丁字母）

<ol class="heti-list-latin">
<li>……</li>
</ol>

太阳病
阳明病
少阳病

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

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

行间注（已并入默认行距）

|行间注 参数已于 2026-09 移除——它原有的行距 2.25 已提为全站默认行距（见「段落与对齐」一节），因此不再需要单独开关。首行缩进 2em、段距 12px/24px 本来也就是默认值。需要真正的「行间夹注」时，可在默认行距的基础上自行放置注文，例如用 heti-small（14px）排小字。

作用范围与限制

只影响 p、h1–h6 与各版式容器；其余标签一律不碰。
段落规则会命中模板输出里的 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 文件。

参见