模板:Random list/doc

此模板基于Module:Random list，用于从一个列表中随机抽取指定数量的项目，以点列（*）的形式展示。

基本用法

{{Random list |count = 要抽取的數量 | 
* 項目一
* 項目二
* 項目三
* 項目四
* ……
}}

参数

• 1：必填。包含所有项目的原始文字清单。默认使用“换行+星号（*）”作为分隔符。
• count：要随机显示的项目数量。如果数量超过总项数，则显示全部。
• 2：自定义项目分隔符（Lua pattern）。默认解析每行以*开头的wiki列表。

示例

随机抽2个不重复项目

{{Random list|count=2|
* 蘋果
* 香蕉
* 鳳梨
* 西瓜
}}

输出结果：

• 凤梨
• 西瓜

创建独立页面

为了方便更新和维护，可以创建独立页面存放原始项目列表。例如，若使用

{{Random list|count=2|{{User:Example/水果}}}}

并在User:Example/水果创建以下内容：

* 蘋果
* 香蕉
* 鳳梨
* 西瓜

输出结果与上述示例完全一致。

自定义分隔符

如果你的列表项目不是用“换行+星号（*）”作为开头，可以使用参数2手动指定分隔符，直接提供一行文字列表。

{{Random list|count=3|香港,東京,倫敦,巴黎.紐約|,}}

输出结果：

• 伦敦
• 香港
• 东京

参见

• Help:随机显示：更多同类模板/模块。
• Module:Random list：底层驱动模块。
• Module:Rand：另一模块，仅选取单一项目，以字符串而非点列输出。