模板:圖書排版/doc

WikiBot​(留言 | 貢獻)2026年9月19日 (六) 11:46的修訂 (doc 改为参数式用法:新增版式参数表,补「文末必须闭合容器」警示)

該模板用於書籍內容頁(如「傷寒論/章節」頁面)的正文排版,本身不輸出任何可見內容,只通過 TemplateStyles 引入 Template:圖書排版/styles.css。

用法

在頁面頂部引用:

{{图书排版}}

樣式只作用於正文段落與標題:

  • 段落 <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」。

可選版式(模板參數)

下列版式默認不生效;給模板傳第 1 參數即可打開對應容器(英文別名等效),可疊加使用。

參數 英文別名 容器類 效果
行间注 annotation heti--annotation 行距 2.25、首行縮進 2em(夾批、行間標註)
古籍 ancient heti--ancient 標題居中、正文宋體(序跋)
诗词 poetry heti--poetry 居中、不縮進
经文 classic heti--classic 經文版式
楷体 kai heti--kai 楷體字體棧
限宽 line-length heti--line-length 正文限寬 42em 並居中
竖排 vertical heti--vertical 豎排,附橫/直排切換條
双栏 / 三栏 / 四栏 columns-2 / columns-3 / columns-4 heti--columns-2/3/4 多欄

用法(尾部必須閉合,見#注意事項):

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

下方各節仍可用手寫 class 的方式實現同樣效果。

古籍體 heti--ancient

標題居中、正文宋體,適合序跋。

<div class="heti heti--ancient">
(正文)
</div>

刻《仲景全書》序 予曰:「吾聞是書於家大夫之日久矣,而書肆間絕不可得。」君曰:「予誠有之。」

詩詞體 heti--poetry

正文居中、不縮進,適合詩詞、銘文。

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

靜夜思

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

舉頭望明月,低頭思故鄉。

豎排 heti--vertical

自上而下、右起排列,適合牌記、題簽。

<div class="heti heti--vertical">
<p>岁乙未,吾邑疫疠大作。</p>
</div>

歲乙未,吾邑疫癘大作,予家臧獲率六七就枕席。


多欄 heti--columns-2 / heti--columns-3

把正文排成多欄;也可用 heti--columns-16em 到 heti--columns-48em 指定欄寬。

<div class="heti heti--columns-2">
<p>(较长的正文)</p>
</div>

予曰:「吾聞是書於家大夫之日久矣,而書肆間絕不可得。」君曰:「予誠有之。」吾吳和緩明卿沈君南昉在海虞,藉其力而起死亡殆徧,予家得大造於沈君矣。不知沈君操何朮而若斯之神,因詢之。

字體族切換

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

宋體示例:予曰:「吾聞是書於家大夫之日久矣。」

楷體示例:予曰:「吾聞是書於家大夫之日久矣。」

輔助類速查

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 着重號(字下點)
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(着重號:字下點)

<span class="heti-em">成无己</span>

予讀而知其為成無己所解之書也。

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>)。
  • 漏寫尾部不會報錯,但會出事: 容器會一直延續到頁面結束,把後續章節、導航框一併包進版式里。
  • 不傳參數時不要寫尾部,否則會多出一個孤立的 </div>。
  • 本版式僅用於頁面正文內容;本站閱讀器(Gadget BookVerticalReader)是獨立的書籍閱讀器,與本模板的版式開關無關。
  • 版式類名沿用 heti(sivan/heti)的官方命名;本站樣式表以 heti 官方規則為底、按需補齊,全部內容都在 Template:圖書排版/styles.css 內,不加載任何外部 heti 文件。

參見