模組:Carousel/doc
这是Module: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: 调用轮展模块 编辑
效果:
1689年波士顿起义是一场发生在1689年4月18日的起义,旨在反对新英格兰自治领总督埃德蒙·安德罗斯爵士的统治。在自治领民兵和波士顿市民的精心组织下,“暴民”在城内逮捕自治领官员。被清教徒认为支持自治领政府统治的英国圣公会教徒也遭拘捕。不过这次起义期间双边都没有出现人员伤亡。前马萨诸塞湾殖民地的领导人重新取得政府控制权。之前被自治领政府撤职的其他殖民地政府官员重新掌握了权力。1686年获命成为自治领总督的安德罗斯上任后无视地方代表权、对镇民大会设限、积极推行圣公会、强制执行航海法案,还否认马萨诸塞殖民地已有土地所有权的合法性,种种极其不得人心的行径和英国发生的光荣革命共同影响,导致殖民地清教徒决定揭竿而起,推翻他的统治。
在要显示轮展内容的位置,按下述方式调用模块:
{{#invoke:Carousel|main|candidateList=User:PhiLiP/carousel-example.json}}
可选参数 编辑
效果:
(当前时间戳为20240430134845,显示第2条)
1850年大西洋飓风季是美国国家飓风中心建立的大西洋飓风数据库中未予收录的最近一个大西洋飓风季。虽然这年的气象有欠完整,但仍然有三场热带气旋对陆地构成显著影响,每场都造成一定程度的破坏。其中第一个系统于7月18日吹袭北卡罗莱纳州,造成严重破坏后又给大西洋地区带去高涨的海潮和狂风暴雨。8月22日,古巴哈瓦那受到一场强烈飓风的冲击,摧毁果林的同时还扰乱了航运,接下来又在佛罗里达州西北狭长地带登陆并带去了高涨的风暴潮。海上有一艘引水船因海况恶劣导致与大船相撞并沉没。9月7到8日,纽约州到鳕鱼角受到一场飓风的冲击,产生阵风和可观降水,造成许多船只遇险。
除了candidateList
外,有两个可选参数timeStart
和timeInterval
。timeStart
定义轮展的起始时间(以MediaWiki时间戳规定的UTC时间,默认值19700101000000,即UTC时间1970年1月1日0时0分0秒);timeInterval
定义每轮展示的秒数(默认值86400秒,即1天)。下为示例:
(从UTC时间2024年4月30日0时0分0秒起,每小时更换一次。)
{{#invoke:Carousel|main|candidateList=User:PhiLiP/carousel-example.json|timeStart=20240430000000|timeInterval=3600}}