Interested Article - Singlechart

Документация

[ просмотр | править | история | обновить ]

Этот шаблон использует некоторые чрезвычайно сложные и эзотерические свойства языка шаблонов .

Пожалуйста, не пытайтесь изменять его до тех пор, пока:

1. Вы до конца не поймёте, как он устроен.
2. Вы не будете готовы к устранению любых последствий в случае неожиданного результата.

Эксперименты следует проводить в песочнице или вашем личном пространстве .

Шаблон Singleschart взят из английской Википедии для удобства создания и перевода статей о музыкальных релизах (синглы).

При помощи шаблона генерируется таблица музыкальных чартов с указанием чарта, ссылки на релиз, места в чарте; сноска на источник (чарт) появляется в разделе Примечания .

Для облегчённой версии — см {{ singlechart2 }}

В другом языковом разделе есть более полный шаблон (англ.) .

Вы можете помочь проекту, обновив текущий шаблон с помощью перевода

Использование

Шаблон используется для отображения позиции в определённом чарте музыкального сингла, с автоматическим формированием ссылки на источник. Шаблоны должн быть вставлены в таблицу.

Заготовка для копирования (все параметры)
`{{singlechart \|chart= \|peak= \|song= \|songid= \|artist= \|artistid= \|url= \|urltitle= \|date= \|year= \|week= \|note= \|publishdate= \|accessdate= \|refname= \|rowheader=}}` для любых чартов обязательными являются параметры названия чарта и места. Остальные параметры имогут являться обязательными в зависимости от того или иного чарта. Рекомендуется всегда заполнять параметры «song=» и «artist=». Параметр artist используется по умолчанию для именования сноски, если она используется где-то ещё в статье. `rowheader` по умолчанию отображается как `false` . Если поставить `true` , названия чартов будут заголовками.

Fields

The parameters publishdate , accessdate , and refname are optional. Whether the other parameters are required or not depend on the chart being referenced. See the tables in the section below.

chart (or first parameter, without name): Chart identifier. Must be one of the options listed under Chart ID in the tables of the section below. Often named as a country or nationality (e.g., Spain or Spanish), but sometimes named for a specific chart (e.g., Billboardjapanhot100). Some charts allow more than one identifier; the results produced are identical.

peak (or second parameter, without name): The number you found to be the peak postion achieved by the single on the specific chart to date. If the song has not appeared on the chart (due to low popularity or lack of release in a country), you can enter a dash (-, not a hyphen -). Usually, it’s better to omit the template completely.

