模板:圖書排版/doc
該模板用於書籍內容頁(如「傷寒論/章節」頁面)的正文排版,本身不輸出任何可見內容,只通過 TemplateStyles 引入 Template:圖書排版/styles.css。
用法
在頁面頂部引入模板、在正文結束處閉合容器(153 個既有頁面均已如此):
{{图书排版}}
(正文……)
{{图书排版/尾}}
頭部與尾部必須成對。 頭部模板總是輸出一個基礎容器 <div class="tushu-body">(不傳參數時也一樣,只是不帶版式類),閉合靠 {{图书排版/尾}} 或文末手寫 </div>。
- 漏寫尾部不會報錯,但容器會自動延伸到頁面末尾,把後續章節與頁尾導航一併包進版式里。
- 尾部應放在
----與<references />之上,使參考資料節留在容器內、頁尾導航與分類留在容器外。
樣式只作用於正文段落與標題:
- 段落
<p>:字號、行高、首行縮進、兩端對齊、斷行規則 - 標題
<h1>–<h6>:字號階梯、行高、字重
表格、列表、鏈接、引用、代碼塊、mark/q/sup/sub 等元素不受影響——導航框、目錄表、信息框的版式不會被改動。
默認排版效果
字體分派:中文 / 西文 / 標點
樣式用一個 @font-face 配 unicode-range,把標點碼位單獨交給宋體字:
| 字符範圍 | 實際字體 | 說明 |
|---|---|---|
| 拉丁字母、數字(ASCII) | Verdana / Arial(黑體棧的西文) | 保留原有西文觀感 |
| 漢字、假名等 CJK | PingFang SC / Microsoft YaHei(黑體棧) → Hiragino Sans GB → SimSun → SimSun-ExtB/G → Jigmo → HanaMin | 黑體優先,屏幕閱讀舒適;生僻字自動往後掉到擴展區字體。繁體視圖由 :lang(zh-hant) 換成繁體系(苹方 TC / 微軟正黑體)
|
中文標點(,。、:;!?()“”《》「」——……) |
local("SimSun") → local("宋体") → Songti SC → STSong → Noto Serif SC |
unicode-range: U+00B7, U+2000-206F, U+3000-303F, U+FF01-FF1F;占滿一個全角字身,兩側留白正常
|
為什麼標點要單獨處理:全角引號 “ ” 的碼位是 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
|
單位策略:正文與標題用 rem——相對根字號(html { font-size: 100% } = 16px),嵌套時不會疊乘,與 MediaWiki 的 --font-size-medium 做法一致;輔助類字號用 em——相對所在元素的字號,隨環境自動縮放。
段落與對齊
- 字號
1.25rem(= 20px) - 段距:不自行聲明,用站點默認(
.mw-body p為0.5em上 /1em下) - 首行縮進
2em - 兩端對齊
text-align: justify - 行高
2;標題行高1.4 - 非中文段落自動左對齊、取消縮進
- 長串西文自動斷行(
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 |
兩欄(欄目數固定為 2) |
詩詞體(參數 诗词)
正文居中、不縮進,適合詩詞、銘文。
{{图书排版|诗词}}
(诗句,每句之间空一行)
{{图书排版/尾}}
靜夜思
床前明月光,疑是地上霜。
舉頭望明月,低頭思故鄉。
分欄詩詞(推薦配 <poem>)
Poem 擴展的 <poem> 負責把換行變成 <br>(因此詩句不必每句空行),|双栏 負責分欄並把詩句改為左對齊(|诗词|双栏 組合與參數順序無關)。詩詞名與作者放在分欄容器之外,只有詩塊參與分欄。
{{图书排版|诗词|双栏}}
==静夜思==
——唐·李白
<poem>
床前明月光
疑是地上霜
举头望明月
低头思故乡
</poem>
{{图书排版/尾}}
該組合也可手寫為 <div class="heti--poetry heti--columns-2">(與 |诗词|双栏 等價,參數順序無關)。
注意 |双栏 自帶 max-width: none(多欄需要寬度),不要再疊加 |限宽。
用法(尾部可選,見#容器與閉合):
{{图书排版|诗词}}
(正文)
{{图书排版/尾}}
下方各節仍可用手寫 class 的方式實現同樣效果。
多欄(參數 双栏)
把正文排成兩欄。注意不要疊加 |限宽——多欄自帶 max-width: none(分欄需要寬度),限寬 42em 再分兩欄每欄只剩約 350px。
{{图书排版|双栏}}
(较长的正文)
{{图书排版/尾}}
予曰:「吾聞是書於家大夫之日久矣,而書肆間絕不可得。」君曰:「予誠有之。」吾吳和緩明卿沈君南昉在海虞,藉其力而起死亡殆徧,予家得大造於沈君矣。不知沈君操何朮而若斯之神,因詢之。
字體族切換
| class | 中文字體 |
|---|---|
heti--song / heti--serif |
宋體(Songti SC / SimSun) |
字體族類是這套樣式里沒有模板參數入口的,需要時這樣手寫。注意只寫這一個類名,不要寫成 class="heti heti--song"——本站沒有引入 heti 的 .heti 容器類。
宋體示例:予曰:「吾聞是書於家大夫之日久矣。」
作用範圍與限制
- 只影響
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)相同。