imported>Comrade John：修飾語句

2024-09-04T14:46:36Z

修飾語句

新页面

{{noteTA
|G1=Music
}}
{{documentation subpage}}
<includeonly>{{intricate}}</includeonly>

本模板可以使編輯者在建立[[單曲]]的排行榜時，依照特定的格式[[維基百科:列明來源|列明來源]]。如要建立[[專輯]]專用的排行榜則可以使用另一個相似的模板{{tl|Album chart}}。

使用此模板可以生成一個包括國家及其使用的排行榜、來源、排行榜最高名次等資訊的表格資料，編輯者可以使用此模板產生的資料創建條目裡需要的排行榜名次的表格，詳細使用方法可以見下面的使用說明。

此模板'''並不能'''驗証單曲是否出現在排行榜上、及所在的最高名次，它只是讓為了創建排行榜名次的表格時可以有[[維基百科:可靠來源|可靠的來源]]。模板所提供的來源資料也'''不會'''自動檢查可用性，未依指定格式使用模板可能會產生一個無法使用的來源。在使用該模板之前，編輯者應該先自行確認該模板的資料及連結無誤再儲存條目。

== 使用方法及參數 ==
{| class="wikitable" style="width: 96%"
! 完整模板
|-
|
:<syntaxhighlight lang="text">{{singlechart |(Chart identifier) |(Peak position) |song= |artist= |chartid= |url= |urltitle= |date= |year= |week= |note= |publishdate= |accessdate= |refname= |refgroup= |rowheader=}}</syntaxhighlight>
|-
|}

