编辑“︁Template:Infobox song/doc”︁

{{Documentation subpage}}
{{NoteTA
|G1=MediaWiki
|1=zh-hans:信息框;zh-hant:資訊框;
|2=zh-cn:数字;zh-tw:數位;zh-hk:數碼;
|3=zh-hans:数据;zh-hant:資料;
|4=zh-cn:上传;zh-tw:上傳;zh-hk:上載;
|5=zh-cn:作词;zh-tw:作詞;zh-hk:填詞;
}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:String|Module:Check for unknown parameters}}
{{High-use|7800}}
{{Infobox song
| name      = 某張單曲
| cover     = Nocover.svg
| alt      = 基於「合理使用」原則，範例中使用示例圖片
| caption    = 單曲封面
| type      = 單曲
| artist     = 某位藝術家
| album     = 
| B-side    = 其他面
| released   = {{Start date|{{#expr:{{#time:Y}}-1}}|4|1}}
| recorded   = {{#expr:{{#time:Y}}-1}}年1月1日－10日
| studio    = [[台北市|台北]]玉成戲院
| venue     = 
| genre     = [[華語流行音樂]]
| length    = {{Duration|m=3|s=1}}
| label    = 某唱片公司
| writer    = 詞曲作者A
| arranger  = 編曲人B
| producer  = 製作人C
| prev_title = 上一張單曲
| prev_year  = {{#expr:{{#time:Y}}-2}}
| next_title = 下一張單曲
| next_year  = {{#time:Y}}
}}
{{Infobox song
| name    = 某首歌曲
| cover    = Nocover.svg
| alt     = 基於「合理使用」原則，範例中使用示例圖片
| caption  = 歌曲封面
| type    = 歌曲
| artist   = 某位藝術家
| album    = 某張專輯
| released = {{Start date|{{#expr:{{#time:Y}}-1}}|4|1}}
| recorded = {{#expr:{{#time:Y}}-1}}年1月1日－10日
| studio   = 
| venue    = [[台北小巨蛋]]
| genre    = [[華語流行音樂]]
| length   = {{Duration|m=3|s=1}}
| label   = 某唱片公司
| composer = 作曲人A
| lyricist = 作詞人B
| arranger = 編曲人C
| producer = 製作人D
}}
關於[[歌曲]]的維基條目內通常會插入一個[[Wikipedia:格式手册/信息框|信息框]]模板。一般情況下，{{Tl|Infobox song}}更傾向於商業發行的歌曲。其他的一些信息框模板，如{{Tl|Infobox musical composition}}和{{Tl|Infobox anthem}}更適合用於傳統或歷史歌曲條目中。右邊的範例為包含最常用參數的信息框。

可以使用與特定歌曲條目相關的資訊複製和完成下面的代碼，「參數」部分提供相關欄位的使用說明。
__TOC__

== 代碼 ==
{{Parameter names example | name | original_name | cover | cover_size | cover_upright | alt | border | caption | type | artist | album | EP | language | A-side | B-side | written | published | released | recorded | studio | venue | genre | length=<span class="duration">{{tlx|Duration|h{{=}}|m{{=}}|s{{=}}}}</span> | label | writer | composer | lyricist | arranger | producer | chronology | prev_title | prev_title2 | prev_year | title | title2 | year | next_title | next_title2 | next_year | tracks | misc | original_artist | from_album | __µ}}
=== 基本參數空白模板 ===
<pre style="overflow:auto">
-{zh;zh-hans;zh-hant;zh-cn;zh-tw;zh-hk;|{{Infobox song
| name     = 
| cover     = <!-- 此處僅填寫檔案名字 -->
| type     = 
| artist    = 
| album     = 
| B-side    = 
| released   = <!-- {{Start date|YYYY|MM|DD}} -->
| format    = 
| recorded   = 
| studio    = 
| genre     = <!-- 請勿添加無來源的音樂類型 -->
| length    =  <!-- 使用{{Duration|h=1|m=3|s=5}}，以免被納入Category:不含hAudio微格式的持續時間 -->
| label     = 
| writer    = <!-- 包括作曲人和作詞人 -->
| arranger   = 
| producer   = 
| prev_title = <!-- 此處供單曲年表使用 -->
| prev_year  = 
| next_title = 
| next_year  = 
}}
}-</pre>

=== 完整參數空白模板 ===
<pre style="overflow:auto">
-{zh;zh-hans;zh-hant;zh-cn;zh-tw;zh-hk;|{{Infobox song
| name       = 
| original_name = 
| cover      = <!-- 此處僅填寫檔案名字 -->
| cover_size   = 
| alt        = 
| border      = 
| caption     = 
| type       = 
| artist      = 
| album      = 
| EP        = 
| language    = <!-- 填入語言的ISO-639代碼，適用於非國語歌曲 -->
| language2   = <!-- 填入語言名稱，後方的數字最多可到5 -->
| A-side     = 
| B-side     = 
| written     = 
| published   = 
| released    = <!-- {{Start date|YYYY|MM|DD}} -->
| format     = 
| recorded    = 
| studio     = 
| venue      = 
| genre      = <!-- 請勿添加無來源的音樂類型 -->
| length     = <!-- 使用{{Duration|h=1|m=3|s=5}}，以免被納入Category:不含hAudio微格式的持續時間 -->
| label      = 
| writer     = <!-- 包括作曲人和作詞人 -->
| composer    = 
| lyricist    = 
| arranger    = 
| producer    = 
| chart_position = 
| certification  = 
| chronology    = 
| prev_title    = <!-- 此處供單曲年表使用 -->
| prev_year    = 
| next_title   = 
| next_year    = 
| tracks      = <!-- 參見「曲目列表範例」章節以獲取關於專輯曲目列表的更多資訊 -->
| misc       = <!-- 此處供{{Extra chronology}}、{{Extra track listing}}、{{Extra album cover}}、{{Audio sample}}和{{External music video}}模板使用 -->
}}
}-</pre>

== 參數 ==
=== name ===
歌曲名稱。如果不填，則會顯示剔除消歧義資訊的條目名稱（{{Tl|PAGENAMEBASE}}）。由於不需要建立維基連結，所以不必填寫[[WP:DAB|消歧義]]内容，如{{Nowrap|「(歌曲)」}}、{{Nowrap|「(魯迅歌曲)」}}等。

=== original_name ===
中文歌曲的官方英文名稱，或非中文歌曲的原文名稱。顯示效果與{{Para|language}}參數相配合。

=== cover ===
添加歌曲封面或其他適合的圖片。

=== alt ===
使用此欄位可以為有視覺障礙的讀者提供替代文字或封面圖片說明。參見[[WP:ALT]]。

=== caption ===
如果有圖片，可以在此處填入合適的說明文字。見[[MOS:CAPTION]]。

=== type ===
指定「單曲」、「器樂」、「創作」、「宣傳」等，如下方的代碼表所示。由於該欄位會自動連結到對應的條目，所以只需填入未連結的代碼即可（預設值為「歌曲」）。
{{Infobox song/doc/type}}

=== artist ===
填入歌曲的原唱者姓名（如有條目請建立連結）。對於傳統或歷史歌曲，其側重點在樂曲上時，則該欄位應當留空（或考慮使用[[模板:Infobox musical composition]]）。

=== album ===
如果歌曲初次發表時是收錄於專輯中的，請在此處填入專輯名稱，並為其建立維基連結。該模板會自動將書名號應用於專輯名稱，並在標題中生成「收录于专辑《專輯名稱》」。如果歌曲初次發表時是在專輯之前作為單曲發行的，則{{Para|album}}不應使用，因為它不是收錄於專輯，而是後來被添加到專輯中。

=== EP ===
如果歌曲初次發表時是收錄於[[迷你專輯]]中的，請在此處填入迷你專輯名稱，並為其建立維基連結。同樣會有書名號應用，並應當按照上方「album」小節中的描述使用。請注意：album和EP只能二選一填寫，具體取決於初次發表時收錄於哪裡。

=== language ===
請填入歌曲的主要演唱語言所對應的ISO 639代码，如en、fr或ja，根據內容會自動調整{{Para|original_name}}的顯示效果，國語歌曲可不必填寫。如果{{Para|genre}}欄位中填入了包含語言資訊的音樂類型（例如「[[華語流行音樂]]」或「[[粵語流行音樂]]」），則此欄亦可不必填寫。如果條目描述的是多語言歌曲，可使用{{Para|language2}}－{{Para|language5}}四項擴展參數。可直接填入語言名稱，不會影響{{Para|original_name}}的顯示效果。

=== A-side ===
如果條目描述的是作為單曲的[[A面與B面|B面]]發行的歌曲，请在此處填入[[A面與B面|A面]]的名称（請勿添加B面），適當時請建立連結。如果條目描述的是雙A面單曲，請參見下方的「雙A面單曲年表」章節以獲取更多資訊。

=== B-side ===
如果條目描述的是作為單曲的A面發行的歌曲，請在此處填入B面的名稱（請勿添加A面），適當時請建立連結。

=== written ===
如果條目中有提及，可填入歌曲編寫或創作的年份。這通常用於在樂譜出版或音樂錄製興起之前編寫的歷史歌曲。

=== published ===
如果條目中有提及，可填入歌曲的[[音樂出版社|出版]]年份。這通常是指音樂錄製興起之前出版的樂譜。

=== released ===
填入歌曲的商業發行日期，可使用{{Tl|Start date}}模板。

=== format ===
填入歌曲的發行方式，例如[[单曲|7英寸單曲]]、{{le|12英寸單曲|12-inch single}}、[[CD單曲]]、{{le|卡帶單曲|cassette single}}、[[數位音樂下載]]（注釋出渠道連結）等。通常情況下，再版版本的發行方式應當記錄於條目中。

=== recorded ===
填入歌曲的錄製時間。當有多個日期時，建議使用月份或月份範圍（例如：2016年1月－3月）進行總結。請於{{Para|studio}}或{{Para|venue}}欄位記錄錄音的地點。

=== studio ===
如果歌曲在「錄音室」錄製，請填入錄音室的名稱和位置，並為其建立維基連結，除非該錄音室位於不知名的國家、政區或城市（參見「[[WP:OVERLINK]]」以獲取更多資訊）。如果錄音室名稱中出現了「錄音室」或「Studios」字樣，請將它們從錄音室名稱中移除。例如「<nowiki>[[Sound City Studios|Sound City]]</nowiki>」，而不是「<nowiki>[[Sound City Studios]]</nowiki>」。

=== venue ===
對於「現場錄製」的歌曲，請填入場地名稱（如音樂廳、體育館等）和位置。適當時請建立連結。

=== genre ===
該欄位應填入最能描述總體風格的音樂類型，資料應當來自可靠來源，並於條目正文中說明和引用，請勿填入個人觀點或原創研究。內容應當建立連結。

=== length ===
歌曲的長度應當以分鐘和秒為單位表示，例如「3:09」。請使用{{Tl|Duration}}模板，以免條目被納入[[:Category:不含hAudio微格式的持续时间]]。

=== label ===
此欄僅需填入最初發行歌曲的[[唱片公司]]即可。如果該歌曲在不同地區由不同的唱片公司負責發行，則應當記錄于正文的「發行歷史」小節下。請將其中的「唱片」或「Records」字樣移除（例如<code>{{Nowrap|<nowiki>[[福茂唱片|福茂]]</nowiki>}}</code>，而不是<code>{{Nowrap|<nowiki>[[福茂唱片]]</nowiki>}}</code>）。

===writer===
填入編寫「樂曲」和「歌詞」的人名。不能與{{Para|composer}}<s>和{{Para|lyricist}}</s>字段通用。

注意：出于对中文维基旧版歌曲信息框的兼容性考虑（旧版的{{Para|writer}}字段被定义为「作词」），{{Para|writer}}字段和{{Para|lyricist}}字段目前仍然通用。如果{{Para|composer}}字段未被定义，则{{Para|writer}}字段将显示为「词曲」，否则将显示为「作词」。后续将视既有条目的清理进度决定是否移除。

===composer===
填入「作曲」的人名。

===lyricist===
填入「填詞」的人名。

===producer===
填入鳴謝的[[音樂製作人]]名。這是監督錄製過程的人，通常與藝人或詞曲作者不同。

===chronology===
該字段與下面的{{Para|prev_title}}和{{Para|next_title}}搭配顯示藝人的單曲年表。

===prev_title===
填入藝人前一首發行的單曲名。必要時用書名號標注。

===prev_year===
填入上一首單曲發行的年份，自動加上“年”字。

===next_title===
填入藝人后一首發行的單曲名。必要時用書名號標注。

===next_year===
填入后一首單曲發行的年份，自動加上“年”字。

===tracks===
顯示曲目列表。有關説明和代碼，參見[[#曲目列表範例|曲目列表範例]]。

===misc===
可用子模板，例如{{Tl|Extra chronology}}、{{Tl|Extra track listing}}、{{Tl|Extra album cover}}、{{Tl|Audiosample}}以及{{Tl|External music video}}。有關其用法的說明，請參閱模板頁面。

==曲目列表範例==
並非所有信息框都應包含專輯曲目列表。
 
只要滿足以下條件，就可以將專輯曲目列表添加到Song信息框：1）條目中沒有添加歌曲導航框；2）專輯的大部分歌曲都存在維基條目。

<!--===使用單獨子模板的曲目列表===

{{Infobox song
| name    = 歌曲A
| cover    =
| alt     =
| type    =
| artist   = 藝人A
| album    = 專輯A
| released = {{Start date|{{#expr:{{#time:Y}}-1}}|04|01}}
| format   =
| recorded = {{#expr:{{#time:Y}}-1}}1月1日至10日
| studio   = Tian'anmen（北京）
| venue    =
| genre    = [[当代节奏布鲁斯]]
| length   = {{Duration|m=3|s=1}}
| label    = [[哥伦比亚唱片|哥伦比亚]]
| writer   = 藝人A
| producer = 製作人A
| tracks   = {{Rumours tracks}}
}}

If a separate album track listing sub-template has been created, it may be added to the {{Para|tracks}} of the infobox.  Using such a template may be more convenient for multi-disc albums or those with many tracks.  A header with the album name will be automatically generated, along with the number of tracks.  The song title will not be linked, but will appear in '''bold'''.

The example to the right uses {{Tl|Rumours tracks}} to demonstrate. To see its use in actual song infobox, click on the song links. Please note, if a singles chronology is also used in the infobox ({{Para|prev_title}}, etc.), {{Tl|Extra track listing}} must be used in the {{Para|misc}} field (refer to that [[Template:Extra track listing|Template:Extra track listing#Usage]] for the code and explanation).
{{Clear}}
-->
===使用隱藏模板的曲目列表===
{{Infobox song
| name    = 歌曲A
| cover    =
| alt     =
| type    =
| artist   = 藝人A
| album    = 專輯A
| released = {{Start date|{{#expr:{{#time:Y}}-1}}|04|01}}
| format   =
| recorded = {{#expr:{{#time:Y}}-1}}年1月1日至10日
| studio   = Tian'anmen（北京）
| venue    =
| genre    = [[当代节奏布鲁斯]]
| length   = {{Duration|m=3|s=1}}
| label    = [[哥伦比亚唱片|哥伦比亚]]
| writer   = 藝人B
| producer = 製作人C
| tracks   = {{Hidden
 | title     = 五首曲目
 | text      = 
;第一面
# 《曲目A》
# 《曲目B》
# 《曲目C》
;第二面
# 《曲目D》
# 《曲目E》
}}
}}

;Code
<pre>{{Infobox song
...
| tracks = {{Hidden
 | title = 
 | text  = 
# 
# 
# etc.
}}
</pre>

;title
輸入曲目數，例如“十首曲目”。或將自動生成標題，例如“專輯A的曲目列表”。

;Code
<pre>{{Infobox song
...
| tracks = {{Hidden
 | title = 
 | text  = 
;Disc one
# 
# 
# etc.
;Disc two
#<li value=>
# 
# 
# etc.
}}
</pre>
{{Clear}}

==雙A面單曲的年表==
{{Infobox song
| name      = 單曲B
| cover      =
| alt       =
| type      = 單曲
| artist     = 藝人B
| album      = 專輯B
| A-side     = 《單曲X》（[[A面與B面|雙A面]]）
| released    = {{Start date|{{#expr:{{#time:Y}}-1}}|04|01}}
| format     = [[CD單曲]]
| recorded    = {{#expr:{{#time:Y}}-1}}1月1日至10日
| studio     = Tian'anmen（北京）
| venue     =
| genre     = [[当代节奏布鲁斯]]
| length    = {{Duration|m=3|s=1}}
| label     = [[哥伦比亚唱片|哥伦比亚]]
| writer     = 藝人A
| producer   = 製作人C
| chronology  = 
| prev_title  = 前首單曲
| prev_title2 = 前首其他
| prev_year   = {{#expr:{{#time:Y}}-2}}
| title     =
| title2     = 其他面
| next_title  = 后首單曲
| next_title2 = 后首其他
| next_year   = {{#time:Y}}
}}

;Code :
<pre>{{Infobox song
...
| A-side    = 
| chronology  = 
| prev_title  = 
| prev_title2 = 
| prev_year  = 
| title2    = 
| next_title = 
| next_title2 = 
| next_year  = 
}}
</pre>

== 模板数据 ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"type": {
			"label": "类型",
			"description": "指定“单曲”、“器乐”、“创作”、“宣传”等。由于该字段会自动链接到对应的条目，所以只需填入未链接的代码即可（默认值为“歌曲”）。",
			"example": "单曲（single）、歌曲（song）、宣传（promo）、小样（demo）、混音单曲（remix single）、器乐（instrumental）、创作（composition）、赞美诗（hymn）、童谣（nursery）、其他（other）"
		},
		"EP": {
			"label": "迷你专辑名称",
			"description": "如果歌曲初次发表时是收录于迷你专辑中的，请在此处填入迷你专辑名称，并为其建立维基链接。"
		},
		"writer": {
			"label": "词曲"
		},
		"title2": {},
		"tracks": {},
		"recorded": {
			"label": "录制时间"
		},
		"length": {
			"label": "时长"
		},
		"chronology": {
			"label": "单曲年表标题"
		},
		"name": {
			"label": "歌曲名称",
			"description": "默认显示剔除消歧义信息的条目名称（{{PAGENAMEBASE}}）。"
		},
		"original_name": {
			"label": "原文名",
			"description": "中文歌曲的官方英文名称，或非中文歌曲的原文名称。"
		},
		"language": {
			"label": "语言",
			"description": "请填入歌曲的主要演唱语言所对应的ISO 639代码",
			"example": "en"
		},
		"cover": {
			"aliases": [
				"image"
			],
			"label": "封面图像",
			"description": "添加歌曲封面或其他适合的图片。  "
		},
		"cover_size": {
			"label": "图像大小"
		},
		"cover_upright": {},
		"alt": {
			"label": "图像替代文字",
			"description": "使用此字段可以为有视觉障碍的读者提供替代文字或封面图片说明。"
		},
		"border": {},
		"caption": {
			"label": "图像说明",
			"description": "如果有图片，可以在此处填入合适的说明文字。"
		},
		"artist": {
			"aliases": [
				"original_artist"
			],
			"label": "原唱者",
			"description": "填入歌曲的原唱者姓名（如有条目请建立链接）。"
		},
		"album": {
			"aliases": [
				"from_album"
			],
			"label": "专辑名称",
			"description": "如果歌曲初次发表时是收录于专辑中的，请在此处填入专辑名称，并为其建立维基链接。"
		},
		"language2": {
			"label": "语言2"
		},
		"language3": {
			"label": "语言3"
		},
		"language4": {
			"label": "语言4"
		},
		"language5": {
			"label": "语言5"
		},
		"A-side": {
			"label": "A面"
		},
		"B-side": {
			"label": "B面"
		},
		"written": {
			"label": "创作时间"
		},
		"published": {
			"label": "出版时间"
		},
		"released": {
			"label": "发行日期"
		},
		"format": {
			"label": "发行方式"
		},
		"studio": {
			"label": "录音室"
		},
		"venue": {
			"label": "场地"
		},
		"genre": {
			"label": "音乐类型"
		},
		"label": {
			"label": "唱片公司"
		},
		"composer": {
			"label": "作曲"
		},
		"lyricist": {
			"label": "作词"
		},
		"arranger": {
			"label": "编曲"
		},
		"producer": {
			"label": "制作人"
		},
		"chart_position": {
			"label": "排行榜最高名次"
		},
		"certification": {
			"label": "销量认证"
		},
		"prev_title": {},
		"next_title": {},
		"prev_single": {
			"aliases": [
				"Last single"
			]
		},
		"__µ": {},
		"prev_title2": {},
		"prev_year": {},
		"next_year": {},
		"year": {},
		"next_title2": {},
		"misc": {},
		"prev": {},
		"next": {},
		"prev_no": {},
		"track_no": {},
		"next_no": {},
		"title": {
			"aliases": [
				"this_single"
			]
		}
	},
	"format": "block",
	"paramOrder": [
		"name",
		"original_name",
		"cover",
		"cover_size",
		"cover_upright",
		"alt",
		"border",
		"caption",
		"type",
		"artist",
		"album",
		"EP",
		"language",
		"language2",
		"language3",
		"language4",
		"language5",
		"A-side",
		"B-side",
		"written",
		"published",
		"released",
		"recorded",
		"format",
		"studio",
		"venue",
		"genre",
		"length",
		"label",
		"writer",
		"composer",
		"lyricist",
		"arranger",
		"producer",
		"chronology",
		"chart_position",
		"certification",
		"prev_title",
		"prev_title2",
		"prev_year",
		"title",
		"title2",
		"year",
		"next_title",
		"next_title2",
		"next_year",
		"prev_single",
		"__µ",
		"prev",
		"next",
		"prev_no",
		"track_no",
		"next_no",
		"tracks",
		"misc"
	]
}
</templatedata>

== 追蹤分類 ==
* {{Clc|在infobox song使用未知參數的頁面}}
* {{Clc|在音乐信息框中使用过时参数的页面}}
* {{Clc|String模块出错的音乐信息框}}
* {{Clc|缺少词曲作家的歌曲条目}}
* {{Clc|同时拥有作曲人和词曲作家的歌曲条目}}
* {{Clc|拥有填词人缺少作曲人的歌曲条目}}
* {{Clc|Infobox song表格格式错误}}

== 參見 == 
* [[Wikipedia:音樂專題/歌曲條目格式指導]]
* {{Tl|Infobox album}}