Template: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：另一模組，僅選取單一項目，以字符串而非點列輸出。