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

单位策略：正文与标题用 rem——相对根字号（html { font-size: 100% } = 16px），嵌套时不会叠乘，与 MediaWiki 的 --font-size-medium 做法一致；辅助类字号用 em——相对所在元素的字号，随环境自动缩放（如 .heti-large 为 1.1em、.heti-small 为 0.8em）。

段落与对齐

• 字号 1.25rem（= 20px）
• 字距 .02em（标题 h1–h3 为 .05em）
• 段距 0.4em 上 / 0.5em 下（与 MediaWiki 默认一致）
• 首行缩进 2em
• 两端对齐 text-align: justify
• 行高 2.25；标题行高固定为 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--poetry heti--line-length">。

参数	英文别名	容器类	效果
诗词	poetry	heti--poetry	居中、不缩进
限宽	line-length	heti--line-length	正文限宽 42em 并居中
双栏	columns-2	heti--columns-2	两栏。（需三栏／四栏时可手写 <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--song / heti--serif	宋体（Songti SC / SimSun）

字体族类是这套样式里没有模板参数入口的，需要时这样手写。注意只写这一个类名，不要写成 class="heti heti--song"——本站没有引入 heti 的 .heti 容器类。

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

辅助类速查

class	用途
heti-meta	落款、副题（块级、不缩进）
heti-verse	诗句（居中、不缩进）
heti-large / heti-x-large / heti-small / heti-x-small	字号微调 22px / 25px / 16px / 14px
heti-fn	文末注释区
heti-hang	悬挂缩进
em-cjk	着重号（由 {{着重}} 提供，样式在 Template:着重/styles.css）
heti-list-latin	用在 <ol> 上：A B C…（其内层 ol 为罗马数字，再内层为小写字母）
heti-list-han	暂不可用：汉字编号 cjk-ideographic 不在 TemplateStyles 白名单内

辅助类演示

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

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（22px）：予曰：“吾闻是书于家大夫之日久矣。”

heti-x-large（25px）：予曰：“吾闻是书于家大夫之日久矣。”

heti-small（16px）：予曰：“吾闻是书于家大夫之日久矣。”

heti-x-small（14px）：予曰：“吾闻是书于家大夫之日久矣。”

heti-fn（文末注释区）

<div class="heti-fn">
<ol>
<li>……</li>
</ol>
</div>

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

着重号 着重号由 {{着重}} 提供（类名 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>

作用范围与限制

• 只影响 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 个既有页面均已如此。

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

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

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

参见

• Template:图书排版/styles.css
• Category:书籍内容页面