模組: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!系列編輯組成員及其他編輯者討論解決方案。