模組:Carousel

模块文档[查看] [编辑] [历史] [清除缓存]

页面轮展模块，可用于首页特色条目、优良条目展示。

用法

Step 1: 创建JSON页面

首先，需要创建一个JSON页面，其中记录了要轮展嵌入的页面，以及轮展的顺序。以下是一个例子（User:PhiLiP/carousel-example.json）：

[
    {
        "title": "1689年波士顿起义",
        "displayTimeRanges": [
            [
                20150304123013,
                null
            ]
        ]
    },
    {
    	"title": "孔子鸟属",
    	"displayTimeRanges": [
    		[20060313005324, 20090614110222]
    	]
    },
    {
        "title": "1850年大西洋飓风季",
        "displayTimeRanges": [
            [
                20141030151730,
                null
            ]
        ]
    },
    {
        "title": "1873年铸币法案",
        "displayTimeRanges": [
            [
                20160805143015,
                null
            ]
        ]
    },
    {
        "title": "1880年民主党全国大会",
        "displayTimeRanges": [
            [
                20141213150114,
                null
            ]
        ]
    }
]

Step 2: 调用轮展模块

效果：

在要显示轮展内容的位置，按下述方式调用模块：

{{#invoke:Carousel|main|candidateList=User:PhiLiP/carousel-example.json}}

可选参数

效果：

（当前时间戳为20250526041633，显示第1条）

除了candidateList外，有两个可选参数timeStart和timeInterval。timeStart定义轮展的起始时间（以MediaWiki时间戳规定的UTC时间，默认值19700101000000，即UTC时间1970年1月1日0时0分0秒）；timeInterval定义每轮展示的秒数（默认值86400秒，即1天）。下为示例：

（从UTC时间2025年5月26日0时0分0秒起，每小时更换一次。）

{{#invoke:Carousel|main|candidateList=User:PhiLiP/carousel-example.json|timeStart=20250526000000|timeInterval=3600}}

上述文档嵌入自Module:Carousel/doc。 (编辑 | 历史)
编者可以在本模块的沙盒 (创建 | 镜像)和测试样例 (创建)页面进行实验。
本模块的子页面。

local p = {}
local lang = mw.language.new('zh')

function getCandidateList(args)
	local page = mw.title.new(args.pageName)
	local candidates =
		mw.text.jsonDecode(page:getContent(), mw.text.JSON_TRY_FIXING)

	-- change mw timestamp to unix timestamp
	for _, item in pairs(candidates) do
		for i in pairs(item.displayTimeRanges) do
			item.displayTimeRanges[i][1] =
				lang:formatDate('U', tostring(item.displayTimeRanges[i][1]))
			if item.displayTimeRanges[i][2] ~= null then
				item.displayTimeRanges[i][2] =
					lang:formatDate('U', tostring(item.displayTimeRanges[i][2]))
			end
		end
	end
	return candidates
end

function p.main(frame)
	local candidateList = getCandidateList{pageName = frame.args.candidateList}
	local currentTime = lang:formatDate('U', frame.args.currentTime)
	local timeStart = lang:formatDate(
		"U", frame.args.timeStart or '19700101000000')
	local timeInterval = tonumber(frame.args.timeInterval) or 86400
	--local index0 = math.floor((os.time() - timeStart) / 86400) % #candidateList
	--local currentPage = candidateList[index0 + 1]
	--return mw.getCurrentFrame():expandTemplate { title = currentPage }
end

return p