;參數
所有的參數除了''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'''：用於標示歌曲特定的版本，用法如<code>note=extended dance mix</code>或<code><nowiki>{{singlechart|Australia|1|song=I'm the Urban Spaceman|artist=The Bonzo Dog Doo Dah Band|note=uncensored version}}</nowiki></code>。
* '''publishdate'''：排行榜公佈的日期，用於附註在參考資料中，建議使用ISO 8601的格式YYYY-MM-DD。
* '''accessdate'''：存取日期，用於附註在參考資料中，建議使用ISO 8601的格式YYYY-MM-DD。
* '''refname'''：用法同<code><nowiki><ref name="name"></nowiki></code>，使參考料資一次可以附註多次於條目中，使用方法請見[[Help:脚注#多處標明同一項註腳]]。
* '''refgroup'''：用法同<code><nowiki><ref group="xxx"></nowiki></code>，用於分組參考資料，使用方法請見[[Help:脚注#把註腳分組]]。

== 模板数据 ==
<templatedata>
{
"description": "Creates a table row for a recognized single chart ",
"params":
{
"1":
{
"label": "Chart identifier",
"description": "Chart name: recognized values are listed at Template:Singlechart/doc",
"type": "string",
"required": true
},
"2":
{
"label": "Chart position",
"description": "peak position on the chart",
"type": "number",
"required": true
},
"artist":
{
"label": "artist",
"description": "artist name as listed on the source chart",
"type": "string",
"required": true
},
"song":
{
"label": "song",
"description": "song title as listed on the source chart",
"type": "string",
"required": true
},
"refname":
{
"label": "reference name",
"description": "Names the reference created by the template so that it may be used other places in the article",
"type": "string",
"required": true
},
"chartnote":
{
"label": "Notes",
"description": "Any special notes about this version here. Typically used to distinguish versions , i.e. 'reggae mix' vs. 'dubsteb version'",
"type": "string",
"required": false
},
"year":
{
"label": "year",
"description": "year chart position occurred, required for Czech Republic, all Hungarian charts, Ireland, Israeliairplay",
"type": "number",
"required": false
},
"week":
{
"label": "week",
"description": "week number (1-53) required for Czech Republic, all Hungarian charts, Ireland, Israeliairplay",
"type": "number",
"required": false
},
"url":
{
"label": "URL",
"description": "required for Bulgarian charts (must be from www.bamp-bg.org) and for Australiapandora (must be from pandora.nla.gov.au) ",
"type": "number",
"required": false
},
"date":
{
"label": "date",
"description": "date of chart. Required for Frenchdigital (format yyyymmdd with no spaces) or any UK chart (format yyyy-mm-dd )",
"type": "number",
"required": false
},
"accessdate":
{
"label": "access date",
"description": "Free format date showing when this information was verified",
"type": "string",
"required": false
},
"rowheader":
{
"label": "Row header control",
"description": "when set to true, the chart name will be treated as a row header",
"type": "string",
"required": false
}
}
}
</templatedata>

== 輸出 ==
此模板展開後會輸出一個有兩列資料的表格及一個參考資料。左列的資料標示排行榜的國家及／或排行榜的名稱，附有夾注在<code><nowiki><ref></ref></nowiki></code>標籤內的參考[n]，如果有使用到''note''參數則會出現在左列的下方；右列則列出歌曲在榜中的最高名次，在表格內置中。

參考資料如其他的參考一樣會陳列在條目中<code><nowiki><references /></nowiki></code>或{{tlc|reflist}}模板處。除非有另外指定，模板會自動為參考資料標注名為<code><nowiki>"sc_Chartid_artist"</nowiki></code>的參考資料，如：假設條目中使用以下模板
::{{tlc|singlechart|Australia|1|4=song=I'm the Urban Spaceman|5=artist=Bonzo Dog Doo Dah Band|6=note=album version}}

則在條目中的別處可利用下列語法使用該模板產生的參考資料
::<code><nowiki>……有些事實來自同樣的來源。<ref name="sc_Australia_Bonzo Dog Doo Dah Band"/></nowiki></code>

當然有些參考資料可以使用自己的refname
::{{tlc|singlechart|Australia|1|4=song=I'm the Urban Spaceman|5=artist=Bonzo Dog Doo Dah Band|6=refname=bonzosinoz}}

在這種情況要引用該參考資料用自定的refname即可
::<code><nowiki>...some fact supported by the same source.<ref name=bonzosinoz/></nowiki></code>

=== 範例 ===
這裡列出幾個使用此模板的範例，如要像範例五以完整的表格列出可參考下面章節[[#使用完整表格列出的範例|使用完整表格列出的範例]]。

{| class="wikitable" style="width: 96%"
! 範例 || 代碼（假設已經在表格內） || 輸出（假設下面已加有<nowiki><references /></nowiki>標籤）
|-
! 範例1
| style="width: 40%; vertical-align: top;" |
<code><pre><nowiki>{{singlechart
|Australia
|18
|artist=Shakira
|song=She Wolf}}</nowiki></pre></code>
| style="width: 50%; vertical-align: top;" |
{| class="wikitable" 
|-
{{singlechart |Australia|18 |artist=Shakira |song=She Wolf}}
|}
<references />

|-
! 範例2
| style="vertical-align: top;" |<code><pre><nowiki> {{singlechart
|Billboardcanadianhot100
|5
|artist=Shakira}}</nowiki></pre></code>
| style="vertical-align: top;" |
{| class="wikitable" 
|-
{{singlechart |Billboardcanadianhot100|5 |artist=Shakira}}
|}
<references />

|-
! 範例3
| style="vertical-align: top;" |<code><pre><nowiki> {{singlechart
|Frenchdigital
|4
|artist=Shakira
|song=She Wolf
|date=20091017}}</nowiki></pre></code>
| style="vertical-align: top;" |
{| class="wikitable" 
|-
{{singlechart|Frenchdigital|4|artist=Shakira|song=She Wolf|date=20091017}}
|}
<references />

|-
! 範例4
| style="vertical-align: top;" |<code><pre><nowiki> {{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}}
</nowiki></pre></code>
| style="vertical-align: top;" |
{| class="wikitable" 
|-
{{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}}
|}
<references />

|-
! 範例5
| style="vertical-align: top;" |<code><pre><nowiki>
{| class="wikitable sortable"
|-
! 排行榜（2009）
! 最高 名次
|-
{{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}}
|}</nowiki></pre></code>
| style="vertical-align: top;" |
{| class="wikitable sortable"
|-
! 排行榜（2009）
! 最高 名次
|-
{{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}}
|}
<references />
|}

=== 錯誤訊息 ===
如果使用不正確的方式引用該模板，模板會自動跑出紅色的錯誤訊息以警告編輯者。舉例來說，如果你在使用''Hungary''排行榜時忘記填入兩個該榜的必填參數''week''或''year''，模板展開來後會像這樣：
::{| class="wikitable"
|-
{{singlechart|Germany|9}}
|}

編輯完後可先利用顯示預覽來查看條目中此模板是否出現像這樣的錯誤訊息，避免未修正就儲存的情況。

== 使用方法 ==
除了《[[告示牌 (雜誌)|告示牌]]》提供的數個排行榜外，此模板也支援許多《告示牌》以外的排行榜。以下兩個表格分別列出此模板支援的非《告示牌》及《告示牌》排行榜。

=== 非《告示牌》排行榜 ===

{| class="wikitable"
! 排行榜ID
! 排行榜名稱
! 來源網站
! 必填參數
! 附註
|-
| Australia、Australian -{澳大利亞}-、-{澳大利亚}-、-{澳洲}-
|[[澳大利亚唱片业协会榜|ARIA]]
| www.australian-charts.com
| artist song
|
|-
| Australiapandora
| [[澳大利亚唱片业协会榜|ARIA]]
| pandora.nla.gov.au
| url urltitle artist*
| 此為[[澳洲國家圖書館]]所做的存檔，僅支援排行榜前50名的單曲。
|-
| Australiaurban
| [[ARIA Charts|ARIA]]
| pandora.nla.gov.au
| url urltitle artist*
| 此為[[澳洲國家圖書館]]所做的存檔，僅支援澳洲都會排行榜的單曲。
|-
| Austria、Austrian -{奧地利}-、-{奥地利}-
| [[奧地利Ö3四十強音樂榜]]
| www.austriancharts.at
| artist song
|
|-
| Belgium (Wallonia) Wallonia -{瓦隆}-、-{華隆}-
| [[Ultratop榜|Ultratop 50]]
| www.ultratop.be
| artist song
|
|-
| Belgium (Flanders) Flanders Belgium (Vlanders) Vlanders -{法蘭德斯}-、-{佛兰德}-、-{佛兰德斯}-
| [[Ultratop榜|Ultratop 50]]
| www.ultratop.be
| artist song
|
|-
| Bulgaria、Bulgarian -{保加利亞}-、-{保加利亚}-
| [[IFPI]] at bamp-br.org
| www.bamp-br.org
| url urltitle artist*
|
|-
| Canadaadultcontemporary
| [[RPM (雜誌)|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 (雜誌)|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 (雜誌)|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 捷克
| [[IFPI|ČNS IFPI]] (Rádio Top 100)
| rowspan="2"| www.ifpicr.cz
| rowspan="2"| year week artist*
| rowspan="2"| ''year''與''week''於來源中尋找。''week''是由01至53的兩位數字，01至09前的0不可省略。僅支援2006年1月以後的排行榜。
|-
| Czechdigital
| [[IFPI|ČNS IFPI]] (Singles Digitál Top 100)
|-
| rowspan="2"| Danish Denmark -{丹麥}- -{丹麦}-
| rowspan="2"| [[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
|
|-
| rowspan="2"| Dutch40 -{荷蘭40強單曲}- -{荷兰40强单曲}-
| rowspan="2"| [[荷蘭四十強單曲榜]]
| rowspan="2"| 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
| rowspan=2| 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 -{德國}-、-{德国}-
| [[GfK娱乐榜单|媒體控制榜]]
| www.musicline.de
| artist
| ''artist''參數請填Last,First（即名,姓）格式。
|-
| German2、Germany2 -{德國2}-、-{德国2}- 西德、West German
| [[GfK娱乐榜单|媒體控制榜]]
| 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 斯洛伐克
| [[IFPI|ČNS IFPI]] (Rádio Top 100)
| rowspan="2"| www.ifpicr.cz
| rowspan="2"| year week artist*
| rowspan="2"| ''week''是由01至53的兩位數字，01至09前的0不可省略。僅支援2006年1月以後的排行榜。
|-
| Slovakdigital
| [[IFPI|Č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 <s>UKchartstats UKchartarchive</s>
| [[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
|-
| colspan="5"| Other non-''Billboard'' charts are not currently supported by {{tlc|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 [[WP:BADCHARTS|deprecated charts]].
<nowiki>*</nowiki> These charts require the ''artist'' parameter solely for the purposes of internal reference naming using the default format (see [[#Output|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.
|}

=== 《告示牌》排行榜 ===
{| class="wikitable"
! 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|''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
|[[Hot 100 Airplay (Radio Songs)|Radio Songs]]
|www.billboard.com
|artist
|
|-
|Billboardchristiansongs
|[[Hot Christian Songs]]
|www.billboard.com
|artist
|
|-
|Billboardcountrysongs
|[[Hot Country Songs]]
|www.billboard.com
|artist
|
|-
|Billboarddanceelectronic
|[[Dance/Electronic Songs|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 (chart)|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 Airplay|Latin Pop Songs]]
|www.billboard.com
|artist
|
|-
|Billboardmainstreamrock
|[[Mainstream Rock (chart)|Mainstream Rock]]
|www.billboard.com
|artist
|
|-
|Billboardpopsongs
|[[Mainstream Top 40]]
|www.billboard.com
|artist
|
|-
|Billboardrandbhiphopairplay
|[[Hot R&B/Hip-Hop Airplay|R&B/Hip-Hop Airplay]]
|www.billboard.com
|artist
|
|-
|Billboardregionalmexican
|[[Regional Mexican Airplay]]
|www.billboard.com
|artist
|
|-
|Billboardrhythmic
|[[Rhythmic (chart)|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
|
|-
|colspan="5"|Other ''Billboard'' charts are not currently supported by {{tlc|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 [[WP:BADCHARTS|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:

<pre>{| 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}}
|}</pre>

expands into:

{| 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}}
|}
<references />

===Example with realistic data===
This example is excerpted from actual usage at [[Doesn't Mean Anything]], with a couple of minor additions.
<pre>{|class="wikitable sortable"
|-
!Chart (2009)
!Peak 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}}
|}</pre>

expands into:

{|class="wikitable sortable"
|-
!Chart (2009)
!Peak 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}}
|}<references />

==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但缺少必要參數的頁面===
{{cl|使用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. {{cl|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: {{cl|singlechart usages for Denmark}} and {{cl|singlechart usages for Danish}} are separate categories.

==另见==
* {{tl|Albumchart}} – counterpart of ''Singlechart'' but for chart positions for music album releases.

Template:Single chart/doc - 版本历史

imported>Comrade John：​修飾語句

imported>Comrade John：修飾語句