Template:Infobox musical composition/doc

{{{name}}}
{{{name}}}
BWV {{{bwv}}}
{{{type}}} by {{{composer}}}
	[[File:{{{image}}}\|frameless\|alt={{{alt}}}\|upright={{{image_upright}}}]] {{{caption}}}
English	{{{translation}}}
Native name	{{{native_name}}}
Full title	{{{full_title}}}
Other name	{{{other_name}}}
Key	{{{key}}}
Catalogue	{{{catalogue}}}
Opus	{{{opus}}}
Year	{{{year}}}
Period	{{{period}}}
Genre	{{{genre}}}
Style	{{{style}}}
Form	{{{form}}}
Related	{{{related}}}
Occasion	{{{occasion}}}
Written	{{{written}}}
Commissioned by	{{{client}}}
Text	{{{text}}}
Cantata text	{{{cantata}}}
Bible text	{{{bible}}}
Chorale	{{{chorale}}}
Language	{{{language}}}
Based on	{{{based_on}}}
Meter	{{{meter}}}
Melody	{{{melody}}}
Time	{{{time}}}
Composed	{{{composed}}}
Dedication	{{{dedication}}}
Performed	{{{performed}}}
Published	{{{published}}}
Publisher	{{{publisher}}}
Recorded	{{{first_recording}}}
Duration	{{{duration}}}
Movements	{{{movements}}}
Scoring	{{{scoring}}}
Vocal	{{{vocal}}}
Instrumental	{{{instrumental}}}
Premiere
Date	{{{premiere_date}}}
Location	{{{premiere_location}}}
Conductor	{{{premiere_conductor}}}
Performers	{{{premiere_performers}}}
	{{{misc}}}

{{{name}}}
{{{name}}}
{{{type}}} by {{{composer}}}
	[[File:{{{image}}}\|frameless\|alt={{{alt}}}\|upright=1]] {{{caption}}}
English	{{{translation}}}
Native name	{{{native_name}}}
Genre	{{{genre}}}
Occasion	{{{occasion}}}
Written	{{{written}}}
Text	{{{text}}}
Language	{{{language}}}
Based on	{{{based_on}}}
Meter	{{{meter}}}
Melody	{{{melody}}}
Composed	{{{composed}}}
Published	{{{published}}}
	{{{misc}}}

{{{name}}}
{{{name}}}
by {{{composer}}}
	[[File:{{{image}}}\|frameless\|alt={{{alt}}}\|upright=1]] {{{caption}}}
English	{{{translation}}}
Native name	{{{native_name}}}
Key	{{{key}}}
Catalogue	{{{catalogue}}}
Opus	{{{opus}}}
Genre	{{{genre}}}
Form	{{{form}}}
Commissioned by	{{{client}}}
Text	{{{text}}}
Language	{{{language}}}
Melody	{{{melody}}}
Composed	{{{composed}}}
Performed	{{{performed}}}
Published	{{{published}}}
Movements	{{{movements}}}
Scoring	{{{scoring}}}
	{{{misc}}}

This is a documentation subpage for Template:Infobox musical composition.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 3,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

Usage edit

Subset version edit

{{Infobox musical composition
| name                = 
| composer            = 
| image               = 
| alt                 = 
| caption             = 
| translation         = 
| native_name         = 
| native_name_lang    = 
| key                 = 
| catalogue           = 
| opus                = 
| genre               = 
| form                = 
| text                = 
| language            = 
| melody              = 
| client              = 
| composed            = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|end_date={{End date|YYYY|MM|DD|df=y}}|location=}} -->
| performed           = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|location=}} -->
| published           = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|location=}} -->
| movements           = 
| scoring             = 
| misc                = 
}}

Hymn version edit

