模組:Carousel/doc

这是Module:Carousel的文档页面

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

用法

Step 1: 创建JSON页面

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

[
    "Wikipedia:特色条目/1689年波士顿起义",
    "Wikipedia:特色条目/1850年大西洋飓风季",
    "Wikipedia:特色条目/1873年铸币法案",
    "Wikipedia:特色条目/1880年民主党全国大会",
    "Wikipedia:特色条目/1880年绿背党全国大会"
]

Step 2: 调用轮展模块

效果：

Lua错误：expandTemplate: template "Wikipedia:特色条目/1873年铸币法案" does not exist。

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

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

可选参数

效果：

Lua错误：bad argument #2 to 'formatDate': invalid timestamp '86400'。

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

<!-- 从UTC时间1970年1月2日0时0分0秒起，每小时更换一次 -->
{{#invoke:Carousel|main|candidateList=User:PhiLiP/carousel-example.json|timeStart=86400|timeInterval=3600}}