song : Title of the single. Made-up words, slang, «hip» spellings, tricky punctuation, etc., can make this parameter difficult to correctly determine. Make sure to check the resulting reference URL (Preview) before saving the definitive version of the article.
songid : Numeric identifier used by some chart listings (see UKchartstats below). Determined by performing a search at the chart listings' website for the single (or performer or album, then following a link through to the single’s page). The songid can be found in the Web address (URL) by inspection. For example, the page for «Genie In A Bottle» at www.chartstats.com has the URL , so the songid to use is 27705.
artist : Name of the single’s perfomer. As for the song parameter, odd spellings and clever stylings (e.g., Ke$ha) can make this parameter difficult to correctly determine. The German chart, for example, typically requires names in lastname, firstname format. Make sure to check the resulting reference URL (Preview) before saving the definitive version of the article. Also note that this parameter is required for all charts where you are reusing the references using the default naming (see section below). If you use the refname parameter, however, artist may not be absolutely necessary.
artistid : Numeric identifier used by some chart listings (see ). Determined by performing a search at the chart listings' website for the artist (or single or album, then following a link through to the performer’s page). The artistid can be found in the Web address (URL) by inspection. For example, the page for Eric Clapton at www.billboard.com has the URL , so the artistid to use is 50403.
url : The URL of the reference where you found the song’s peak position for the chart. Used only for particular charts (see Support tables) where there is no indexing system, not necessary (or even used) for others.
urltitle : The title of the page for the reference where you found the song’s peak position for the chart. Used in combination with the url parameter, and only for particular charts (see Support tables) where there is no indexing system, not necessary (or even used) for others.
date : Date of the chart in the format YYYYMMDD, an 8-digit number indicating year (Y), month (M) and day (D). Used only for certain charts (see Frenchdigital below); not necessary (or even used) for others. This date is used solely to create the reference URL to the download chart, and is not displayed textually in the references list. For general citation of any chart’s publication date, use the optional publishdate parameter.
year : Four-digit year indicating the year being reported by the chart. Used in combination with the week parameter and only for certain charts; not necessary (or even used) for others. Not necessarily the same as the publication date referred to by publishdate .
week : Two-digit week indicating the week being reported by the chart. Week is a number from 01 to 53, with a leading 0 for weeks 01-09 (some charts do not require the leading zero; consult tables below). Used in combination with the year parameter and only for certain charts; not necessary (or even used) for others. Not necessarily related to the publication date referred to by publishdate .
note : For adding a note about a particular version of a song, e.g., note=extended dance mix , or {{singlechart|Australia|1|song=I'm the Urban Spaceman|artist=The Bonzo Dog Doo Dah Band|note=uncensored version}} .
publishdate : Date of publication of the reference generated by the template, in the same format as other in citations in the same article. Optional parameter.
accessdate : Date that the reference generated by the template was retrieved to determine peak position. Should be in the same format as other dates in citations in the same article. Optional parameter.
refname : Enables you to specify a name for the reference generated by the template. If no value is provided for refname the default reference name (in the form sc_Chartid_artist, see below) will be used. A reference with a name can be for claims elsewhere in the article. Optional parameter.

Output

The template’s expansion results in two output items:

a row of output for a two-cell table row, and
a reference

The output row includes the piping character to divide the left cell from the right cell. The left cell includes the country and/or chart name, with wikilinks to the chart article(s), as well as the reference note ^[n] as if it were enclosed in <ref></ref> tags. Any note included with the note parameter is shown in the left cell as well. The right cell contains the peak position number, including the code to horizontally center the number in the table cell.

The citation generated by this template will appear in the list in place of <References/> or the {{ reflist }} template, like any other references. The reference produced will be given a name in the form "sc_Chartid_artist" by default, i.e. , if the article uses

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

then the citation could be used to support other statements on the page using a reference as in


         ...some fact supported by the same source.<ref name="sc_Australia_Bonzo Dog Doo Dah Band"/>

Alternatively, the name can be overridden using the refname parameter, i.e. ,

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

which could then be used as a citation to support other statements on the page using a reference as in


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

Note that the refname parameter does not require the use of quotation marks, but names with spaces in them will necessitate quotation marks in the name parameter of <ref> (for example, you would need to use <ref name="bonzos in oz"/> if you used spaces in the name).

Примеры использования

Пример Код Итог (с <references/>)

Пример 1

{{singlechart
  |Australia
  |18
  |artist=Shakira
  |song=She Wolf}}

Австралия ( ARIA )	18

" . ARIA Top 50 Singles .

Пример 2


          {{singlechart
  |Billboardcanadianhot100
  |5
  |artist=Shakira
  |artistid=147604}}

Канада ( Billboard Canadian Hot 100 )	5

. Billboard .

Пример 3


          {{singlechart
  |Frenchdigital
  |4
  |artist=Shakira
  |song=She Wolf
  |date=20091017}}

Франция ( SNEP Téléchargements )	4

" (фр.) . Les classement de telechargement single .

Пример 4


          {{singlechart
  |Italy
  |3
  |artist=Shakira
  |song=Loba
  |note="Loba" (Spanish version)
  |refname="Loba"}}
|-
{{singlechart
  |Italy
  |11
  |artist=Shakira
  |song=She Wolf
  |note="She Wolf" (English version)
  |refname="She Wolf"}}

Италия ( FIMI ) "Loba" (Spanish version)	3
Италия ( FIMI ) "She Wolf" (English version)	11

" . Top Digital Download .
" . Top Digital Download .

Пример 5


         {| class="wikitable sortable" border="1"
|-
! Chart (2009)
! Peak<br>position
|-
{{singlechart |Flanders|16
  |artist=Shakira |song=She Wolf}}
|-
{{singlechart |Wallonia|5
  |artist=Shakira |song=She Wolf}}
|-
|[[Brasil Hot 100 Airplay]]<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 |artistid=147604}}
|-
{{singlechart |UKchartstats|4
  |artist=Shakira|song=She Wolf|songid=34525}}
|}

