Template:图书排版/doc:修订间差异

删除的内容 添加的内容
doc 改为参数式用法:新增版式参数表,补「文末必须闭合容器」警示
doc 改为参数式用法:新增版式参数表,补「文末必须闭合容器」警示
第90行:
|}
 
用法(尾部必须闭合可选,见[[#注意事项容器与闭合]]):
<pre>
<nowiki>{{图书排版|行间注}}</nowiki>
第262行:
* 未引入 heti 的 JavaScript 增强(中西文自动间距、标点挤压):需要改站点 JS,且其挤压方向与「标点要有留白」相反。
 
== 注意事项容器与闭合 ==
<code><nowiki>{{图书排版}}</nowiki></code> 会输出一个基础容器 <code>&lt;div class="tushu-body"&gt;</code>,正文限宽(42em + 居中)就挂在这个容器上——容器继承正文字号,因此 <code>em</code> 的基准就是正文,标题与段落因而同宽对齐。(若把 <code>max-width</code> 分别写在 <code>p</code> 与 <code>h1</code>–<code>h6</code> 上,<code>em</code> 会按各元素自身字号计算,h1 的 42em 宽达 1344px,标题反而无法与正文对齐。)
* '''头部与尾部必须成对。''' 头部 <code><nowiki>{{图书排版|参数}}</nowiki></code> 只负责打开容器,闭合要靠尾部 <code><nowiki>{{图书排版/尾}}</nowiki></code>(或在文末手写 <code>&lt;/div&gt;</code>)。
 
* '''漏写尾部不会报错,但会出事:''' 容器会一直延续到页面结束,把后续章节、导航框一并包进版式里。
'''不写闭合标签也可以。''' 容器由 HTML5 解析器自动闭合到内容区末尾,因此页末的导航、表格也会落在容器内并一并限宽(多数情况下反而更整齐)。这正是 2026-09 起 153 个既有页面无需任何改动就能生效的原因。
* '''不传参数时不要写尾部''',否则会多出一个孤立的 <code>&lt;/div&gt;</code>。
* 若只想让容器包住正文、把页末导航排除在外,在正文结束时写 <code><nowiki>{{图书排版/尾}}</nowiki></code>(等价于手写 <code>&lt;/div&gt;</code>)。
* 传了版式参数也一样:容器始终只有一个,参数是它的附加类,例如 <code>class="tushu-body heti--ancient"</code>。
* 本版式仅用于'''页面正文内容''';本站阅读器(Gadget BookVerticalReader)是独立的书籍阅读器,与本模板的版式开关无关。
* 版式类名沿用 heti([https://github.com/sivan/heti sivan/heti])的官方命名;本站样式表以 heti 官方规则为底、按需补齐,全部内容都在 [[Template:图书排版/styles.css]] 内,'''不加载任何外部 heti 文件'''。