{{Infobox musical composition
| name                = <!-- name(s) of hymn in quotation marks -->
| type                = <!-- the possibility to say what kind of hymn, such as "Spanish hymn", with the possibility to link to a list -->
| image               = <!-- without leading "File:" -->
| alt                 = 
| caption             = 
| translation         = <!-- to English, if hymn name is a different language -->
| native_name         = <!-- if hymn name is the translation -->
| native_name_lang    = <!-- two-letter code -->
| composer            = 
| genre               = [[Hymn]]
| occasion            = 
| text                = by <!-- text author(s) --> 
| language            = 
| written             = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|end_date={{End date|YYYY|MM|DD|df=y}}|location=}} -->
| based_on            = <!-- for example biblical quotation, example {{Sourcetext|source=Bible|version=King James|book=1 Corinthians|chapter=13|verse=1|range=–13}} --> 
| meter               = <!-- of the poetry -->
| melody              = <!-- name (in quotation marks) or source of traditional melody, or of hymn whose melody is used, or by composer(s) -->
| composed            = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|end_date={{End date|YYYY|MM|DD|df=y}}|location=}} -->
| published           = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|location=}} -->
| misc                = room for remarks
}}

Full syntax infobox edit

{{Infobox musical composition
| name                = 
| subtitle            = 
| bwv                 =
| type                = 
| composer            = 
| image               = <!-- free image only -->
| image_upright       = 
| alt                 = 
| border              = <!-- Set to yes for a border -->
| caption             = 
| translation         = 
| native_name         = 
| native_name_lang    = 
| full_title          = 
| other_name          = 
| key                 = 
| catalogue           = 
| opus                = 
| year                = <!-- {{Start date|YYYY}} (1583 & after only) -->
| period              = 
| genre               = 
| style               = 
| form                = 
| related             = 
| occasion            = 
| written             = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|end_date={{End date|YYYY|MM|DD|df=y}}|location=}} -->
| client              = 
| text                = 
| cantata             = 
| bible               = 
| chorale             = 
| language            = 
| based_on            = 
| meter               = 
| melody              = 
| time                = <!-- time signature if unusual or worth mentioning -->
| composed            = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|end_date={{End date|YYYY|MM|DD|df=y}}|location=}} -->
| dedication          = 
| performed           = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|location=}} -->
| published           = <!-- {{Timeline-event|date={{Start date|YYYY|MM|DD|df=y}}|location=}} --><!--supposedly hAudio microformat-->
| publisher           = 
| first_recording     = 
| duration            = <!-- {{Duration|m=3|s=45}}, optional h parameter for hours --><!-- supposedly hAudio microformat -->
| movements           = 
| scoring             = 
| vocal               = 
| instrumental        = 
| premiere_date       = 
| premiere_location   = 
| premiere_conductor  = 
| premiere_performers = 
| misc                = 
}}

Parameters edit

The template is very general and therefore offers a great choice of parameters. For a given composition, use only those of relevance, look first if the subset covers them. Parameters can be entered in several ways, to make the template consistent with other usages, for example parameters can be entered capital or lowercase. For multiple occurrences of a parameter, use {{flatlist}} or {{plainlist}}.

Subset parameters edit

|name= title of the composition, using the common name
|image= a suitable free image
|alt= an alternative description of the image for readers who don't see it
|caption= description of the image
|translation= title in English, if the common name is in different language
|native_name= native title, if the common name is English
|native_name_lang= language of the native title/common title not in English
|type= the type of composition, e.g. cantata
|composer= composer of the piece
|genre= genre of the piece, such as choral music
|form= form, such as "string quartet"
|key= key, such as "C minor", "C-sharp major"
|catalogue= catalogue number, listing the catalogue with a link, such as K.
|opus= opus number
|year= year of composition if different from a date below
|text= text source for works with text such as songs and cantatas
|language= language of the text
|melody= open to name a melody or its writer, useful for hymns, songs and variations
|client= person or organisation who commissioned the work
|composed= time and location of composition if known and different from |performed=. See Notes^[1] for location details.
|performed= date and location of notable performances, typically the premiere. See Notes^[1] for location details. See Notes^[1] for location details.
|published= date(s) and location(s) of publishing. See Notes^[1] for location details.
|movements= number of movements
|scoring= scoring
|misc= room to enter additional information

Additional parameters edit