Chart (2009)	Peak position
Бельгия / Фландрия ( Ultratop 50 )	16
Бельгия / Валлония ( Ultratop 50 )	5
Brasil Hot 100 Airplay	1
Венгрия ( Rádiós Top 40 )	5
Ирландия ( IRMA )	2
Япония ( Billboard Japan Hot 100 )	9
Великобритания ( UK Singles Chart )	4

" (нид.) . Ultratop 50 .
" (фр.) . Ultratop 50 .
«Brazil Hot 100 Airplay» (in Portuguese). Billboard Brasil (Brazil: bpp) (2): 79. November 2009. ISSN 977-217605400-2
" (венг.) . Rádiós Top 40 játszási lista . Magyar Hanglemezkiadók Szövetsége.
" . Irish Singles Chart .
. Billboard .
. Official Charts Company .

Сообщения об ошибках

Сообщения об ошибках будут выглядеть так:

Венгрия ( Rádiós Top 40 ) YEAR AND WEEK MANDATORY FIELDS FOR HUNGARIAN CHARTS	19

Международные чарты

ID чарта	Чарт	Сайт-источник	Необходимые параметры	Примечания
Australia Australian	ARIA	www.australian-charts.com	artist song
Australiapandora	ARIA	pandora.nla.gov.au	url urltitle artist*
Australiaurban	ARIA	pandora.nla.gov.au	url urltitle artist*
Austria Austrian	Ö3 Austria Top 40	www.austriancharts.at	artist song
Belgium (Wallonia) Wallonia	Ultratop	www.ultratop.be	artist song
Belgium (Flanders) Belgium (Vlanders) Flanders Vlanders	Ultratop	www.ultratop.be	artist song
Bulgaria Bulgarian	IFPI at bamp-br.org	www.bamp-br.org	url urltitle artist*	urltitle должен совпадать с заголовком страницы.
CIS	Tophit	www.tophit.ru	artist song songid
Czech Republic	IFPI at www.ifpicr.cz	www.ifpicr.cz	year week artist*	Year и week — необходимые параметры. Week — число 01 to 53, (с 0 для 01-09).
Danish Denmark	Hitlisten	www.danishcharts.com	artist song
Danish Denmark	Hitlisten	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	Dutch Top 40	www.top40.nl	artist song
Dutch40	Dutch Top 40	www.top40.nl	year week artist*	Year и week необходимые параметры. Week — номер от 1 to 53
Finnish Finland	YLE	www.finnishcharts.com	artist song
French France	SNEP	www.lescharts.com	artist song
Frenchdigital	SNEP	www.lescharts.com	artist song date	date — 8-значное число YYYYMMDD
German Germany	Media Control Charts	www.musicline.de	artist song	Для artist — порядок фамилия, имя.
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 to 53.
Italian Italy	FIMI	www.italiancharts.com	artist song
Russia Russian	Tophit	www.tophit.ru	artist song date	date - указывается первая дата природа (дата начала недельного чарта). Дата в формате yyyy-mm-dd (год-месяц-день)
New Zealand	RIANZ	www.charts.org.nz	artist song
Norwegian Norway	VG-lista	www.norwegiancharts.com	artist song	Когда не вводятся параметры year и week , (требуются artist и song ) ссылка будет вести на www.norwegiancharts.com.
Norwegian Norway	VG-lista	lista.vg.no/	artist song week year	Когда вводятся параметры year и week , ссылка будет вести на lista.vg.no/.
Scotland	Official Charts Company	www.officialchartcompany.com	date artist song	Дата в формате yyyy-mm-dd
Slovakia Slovakian	IFPI at www.ifpicr.cz	www.ifpicr.cz	year week artist*	Year и week — год и неделя определяются по тому году, когда песня вошла в чарт. Week — число от 01 до 53, (с добавлением 0 для 01-09). Неделя необходима для показа нужного чарта.
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
Ukraine Ukrainian	Tophit	www.tophit.ru	artist song date	date - указывается первая дата природа (дата начала недельного чарта). Дата в формате yyyy-mm-dd (год-месяц-день)
UK United Kingdom	Official Charts Company Main singles chart	www.officialchartcompany.com	date artist song	Дата в формате yyyy-mm-dd. Из-з ограничений движка Wikimedia, опция «artist search» не может быть использована. Таким образом можно указать позиции 1-40, для 41-100 следует использоать UKchartstats.
UKchartstats	Official Charts Company Main singles chart	www.chartstats.com	artist song songid
UKdance	Official Charts Company Dance singles chart	www.officialchartcompany.com	date artist song	Дата в формате yyyy-mm-dd
UKdownload	Official Charts Company Download chart	www.officialchartcompany.com	date artist song	Дата в формате yyyy-mm-dd
UKindependent UKindie	Official Charts Company Independent singles chart	www.officialchartcompany.com	date artist song	Дата в формате yyyy-mm-dd
UKrandb	Official Charts Company R&B chart	www.officialchartcompany.com	date artist song	Дата в формате yyyy-mm-dd
Другие международные чарты не поддерживаются шаблоном {{ singlechart }} и источники придётся добавлять вручную (см. Бразильский чарт из примера выше). * Параметр artist нужен для оформления сносок. Можно использовать refname , для того, чтобы использовать этот источник в нескольких местах. Использование параметров song и title настоятельно рекомендуется.

