模組:TodayBirthday/doc

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

調用方法

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

使用<syntaxhighlight inline lang="wikitext"></syntaxhighlight>即可調用模塊，各參數說明如下：

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

示例

• 調用<syntaxhighlight inline lang="wikitext">7天內過生日的賽馬娘有：安心澤刺刺美（11月11日）。</syntaxhighlight>將顯示：

7天內過生日的賽馬娘有：安心澤刺刺美（11月11日）。

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

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

• 調用<syntaxhighlight inline lang="wikitext">1</syntaxhighlight>將顯示：1
• 調用<syntaxhighlight inline lang="wikitext">0</syntaxhighlight>將顯示：0
• 調用<syntaxhighlight inline lang="wikitext">11</syntaxhighlight>將顯示：11
• 調用<syntaxhighlight inline lang="wikitext">2</syntaxhighlight>將顯示：2

使用方法

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

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

• TodayBirthday/data/D4DJ
• TodayBirthday/data/LoveLive!
• TodayBirthday/data/OMORI
• TodayBirthday/data/少女歌劇
• TodayBirthday/data/賽馬娘
• TodayBirthday/data/黑塔利亞

數據填寫說明

使用以上方式創建新模塊後會有如下代碼： <syntaxhighlight lang="lua"> local p = {}

p.data={

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

}

return p </syntaxhighlight>

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

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

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

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

填寫示例： <syntaxhighlight lang="lua">

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

</syntaxhighlight>

使用html的填寫示例： <syntaxhighlight lang="lua">

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

</syntaxhighlight>

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