|subtitle= subtitle, appears right below the title^{[further explanation needed]}
|type= appears with the composer above an image: an (optional) help to characterize the composition if the name alone does not do it, especially if it is a foreign name, type for example Mass, String trio, Tone poem, Song cycle
|full_title= if the common name is not the full title
|other_name= other name(s) the work may be known by, such as Moonlight Sonata
|period= period of the composition such as "contemporary music"
|style= style of the composition, such as "Free atonality"
|related= related works, such a different version, a use in a later composition
|occasion= occasion for which the piece was commissioned or composed
|client= person or organisation who commissioned the work
|written= more general if "composed" can't be said or is not known
|based_on= for example the theme for variations, or a paraphrase
|meter= poetic meter
|time= time signature if unusual or worth mentioning
|publisher= company (or companies) which published the piece
|first_recording= date and location of the first recording. See Notes^[1] for location details.
|dedication= name(s) of dedicatee(s)
|duration= duration of a typical performance, such as "12 minutes"
|vocal= vocal performers
|instrumental= instrumental performers
|premiere_date= date the piece was first played for the public. See Notes^[1] for location details.
|premiere_location= premiere location, such as hall, city, country. See Notes^[1] for location details.
|premiere_conductor= conductor who led the premiere
|premiere_performers= participants in the premiere

TemplateData edit

This is the TemplateData for this template used by TemplateWizard, VisualEditor and other tools. See a monthly parameter usage report for Template:Infobox musical composition in articles based on its TemplateData.

TemplateData for Infobox musical composition

The template is very general and therefore offers a great choice of parameters. For a given composition, use only those of relevance, look first if the subset covers them.

Template parameters
This template has custom formatting.
Parameter		Description	Type	Status
Title	`name`	Title of the composition, using the common name; or name(s) of hymn in quotation marks	Unknown	suggested
Subtitle	`subtitle`	Subtitle, appears right below the title	Unknown	optional
Bach-Werke-Verzeichnis number	`bwv`	no description	Number	optional
Type	`type`	Appears with the composer above an image: an (optional) help to characterize the composition if the name alone does not do it, especially if it is a foreign name, type for example Mass, String trio, Tone poem, Song cycle	Unknown	optional
Composer	`composer`	Composer of the piece	Unknown	optional
Image	`image`	Suitable free image; without leading "File:"	Unknown	optional
Image size	`image_size`	Per [[WP:PICSIZE]], should normally be left blank, in order to respect the users' preferences, which may be important for accessibility.	Unknown	deprecated
Image upright	`image_upright`	See Module:InfoboxImage#Parameters and look for "upright"	Unknown	optional
Border	`border`	Border for image Auto value `yes`	Unknown	optional
Alt	`alt`	Alternative description of the image for readers who don't see it	Unknown	optional
Image caption	`caption`	Description of the image	Unknown	optional
English name	`translation`	Title in English, if the common name is in different language	Unknown	optional
Native name	`native_name`	Native title, if the common name is English	Unknown	optional
Native name language	`native_name_lang`	Language of the native title/common title not in English	Unknown	optional
Full title	`full_title`	If the common name is not the full title	Unknown	optional
Other name	`other_name`	Other name(s) the work may be known by, such as Moonlight Sonata	Unknown	optional
Key	`key`	Key, such as "C minor", "C-sharp major"	Unknown	optional
Catalogue	`catalogue`	Catalogue number, listing the catalogue with a link, such as K.	Unknown	optional
Opus	`opus`	Opus number Example 9	Unknown	optional
Year	`year`	Year of composition if different from a date below	Unknown	optional
Period	`period`	Period of the composition such as "contemporary music"	Unknown	optional
Genre	`genre`	Genre of the piece, such as choral music; or "Hymn" if it's a hymn	Unknown	optional
Style	`style`	Style of the composition, such as "Free atonality"	Unknown	optional
Form	`form`	Form, such as "string quartet"	Unknown	optional
Related	`related`	Related works, such a different version, a use in a later composition	Unknown	optional
Occasion	`occasion`	Occasion for which the piece was commissioned or composed	Unknown	optional
Client	`client`	Person or organisation who commissioned the work	Unknown	optional
Written	`written`	More general if "composed" can't be said or is not known	Unknown	optional
Text	`text`	Text source for works with text such as songs and cantatas	Unknown	optional
Cantata text	`cantata`	no description	String	optional
Bible text	`bible`	no description	String	optional
Chorale	`chorale`	no description	String	optional
Language	`language`	Language of the text	Unknown	optional
Based on	`based_on`	For example the theme for variations, or a paraphrase	Unknown	optional
Meter	`meter`	Poetic meter	Unknown	optional
Melody	`melody`	Open to name a melody or its writer, useful for hymns, songs and variations	Unknown	optional
Time	`time`	Time signature if unusual or worth mentioning	Unknown	optional
Composed	`composed`	Time and location of composition if known and different from "Performed"	Unknown	optional
Dedication	`dedication`	Name(s) of dedicatee(s)	Unknown	optional
Performed	`performed`	Date and location of notable performances, typically the premiere	Unknown	optional
Published	`published`	Date(s) and location(s) of publishing	Unknown	optional
Publisher	`publisher`	Company (or companies) which published the piece	Unknown	optional
First recording	`first_recording`	Date and location of the first recording	Unknown	optional
Duration	`duration`	Duration of a typical performance, such as "12 minutes"	Unknown	optional
Movements	`movements`	Number of movements	Unknown	optional
Scoring	`scoring`	Scoring	Unknown	optional
Vocal	`vocal`	Vocal performers	Unknown	optional
Instrumental	`instrumental`	Instrumental performers	Unknown	optional
Premiere date	`premiere_date`	Date the piece was first played for the public	Unknown	optional
Premiere conductor	`premiere_conductor`	Conductor who led the premiere	Unknown	optional
Premiere location	`premiere_location`	Premiere location, such as hall, city, country	Unknown	optional
Premiere performers	`premiere_performers`	Participants in the premiere	Unknown	optional
Misc	`misc`	Room to enter additional information	Unknown	optional
title	`title`	no description	Unknown	deprecated
image_caption	`image_caption`	no description	Unknown	deprecated
text_poet	`text_poet`	no description	Unknown	deprecated

