Predefinição:Single chart/doc

Origem: Wikipédia, a enciclopédia livre.
Saltar para a navegação Saltar para a pesquisa

Este modelo é usado para citar fontes na Wikipédia. É especificamente para gravações musicais: singles. Um modelo similar para uso quando citando fontes para álbums musicais pode ser encontrado em {{Albumchart}}; no entanto, para EPs ou outras versões, ainda não foi desenvolvido.

Em geral, o modelo se expande para produzir uma linha da tabela com o país informações, parada musical, referência e melhor posição para o único dado na tabela particular. Tabelas de tais informações são comumente usados ​​em artigos da Wikipedia em singles, álbuns, discografias e artistas.

Esta predefinição não verifica quaisquer posições ou aparências gráficas. Ele primeiramente fornece um URL de referência que acredita-se ser associado com uma fonte fiável para uma tabela reconhecida. A URL de referência em si também não é verificada. Introduzir uma grafia incorreta ou alternativa de um título da canção pode produzir um link ruim, por exemplo. Editores individuais terão de seguir as URLs geradas pela predefinição para verificar sua utilidade antes de dar andamento em um artigo editado.

Uso[editar código-fonte]

Esta predefinição de saída de dados adequada para a inclusão dentro de um tabela de músicas. Ela irá produzir um nome de uma tabela referenciada e uma posição. Ele pode ser usado como uma parte de um quadro ou de uma série de chamadas pode ser utilizado para criar uma tabela. Esta predefinição não cria a marcação na tabela.

Todos os nomes de campo usados devem estar em minúscula.

Você pode copiar uma versão em branco para usar. Lembre-se de usar o caractere "|" (pipe) entre cada campo. Por favor, apague todos os campos não utilizados para evitar a desordem na janela de edição.

O modelo tem a seguinte sintaxe:

Versão completa (copiar e colar texto abaixo e excluir parâmetros que você não precisa)
{{singlechart |(Identificar parada) |(Posição de pico) |canção= |cançãoid= |artista= |artistaid= |tabelaid= |url= |urltítulo= |data= |ano= |semana= |nota= |publicadodata= |acessodata= |refnome= |refgrupo= |rowheader= }}

É uma boa prática incluir sempre "canção=" e "artista=", apesar de alguns usos da predefinição não precisar deles. Isto faz com que seja mais fácil para modificar o modelo, no futuro, se houver uma alteração nos arquivos referenciados pelo modelo. Além disso, o parâmetro artista é utilizado como padrão para citar referências para reutilização em outras partes do artigo.

Campos[editar código-fonte]

