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

删除的内容 添加的内容
移除注音(HTML ruby)样式,行间注改为 图书排版 参数开关
doc 改为参数式用法:新增版式参数表,补「文末必须闭合容器」警示
第65行:
岁乙未,吾邑疫疠大作,予家臧获率六七就枕席。予曰:“吾闻是书于家大夫之日久矣,而书肆间绝不可得。”君曰:“予诚有之。”Latin check: Georgia ABC abc 0123 — “quoted latin”。
 
== 可选版式(需加 class)模板参数) ==
下列版式默认不生效,需要把内容包进;给模板传第 1 参数即可打开对应 class 的容器里;(英文别名等效),可叠加使用。
 
{| class="wikitable"
! 参数 !! 英文别名 !! 容器类 !! 效果
|-
| <code>行间注</code> || <code>annotation</code> || <code>heti--annotation</code> || 行距 2.25、首行缩进 2em(夹批、行间标注)
|-
| <code>古籍</code> || <code>ancient</code> || <code>heti--ancient</code> || 标题居中、正文宋体(序跋)
|-
| <code>诗词</code> || <code>poetry</code> || <code>heti--poetry</code> || 居中、不缩进
|-
| <code>经文</code> || <code>classic</code> || <code>heti--classic</code> || 经文版式
|-
| <code>楷体</code> || <code>kai</code> || <code>heti--kai</code> || 楷体字体栈
|-
| <code>限宽</code> || <code>line-length</code> || <code>heti--line-length</code> || 正文限宽 42em 并居中
|-
| <code>竖排</code> || <code>vertical</code> || <code>heti--vertical</code> || 竖排,附横/直排切换条
|-
| <code>双栏</code> / <code>三栏</code> / <code>四栏</code> || <code>columns-2</code> / <code>columns-3</code> / <code>columns-4</code> || <code>heti--columns-2/3/4</code> || 多栏
|}
 
用法(尾部必须闭合,见[[#注意事项]]):
<pre>
<nowiki>{{图书排版|行间注}}</nowiki>
(正文)
<nowiki>{{图书排版/尾}}</nowiki>
</pre>
下方各节仍可用手写 class 的方式实现同样效果。
 
=== 古籍体 <code>heti--ancient</code> ===
第218行 ⟶ 第246行:
 
 
=== 行间注版式( <code><nowiki>{{图书排版|行间注}}</nowiki></code>) ===
需要整段留出较大行间空间时(夹批、行间标注等),给模板传第 1 参数)使用,把段落行距放大到 <code>2.25</code>、首行间注缩进 <code>2em</code>:
<pre>
<nowiki>{{图书排版|行间注}}</nowiki>
(正文)
<nowiki>{{图书排版/尾}}</nowiki>
&lt;/div&gt;
</pre>
它把段落行距放大到 <code>2.25</code>、首行缩进 <code>2em</code>;容器由头部模板打开,需、由尾部模板闭合;'''尾部不可省'''(也可在页面文末尾直接手动写 <code>&lt;/div&gt;</code> 闭合)。不传参数时本模板不输出任何可见内容。
== 作用范围与限制 ==
* 只影响 <code>p</code>、<code>h1</code>–<code>h6</code>、 与各版式容器(如行间注容器的 <code>.tushuheti--annotation</code>;);其余标签一律不碰。
* 段落规则会命中'''模板输出里的 p'''(少数模板会生成段落),影响很小但存在。
* 纸色背景 <code>#f6f4f0</code> 需要选中内容容器自身,TemplateStyles 无法做到,需站点级 CSS。
第233行 ⟶ 第261行:
 
== 注意事项 ==
* '''头部与尾部必须成对。''' 头部 <code><nowiki>{{图书排版|参数}}</nowiki></code> 只负责打开容器,闭合要靠尾部 <code><nowiki>{{图书排版/尾}}</nowiki></code>(或在文末手写 <code>&lt;/div&gt;</code>)。
* 本版式仅用于'''页面正文内容''';本站阅读器(Gadget BookVerticalReader)是独立的书籍阅读器,与本模板的行间注功能无关。▼
* '''漏写尾部不会报错,但会出事:''' 容器会一直延续到页面结束,把后续章节、导航框一并包进版式里。
* 可选版式的 class 名沿用 <code>heti--*</code> 命名(来自中文排版方案 heti),但本站'''不依赖任何 heti 文件''',全部样式都在 [[Template:图书排版/styles.css]] 内。
* '''不传参数时不要写尾部''',否则会多出一个孤立的 <code>&lt;/div&gt;</code>。
▲* 本版式仅用于'''页面正文内容''';本站阅读器(Gadget BookVerticalReader)是独立的书籍阅读器,与本模板的行间注功能版式开关无关。
* 版式类名沿用 heti([https://github.com/sivan/heti sivan/heti])的官方命名;本站样式表以 heti 官方规则为底、按需补齐,全部内容都在 [[Template:图书排版/styles.css]] 内,'''不加载任何外部 heti 文件'''。
 
== 参见 ==