跳转到内容

模块:图书排版

勤求古训,博采众方
WikiBot​(留言 | 贡献)2026年9月21日 (一) 17:56的版本 (以 heti 官方规则为底补齐版式类,并把版式改为模板参数开关({{图书排版|行间注}} 等))
--[[
Module:图书排版 —— 解析 {{图书排版}} 的位置参数,拼出版式容器。

设计见 content/tushu/DESIGN.md。要点:

  1) 收集全部位置参数,因此支持叠加:{{图书排版|诗词|双栏}}
     → <div class="tushu-body heti--poetry heti--columns-2">。
     重复的类名会被去重(如 {{图书排版|诗词|双栏|诗词}} 不会产出重复类)。
  2) 容器类一律沿用 heti 官方类名(.heti--*),不另造前缀。
     分栏诗词用 |诗词|双栏 组合即可(其诗句左对齐由样式表按类集合匹配,与参数顺序无关)。
  3) **总是输出基础容器 tushu-body**(即使一个参数都没传)。原因:153 个页面已于
     2026-09 加上 {{图书排版/尾}},若模板不输出容器,那些 </div> 会变成孤立的
     闭合标签而破坏页面结构。容器本身不带样式——限宽由 |限宽 参数触发
     (见样式表里的 .heti--line-length)。
  4) 古籍 / 经文 / 黑体 / 竖排 / 诗栏 / 楷体 六项版式已于 2026-09 彻底移除:
     模板不再有这些参数入口,样式表内的对应类(.heti--ancient / --classic /
     --sans / --hei / --vertical / --kai)与字体栈也一并删除,页面手写这些
     class 亦不再生效。分栏诗词改用 |诗词|双栏 组合。详见 DESIGN.md §3。
]]

local p = {}

-- 参数 → 容器类(中文为主,英文为别名)。值可以含多个类名,用空格分隔。
local CLASS = {
	['诗词'] = 'heti--poetry', ['poetry'] = 'heti--poetry',
	['限宽'] = 'heti--line-length', ['line-length'] = 'heti--line-length',
	['双栏'] = 'heti--columns-2', ['columns-2'] = 'heti--columns-2',
}

function p.main(frame)
	local args = frame:getParent().args
	local seen, ordered = {}, {}

	for _, v in ipairs(args) do
		local key = mw.text.trim(v)
		local val = CLASS[key]
		if key ~= '' and val then
			-- 展开为单个类名后按名去重,避免重复写法产出重复类
			for cls in val:gmatch('%S+') do
				if not seen[cls] then
					seen[cls] = true
					ordered[#ordered + 1] = cls
				end
			end
		end
	end

	-- 基础容器始终在前
	local cls = { 'tushu-body' }
	for _, c in ipairs(ordered) do
		cls[#cls + 1] = c
	end

	return string.format('<div class="%s">', table.concat(cls, ' '))
end

return p