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