模組:TodayBirthday/doc

這是一個用於顯示某個主題中在今天以及近期過生日的角色的模塊，其封裝模板為{{TodayBirthday}}。

調用方法

• 建議使用封裝模板{{TodayBirthday}}進行調用。

使用{{#invoke:TodayBirthday|main|数据模块名|角色称呼|最近生日天数|设置当前时间}}即可調用模塊，各參數說明如下：

• 數據模塊名：存放在Module:TodayBirthday/data/下的數據模塊名稱，不需要寫前綴。
• 角色稱呼：輸出語句中對角色的稱呼，可省略，默認為「角色」。
• 最近生日天數：設置顯示最近多少天內過生日的角色，設為0為不顯示，默認為0。
• 設置當前時間：給定計算生日的「當天」時間，測試用，在封裝模板中不提供此參數，默認為今天。

示例

• 調用{{#invoke:TodayBirthday|main|赛马娘|赛马娘|7}}將顯示：

7天內沒有賽馬娘過生日。

• 調用{{#invoke:TodayBirthday|main|赛马娘|赛马娘|7|2021-5-1}}將顯示：

祝無聲鈴鹿、狂怒樂章生日快樂！7天內過生日的賽馬娘有：特別週（5月2日）、駿川手綱（5月2日）、成田白仁（5月3日）、谷野美酒（5月4日）、目白多伯（5月6日）、稻荷一（5月7日）、待兼詩歌劇（5月7日）、森林寶穴（5月7日）、櫻花桂冠（5月8日）。

使用更多數據

模塊通過變量擴展和{{array}}輸出了更多可用的數據，可以用於更多定製功能（以下所有示例均為上面{{#invoke:TodayBirthday|main|赛马娘|赛马娘|7|2021-5-1}}的輸出結果）：

• {{#var:tbirth_today_raw}}（不帶描述信息的今天過生日的角色列表）：無聲鈴鹿、狂怒樂章
• {{#var:tbirth_recent_raw}}（不帶描述信息的最近過生日的角色列表）：特別週（5月2日）、駿川手綱（5月2日）、成田白仁（5月3日）、谷野美酒（5月4日）、目白多伯（5月6日）、稻荷一（5月7日）、待兼詩歌劇（5月7日）、森林寶穴（5月7日）、櫻花桂冠（5月8日）
• {{#var:tbirth_count}}（今天和最近過生日的角色總數）：11
• {{#var:tbirth_count_today}}（今天過生日人數）：2
• {{#var:tbirth_count_recent}}（最近過生日人數）：9

• {{array|get|tbirth_today|1}}（今天過生日角色數組）：無聲鈴鹿
• {{array|get|tbirth_recent|1}}（最近過生日角色數組）：特別週

使用方法

使用以下按鈕創建一個主題的角色數據模塊：

以下為目前已創建的角色數據模塊，請注意不要重複創建（點擊展開）：

• TodayBirthday/data/LoveLive!
• TodayBirthday/data/OMORI
• TodayBirthday/data/賽馬娘
• TodayBirthday/data/黑塔利亞

數據填寫說明

使用以上方式創建新模塊後會有如下代碼：

local p = {}

p.data={
	{
        "",--填写显示名称
        "",--填写内部链接
        1,1--填写生日，形式：月,日
    },
    {--以同样格式添加下一个数据
        "",
        "",
        1,1
    },
}

return p

需要填寫的是使用--注釋的三行（即5-7行），說明如下：

• 在第一行填寫角色顯示名稱，支持html，但建議將第一行的字符串改為用單引號'包裹，或者將雙引號"使用反斜槓\轉義，寫為\"；並且如果這麼做第二行必須要填寫內部鏈接。

• 顯示圖片：受wiki內鏈生成機制限制，圖片不能以[[File:]]的形式插入，請使用<img />語法插入圖片

• 第二行填寫內部鏈接，若與顯示名稱相同則可省略，不需要寫[[和]]。
• 第三行填寫生日，以月,日的形式。注意分隔符為半角逗號,。

填寫示例：

    {
        "特别周",
        "",
        5,2
    },

使用html的填寫示例：

    {
        '<span style="color:#EE6ECB">特别周</span>',
        "特别周",
        5,2
    },

然後在下一行填寫新的角色數據即可。