Чарты Billboard

Billboard требуют имя музыканта или название группы и id. Эти данные можно найти через поиск на www.billboard.com. Например Katy Perry на www.billboard.com — . 958673 — id Katy Perry. Это и есть параметр artistid в шаблоне. Например,

{{ singlechart | Billboardhot100 | 1 | artist=Katy Perry | artistid=958673 }} ставит Кэти Перри на 1 место чарта Billboard Hot 100.

ID чарта	Чарт	Сайт-источник	Необходимые параметры	Примечания
Billboardcanadianhot100 Canada	Canadian Hot 100	www.billboard.com	artist
Billboardeuropeanhot100	European Hot 100 Singles	www.billboard.com	artist
Billboardjapanhot100	Japan Hot 100	www.billboard.com	artist
Billboardadultcontemporary	Adult Contemporary	www.billboard.com	artist
Billboardalternativesongs	Alternative Songs	www.billboard.com	artist
Billboardhot100	Billboard Hot 100	www.billboard.com	artist
Billboardadultpopsongs	Adult Top 40	www.billboard.com	artist
Billboardcountrysongs	Hot Country Songs	www.billboard.com	artist
Billboarddanceclubplay	Hot Dance Club Songs	www.billboard.com	artist
Billboarddigitalsongs	Hot Digital Songs	www.billboard.com	artist
Billboardlatinpopsongs	Latin Pop Airplay	www.billboard.com	artist
Billboardregionalmexican	Latin Regional Mexican Airplay	www.billboard.com	artist
Billboardlatintropical Billboardtropicalsongs	Latin Tropical Airplay	www.billboard.com	artist	До 2009 чартов нет, см. Allmusic .
Billboardlatinsongs	Hot Latin Songs	www.billboard.com	artist
Billboardpopsongs	Mainstream Top 40 (Pop Songs)	www.billboard.com	artist
Billboardrandbhiphop	Hot R&B/Hip-Hop Songs	www.billboard.com	artist
Billboardradiosongs	Hot 100 Airplay	www.billboard.com	artist
Billboardrapsongs	Rap Songs	www.billboard.com	artist
Другие чарты Billboard пока не включены в {{ singlechart }} и источники придётся добавлять вручную (см. Бразильский чарт из примера выше).

Примеры таблиц чартов

Таблицы с другими данными

Пример таблицы с добавлением {{ singlechart }} :