Os parâmetros publicadodata, acessodata e refnome são opcional. Se os outros parâmetros são necessários ou não dependerá da tabela a ser referenciado. Veja as tabelas no Suporteabaixo.

  • (Identificar parada) (ou primeiro parâmetro, sem nome): Identificar tabela. Deve ser uma das opções listadas em sob Chart ID nas tabelas do Suporte abaixo. Muitas vezes apontado como um país ou nacionalidade (por exemplo, a Espanha), mas às vezes nomeado para uma tabela específica (por exemplo, Billboardjapanhot100). Algumas tabelas permitem mais do que um identificador; os resultados produzidos são idênticos.
  • (Posição de pico) (ou segundo parâmetro, sem nome): O número que você encontrou para ser a posição de pico alcançada pelo single na tabela específica até a data. Se a música não aparece na tabela (devido a baixa popularidade ou a falta de liberação de um país), você pode inserir um traço (–, não um hífen -). Geralmente, é melhor omitir o modelo completo.
  • canção: Título do single. Palavrinhas, gírias, "hip" grafias, pontuação complicada, etc., podem dificultar esse parâmetro a determinar corretamente. Certifique-se de verificar a URL de referência resultante (Previsão) antes de salvar a versão definitiva do artigo.
  • cançãoid: Identificador numérico usado por algumas listagens gráficas (ver UKchartstats abaixo). Determinado por realizar uma pesquisa no site dos anúncios da tabela para o single (ou artista ou álbum, seguir um link através da página do single). O cançãoid pode ser encontrado no endereço Web (URL) pela inspeção. Por exemplo, a página para "Genie In A Bottle" em www.chartstats.com tem a URL http://www.chartstats.com/songinfo.php?id=27705, portanto, o cançãoid a usar é 27705.
  • artista: Nome do artista do single. Como para o parâmetro canção, grafias estranhas e estilos inteligentes (por exemplo, Ke$ha) podem fazer esse parâmetro difícil de determinar corretamente. A tabela alemã, por exemplo, geralmente requer nomes no formato, sobrenome, nome. Certifique-se de verificar a URL de referência resultante (Previsão) antes de salvar a versão definitiva do artigo. Observe também que este parâmetro é necessário para todos as tabelas onde estão reutilizando as referências utilizando a nomenclatura padrão (ver Saída seção abaixo). Se você usar o parâmetro refnome, no entanto, o artista pode não ser absolutamente necessário.
  • artistaid: Identificador numérico usado por algumas listagens gráficas (ver Paradas da Billboard). Determinado por realizar uma pesquisa no site as listagens de gráfico para a artista (ou single ou álbum, depois seguindo um link para a página através do intérprete). O artistaid pode ser encontrado no endereço da Web (URL) por inspeção. Por exemplo, a página de Eric Clapton em www.billboard.com tem a URL http://www.billboard.com/#/artist/eric-clapton/50403, de modo que o artistaid a usar é 50403.
  • tabelaid: Identificador numérico usado por algumas listagens gráficas (ver Polish Music Charts). Determinado por realizar uma pesquisa no site as listagens gráficas para a carta de arquivamento. A tabelaid pode ser encontrado no endereço da Web (URL) por inspeção. Por exemplo, Polish Airplay Chart de 12 de novembro de 2011 no www.zpav.pl tem a URL http://www.zpav.pl/rankingi/listy/nielsen/top5.php?lang=2&idlisty=532, por isso o tabelaid para usar é 532.
  • url: A URL da referência de onde você encontrou posição de pico da canção para o gráfico. Usado apenas para gráficos particulares (ver tabelas de Suporte), onde não existe um sistema de indexação, não é necessário (ou mesmo usado) para os outros.
  • urltítulo: O título da página para a referência de onde você encontrou posição de pico da canção para o gráfico. Usado em combinação com o parâmetro url, e apenas para gráficos particulares (ver tabelas de Suporte), onde não há sistema de indexação, não é necessário (ou mesmo usado) para os outros.
  • data: Data do gráfico no formato AAAAMMDD, um número de 8 dígitos, indicando o ano (A), mês (M) e dia (D). Usado apenas para alguns quadros (ver Frenchdigital abaixo); não é necessário (ou mesmo usado) para os outros. Esta data é usada somente para criar a URL de referência para o gráfico de download, e não é exibido textualmente na lista de referências. Para citação geral da data de publicação de qualquer carta, use o parâmetro opcional publicadodata.
  • ano: Ano com quatro dígitos que indica o ano que está sendo relatado pelo gráfico. Utilizado em combinação com o parâmetro semana e apenas para alguns gráficos; não é necessário (ou mesmo usado) para os outros. Não necessariamente a mesma que a data de publicação referida por publicadodata.
  • semana: Semana com dois dígitos indicando a semana que está sendo relatado pelo gráfico. Semana é um número de 01 a 53, com um 0 para semana 01-09 (alguns gráficos não exigem a zero; consultar Suporte nas tabelas abaixo). Usado em combinação com o parâmetro ano e apenas para alguns gráficos; não é necessário (ou mesmo usado) para os outros. Não necessariamente relacionadas com a data de publicação referida pelo publicadodata.
  • nota: Para adicionar uma nota sobre uma versão particular de uma canção, por exemplo, nota=mix de dança estendida, ou {{singlechart|Austrália|1|canção=I'm the Urban Spaceman|artista=The Bonzo Dog Doo Dah Band|nota=versão sem censura}}.
  • publicadodata: Data de publicação da referência gerada pelo gráfico, no mesmo formato como outros WP:LDE/NQ em citações no mesmo artigo. Parâmetro opcional.
  • acessodata: Data em que a referência foi gerada pelo gráfico foi acessado para determinar a posição de pico. Devem estar no mesmo formato que as outras datas em citações no mesmo artigo. Parâmetro opcional.
  • refnome: Permite que você especifique um nome para a referência gerada pelo gráfico. Se nenhum valor é fornecido para refnome o nome de referência padrão (sob a forma gs_tid_artista, ver Saída abaixo) será usado. Uma referência a um nome pode ser reutilizada para os créditos em outras partes do artigo. Parâmetro opcional.
  • refgrupo: Permite que você especifique um nome para o grupo de referência. Parâmetro opcional.

Saída[editar código-fonte]

Os resultados da predefinição de expansão em dois itens de saída:

  • uma linha de saída para uma linha da tabela de duas células, e
  • uma referência

A linha de saída inclui o caractere canalizado para dividir o caractere à esquerda da célula para a direita. A célula esquerda inclui o país e/ou o nome do quadro, com wikilinks ao artigo gráfico(s), bem como a nota de referência[n] como se tivesse sido colocado em <ref></ref> tags. Qualquer nota incluída com o parâmetro "nota" é mostrado no lado esquerdo da célula também. A célula à direita contém o número da posição do pico, incluindo o código de centro horizontal do número na célula da tabela.

A citação gerada por esta predefinição vai aparecer na lista <references/> ou na predefinição {{referências}}, como quaisquer outras referências. A referência produzida será dada um nome na forma de "sc_Tabela_artista" pelo padrão, i.e., se o artigo utiliza

{{singlechart|Australia|1|canção=I'm the Urban Spaceman|artista=Bonzo Dog Doo Dah Band|nota=album version}}

em seguida, a citação pode ser usada para apoiar outras considerações sobre a página usando uma referência, tal como

...algum fato, apoiado pela mesma fonte.<ref name="sc_Australia_Bonzo Dog Doo Dah Band"/>

Alternativamente, o nome pode ser substituído usando o parâmetro refnome, i.e.,

{{singlechart|Australia|1|canção=I'm the Urban Spaceman|artista=Bonzo Dog Doo Dah Band|refnome=bonzosinoz}}

que pode então ser usada como uma citação para apoiar outras considerações sobre a página usando uma referência, tal como

...algum fato, apoiado pela mesma fonte.<ref name=bonzosinoz/>

Note que o parâmetro refnome não requer a utilização de aspas, mas os nomes com espaços neles exigirá aspas no parâmetro nome de <ref>(por exemplo, você precisará usar <ref name="bonzos in oz"/> espaços no nome).

Breves exemplos de saída com parâmetros diferentes[editar código-fonte]

Alguns exemplos rápidos de uso do template e a saída correspondente são mostrados aqui. Exemplos mais detalhados com torno código de tabela estão em Exemplos com o layout da tabela na seção abaixo..

Exemplo nº Codificação (assumido dentro de uma linha na tabela) Saída (assumido com <references/> adicionada)
Exemplo 1
{{singlechart
  |Australia
  |18
  |artista=Shakira
  |canção=She Wolf}}
Austrália (ARIA)[1] 18
Exemplo 2
 {{singlechart
  |Billboardcanadianhot100
  |5
  |artista=Shakira
  |artistaid=147604}}
Canadá (Canadian Hot 100)[1] 5
  1. «Shakira Album & Song Chart History» (em inglês). Canadian Hot 100 para Shakira.
Exemplo 3
 {{singlechart
  |Frenchdigital
  |4
  |artista=Shakira
  |canção=She Wolf
  |data=20091017}}
França (Download SNEP)[1] 4
Exemplo 4
 {{singlechart
  |Italy
  |3
  |artista=Shakira
  |canção=Loba
  |nota="Loba" (Versão em Espanhol)}}
|-
{{singlechart
  |Italy
  |11
  |artista=Shakira
  |canção=She Wolf
  |nota="She Wolf" (Versão em Inglês)}}
Itália (FIMI)[1]
"Loba" (Versão em Espanhol)
3
Itália (FIMI)[1]
"She Wolf" (Versão em Inglês)
11
  1. a b «Italiancharts.com – Shakira – Loba» (em inglês). Top Digital Download. Hung Medien. Erro de citação: Código <ref> inválido; o nome "sc_Italy_Shakira" é definido mais de uma vez com conteúdos diferentes
Exemplo 5
{| class="wikitable sortable" border="1"
|-
! Parada (2009)
! Melhor<br />posição
|-
{{singlechart |Flanders|16
  |artista=Shakira |canção=She Wolf}}
|-
{{singlechart |Wallonia|5
  |artista=Shakira |canção=She Wolf}}
|-
|{{BRA}} ([[Billboard Brasil|''Billboard'' Hot 100 Airplay]])
<ref>
"Brazil Hot 100 Airplay".
Billboard Brasil (Brasil: bpp) (2): 79. Novembro de 2009. 
ISSN 977-217605400-2</ref>
| style="text-align:center;"|1
|-
{{singlechart |Hungary|5|ano=2009|semana=14}}
|-
{{singlechart |Ireland|2 |ano=2009 |semana=40}}
|-
{{singlechart |Billboardjapanhot100|9
  |artista=Shakira |artistaid=147604}}
|-
{{singlechart |UKchartstats|4
  |artista=Shakira|canção=She Wolf|cançãoid=34525}}
|}
Parada (2009) Melhor
posição
Bélgica (Ultratop 50 de Flandres)[1] 16
Bélgica (Ultratop 40 da Valônia)[2] 5
 Brasil (Billboard Hot 100 Airplay)[3] 1
Hungria (Rádiós Top 40)[4] 5
Irlanda (IRMA)[5] 2
Polónia (Polish Airplay Top 5)[6] 2
Japão (Japan Hot 100)[7] 9
Reino Unido (UK Singles Chart)[8] 4
  1. «Ultratop.be – Shakira – She Wolf» (em neerlandês). Ultratop 50. Ultratop & Hung Medien / hitparade.ch.
  2. «Ultratop.be – Shakira – She Wolf» (em francês). Ultratop 40. Ultratop & Hung Medien / hitparade.ch.
  3. "Brazil Hot 100 Airplay". Billboard Brasil (Brasil: bpp) (2): 79. Novembro de 2009. ISSN 977-217605400-2
  4. «Archívum – Slágerlisták – MAHASZ» (em húngaro). Rádiós Top 40 játszási lista. Magyar Hanglemezkiadók Szövetsége.
  5. «Chart Track» (em inglês). Irish Singles Chart. GfK.
  6. «Listy bestsellerów, wyróżnienia :: Związek Producentów Audio-Video» (em polonês). Polish Airplay Top 20. ZPAV.
  7. «Shakira Album & Song Chart History» (em inglês). Japan Hot 100 para Shakira.
  8. «Chart Stats – Shakira – She Wolf» (em inglês). UK Singles Chart.

Mensagem de erro[editar código-fonte]

Como auxílio para os usuários do modelo, algumas verificações são feitas para verificar se os parâmetros necessários foram inseridos. (As referências reais não são verificados para se suportar corretamente a posição de pico alegou ou mesmo se a ligação é funcional, mas algumas entradas de parâmetros são verificados quanto à adequação.) Quando um cheque determina que um parâmetro obrigatório está faltando, uma mensagem de erro é gerado em vermelho. Por exemple, se você esquecer a semana ou o ano para a tabela da Hungria, o resultado no artigo será algo como:

Hungria (Rádiós Top 40)CAMPO DE ANO E SEMANA OBRIGATÓRIO PARA PARADA HÚNGARA 19

Este é um incentivo (adicional) para a previsão no artigo antes de salvar suas edições. Verifique a tabela de gráficos, bem como a seção de referências para (tipicamente em vermelho) mensagens de erro.

Suporte[editar código-fonte]

Há um grande número de paradas publicadas pela Billboard e permite uma certa uniformidade na forma como um acessa suas informações. No entanto, há outras paradas e arquivos usados ​​como referência na Wikipédia, produzido por uma multidão de editores, que exigem uma abordagem variada ao procurar posições nas paradas. Abaixo estão duas tabelas, a primeira para tabelas que não são Billboard, o segundo para paradas da Billboard, atualmente suportados pela predefinição {{singlechart}}. Os parâmetros necessários para gerar citações de referência são mostrados em ambos os quadros para cada gráfico suportado.

Tabela ID Nome da parada atual Site utilizado como arquivo Parâmetros requeridos Notas
Australia
Australian
ARIA www.australian-charts.com
  • artista
  • canção
Australiapandora ARIA pandora.nla.gov.au
  • url
  • urltítulo
  • artista*
Esta força o uso do arquivo da Biblioteca Nacional da Austrália para uma posição na tabela australiana. Este é o único método de recuperar posições arquivados acima de 50.
Australiaurban ARIA pandora.nla.gov.au
  • url
  • urltítulo
  • artista*
Esta força o uso do arquivo da Biblioteca Nacional da Austrália para uma posição na tabela australiana. Isto é apenas o arquivo para a tabela Australian Urban.
Austria
Austrian
Ö3 Austria Top 40 www.austriancharts.at
  • artista
  • canção
Belgium (Wallonia)
Wallonia
Ultratop 40 www.ultratop.be
  • artista
  • canção
Adicionar "Tip" depois do nome da tabela (ex: "Wallonia Tip") para referências da Ultratip.
Belgium (Flanders)
Belgium (Vlanders)
Flanders
Vlanders
Ultratop 50 www.ultratop.be
  • artista
  • canção
Adicionar "Tip" depois do nome do gráfico para referências da Ultratip.
Bulgaria
Bulgarian
IFPI @ bamp-br.org www.bamp-br.org
  • url
  • urltítulo
  • artista*
O parâmetro url é validado para apontar para bamp-br.org. O parâmetro urltítulo deve coincidir com o título da página no URL. Infelizmente, o gráfico da Bulgária não pode ser indexados automaticamente.
Czech Republic IFPI @ www.ifpicr.cz www.ifpicr.cz
  • ano
  • semana
  • artista*
Ano e semana indica para o gráfico referenciado. Semana é um número de 01 a 53, com um 0 para semanas 01-09. Um comentário é gerado na referência para mostrar o que deve ser inserido na tabela de pesquisa para produzir o gráfico correto.
Danish
Denmark
Hitlisten www.danishcharts.com
  • artista
  • canção
Quando ano e semana não estão presentes, a forma (exigindo artista e canção) fornecerá uma referência para www.danishcharts.com, que pode variar de posições oficiais para as músicas mais antigas. Evite usar este formulário para posições nas paradas antes de novembro de 2007.
www.hitlisten.nu
  • artista
  • canção
  • semana
  • ano
Parada de single dinamarquesa (incluí antes de novembro de 2007).
Denmark 2007 Hitlisten www.hitlisten.nu
  • artista
  • canção
  • semana
  • ano
Parada de single dinamarquesa (incluí antes de novembro de 2007).
Danish Airplay
Denmark Airplay
Hitlisten www.hitlisten.nu
  • artista
  • canção
  • semana
  • ano
Gráfico oficial de airplay Top 20 dinamarquesa
Dutch100 Mega Single Top 100 www.dutchcharts.nl
  • artista
  • canção
Note que a linha da tabela para este Chart ID irá expandir como "Países Baixos" e podem aparecer incorretamente colocado se você posicioná-lo em "D" em uma tabela ordenada alfabeticamente.
Dutch40 Dutch Top 40 www.top40.nl
  • artista
  • canção
Quando ano e semana não estão presentes, a forma (exigindo artista e canção) irá fornecer uma referência que aponta para uma página de resultados de pesquisa sem posições. Note que a linha da tabela para esse Chart ID irá expandir como "Países Baixos" e podem aparecer incorretamente colocado se você posicioná-lo em "D" em uma tabela ordenada alfabeticamente.
  • ano
  • semana
  • artista*
Ano e semana indica para o gráfico referenciado. semana é um número de 1 a 53, com um 0 para semanas de 1-9.
Note que a linha da tabela para esse ID Gráfico irá expandir como "Países Baixos" e podem aparecer incorretamente colocado se você posicioná-lo em "D" em uma tabela ordenada alfabeticamente.
Finnish
Finland
Musiikkituottajat – IFPI Finland www.finnishcharts.com
  • artista
  • canção
French
France
SNEP www.lescharts.com
  • artista
  • canção
Frenchdigital SNEP www.lescharts.com
  • artista
  • canção
  • data
Esta força para a tabela de download, que não é devolvido em o resumo dos resultados. data é um número de 8 dígitos, YYYYMMDD
German
Germany
Media Control Charts www.musicline.de
  • artista
  • canção
Para artista use o formato de Último, Primeiro.

Para canção às vezes uma nomeação inesperada é necessária, ex: "Bad Romance (2-track)" em vez de simplesmente "Bad Romance".

Germany2 Media Control Charts www.charts.de
  • artista
  • canção
Hungary
Hungarian
Mahasz
(Rádiós Top 40)
www.mahasz.hu
  • artista
  • canção
  • ano
  • semana
Este é o principal, para tabela Top 40 Radio airplay. Um link é gerado para o mapa individual.
Hungarytop10 Mahasz
(Single Top 10)
www.mahasz.hu
  • artista
  • canção
  • ano
  • semana
Um link é gerado para cada tabela individualmente.
Hungarydance Mahasz
(Dance Top 40)
www.mahasz.hu
  • artista
  • canção
  • ano
  • semana
Um link é gerado para cada tabela individualmente.
Ireland
Irish
IRMA www.chart-track.co.uk
  • ano
  • semana
  • artista*
Os valores permitidos para a semana variam de 1 a 53. Um dígito valores não precisam ser precedidos por um 0.
Italian
Italy
FIMI www.italiancharts.com
  • artista
  • canção
New Zealand RIANZ www.charts.org.nz
  • artista
  • canção
Norwegian
Norway
VG-lista www.norwegiancharts.com
  • artista
  • canção
Quando ano e semana não estão presentes, a forma (exigindo artista e canção) fornecerá uma referência indicando para www.norwegiancharts.com.
lista.vg.no/
  • artista
  • canção
  • ano
  • semana
Quando ano e semana não estão presentes, a forma fornecerá uma referência indicando para lista.vg.no/.
Poland Polish Music Charts www.zpav.pl
  • tabelaid
Polishdance Polish Dance Chart www.zpav.pl
  • tabelaid
Scotland Official Charts Company www.officialchartcompany.com
  • data
  • artista
  • canção
Data no formato yyyy-mm-dd
Slovakia
Slovakian
IFPI @ www.ifpicr.cz www.ifpicr.cz
  • ano
  • semana
  • artista*
Ano e semana indica para o gráfico referenciado. Semana é um número de 01 a 53, com um 0 para semana 01-09. Um comentário é gerado na referência para mostrar o que deve ser inserido na tabela de pesquisa para produzir o gráfico correto.
Spain
Spanish
PROMUSICAE www.spanishcharts.com
  • artista
  • canção
Sweden
Swedish
Sverigetopplistan www.swedishcharts.com
  • artista
  • canção
Swiss
Switzerland
Schweizer Hitparade www.swisscharts.com
  • artista
  • canção
UK
United Kingdom
Official Charts Company
Main singles chart
www.theofficialcharts.com
  • data
  • artista
  • canção
Date is formatted yyyy-mm-dd. Due to technical limitations of URL formatting in Wikimedia, the "artist search" facility is not used, and a direct link to the chart is provided. This means that only positions 1-40 can be referenced with this template. For positions 41-100, UKchartstats should be used. This limitation is expected to be removed during 2010.
UKchartstats
UKchartarchive
The Official Charts Company
Main singles chart
www.chartstats.com
www.chartarchive.org
  • artista
  • canção
  • cançãoid
Different archives archive different ranges. For positions 41-100, this archive is generally recommended.
UKdance The Official Charts Company
Dance singles chart
www.theofficialcharts.com
  • data
  • artista
  • canção
Data no formato yyyy-mm-dd
UKdownload The Official Charts Company
Download chart
www.theofficialcharts.com
  • data
  • artista
  • canção
Data no formato yyyy-mm-dd
UKindependent
UKindie
The Official Charts Company
Independent singles chart
www.theofficialcharts.com
  • data
  • artista
  • canção
Data no formato yyyy-mm-dd
UKrandb The Official Charts Company
R&B chart
www.theofficialcharts.com
  • data
  • artista
  • canção
Data no formato 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.

Paradas da Billboard[editar código-fonte]

Billboard charts all require the artist name and an id number. This can be found by looking up the artist on www.billboard.com. For example, searching for Katy Perry on www.billboard.com will lead to http://www.billboard.com/#/artist/katy-perry/958673 . 958673 is the id number for Katy Perry. This is passed through the artistid parameter. For example,

  • {{singlechart|Billboardhot100|1|artist=Katy Perry|artistid=958673}} is the syntax for citing a number 1 position on the Billboard Hot 100 for Katy Perry.
  • Also, the artist id can sometimes retrieved using the {{BillboardID}} template which, given the artist name, returns the id number without searching the website. With this template, instead of writing:
  • {{singlechart|Billboardhot100|1|artist=Katy Perry|artistid=958673}}
We write:
  • {{singlechart|Billboardhot100|1|artist=Katy Perry|artistid={{BillboardID|Katy Perry}}}}
And the template returns the correct id, avoiding errors when writing the number. {{BillboardID}} is fairly incomplete at this time; be sure to check if the template supports the artist before using it.
Chart ID Actual chart name Website used as archive Required parameters Notes
Billboardcanadianhot100
Canada
Canadian Hot 100 www.billboard.com artist
artistid
Billboardeuropeanhot100 European Hot 100 Singles www.billboard.com artist
artistid
Billboardjapanhot100 Japan Hot 100 www.billboard.com artist
artistid
Billboardadultcontemporary Adult Contemporary www.billboard.com artist
artistid
Billboardalternativesongs Alternative Songs www.billboard.com artist
artistid
Billboardhot100 Billboard Hot 100 www.billboard.com artist
artistid
Billboardadultpopsongs Adult Top 40 www.billboard.com artist
artistid
Billboardbubbling100 Bubbling Under Hot 100 Singles www.billboard.com artist
artistid
Billboardcountryairplay Country Airplay www.billboard.com artist
artistid
Billboardcountrysongs Hot Country Songs www.billboard.com artist
artistid
Billboarddanceairplay Dance/Mix Show Airplay www.billboard.com artist
artistid
Billboarddanceclubplay Hot Dance Club Songs www.billboard.com artist
artistid
Billboarddigitalsongs Hot Digital Songs www.billboard.com artist
artistid
Billboardlatinpopsongs Latin Pop Airplay www.billboard.com artist
artistid
Billboardregionalmexican Latin Regional Mexican Airplay www.billboard.com artist
artistid
Billboardlatintropical
Billboardtropicalsongs
Latin Tropical Airplay www.billboard.com artist
artistid
Charts prior to August 2009 are not available on the website. Use Allmusic instead.
Billboardlatinsongs Hot Latin Songs www.billboard.com artist
artistid
Billboardpopsongs Mainstream Top 40 (Pop Songs) www.billboard.com artist
artistid
Billboardrandbhiphop Hot R&B/Hip-Hop Songs www.billboard.com artist
artistid
Billboardradiosongs Hot 100 Airplay (Radio Songs) www.billboard.com artist
artistid
Billboardrapsongs Rap Songs www.billboard.com artist
artistid
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[editar código-fonte]

Example with dummy data[editar código-fonte]

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"
|-
! Parada (ano)
! Melhor<br/>posição
|-
| linha 1, coluna 1
| linha 1, coluna 2
|-
| linha 2, coluna 1
| linha 2, coluna 2
|-
 {{singlechart|Australia|6|canção=I'm the Urban Spaceman|artista=Bonzo Dog Doo Dah Band|nota=Happy Meal edition}}
|-
 {{singlechart|Belgium (Wallonia)|4|canção=I'm the Urban Spaceman|artista=Bonzo Dog Doo Dah Band}}
|}

<references/>

expands into:

Parada Melhor
posição
linha 1, coluna 1 linha 1, coluna 2
linha 2, coluna 1 linha 2, coluna 2
Austrália (ARIA)[1]
Happy Meal edition
6
Bélgica (Ultratop 40 da Valônia)[2] 4

Exemplo com dados realistas[editar código-fonte]

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

{|class="wikitable sortable"
|-
! Parada (2009)
! Melhor<br />posição
|-
{{singlechart|Australia|96|artista=Alicia Keys|canção=Doesn't Mean Anything}}
|-
{{singlechart|Billboardcanadianhot100|66|artista=Alicia Keys|artistaid=433721}}
|-
{{singlechart|Czech Republic|31|artista=Alicia Keys|canção=Doesn't Mean Anything|ano=2010|semana=01}}
|-
{{singlechart|Billboardeuropeanhot100|10|artista=Alicia Keys|artistaid=433721}}
|-
{{singlechart|Germany|8|artista=Keys,Alicia|canção=Doesn't Mean Anything|nota=Angela Merkel rap edition}}
|-
{{singlechart|Billboardjapanhot100|3|artista=Alicia Keys|artistaid=433721}}
|-
{{singlechart|Dutch100|43|artista=Alicia Keys|canção=Doesn't Mean Anything|acessodata=28 de fevereiro de 2010}}
|-
{{singlechart|New Zealand|22|artista=Alicia Keys|canção=Doesn't Mean Anything}}
|-
{{singlechart|Slovakia|31|artista=Alicia Keys|canção=Doesn't Mean Anything|semana=52|ano=2009}}
|-
{{singlechart|UKchartstats|8|artista=Alicia Keys|canção=Doesn't Mean Anything|cançãoid=34669}}
|-
{{singlechart|Billboardhot100|60|artista=Alicia Keys|artistaid=433721}}
|-
{{singlechart|Billboardrandbhiphop|14|artista=Alicia Keys|artistaid=433721}}
|}

<references/>

expands into:

Parada (2009) Melhor
posição
Austrália (ARIA)[1] 96
Canadá (Canadian Hot 100)[2] 66
República Tcheca (Rádio Top 100)[3] 31
Europa (European Hot 100 Singles)[4] 10
Alemanha (Media Control AG)[5]
Angela Merkel rap edition
8
Japão (Japan Hot 100)[6] 3
Países Baixos (Mega Single Top 100)[7] 43
Nova Zelândia (NZ Top 10 Heatseekers)[8] 22
Eslováquia (IFPI)[9] 31
Reino Unido (UK Singles Chart)[10] 8
Estados Unidos (Billboard Hot 100)[11] 60
Estados Unidos (Billboard R&B/Hip-Hop Songs)[12] 14
  1. «Australian-charts.com – Alicia Keys – Doesn't Mean Anything» (em inglês). ARIA Top 50 Singles. Hung Medien.
  2. «Alicia Keys Album & Song Chart History» (em inglês). Canadian Hot 100 para Alicia Keys.
  3. «ČNS IFPI» (em tcheco). Hitparáda – Radio Top 100 Oficiální. IFPI República Checa. Nota: inserir 012010 na pesquisa.
  4. «Alicia Keys Album & Song Chart History» (em inglês). European Hot 100 para Alicia Keys.
  5. «Die ganze Musik im Internet: Charts, News, Neuerscheinungen, Tickets, Genres, Genresuche, Genrelexikon, Künstler-Suche, Musik-Suche, Track-Suche, Ticket-Suche – musicline.de» (em alemão). Media Control Charts. PhonoNet GmbH.
  6. «Alicia Keys Album & Song Chart History» (em inglês). Japan Hot 100 para Alicia Keys.
  7. «Dutchcharts.nl – Alicia Keys – Doesn't Mean Anything» (em neerlandês). Mega Single Top 100. Hung Medien / hitparade.ch. Consultado em 28 de fevereiro de 2010.
  8. «Charts.org.nz – Alicia Keys – Doesn't Mean Anything» (em inglês). Top 40 Singles. Hung Medien.
  9. «SNS IFPI» (em eslovaco). Hitparáda – Radio Top100 Oficiálna. IFPI República Checa. Nota: inserir 200952 na pesquisa.
  10. «Chart Stats – Alicia Keys – Doesn't Mean Anything» (em inglês). UK Singles Chart.
  11. «Alicia Keys Album & Song Chart History» (em inglês). Billboard Hot 100 para Alicia Keys.
  12. «Alicia Keys Album & Song Chart History» (em inglês). Billboard R&B/Hip-Hop Songs para Alicia Keys.

Ver também[editar código-fonte]

  • {{Albumchart}} – contrapartida de Singlechart mas para posições nas paradas de lançamentos de álbuns de música.