模块:舰娘图鉴/doc

这个模块用于辅助模板:舰娘图鉴解析页面参数。
目前只用来处理台词方面的参数、潜艇狩猎范围。

舰娘台词

本模块会根据调用参数生成舰娘台词表格。

模块解析调用模板:舰娘图鉴的参数和模板页面调用本模块的参数，
将这些参数解析整理后传递给模块:舰娘台词，
最后由模块:舰娘台词生成舰娘台词表格。

模板中{{#invoke:舰娘图鉴}}的参数会覆盖 {{舰娘图鉴}}的参数。
之所以解析两层参数，是为了模板中对参数进行加工处理。
例如模板对特殊触摸台词参数使用模板:黑幕遮罩。

参数解析机制

表ShipWordsParameters中定义了模块要检查的参数的名字。

例如

ShipWordsParameters = {
	login = {'登录台词', '登陆台词'};
}

则模块会依次查找以下参数是否被赋值：

{{ 舰娘图鉴
| login = 
| 登录台词 =
| 登陆台词 =
}}

若参数登录台词被赋值，则会继续查找以下参数：

{{ 舰娘图鉴
| 登录台词_jp = 
| 登录台词_mediaFile = 
| 登录台词_jp_mediaFile = 
| 登录台词_2 =
| 登录台词_2_jp =
| 登录台词_2_mediaFile = 
| 登录台词_2_jp_mediaFile =
| 登录台词_3 =
| ....
}}

• XX_jp是台词的日文。
• XX_mediaFile是台词的语音文件。
• 若同一句台词对应日文中文两个语音，则用XX_jp_mediaFile设置日文语音。
• 若有多句台词，则用XX_2顺延。
• 目前最大到XX_15。

也可以为XX_mediaFile参数直接提供URL。

媒体文件默认值

若参数登陆台词非空，则会默认

{{ 舰娘图鉴
| 登录台词_mediaFile = {{{名称}}}login.mp3
}}

其中{{{名称}}}是舰娘名字，由参数名称确定。

表ShipWordsParameters中可以定义默认媒体文件默认值。
例如：

ShipWordsParameters = {
	unlock = {'获取台词', '获得台词', mediaFile = '%sget.mp3'};
}

则当页面独角兽有unlock台词时，默认媒体文件名为独角兽get.mp3。

只有首个台词会应用默认媒体文件名。XX_2、XX_3等需要手动设置媒体文件名。

主界面台词和彩蛋台词情况特殊。

空值

这里的空值是指调用模板或模块时为参数提供了空白字符串。
例如：

{{ 舰娘图鉴
| 登录台词 =
| 登陆台词 =
}}

这里登录台词和登陆台词传入的都是空白值。

ShipWordsParameters = {
	login = {'登录台词', '登陆台词'};
}

目前的函数实现是：
当遇到登录台词参数时，
函数会停止检查后面的参数登陆台词。
又因为登录台词为空值，
函数不会继续检查XX_jpXX_mediaFileXX_2，
也不会为XX_mediaFile设置默认值。

因此生成的表格中，会出现一行登录台词的空白行。

主界面台词情况特殊。

主界面台词与彩蛋台词

主界面台词（main）除了会按照以上规则处理外：

• 还会检查主界面N台词。
• N为1~15。可以间断。
• 主界面N台词非空时，会覆盖主界面台词_N设定的值。
• 主界面N台词非空时，会检查主界面N台词_jp主界面N台词_mediaFile等。
• 默认媒体文件名为{{{名称}}}main_N.mp3

彩蛋台词（couple_encourage ）除了会按照以上规则处理外：

• 还会检查彩蛋N台词。
• N为1~15。不可间断。
• 彩蛋N台词非空时，会覆盖彩蛋台词_N设定的值。
• 彩蛋N台词非空时，会检查彩蛋N台词_jp彩蛋N台词_mediaFile等。
• 默认媒体文件名为{{{名称}}}linkN.mp3

潜艇范围

用于显示潜艇狩猎范围，沿用了模板:狩猎范围的参数格式。

参数列表

#1		表格的类名（submarineRangeXXX）可省略。
T		表格标题。可省略。
A		第1行。可省略。
B...G	第2~7行。可省略。

示例

{{#invoke:舰娘图鉴|生成潜艇范围表格
|U-81Lv1
|A=
|B=3、4、5
|C=2-3-4-5-6
|D=2 3 4 5 6
|E=3，4，5
|F=3、4、5
|G=}}

预览

另见模板:狩猎范围。