Plantilla:Albumchart/doc

Esta plantilla se utiliza para referencias en Wikipedia, específicamente para álbumes (véase Wikipedia:Verificabilidad). Una plantilla similar para su uso cuando se citen las fuentes para los [sencillos musicales se puede encontrar en {{Singlechart}}; sin embargo, para los EPs u otras liberaciones, aún no se ha desarrollado una plantilla.

En general, la plantilla se expande para producir una fila de la tabla con la información de los países, 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.

Esta plantilla no verifica ninguna posición o apariencia de la tabla. Se proporciona principalmente una URL de referencia donde se cree que está asociada con una fuente confiable para un gráfico reconocido.

NOTA

La introducción de ortografía incorrecta o alternativa de un título del álbum puede producir un mal vínculo, por lo que usuarios editores deberán seguir las URLs generadas por la plantilla para verificar su utilidad antes de alejarse en algún artículo.

Uso

Después, los parámetros más comunes empleados en la plantilla:

{{albumchart|(Identificación de gráfica)|(Pico de posición)|artist=|album=|refname=|fechaacceso=30 de mayo de 2012}}

Después, los parámetros para cualquier gráfico Billboard:

{{albumchart|Billboard(Identificación especificada)|(Pico de posición)|artista=|artistaid=|refname=|fechaacceso=30 de mayo de 2012}}

Después, los parámetros para cualquier lista del Reino Unido (excepto para los parámetros principales del Reino Unido, UKChartStats y UKZobble):

{{albumchart|UK(Identificación especificada)|(Pico de posición)|artista=|fecha=YYYY-MM-DD|refname=|fechaacceso=30 de mayo de 2012}}

{{albumchart|Billboard(Identificación especificada)|(Pico de posición)|artista=|artistaid=}}

Referencias manuales

En las siguientes circunstancias se plantean:

1. El nombre del álbum contiene caracteres especiales que el campo álbum= no maneja correctamente y devuelve un error url.
2. Cuando la plantilla se ha de utilizar para las cartas de fin de año en lugar de los gráficos semanales.
3. Cuando la posición de la carta se recupera de una fuente que no sea la predeterminada por {{albumchart}} como los Gráficos del Billboard o Allmusic (recordemos que todas las fuentes deben ser confiables).

Entonces podría ser necesaria una referencia manual. Cuando se activa la referencia manual, el usuario debe proporcionar la información correspondiente en el campo url= y el título=, y puede, además, proporcionar la información para los campos trabajo=, página=, fecha=, ubicación= y editor=, al igual que en la plantilla: {{cita noticias}}, añadiendo una fuente diferente a la utilizada por {{albumchart}}.

Listas de éxitos	Pico de posición
Australia (ARIA)​	1

Parámetros

NOTA: Solo los parámetros fechapublicación, fechaacceso, refnombre y refgroup son opcionales.

Versión
{{albumchart|lista=|posición=|artista=|idartist=}}

• (Lista) (o el primer parámetro, sin nombre): identificador del gráfico. Debe ser una de las opciones enumeradas en tabla de ID en las tablas de la Ayuda en la sección de abajo. A menudo llamado como un país o nacionalidad (por ejemplo, España o español), pero a veces es el nombre de un gráfico específico (por ejemplo, BillboardJapanHot100). Algunas cartas permiten más de un identificador; los resultados producidos son identicos.
• (Posición) por defecto, el segundo parámetro, no tiene identificador. El número del ranking en el cual aparece el tema musical citado en dicha lista.
• álbum: Título del álbum.
• dvd: Para DVDs musicales, el título del álbum. Algunas listas de música de DVD tienen que estar provistas en este campo en lugar del parámetro album para que funcione correctamente.
• artista: Nombre de la banda o solista que interpreta el tema musical.
• artistid: identificador numérico utilizado por algunos anuncios gráficos (ver Billboard gráficos). Determinado por la realización de una búsqueda en el sitio web de los anuncios gráficos para el artista (o el álbum o sencillo, entonces sigue un enlace a través de la página del artista). El ArtistID se puede encontrar en la dirección web (URL) por inspección. Por ejemplo: la página de Eric Clapton en www.billboard.com tiene la URL http://www.billboard.com/#/artist/eric-clapton/50403.
• id: El identificador numérico utilizado por algunos anuncios gráficos (ver Gráficos Música polaca). Determinado por la realización de una búsqueda en el sitio web de los anuncios gráficos para la carta de archivo. El ChartID se puede encontrar en la dirección web (URL) por inspección. Por ejemplo: la carta polaca Airplay del 12 de noviembre de 2011 en www.zpav.pl tiene la URL http://www.zpav.pl/rankingi/listy/nielsen/top5.php?lang=2&idlisty=532, por lo que el ChartID a utilizar es 532.
• url: La URL de la referencia donde se encuentra el top de posición de la canción en la gráfica.
• títulourl: Especifique un título adecuado para aquellas listas que no se indexan, pues éste no podrá ser generado automáticamente.
• fecha: Fecha de la gráfica con el formato AAAAMMDD, un número de 8 dígitos que indica el año (Y), el mes (M) y el día (D).
• año: El año sobre el cual se consideró confeccionar dicha lista.
• semana: Semana exacta a la que hace referencia la lista. É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.
• fechaacceso: Fecha de acceso a la referencia. Similar al mismo parámetro en  ..
• refnombre: Permite especificar un nombre diferente al predeterminado en el enlace externo.
• refgroup: Permite especificar un nombre para el grupo de referencia.

Ejemplos con diseño de la tabla

Esta plantilla solo produce filas individuales dentro de una tabla, tendrá que añadir (o si lo ya tiene) el marco de la mesa en el artículo. Aquí hay algunos ejemplos con su correspondiente demostración:

• La plantilla:

{| class="wikitable sortable" border="1"
|-
! Chart
! Pico de posición
|-
| fila 1, celda 1
| fila 1, celda 2
|-
| fila 2, celda 1
| fila 2, celda 2
|-
 {{albumchart|Billboard200|2|artist=Paramore|artistid=683820}}
|-
 {{albumchart|BillboardRock|1|artist=Paramore|artistid=683820}}
|}
{{reflist}}

• Se vería así:

Chart	Pico de posición
fila 1, celda 1	fila 1, celda 2
fila 2, celda 1	fila 2, celda 2
Estados Unidos (Billboard 200)​	2
Estados Unidos (Billboard Top Rock Albums)​	1

Ejemplo con más datos

• La plantilla:

{| class="wikitable sortable plainrowheaders"
|-
! Gráficas (1997)
! Pico de posición
|-
|{{Album chart|Australia|37|artista=Daft Punk|album=Homework|refname=ARIA|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Noruega|40|artista=Daft Punk|album=Homework|refname=HungM|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Nueva Zelanda|8|artista=Daft Punk|album=Homework|refname=HungM2|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Países Baj9s|25|artista=Daft Punk|album=Homework|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Austria|34|artista=Daft Punk|album=Homework|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Flanders|7|artista=Daft Punk|album=Homework|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Wallonia|9|artista=Daft Punk|album=Homework|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|BillboardCanada|15|artista=Daft Punk|artistid=141900|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Finlandia|34|artista=Daft Punk|album=Homework|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Francia|3|refname=FAC|artista=Daft Punk|album=Homework|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Suecia|16|artista=Daft Punk|album=Homework|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Reino Unido|8|artista=Daft Punk|album=Homework|fechaacceso=30 de mayo de 2012}}
|-
|{{Album chart|Billboard200|150|artista=Daft Punk|artistid=141900|fechaacceso=30 de mayo de 2012}}
|-
|}
{{reflist}}

• Se vería así:

Gráfica(1997)	Pico de posición
Australia (ARIA)​	37
Noruega Noruega (VG-lista)​	40
Nueva ZelandaNueva Zelanda (Recorded Music NZ)​	8
Países Bajos (Album Top 100)​	25
Austria (Ö3 Austria Top 40)​	34
Bélgica (Ultratop 200 Flandes)​	7
Bélgica (Ultratop 40 Valonia)​	9
Canadá (Billboard Canadian Albums)​	15
Finlandia (Suomen Virallinen Lista)​	34
Francia (SNEP)​	3
Suecia Suecia (Sverigetopplistan)​	16
Reino Unido (UK Albums Chart)​	8
Estados Unidos (Billboard 200)​	150

TemplateData

Esta plantilla se utiliza para referencias en Wikipedia, específicamente para álbumes.

Parámetros 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
álbum	álbum album	Título del álbum. Ejemplo Homework	Cadena	sugerido
dvd	dvd	Para DVDs musicales, el título del álbum. Algunas listas de música de DVD tienen que estar provistas en este campo en lugar del parámetro album para que funcione correctamente.	Cadena	opcional
artista	artista artist	Nombre de la banda o solista que interpreta el tema musical. Ejemplo Daft Punk	Cadena	opcional
artistid	artistid idartista	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
refnombre	refnombre 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
obra	obra work	sin descripción	Cadena	opcional
país	país location	sin descripción	Cadena	opcional
página	página page	sin descripción	Cadena	opcional
publicado	publicado publisher	sin descripción	Cadena	opcional
rowheader	rowheader	Permite destacar una fila en particular por sobre el resto. Hay que asignarle el valor «true». Predeterminado true Valor automático	Wikitexto desequilibrado	opcional

Véase también

• {{Enlace Billboard}}
• {{Singlechart}}