該模板用於書籍內容頁(如「傷寒論/章節」頁面)的正文排版,本身不輸出任何可見內容,只通過 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 文件。

繁體(zh-Hant)的字體

簡體視圖正文用黑體棧(苹方 SC → 微軟雅黑 → …);繁體視圖由 :lang(zh-hant) 規則改用繁體系字體棧(苹方 TC → 微軟正黑體 → 思源黑體 TC → 明體 → …),與站內 Vector 皮膚一致。兩套棧只在中文段不同:西文、標點(@font-face)與擴展區兜底(SimSun-ExtB/SimSun-ExtG/Jigmo/HanaMin)相同。

參見