Template:曲目信息/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时需填写 （如Quon和Genesis）	否 选填项	曲目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	控制曲目信息模板只显示平台相关分类