{| class="wikitable sortable" border="1"
|-
! Чарт
! Позиция
|-
| 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/>

будет выглядеть как:

Чарт	Позиция
row 1, cell 1	row 1, cell 2
row 2, cell 1	row 2, cell 2
Австралия ( ARIA ) Happy Meal edition	6
Бельгия / Валлония ( Ultratop 50 )	4

" . ARIA Top 50 Singles .
" (фр.) . Ultratop 50 .

Пример с реальными данными

Пример взят из статьи « » (песня Алишии Кис).

{|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|artistid=433721}}
|-
{{singlechart|Czech Republic|31|artist=Alicia Keys|song=Doesn't Mean Anything|year=2010|week=01}}
|-
{{singlechart|Billboardeuropeanhot100|10|artist=Alicia Keys|artistid=433721}}
|-
{{singlechart|Germany|8|artist=Keys,Alicia|song=Doesn't Mean Anything|note=Angela Merkel rap edition}}
|-
{{singlechart|Billboardjapanhot100|3|artist=Alicia Keys|artistid=433721}}
|-
{{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|artistid=433721}}
|-
{{singlechart|Billboardrandbhiphop|14|artist=Alicia Keys|artistid=433721}}
|}

<references/>

будет выглядеть как:

Чарт (2009)	Лучший результат
Австралия ( ARIA )	96
Канада ( Billboard Canadian Hot 100 )	66
Чехия ( Rádio Top 100 )	31
Европа ( Billboard European Hot 100 Singles )	10
Германия ( GfK ) Angela Merkel rap edition	8
Япония ( Billboard Japan Hot 100 )	3
Нидерланды ( Single Top 100 )	43
Новая Зеландия ( Recorded Music NZ )	22
Словакия ( Rádio Top 100 )	31
Великобритания ( UK Singles Chart )	8
США ( Billboard Hot 100 )	60
США ( Billboard Hot R&B/Hip-Hop Songs )	14

" . ARIA Top 50 Singles .
. Billboard .
" (чешск.) . Hitparáda – Radio Top 100 Oficiální. IFPI Czech Republic. Note: Change the chart to CZ – RADIO – TOP 100 and insert 201001 into search .
European Hot 100 for Alicia Keys.
" (нем.) . Media Control Charts . PhonoNet GmbH.
. Billboard .
" (нид.) . Single Top 100 . Проверено 2010-02-28.
" . Top 40 Singles .
" (in Slovak). Hitparáda – Radio Top 100 Oficiálna. IFPI Czech Republic. Note: insert 200952 into search .
. Official Charts Company .
. Billboard .
. Billboard .

TemplateData

Нет описания.

Параметры шаблона [ ]

Шаблон использует строчное форматирование параметров.
Параметр		Описание	Тип	Статус
1	`1`	без описания	Неизвестно	необязательный
2	`2`	без описания	Неизвестно	необязательный
rowheader	`rowheader`	без описания	Неизвестно	необязательный
artist	`artist`	без описания	Неизвестно	необязательный
publish-date	`publish-date`	без описания	Неизвестно	необязательный
publishdate	`publishdate`	без описания	Неизвестно	необязательный
access-date	`access-date`	без описания	Неизвестно	необязательный
accessdate	`accessdate`	без описания	Неизвестно	необязательный
refname	`refname`	без описания	Неизвестно	необязательный
refgroup	`refgroup`	без описания	Неизвестно	необязательный
note	`note`	без описания	Неизвестно	необязательный
song	`song`	без описания	Неизвестно	необязательный
url	`url`	без описания	Неизвестно	необязательный
urltitle	`urltitle`	без описания	Неизвестно	необязательный
page	`page`	без описания	Неизвестно	необязательный
chartid	`chartid`	без описания	Неизвестно	необязательный
songid	`songid`	без описания	Неизвестно	необязательный
year	`year`	без описания	Неизвестно	необязательный
week	`week`	без описания	Неизвестно	необязательный
date	`date`	без описания	Неизвестно	необязательный
archivedate	`archivedate`	без описания	Неизвестно	необязательный
archiveurl	`archiveurl`	без описания	Неизвестно	необязательный
artistid	`artistid`	без описания	Неизвестно	необязательный
id	`id`	без описания	Неизвестно	необязательный
forceartist	`forceartist`	без описания	Неизвестно	необязательный