模板:Single chart/doc

本模板可以使编辑者在建立单曲的排行榜时，依照特定的格式列明来源。如要建立专辑专用的排行榜则可以使用另一个相似的模板{{Album chart}}。

使用此模板可以生成一个包括国家及其使用的排行榜、来源、排行榜最高名次等资讯的表格资料，编辑者可以使用此模板产生的资料创建条目里需要的排行榜名次的表格，详细使用方法可以见下面的使用说明。

此模板并不能验证单曲是否出现在排行榜上、及所在的最高名次，它只是让为了创建排行榜名次的表格时可以有可靠的来源。模板所提供的来源资料也不会自动检查可用性，未依指定格式使用模板可能会产生一个无法使用的来源。在使用该模板之前，编辑者应该先自行确认该模板的资料及连结无误再储存条目。

使用方法及参数

完整模板
{{singlechart |(Chart identifier) |(Peak position) |song= |artist= |chartid= |url= |urltitle= |date= |year= |week= |note= |publishdate= |accessdate= |refname= |refgroup= |rowheader=}}

参数

所有的参数除了Chart identifier、Peak position、accessdate为必填、publishdate与refname为选填外，其他参数都应照著下面章节#使用方法依著各个排行榜不同的格式来填写。

• (Chart identifier)或未填参数名称时第一个值：排行榜提供者。填入的值必须为#使用方法章节中表格内“排行榜ID”下的任一值。有些值为国家或国籍（如：Spain、Spanish或西班牙），也有些为特定名称的值（如：Billboardjapanhot100），有些排行榜有著一个以上的值，填入任一个值会得出相同的结果。
• (Peak position)或未填参数名称时第二个值：最高名次。指单曲在排行榜所获得的最高名次。
• song：单曲的名称。不同排行榜所需填入的名称略有不同，请在储存前确认生成连结是否无误。
• artist：专辑的名称。如同song参数，不同排行榜所需填入的名称略有不同，请在储存前确认生成连结是否无误。
• chartid：排行榜代码。仅使用于特定几个排行榜的来源连结中，应填入的代码可在来源的连结网址中找到。
• url：来源网址。仅使用于排行榜来源连结较一般连结无系统者，将直接填入来源的连结网址。
• urltitle：来源网站显示名称。通常与url参数一起使用，将用来显示来源连结出现在参考资料时的显示文字。
• date：排行档存档的日期，格式为“YYYYMMDD”。仅使用于#使用方法中特定几个排行榜，这类的排行榜通常只能查某一个时间中一整个榜，并不能查询特定的一首歌。如其他排行榜要列出排行榜公布的日期请使用publishdate参数。
• year与week：分别为四位数年份及二位数周数，仅用于特定几个排行榜中。周数为01-53等二位数字，有些排行榜在1-9时前面不加0，详细用法见#使用方法中介绍。这两个参数用法与publishdate不同。
• note：用于标示歌曲特定的版本，用法如note=extended dance mix或{{singlechart|Australia|1|song=I'm the Urban Spaceman|artist=The Bonzo Dog Doo Dah Band|note=uncensored version}}。
• publishdate：排行榜公布的日期，用于附注在参考资料中，建议使用ISO 8601的格式YYYY-MM-DD。
• accessdate：存取日期，用于附注在参考资料中，建议使用ISO 8601的格式YYYY-MM-DD。
• refname：用法同<ref name="name">，使参考料资一次可以附注多次于条目中，使用方法请见Help:脚注#多处标明同一项注脚。
• refgroup：用法同<ref group="xxx">，用于分组参考资料，使用方法请见Help:脚注#把注脚分组。

模板数据

Creates a table row for a recognized single chart

模板参数

参数		描述	类型	状态
Chart identifier	1	Chart name: recognized values are listed at Template:Singlechart/doc	字符串	必需
Chart position	2	peak position on the chart	数字	必需
artist	artist	artist name as listed on the source chart	字符串	必需
song	song	song title as listed on the source chart	字符串	必需
reference name	refname	Names the reference created by the template so that it may be used other places in the article	字符串	必需
Notes	chartnote	Any special notes about this version here. Typically used to distinguish versions , i.e. 'reggae mix' vs. 'dubsteb version'	字符串	可选
year	year	year chart position occurred, required for Czech Republic, all Hungarian charts, Ireland, Israeliairplay	数字	可选
week	week	week number (1-53) required for Czech Republic, all Hungarian charts, Ireland, Israeliairplay	数字	可选
URL	url	required for Bulgarian charts (must be from www.bamp-bg.org) and for Australiapandora (must be from pandora.nla.gov.au)	数字	可选
date	date	date of chart. Required for Frenchdigital (format yyyymmdd with no spaces) or any UK chart (format yyyy-mm-dd )	数字	可选
access date	accessdate	Free format date showing when this information was verified	字符串	可选
Row header control	rowheader	when set to true, the chart name will be treated as a row header	字符串	可选

输出

此模板展开后会输出一个有两列资料的表格及一个参考资料。左列的资料标示排行榜的国家及／或排行榜的名称，附有夹注在<ref></ref>标签内的参考^[n]，如果有使用到note参数则会出现在左列的下方；右列则列出歌曲在榜中的最高名次，在表格内置中。

参考资料如其他的参考一样会陈列在条目中<references />或{{reflist}}模板处。除非有另外指定，模板会自动为参考资料标注名为"sc_Chartid_artist"的参考资料，如：假设条目中使用以下模板

{{singlechart|Australia|1|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band|note=album version}}

则在条目中的别处可利用下列语法使用该模板产生的参考资料

……有些事實來自同樣的來源。<ref name="sc_Australia_Bonzo Dog Doo Dah Band"/>

当然有些参考资料可以使用自己的refname

{{singlechart|Australia|1|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band|refname=bonzosinoz}}

在这种情况要引用该参考资料用自定的refname即可

...some fact supported by the same source.<ref name=bonzosinoz/>

范例

这里列出几个使用此模板的范例，如要像范例五以完整的表格列出可参考下面章节使用完整表格列出的范例。

范例	代码（假设已经在表格内）	输出（假设下面已加有<references />标签）
范例1	{{singlechart |Australia |18 |artist=Shakira |song=She Wolf}}	澳大利亚（澳大利亚唱片业协会单曲榜） 18
范例2	{{singlechart |Billboardcanadianhot100 |5 |artist=Shakira}}	加拿大（Canadian Hot 100） 5
范例3	{{singlechart |Frenchdigital |4 |artist=Shakira |song=She Wolf |date=20091017}}	法国（法国唱片出版业公会下载榜） 4
范例4	{{singlechart |Italy |3 |artist=Shakira |song=Loba |note="Loba" (Spanish version) |refname=Loba-es}} |- {{singlechart |Italy |11 |artist=Shakira |song=She Wolf |note="She Wolf" (English version) |refname=Loba-en}}	意大利（意大利音乐产业联盟单曲榜） "Loba" (Spanish version) 3 意大利（意大利音乐产业联盟单曲榜） "She Wolf" (English version) 11
范例5	{| class="wikitable sortable" |- ! 排行榜（2009） ! 最高<br/>名次 |- {{singlechart |Flanders|16 |artist=Shakira |song=She Wolf}} |- {{singlechart |Wallonia|5 |artist=Shakira |song=She Wolf}} |- |巴西（《告示牌》[[Billboard Brasil|巴西百強電台榜]]）<ref> "Brazil Hot 100 Airplay" (in Portuguese). Billboard Brasil (Brazil: bpp) (2): 79. November 2009. ISSN 977-217605400-2</ref> | style="text-align:center;"|1 |- {{singlechart |Hungary|5|year=2009|week=14}} |- {{singlechart |Ireland|2 |year=2009 |week=40}} |- {{singlechart |Billboardjapanhot100|9 |artist=Shakira}} |- {{singlechart|Poland|2|year=2013|chartid=532}} |- {{singlechart |UKchartstats|4 |artist=Shakira|song=She Wolf|songid=34525}} |}	排行榜（2009） 最高 名次 比利时佛兰德（Ultratop五十强单曲榜） 16 比利时瓦隆（Ultratop五十强单曲榜） 5 巴西（《告示牌》巴西百强电台榜） 1 匈牙利（四十强电台榜） 5 爱尔兰（爱尔兰唱片音乐协会单曲榜） 2 日本（Japan Hot 100） 9 波兰（波兰百大电台榜） 2 英国（官方榜单公司单曲榜） 4

错误讯息

如果使用不正确的方式引用该模板，模板会自动跑出红色的错误讯息以警告编辑者。举例来说，如果你在使用Hungary排行榜时忘记填入两个该榜的必填参数week或year，模板展开来后会像这样：

songid field is MANDATORY FOR GERMAN CHARTS

9

编辑完后可先利用显示预览来查看条目中此模板是否出现像这样的错误讯息，避免未修正就储存的情况。

使用方法

除了《告示牌》提供的数个排行榜外，此模板也支援许多《告示牌》以外的排行榜。以下两个表格分别列出此模板支援的非《告示牌》及《告示牌》排行榜。

非《告示牌》排行榜

排行榜ID	排行榜名称	来源网站	必填参数	附注
Australia、Australian 澳大利亞、澳大利亚、澳洲	ARIA	www.australian-charts.com	artist song
Australiapandora	ARIA	pandora.nla.gov.au	url urltitle artist*	此为澳洲国家图书馆所做的存档，仅支援排行榜前50名的单曲。
Australiaurban	ARIA	pandora.nla.gov.au	url urltitle artist*	此为澳洲国家图书馆所做的存档，仅支援澳洲都会排行榜的单曲。
Austria、Austrian 奧地利、奥地利	奥地利Ö3四十强音乐榜	www.austriancharts.at	artist song
Belgium (Wallonia) Wallonia 瓦隆、華隆	Ultratop 50	www.ultratop.be	artist song
Belgium (Flanders) Flanders Belgium (Vlanders) Vlanders 法蘭德斯、佛兰德、佛兰德斯	Ultratop 50	www.ultratop.be	artist song
Bulgaria、Bulgarian 保加利亞、保加利亚	IFPI at bamp-br.org	www.bamp-br.org	url urltitle artist*
Canadaadultcontemporary	RPM Adult Contemporary Tracks	www.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpm	chartid	After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
Canadacountry	RPM Country Tracks	www.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpm	chartid	After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
Canadatopsingles	RPM Top Singles	www.bac-lac.gc.ca/eng/discover/films-videos-sound-recordings/rpm	chartid	After searching, click on the desired result, then click on the chart to display a larger image. Use the chartid from the larger image.
Czech Republic 捷克	ČNS IFPI (Rádio Top 100)	www.ifpicr.cz	year week artist*	year与week于来源中寻找。week是由01至53的两位数字，01至09前的0不可省略。仅支援2006年1月以后的排行榜。
Czechdigital	ČNS IFPI (Singles Digitál Top 100)
Danish Denmark 丹麥 丹麦	Hitlisten	www.danishcharts.com	artist song	如未填year或week两个参数，模板将自动使用这个来源，但仅支援2007年11月之后的排行榜。2007年11月之前请使用www.hitlisten.nu做为参考来源。
		www.hitlisten.nu	artist song week year	官方丹麦排行榜。
Denmark 2007	Hitlisten	www.hitlisten.nu	artist song week year	官方丹麦排行榜。
Danish Airplay Denmark Airplay	Hitlisten	www.hitlisten.nu	artist song week year	官方丹麦串流排行榜。
Dutch100 荷蘭百強單曲 荷兰百强单曲	Mega Single Top 100	www.dutchcharts.nl	artist song
Dutch40 荷蘭40強單曲 荷兰40强单曲	荷兰四十强单曲榜	www.top40.nl	artist song	当year与week参数未填时，模板会自动使用此种参考来源。
			year week artist*	当year与week参数有填写时，模板会自动使用此种参考来源。week参数为1到53的数字，1到9前面不加0。
Finnish、Finland 芬蘭、芬兰	Suomen virallinen lista	www.ifpi.fi	artist song
Finnishdownload latauslista	Suomen virallinen latauslista	www.ifpi.fi	artist	Non-Finnish artists: If the release has charted on the comprehensive chart above, this chart is to be omitted. Finnish artists: If the release has charted on the comprehensive chart (above) and not abroad, this chart can be added.
Finnishairplay radiosoittolista	Suomen virallinen radiosoittolista	www.ifpi.fi	artist
French、France 法國、法国	SNEP	www.lescharts.com	artist song
Frenchdigital	SNEP	www.lescharts.com	artist song date	需特别注意date参数的格式为YYYYMMDD。
German、Germany 德國、德国	媒体控制榜	www.musicline.de	artist	artist参数请填Last,First（即名,姓）格式。
German2、Germany2 德國2、德国2 西德、West German	媒体控制榜	www.offiziellecharts.de	artist song id
Hungary Hungarian 匈牙利	Mahasz (Rádiós Top 40)	www.mahasz.hu	artist song year week
Hungarytop10	Mahasz (Single Top 10)	www.mahasz.hu	artist song year week
Hungarydance	Mahasz (Dance Top 40)	www.mahasz.hu	artist song year week
Ireland、Irish 愛爾蘭、爱尔兰	IRMA	www.chart-track.co.uk	year week artist*	week参数为1到53的数字，1到9前面不加0。
Ireland2 愛爾蘭2、爱尔兰2	IRMA	irishcharts.ie/	artist 或 song	If the song parameter is present, it provides a reference pointing to search results for the song, otherwise, it provides a url including search results for the specified artists.
Italian、Italy 義大利、意大利	FIMI	www.italiancharts.com	artist song
New Zealand 紐西蘭、新西兰	新西兰唱片音乐协会	www.charts.org.nz	artist song
Norwegian、Norway 挪威	VG-lista	www.lista.vg.no/	artist song week year
Polish、Poland 波蘭、波兰	Polish Music Charts	www.zpav.pl	chartid year
Polishdance	Polish Dance Chart	www.zpav.pl	chartid
Scotland 蘇格蘭、苏格兰	苏格兰单曲榜	www.officialchartcompany.com	date artist song	需特别注意date参数为YYYY-MM-DD格式。
Slovakia、Slovakian 斯洛伐克	ČNS IFPI (Rádio Top 100)	www.ifpicr.cz	year week artist*	week是由01至53的两位数字，01至09前的0不可省略。仅支援2006年1月以后的排行榜。
Slovakdigital	ČNS IFPI (Singles Digitál Top 50)
Spain、Spanish 西班牙	PROMUSICAE	www.spanishcharts.com	artist song
Sweden、Swedish 瑞典	Sverigetopplistan	www.swedishcharts.com	artist song
Swiss、Switzerland 瑞士	Schweizer Hitparade	www.swisscharts.com	artist song
UK、United Kingdom 英國、英国	Official Charts Company Main singles chart	www.officialcharts.com	date artist song	Date is formatted yyyy-mm-dd. This template only supports positions 1-40. For positions 41-75, UKsinglesbyname should be used. There are no reliable archived sources for positions beyond 75.
UKsinglesbyname UKchartstats UKchartarchive	Official Charts Company Main singles chart	www.officialcharts.com	artist song songid	This accesses the artist information page on officialcharts.com. Due to the format of officialcharts.com, this can only support positions 1-75. The UKchartstats and UKchartarchive values will bring up this same information, as UKchartstats.com no longer publishes chart data due to licensing issues. Ukchartstats and UKchartarchive should no longer be used.
UKdance 英國舞曲單曲、英国舞曲单曲	Official Charts Company Dance singles chart	www.officialcharts.com	date artist song	date is formatted yyyy-mm-dd
UKdownload 英國下載、英国下载	Official Charts Company Download chart	www.officialcharts.com	date artist song	Date is formatted yyyy-mm-dd
UKindependent UKindie 英國獨立單曲、英国独立单曲	Official Charts Company Independent singles chart	www.officialcharts.com	date artist song	Date is formatted yyyy-mm-dd
UKrandb 英國節奏藍調單曲、英国节奏蓝调单曲	Official Charts Company R&B chart	www.officialcharts.com	date artist song	Date is formatted yyyy-mm-dd
Other non-Billboard charts are not currently supported by {{singlechart}} and their use will need to be formatted and referenced manually (see the Brazil listing in Example 5 above). Be sure, however, not to use one of the deprecated charts. * These charts require the artist parameter solely for the purposes of internal reference naming using the default format (see Output above). If you are using the refname parameter to override the default naming, or you are sure that the references are not being reused in the article, you omit artist for the marked charts. The use of song and title are recommended for all charts, however.

《告示牌》排行榜

Chart ID	Actual chart name	Website used as archive	Required parameters	Notes
Billboardcanadianhot100 Canada	Canadian Hot 100	www.billboard.com	artist
Billboardcanadaac	Canada AC	www.billboard.com	artist
Billboardcanadachrtop40	Canada CHR/Top 40	www.billboard.com	artist
Billboardcanadacountry	Canada Country	www.billboard.com	artist
Billboardcanadahotac	Canada Hot AC	www.billboard.com	artist
Billboardcanadarock	Canada Rock	www.billboard.com	artist
Billboardeurodigital	Euro Digital Songs	www.billboard.com	artist
Billboardeuropeanhot100	European Hot 100 Singles	www.billboard.com	artist
Billboardjapanhot100	Japan Hot 100	www.billboard.com	artist
Luxembourgdigitalsongs	Luxembourg Digital Songs	www.billboard.com	artist
Portugaldigitalsongs	Portugal Digital Songs	www.billboard.com	artist
Billboardglobal200	Billboard Global 200	www.billboard.com	artist
Billboardhot100	Billboard Hot 100	www.billboard.com	artist
Billboardbubbling100	Bubbling Under Hot 100 Singles	www.billboard.com	artist
Billboarddigitalsongs	Digital Songs	www.billboard.com	artist
Billboardradiosongs	Radio Songs	www.billboard.com	artist
Billboardchristiansongs	Hot Christian Songs	www.billboard.com	artist
Billboardcountrysongs	Hot Country Songs	www.billboard.com	artist
Billboarddanceelectronic	Hot Dance/Electronic Songs	www.billboard.com	artist
Billboardlatinsongs	Hot Latin Songs	www.billboard.com	artist
Billboardrandbhiphop	Hot R&B/Hip-Hop Songs	www.billboard.com	artist
Billboardrapsongs	Hot Rap Songs	www.billboard.com	artist
Billboardrocksongs	Hot Rock Songs	www.billboard.com	artist
Billboardadultalternativesongs	Adult Alternative Songs	www.billboard.com	artist
Billboardadultcontemporary	Adult Contemporary	www.billboard.com	artist
Billboardadultrandbsongs	Adult R&B Songs	www.billboard.com	artist
Billboardadultpopsongs	Adult Top 40	www.billboard.com	artist
Billboardalternativesongs	Alternative Songs	www.billboard.com	artist
Billboardchristianairplay	Christian Airplay	www.billboard.com	artist
Billboardcountryairplay	Country Airplay	www.billboard.com	artist
Billboarddanceclubplay	Dance Club Songs	www.billboard.com	artist
Billboarddanceairplay	Dance/Mix Show Airplay	www.billboard.com	artist
Billboardlatinairplay	Latin Airplay	www.billboard.com	artist
Billboardlatinpopsongs	Latin Pop Songs	www.billboard.com	artist
Billboardmainstreamrock	Mainstream Rock	www.billboard.com	artist
Billboardpopsongs	Mainstream Top 40	www.billboard.com	artist
Billboardrandbhiphopairplay	R&B/Hip-Hop Airplay	www.billboard.com	artist
Billboardregionalmexican	Regional Mexican Airplay	www.billboard.com	artist
Billboardrhythmic	Rhythmic	www.billboard.com	artist
Billboardrockairplay	Rock Airplay	www.billboard.com	artist
Billboardsmoothjazzsongs	Smooth Jazz Songs	www.billboard.com	artist
Billboardlatintropical	Tropical Songs	www.billboard.com	artist
Other Billboard charts are not currently supported by {{singlechart}} and their use will need to be formatted and referenced manually (see the Brazil listing in Example 5 above). Be sure, however, not to use one of the deprecated charts.

Examples with table layout

Example with dummy data

Since this template produces only individual rows within a table, you will need to add (or already have) the table's framework in the article. Here is a sample table with its corresponding output:

{| class="wikitable sortable"
|-
! Chart
! Peak position
|-
| row 1, cell 1
| row 1, cell 2
|-
| row 2, cell 1
| row 2, cell 2
|-
 {{singlechart|Australia|6|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band|note=Happy Meal edition}}
|-
 {{singlechart|Belgium (Wallonia)|4|song=I'm the Urban Spaceman|artist=Bonzo Dog Doo Dah Band}}
|}

expands into:

Chart	Peak position
row 1, cell 1	row 1, cell 2
row 2, cell 1	row 2, cell 2
澳大利亚（澳大利亚唱片业协会单曲榜） Happy Meal edition	6
比利时瓦隆（Ultratop五十强单曲榜）	4

Example with realistic data

This example is excerpted from actual usage at Doesn't Mean Anything, with a couple of minor additions.

{|class="wikitable sortable"
|-
!Chart (2009)
!Peak<br />position
|-
{{singlechart|Australia|96|artist=Alicia Keys|song=Doesn't Mean Anything}}
|-
{{singlechart|Billboardcanadianhot100|66|artist=Alicia Keys}}
|-
{{singlechart|Czech Republic|31|artist=Alicia Keys|song=Doesn't Mean Anything|year=2010|week=01}}
|-
{{singlechart|Billboardeuropeanhot100|10|artist=Alicia Keys}}
|-
{{singlechart|Germany|8|artist=Keys,Alicia|song=Doesn't Mean Anything|songid=625466|note=Angela Merkel rap edition|rowheader=true}}
|-
{{singlechart|Billboardjapanhot100|3|artist=Alicia Keys}}
|-
{{singlechart|Dutch100|43|artist=Alicia Keys|song=Doesn't Mean Anything|accessdate=2010-02-28}}
|-
{{singlechart|New Zealand|22|artist=Alicia Keys|song=Doesn't Mean Anything}}
|-
{{singlechart|Slovakia|31|artist=Alicia Keys|song=Doesn't Mean Anything|week=52|year=2009}}
|-
{{singlechart|UKchartstats|8|artist=Alicia Keys|song=Doesn't Mean Anything|songid=34669}}
|-
{{singlechart|Billboardhot100|60|artist=Alicia Keys}}
|-
{{singlechart|Billboardrandbhiphop|14|artist=Alicia Keys}}
|}

expands into:

Chart (2009)	Peak position
澳大利亚（澳大利亚唱片业协会单曲榜）	96
加拿大（Canadian Hot 100）	66
捷克（电台百强单曲榜）	31
欧洲（European Hot 100）	10
德国（德国官方单曲榜） Angela Merkel rap edition	8
日本（Japan Hot 100）	3
荷兰（百强单曲榜）	43
新西兰（新西兰唱片音乐协会单曲榜）	22
斯洛伐克（电台百强单曲榜）	31
英国（官方榜单公司单曲榜）	8
美国（《告示牌》百大单曲榜）	60
美国（《告示牌》Hot R&B/Hip-Hop Songs）	14

Maintenance categories

To help maintain music articles, this template will automatically categorize articles that call it based on the parameters used in the reference.

使用Single chart但缺少必要参数的页面

Category:使用Single chart但缺少必要参数的页面 contains a list of articles that have failed error checking because of missing parameters.

Singlechart usages for chartname

This set of categories lists the calls for each possible chart name, i.e. Category:singlechart usages for Billboardhot100 contains all articles that have used the template to build a reference for the Billboard Hot 100. Note that alternate names are not handled gracefully: Category:singlechart usages for Denmark and Category:singlechart usages for Danish are separate categories.

另见

• {{Albumchart}} – counterpart of Singlechart but for chart positions for music album releases.