模板:曲目信息/doc

使用曲目信息模板可以在單曲頁面中生成包含一首曲目的各種信息的表格。

同時，曲目信息模板還會根據獲取的數據自動為單曲頁面生成分類。
關於生成的分類類型，目前可自動生成的分類包括使用背景、各難度對應等級、所屬第一曲包(指移動版曲包，若NS版中曲目收錄於另一曲包則需手動填寫分類)、側、具有第四難度差分等等(可參考任意單曲頁面底端的分類一覽)。

在用戶頁面中使用本模板時，應避免生成分類，請參見參數類型中配置組的nocat參數。

用法

全部參數

曲目信息可以通過讀取填入的參數或者讀取Songlist.json來獲取內容(優先讀取參數)。
其中部分參數若未填入則可自動讀取，部分參數若未填入則默認留空；部分參數必須同時填入才可生效，部分參數若同時填入將會相互衝突。

若欲了解曲目信息模板各參數的詳細用途與填寫格式，請參考參數類型。

曲目信息模板中包含共計68個參數，可使用的全部參數如下：

曲目信息模板可用參數一覽

{{曲目信息 <!--1.基本信息组--> |id= |曲名= |第二曲名= |侧= |曲包MO= |曲包NS= |类别= |时长= |BPM= <!--2.图片组--> |图片= |Beyond曲绘= |第二曲绘图片= |Past曲绘= |Present曲绘= |Future曲绘= |第一曲绘说明= |第二曲绘说明= |画师= |Beyond画师= <!--3.背景组--> |背景= |Past背景= |Present背景= |Future背景= |Beyond背景= |Eternal背景= <!--4.更新时间组--> |更新版本= |更新时间= |Beyond更新版本= |Beyond更新时间= |Eternal更新版本= |Eternal更新时间= |更新版本NS= |更新时间NS= |Beyond更新版本NS= |Beyond更新时间NS= <!--5.谱面信息组--> |Past等级= |Present等级= |Future等级= |Beyond等级= |Eternal等级= |PastNote= |PresentNote= |FutureNote= |BeyondNote= |EternalNote= |note编写= |PastNote编写= |PresentNote编写= |FutureNote编写= |BeyondNote编写= |EternalNote编写= <!--6.谱面信息NS组--> |Past等级NS= |Present等级NS= |Future等级NS= |Beyond等级NS= |PastNoteNS= |PresentNoteNS= |FutureNoteNS= |BeyondNoteNS= |note编写NS= |PastNote编写NS= |PresentNote编写NS= |FutureNote编写NS= |BeyondNote编写NS= <!--7.配置组--> |图片显示控制= |nocat= |unset= }}

簡略語法

一般情況下，建議在新曲目更新時使用如下簡略語法。
同時這也是大部分曲目的單曲頁面可使用的最簡略形式，再加以省略就會出現空的內容，因為部分內容無法從Songlist讀取。

簡略語法
{{曲目信息 |PastNote= |PresentNote= |FutureNote= }}

參數類型

填寫格式一列的「%內容%」表示一類數據的名稱。
以下參數中，除兩種曲名和背景組外的所有參數中，空格與下劃線相互等效。
考慮到部分瀏覽器中的轉義問題，推薦使用下劃線。

