Template: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
美国（Billboard Hot 100）	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.