Module: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
    },

然后在下一行填写新的角色数据即可。