Image use edit

|image= may be useful for an image related to the composition, of an autograph manuscript, original printed edition or similar item, the composer, a dedicatee, a place of first performance, you name it. Please use it only if a free (public domain) illustration is available. Since musical compositions are not normally perceived primarily through their written form by the wider public, the visual presence of the written page does not have the same identifying function as it has for books, audio media or similar releases. Therefore, there will not normally be a good justification for including a non-free title page illustration under WP:NFC, as is typically done with such items.

For the same reason, including a non-free image of the cover of an audio recording of the composition in question will also typically be excluded, because in the classical music tradition, no individual audio recording normally has any privileged status in representing the original composition. This may be different, however, for "official" premiere recordings of contemporary works.

Examples edit

Symphony edit

Symphony No. 5
by Anton Bruckner
A portrait of Anton Bruckner
Key	B-flat major
Catalogue	WAB 105
Composed	1875 (1875)–1876 1877 (1877)–1881
Dedication	Karl von Stremayr
Published	1896 (1896) (ed. Schalk) 1935 (1935) (ed. Robert Haas) 1951 (1951) (ed. Leopold Nowak)
Recorded	1937 (1937)
Movements	4
Premiere
Date	8 April 1894 (1894-04-08)
Location	Graz
Conductor	Franz Schalk

{{Infobox musical composition
| name              = Symphony No. 5
| image             = Anton Bruckner.jpg
| caption           = A portrait of Anton Bruckner
| key               = B-flat major
| dedication        = [[Karl von Stremayr]]
| composer          = [[Anton Bruckner]]
| catalogue         = [[Werkverzeichnis Anton Bruckner|WAB]] 105
| movements         = 4
| composed          = {{plainlist|
* {{Start date|1875}}–1876
* {{Start date|1877}}–1881
}}
| premiere_date     = {{Start date|1894|04|08|df=y}}<ref>Paul Hawkshaw and Timothy L. Jackson. "Bruckner, Anton." In Grove Music Online. Oxford Music Online, http://www.oxfordmusiconline.com/subscriber/article/grove/music/40030 (accessed 4 June 2011).</ref>
| premiere_location = [[Graz]]
| premiere_conductor= [[Franz Schalk]]
| published         = {{plainlist|
* {{Start date|1896}} (ed. Schalk)
* {{Start date|1935}} (ed. Robert Haas)
* {{nowrap|{{Start date|1951}} (ed. Leopold Nowak)}}
}}
| first_recording   = {{Start date|1937}} [[Karl Böhm]], [[Dresden Staatskapelle]]
}}

