Module:LoveLive/data/doc

这个模块用于存储Module:LoveLive所需的数据。

数据结构

模块最终返回的数据是一个Lua table，由四个字段组成：charaData，charaMap，groupData，groupMap。

charaData

LoveLive!系列所有主要角色的数据，为一个table。每个角色的数据为一个键值对，其值包含以下字段：

• id：角色的ID，与键值对的键相同，由代码自动生成。通常使用角色英文名小写，但有例外，如学园偶像音乐剧角色均以musical_开头。
• fullName：各语种下角色的全名，包括zhHans（简体中文）、zhHant（繁体中文）、ja（日文）三个字段，每个字段下列举所有可用的表记或翻译（下同，不再赘述），其中zhHans的第一个值应为角色在萌娘百科的条目名。
• givenName：各语种下角色的名，包括zhHans、zhHant、ja和en（英文）。
• yohaneName：Aqours成员特有的字段，表示该角色在《幻日夜羽 -SUNSHINE in the MIRROR-》中所对应角色的名字，包括zhHant、ja和en。参见#幻日夜羽角色的处理。
• abbr：角色名字常用的中文单字简称，可选。
• seiyuu：角色的声优信息，为一个列表，列举曾饰演该角色的所有声优（或演员，下同），每个声优的信息包含以下字段：
  • zhHans：声优的简体中文姓名，同样是列举所有可用的表记或翻译，且第一个值应为声优在萌娘百科的条目名。
  • ja：声优的日文姓名。
  • labels：对于存在多位声优的角色（主要是音乐剧角色），列举一些可用的标签，方便以角色名[标签]的格式指定声优。
• color：角色的主题色，选取方案见Template:LoveLive!角色颜色/doc。
• iconType：角色的头像类型，通常无需填写，详情见下。
• icons：角色的头像文件名列表，用于{{LoveLive!角色头像}}，格式及含义如下：
  • 如果仅有1个值（无需File:前缀，下同），则头像为固定图片。
  • 如果有2个值，则默认显示第一张图片，当鼠标移动到头像上方时变为第二张（参见{{Hover}}）。
  • 如果存在iconType字段，则特殊处理。目前可用的iconType包括：
    • iconType = "hasu"：对于莲之空女学院学园偶像俱乐部角色，角色在不同年级时期的头像不同（在{{LoveLive!角色头像}}中由|grade=参数指定），在这里icons列表的每个值为{ grade = xxx, file = "xxx.png" }的格式，xxx为103、104、105…，且需从前期到后期排列。（此外，莲之空角色的头像显示为方形而非圆形。）
• yohaneIcons：《幻日夜羽 -SUNSHINE in the MIRROR-》角色的头像，参见#幻日夜羽角色的处理。

charaMap

由角色的可用名称到角色ID的映射，由代码根据charaData自动生成。可用名称包括charaData中已列出的角色ID和各种语言的全名、名、简称等，其中大小写字母等价，-与_等价，·、・与无间隔号均等价，同时有一些例外，详见Template:LoveLive!角色表述/doc#角色。

groupData

LoveLive!系列各组合的数据，为一个table。每个组合的数据为一个键值对，其值包含以下字段：

• id：组合的ID，与键值对的键相同，由代码自动生成。
• name：组合的简体中文或英文名称。
• nameJa：组合的日文原名，仅在与name不同时才需要填写。
• link：组合在萌娘百科的条目名，仅在与name不同时才需要填写。
• alternatives：组合的其他可用称呼列表，包括繁体中文名、各语种的简称等，可以与上述字段重复。
• members：组合的成员（及声优）列表，为一个table。
  • 如果成员未曾变动，则只有一个子列表，包含所有成员的角色ID。
  • 如果曾发生过成员（或声优）变动，则列举历史上所有时期的成员组成，每一组成员的索引可以自动编号也可以手动设置，每个成员的值可指定声优。
• color：组合的主题色。

groupMap

由组合的可用名称到组合ID的映射，由代码根据groupData自动生成。可用名称包括id、name、nameJa和alternatives的所有值，其中大小写字母等价。

技术说明

指定角色的声优

在{{LoveLive!角色表述}}等处使用时，可用以下两种格式之一指定显示角色的哪位声优：

1. name[label]，其中name是角色的可用名称（charaMap中的一个键），而label可以是声优的简体中文名、日文名或标签之一。
2. name2，其中2或其他数字代表角色seiyuu列表中的第几个声优。
   • 不过，对于音乐剧角色，为了兼容旧的{{LoveLive!角色表述}}设计，当使用这种格式时，1、2、3、4分别被映射为2022、2023、2024-1、2024-2这四个标签，而非声优列表的第几个。因此事实上目前只有优木雪菜可用setsuna2来指定。
   • 注意：为了实现这种设计，任何角色的任一可用名称都不可以数字结尾。

如果没有指定声优，则默认显示角色的第一位声优。详细代码见Module:LoveLive的getCharaSeiyuu函数。

幻日夜羽角色的处理

在本模块中，《幻日夜羽 -SUNSHINE in the MIRROR-》的角色（除莱拉普斯外，下同）并没有单独列在charaData里、没有单独的角色ID，而是与她们在LoveLive!Sunshine!!中所对应的角色共享同一个角色ID和数据表。

幻日夜羽角色的可用名称为对应LLSS角色的所有可用名称前加上yohane-前缀，详见Template:LoveLive!角色表述/doc#角色。

在获取角色的名字或头像时，对于幻日夜羽角色，分别显示yohaneName或yohaneIcons，而非fullName、givenName或icons。

指定组合的成员组成

与指定角色声优类似，可用name2来指定显示组合的哪一组成员组成，其中2或其他数字代表组合members表的索引值（因此任何组合的任一可用名称都不可以数字结尾）。如果没有指定则默认显示索引值为1的成员组成。详细代码见Module:LoveLive的getGroupMembers函数。

维护指南

添加新的角色和组合

当企划增添新的角色和组合时，分别在charaData和groupData中添加新的键值对，并到Template:LoveLive!角色颜色/doc、Template:LoveLive!角色表述/doc、Template:LoveLive!角色头像/doc等文档中添加相应的行。

务必注意保持各个字段的数据格式，例如如果数据格式应为table，即使只有一个值也需写成table，而不能省去外层的{ }。

角色声优或组合成员变动

当角色声优、组合成员变动时，参照#技术说明在角色的seiyuu或组合的members字段中添加新的值，并视需要修改Module:LoveLive等代码。

角色头像更新

如莲之空角色的头像更新，按照#charaData中iconType = "hasu"处的说明添加新头像。

修正或增补数据

如发现现有数据有误，请修改相应数据。

可以增补角色、声优、组合各类名称的其他可用值以及多声优角色的声优标签等内容。

现在您对可用名称的修改会自动反映到Template:LoveLive!角色表述/doc#列表中，无须手动维护。

复杂需求

如有更复杂需求，或后续角色发生重名等问题，请联络C8H17OH[更多]讨论页贡献上传历史封禁及历史被删贡献移动日志巡查日志用户权限、萌娘百科LoveLive!系列编辑组成员及其他编辑者讨论解决方案。