Plantilla:Single chart

Documentación de la plantilla

Uso

Esta plantilla se utiliza para citar fuentes, específicamente para sencillos musicales. Actualmente no hay una equivalente para álbumes o EP; sin embargo, una plantilla similar para su uso cuando se citen las fuentes para los álbumes musicales se puede encontrar en {{Albumchart}}. La plantilla se expande generando la fila de una tabla, por lo que es necesario que exista un marco adecuado para la misma o de lo contrario la visualización no será idónea. Ésta proporciona información sobre la ubicación de un sencillo en una determinada lista de algún país en particular, proporcionando la debida referencia.

En general, la plantilla se expande para producir una fila de la tabla con la información de los países, carta ficha, la referencia y la posición del top para el álbum que figura en la carta en particular. Las tablas de dicha información se utilizan comúnmente en los artículos de Wikipedia en sencillos, álbumes, discografías y artistas. La referencia no garantiza siquiera que el sencillo en cuestión aparezca en la lista, se deberá corroborar ingresando a la página externa. Por ello se recomienda hacerlo siempre antes de guardar los cambios. Su función principal es la de proporcionar una fuente fiable.

Recuerde que esta plantilla no se sustituye. La plantilla es compatible con su versión en inglés, pero se recomienda traducirla al español.

Versión completa (copia y pega el texto de abajo y luego elimina los parámetros que no utilices)
{{singlechart | lista | posición |canción= |idcanción= |artista= |idartist= |url= |títulourl= |fecha= [id= |año= |semana= |nota= |fechapublicación= |fechaacceso= |nombreref= |filadestacada= }}

NOTA: Es recomendable incluir siempre los parámetros |canción= y |artista=, a pesar de que en algunos casos no son necesarios. Pues es posible que se produzcan cambios en el sistema organizativo de las páginas externas y esta práctica podría facilitar la adaptación en dichos casos. Los parámetros fechapublicación, fechaacceso y nombreref son opcionales. El resto depende de la lista consultada, según ella se requerirán algunos y otros no.

Parámetros

lista (opcional)

por defecto, el primer parámetro, sin identificador. Indica el país al cual corresponde la lista escogida. De haber más de una lista por país, el valor deberá indicar a cuál hace referencia. Para conocer las posibilidades véase Listas soportadas.

posición (opcional)

por defecto, el segundo parámetro, sin identificador. El número del ranking en el cual aparece el tema musical citado en dicha lista.

canción

Tema musical a referenciar.

idcanción

Algunas listas requieren un identificador que sirve para hallar la canción exacta que se busca referenciar. Cuando esto se requiere es de carácter obligatorio.

artista

Nombre de la banda o solista que interpreta el tema.

idartista

Las lista de Billboard incluyen un enlace a una página estadística del artista, para generarlo es necesario dar el identificador adecuado.

url

En algunas listas no existe un sistema de indexado, por lo cual es necesario especificar la dirección url. Salvo que esto sea necesario, en el resto de las listas este dato puede omitirse.

títulourl

Especifique un título adecuado para aquellas listas que no indexan, pues éste no podrá ser generado automáticamente.

fecha

La lista Francia digital requiere este dato para ofrecer un enlace extra sobre el tema en cuestión. La fecha debe darse como un número de ocho dígitos en formato AAAAAMMDD. No debe confundirse con fechapublicación.

año

El año sobre el cual se consideró para confeccionar dicha lista.

semana

Semana exacta a la que la lista hace referencia. Ésta debe ser un número de dos cifras comprendido entre 01 y 53.

nota

Aclaración que se considere pertinente. Úsese con moderación.

fechapublicación

Fecha de publicación de la lista. Véase Wikipedia:Manual de estilo#Fechas.

fechaacceso

Fecha de acceso a la referencia. Similar al mismo parámetro en {{obra citada}}.

nombreref

Permite especificar un nombre diferente al predeterminado en el enlace externo.

filadestacada

Permite destacar una fila en particular por sobre el resto. Basta con asignarle cualquier valor a este parámetro. Pueden haber tantas filas destacadas como se desee.

Ejemplo

• La plantilla:

{| class="wikitable sortable plainrowheaders col2cen"
|+Posiciones en listas semanales obtenidas por {{esd|«Doesn't Mean Anything»}} (2009)
! scope="col" |Lista
! scope="col" |Mejor<br>posición
|-
{{singlechart|Alemania|8|artista=Keys,Alicia|canción=Doesn't Mean Anything|songid=625466|nota=versión rap por Angela Merkel}}
|-
{{singlechart|Australia|96|artista=Alicia Keys|canción=Doesn't Mean Anything}}
|-
{{singlechart|Canadá|66|artista=Alicia Keys|idartista=278600}}
|-
{{singlechart|Eslovaquia|31|artista=Alicia Keys|canción=Doesn't Mean Anything|semana=52|año=2009}}
|-
{{singlechart|Estados Unidos Billboard Hot 100|60|artista=Alicia Keys|idartista=278600}}
|-
{{singlechart|Estados Unidos hip-hop|14|artista=Alicia Keys|idartista=278600}}
|-
{{singlechart|Irlanda|34|artista=Alicia Keys|canción=Doesn't Mean Anything|año=2009|semana=49}}
|-
{{singlechart|Japón|3|artista=Alicia Keys|idartista=278600}}
|-
{{singlechart|Nueva Zelanda|22|artista=Alicia Keys|canción=Doesn't Mean Anything}}
|-
{{singlechart|Países Bajos Top 100|43|artista=Alicia Keys|canción=Doesn't Mean Anything|fechaacceso=28 de febrero de 2010}}
|-
{{singlechart|Reino Unido|8|artista=Alicia Keys|canción=Doesn't Mean Anything|fecha=20091206|idcanción=34669}}
|-
{{singlechart|República Checa|31|artista=Alicia Keys|canción=Doesn't Mean Anything|año=2010|semana=01}}
|-
{{singlechart|Estados Unidos música europea|10|artista=Alicia Keys|idartista=278600}}
|}
{{listaref}}

• Se visualiza:

Posiciones en listas semanales obtenidas por «Doesn't Mean Anything» (2009)

Lista	Mejor posición
Alemania (Offizielle Deutsche Charts)​ versión rap por Angela Merkel	8
Australia (ARIA)​	96
Canadá (Canadian Hot 100)​	66
Eslovaquia (Singles Digitál Top 100)​	31
EE. UU. (Billboard Hot 100)​	60
EE. UU. (Hot R&B/Hip-Hop Songs)​	14
Irlanda (IRMA)​	34
Japón (Japan Hot 100)​	3
Nueva Zelanda (Recorded Music NZ)​	22
Países Bajos (Mega Single Top 100)​	43
Reino Unido (UK Singles Chart)​	8
República Checa (IFPI)​	31
Unión Europea (European Hot 100)​	10

TemplateData

Esta plantilla se utiliza para citar fuentes, específicamente para sencillos musicales. La plantilla se expande generando la fila de una tabla, por lo que es necesario que exista un marco adecuado para la misma.

Parámetros de la plantilla[Editar los datos de la plantilla]

Es preferible escribir los parámetros en una sola línea.

Parámetro		Descripción	Tipo	Estado
lista	lista 1	El país al cual corresponde la lista escogida. De haber más de una lista por país, el valor deberá indicar a cuál hace referencia. Ejemplo Alemania	Cadena	obligatorio
posición	posición 2	El número del ranking en el cual aparece el tema musical citado en dicha lista. Ejemplo 3	Número	obligatorio
canción	canción song	Tema musical a referenciar. Ejemplo Doesn't Mean Anything	Cadena	sugerido
artista	artista artist	Nombre de la banda o solista que interpreta el tema. Ejemplo Alicia Keys	Cadena	opcional
idartista	idartista artistid	Las listas de Billboard incluyen un enlace a una página estadística del artista, para generarlo es necesario dar el identificador adecuado. Ejemplo 433721	Cadena	opcional
url	url	En algunas listas no existe un sistema de indexado, por lo cual es necesario especificar la dirección url. Salvo que esto sea necesario, en el resto de las listas este dato puede omitirse.	URL	opcional
títulourl	títulourl urltitle	Un título adecuado para aquellas listas que no indexan, pues éste no podrá ser generado automáticamente.	Cadena	opcional
fecha	fecha date	La lista «Francia digital» requiere este dato para ofrecer un enlace extra sobre el tema en cuestión. La fecha debe darse como un número de ocho dígitos en formato AAAAAMMDD. No debe confundirse con «fechapublicación». Ejemplo 20130625	Número	opcional
año	año year	El año sobre el cual se consideró para confeccionar dicha lista. Ejemplo 2006	Número	opcional
semana	semana week	Semana exacta a la que la lista hace referencia. Debe ser un número de dos cifras comprendido entre 01 y 53. Ejemplo 16	Número	opcional
nota	nota note	Aclaración que se considere pertinente.	Cadena	opcional
fechapublicación	fechapublicación publishdate	Fecha de publicación de la lista.	Fecha	opcional
fechaacceso	fechaacceso accessdate	Fecha de acceso a la referencia.	Fecha	opcional
nombreref	nombreref refname	Permite especificar un nombre diferente al predeterminado en el enlace externo.	Cadena	opcional
refgroup	refgroup	Permite especificar un nombre para el grupo de referencia.	Cadena	opcional
id	id	El identificador numérico utilizado por algunos anuncios gráficos. Se puede encontrar en la dirección web (URL) por inspección.	Cadena	opcional
filadestacada	filadestacada rowheader	Permite destacar una fila en particular por sobre el resto. Basta con asignarle cualquier valor.	Wikitexto desequilibrado	opcional

Véase también

• Categoría:Wikipedia:Mantenimiento para la plantilla singlechart
• {{Albumchart}}
• {{Enlace Billboard}}

Esta documentación está transcluida desde Plantilla:Single chart/doc.
Los editores pueden experimentar en la zona de pruebas (crear) y en los casos de prueba (crear) de la plantilla.
Por favor, añade las categorías en la subpágina de documentación. Subpáginas de esta plantilla.