Hymn edit

Vom Himmel hoch, da komm ich her
Hymn by Martin Luther
1567 publication
English	From Heaven Above to Earth I Come
Genre	Hymn Christmas carol
Written	1534 (1534)
Text	by Martin Luther
Language	German
Meter	8.8.8.8
Melody	of a secular song (1535) probably by Martin Luther (1539)
Published	1535 (1535)

{{Infobox musical composition
| name                = Vom Himmel hoch, da komm ich her
| image               = VomHimmel00007012.jpg
| caption             = 1567 publication
| translation         = From Heaven Above to Earth I Come
| native_name_lang    = [[German language|German]]
| composer            = 
| genre               = {{plainlist|
* [[Hymn]]
* [[Christmas carol]]
}}
| text                = by [[Martin Luther]]
| written             = {{start date|1534}}
| meter               = 8.8.8.8
| language            = German
| melody              = {{plainlist|
* of a secular song (1535)
* probably by Martin Luther (1539)
}}
| published           = {{start date|1535}}
}}

Songs edit

Wesendonck Lieder
Song cycle by Richard Wagner
Portrait of Mathilde Wesendonck (1850) by Karl Ferdinand Sohn
English	Wesendonck Songs
Catalogue	WWV 91
Text	Poems by Mathilde Wesendonck
Language	German
Composed	1857 (1857)–1858
Scoring	voice and piano

{{Infobox musical composition
| name                = {{nowrap|{{lang|de|Wesendonck Lieder}}}}
| type                = [[Song cycle]]
| composer            = [[Richard Wagner]]
| image               = File:Mathilde Wesendonck by Karl Ferdinand Sohn, 1850.jpg
| alt                 = 
| caption             = Portrait of Mathilde Wesendonck (1850) by [[Karl Ferdinand Sohn]]
| translation         = Wesendonck Songs
| catalogue           = [[Wagner-Werk-Verzeichnis|WWV]] 91
| text                = Poems by [[Mathilde Wesendonck]]
| language            = [[German language|German]]
| composed            = {{start date|1857}}–1858
| scoring             = voice and piano
}}

Notes edit

^ ^a ^b ^c ^d ^e ^f ^g As per RfC "Naming countries in infoboxes": When identifying a location, city or region in the United States or United Kingdom, the preferred approach is to use the country abbreviations allowed by MOS:ACRO, such as "Portsmouth, New Hampshire, U.S." and "Cardiff, Wales, UK", rather than spelling out the full country name. Avoid using abbreviations for states or provinces in all nations. New Hampshire rather than NH, New South Wales rather than NSW, or British Columbia rather than BC (see MOS:POSTABBR). Cities such as New York City and London may be rendered as "New York City, U.S." and "London, UK" or simply "New York City" and "London". Also, these should not be linked when the context makes it clear (see MOS:OVERLINK). If only the country name is included, it may be written out in full.

Microformats edit

hCalendar edit

The HTML mark-up produced by this template includes an hCalendar microformat that makes event details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject.

Classes used

The HTML classes of this microformat include:

attendee
contact
description
dtend
dtstart
location
organiser
summary
url
vevent

Please do not rename or remove these classes
nor collapse nested elements which use them.

hAudio edit

The HTML mark-up produced by this template includes an hAudio microformat that makes an audio recording's details readily parsable by computer programs. This aids tasks such as the cataloguing of articles and maintenance of databases. For more information about the use of microformats on Wikipedia, please visit the Microformat WikiProject.

Subtemplates

Date-of-publication ("published") information will only be included in the microformat if {{start date}} (or, where appropriate, {{start date and age}}) is used in a parent infobox/template. Do not, however, use {{start date}} or {{start date and age}} if a date before 1583 CE is involved.

Use {{duration}} to specify the duration/length of a recording. For instance, if the recording's duration is 3 minutes 45 seconds, use {{duration|m=3|s=45}} (which appears as: 3:45). If needed, |h= may be included to specify a number of hours.

Please do not remove instances of these subtemplates.

Classes used