參數組	參數名稱	填寫內容	是否自動讀取內容	填寫格式
基本信息組	id	曲目ID 模板無法正確通過曲名獲取ID時需手動填寫（如II）	否 選填項	曲目ID
	曲名	曲目名稱 若曲名首字符為小寫英文字母，則需手動填寫	是 可通過{{PAGENAME}}獲取	曲目標題 在曲名處填入Can I Friend You on Bassbook? Lol 在第二曲名處填入ベースラインやってる？ｗ
	第二曲名	一般為日文曲名 直接輸入即可，無需考慮不同語言環境下的顯示問題	否
	側	曲目所屬的側 0指光芒側，1指紛爭側，2指消色側	是	數字0、1或2
	曲師/編曲	曲目曲師，兩種寫法均可被識別 優先自動獲取	是，通過Template:ComplexArtistsList.json	[[曲师列表#%曲师标准名%|%曲师名义%]]或{{Link|曲师|%曲师标准名%}} 如[[曲师列表#lapix_(HiTECH NINJA)|HiTECH NINJA]]或{{Link|曲师|lapix (HiTECH NINJA)}} (推薦使用前一種寫法)
	曲包MO	曲目在移動版中所屬的曲包 優先自動獲取	是，通過packlist轉換為曲包名	[[%曲包名%]] 如[[Lasting Eden]]
	曲包NS	曲目在NS版中所屬的曲包 優先自動獲取
	類別	曲目所屬的類別，僅適用於Memory Archive曲包曲目	是	類別名，如綜合
	時長	曲目音頻的長度 優先自動獲取	是，通過Template:Song Length.json獲取	xx:xx 可參考dropdead (為了取得各條目間觀感的統一，請使用半角冒號)
	BPM	曲目的BPM	是	xxx 可以是一個區間，甚至可以帶文本標記內容 可參考dropdead
圖片組	圖片	默認的曲繪圖片	是	Songs_%songid%(_可能是byd或特殊後綴).jpg 如Songs_ifi.jpg
	Beyond曲繪	Beyond難度下顯示的曲繪圖片
	第二曲繪圖片	非難度上不同曲繪時填寫	否
	Past曲繪	對於普通難度有分曲繪的曲目填寫 這三個參數必須同時填寫才可生效
	Present曲繪
	Future曲繪
	第一曲繪說明	僅填寫圖片與第二曲繪時可用 決定切換至第一曲繪的按鈕的顯示字樣	否	文字內容 可參考A Wandering Melody of Love
	第二曲繪說明	僅填寫圖片與第二曲繪時可用 決定切換至第二曲繪的按鈕的顯示字樣
	畫師	普通難度曲繪的畫師	是，通過link模板轉換	[[画师列表#%画师标准名%|%画师名义%]]或{{Link|曲师|%曲师标准名%}} 如[[画师列表#Khronetic|khronetic -synesthesia-]]或{{Link|画师|Khronetic}} (推薦使用前一種寫法)
	Beyond畫師	Beyond難度曲繪的畫師
背景組	背景	遊玩時的背景	是	背景名，如pragmatism3 可查詢背景列表以獲取曲目對應的背景名信息 (部分背景名中帶有「-」或「_」，需原樣填寫)
	Past背景	正常填寫上面的「背景」參數即可，如果不同難度下使用不同背景再補充這個	自動讀取songlist
	Present背景
	Future背景
	Beyond背景
	Eternal背景
更新時間組	更新版本	可自動獲取 如自動信息不正確，修改對應參數即可	是，通過模板:VersionTime.json獲取	vx.x.x 如v4.0.0
	更新時間			xxxx/xx/xx 如2022/07/07
	Beyond更新版本	可自動獲取 如自動信息不正確，需同時填寫版本/時間才能生效		vx.x.x 如v4.0.0
	Beyond更新時間			xxxx/xx/xx 如2022/07/07
	Eternal更新版本			vx.x.x 如v5.6.0
	Eternal更新時間			xxxx/xx/xx 如2024/04/26
	更新版本NS	無法自動獲取 如自動信息不正確，需同時填寫版本/時間才能生效	否	vx.x.x 如v2.0.1
	更新時間NS			xxxx/xx/xx 如2023/03/16
	Beyond更新版本NS			vx.x.x 如v2.0.1
	Beyond更新時間NS			xxxx/xx/xx 如2023/03/16
譜面信息組	Past等級	難度等級	是	純數字和「+」，如10+
	Present等級
	Future等級
	Beyond等級
	Eternal等級
	PastNote	曲目物量	否，需手動填入	純數字，如2221
	PresentNote
	FutureNote
	BeyondNote
	EternalNote
	note編寫	全難度譜師，優先自動獲取 注意首字母為小寫，輸入大寫的「Note編寫」將導致參數無效	是，通過Template:DesignersList.json	[[谱师列表#%谱师标准名%|%谱师名义%]]或{{Link|曲师|%曲师标准名%}} 如[[谱师列表#Toaster|{{Lang|ja|東星}}]]或{{Link|谱师|Toaster}} (推薦使用前一種寫法)
	PastNote編寫	單獨的譜師值，優先自動獲取 優先級：某一難度單獨的譜師參數 > 譜師參數 > 自動獲取
	PresentNote編寫
	FutureNote編寫
	BeyondNote編寫
	EternalNote編寫
譜面信息NS組	Past等級NS	難度等級	是，通過Songlist NS獲取	純數字和「+」，如10+
	Present等級NS
	Future等級NS
	Beyond等級NS
	PastNoteNS	曲目物量	否	純數字，如2158
	PresentNoteNS
	FutureNoteNS
	BeyondNoteNS
	note編寫NS	曲目的譜師，當未指定單獨譜師的值使用這個值 注意首字母為小寫，輸入大寫的「Note編寫NS」將導致參數無效	是，通過link模板轉換，通過songlist NS獲取	[[谱师列表#%谱师标准名%|%谱师名义%]]或{{Link|曲师|%曲师标准名%}} 如[[谱师列表#Toaster|{{Lang|ja|東星}}]]或{{Link|谱师|Toaster}} (推薦使用前一種寫法)
	PastNote編寫NS	單獨的譜師值 優先級：某一難度單獨的譜師參數 > 譜師參數 > 自動獲取
	PresentNote編寫NS
	FutureNote編寫NS
	BeyondNote編寫NS
配置組	圖片顯示控制	控制具有Beyond難度但與普通難度共用一張曲繪的曲目不顯示Beyond難度曲繪差分 (否則可能導致模板顯示紅鏈)	否 未使用時請留空	nobyd
	nocat	控制曲目信息模板不自動進行分類 (在用戶沙盒中使用該模板請將nocat置1)		yes或1 (事實上，跟據Lua的語法特點，你可以輸入除false以外的任何值)
	unset	控制曲目信息模板只顯示平台相關分類