Дидани манбаъи Шаблон:Infobox musical composition/doc

{{Documentation subpage}}
<!-- Categories and interwikis go at the bottom of this page. -->

== Usage ==

=== Parameters ===
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 <nowiki>{{flatlist}}</nowiki> or <nowiki>{{plainlist}}</nowiki>.

=== Subset version ===
{{Infobox musical composition
| name                = {{{name}}}
| composer            = {{{composer}}}
| image               = {{{image}}}
| alt                 = {{{alt}}}
| caption             = {{{caption}}}
| translation         = {{{translation}}}
| native_name         = {{{native_name}}}
| native_name_lang    = {{{native_name_lang}}}
| key                 = {{{key}}}
| catalogue           = {{{catalogue}}}
| genre               = {{{genre}}}
| form                = {{{form}}}
| text                = {{{text}}}
| language            = {{{language}}}
| melody              = {{{melody}}}
| composed            = {{{composed}}}
| performed           = {{{performed}}}
| published           = {{{published}}}
| movements           = {{{movements}}}
| scoring             = {{{scoring}}}
| misc                = {{{misc}}}
}}
<pre style="overflow:auto">
{{Infobox musical composition
| composer            = 
| name                = 
| image               = 
| alt                 = 
| caption             = 
| translation         = 
| native_name         = 
| native_name_lang    = 
| key                 = 
| catalogue           = 
| genre               = 
| form                = 
| text                = 
| language            = 
| melody              =
| 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                = 
}}
</pre>
{{clear}}

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

=== Hymn version ===
{{Infobox musical composition
| name                = {{{name}}}
| type                = {{{type}}}
| image               = {{{image}}}
| alt                 = {{{alt}}}
| caption             = {{{caption}}}
| translation         = {{{translation}}}
| native_name         = {{{native_name}}}
| native_name_lang    = {{{native_name_lang}}}
| composer            = {{{composer}}}
| genre               = {{{genre}}}
| occasion            = {{{occasion}}}
| text                = {{{text}}}
| language            = {{{language}}}
| written             = {{{written}}}
| based_on            = {{{based_on}}}
| meter               = {{{meter}}}
| melody              = {{{melody}}}
| composed            = {{{composed}}}
| published           = {{{published}}}
| misc                = {{{misc}}}
}}
<pre style="overflow:auto">
{{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
}}
</pre>
{{clear}}

=== Maximum infobox ===
{{Infobox musical composition
| name                = {{{name}}}
| type                = {{{type}}}
| subtitle            = {{{subtitle}}}
| composer            = {{{composer}}}
| image               = {{{image}}}
| alt                 = {{{alt}}}
| border              = yes
| caption             = {{{caption}}}
| translation         = {{{translation}}}
| native_name         = {{{native_name}}}
| native_name_lang    = {{{native_name_lang}}}
| full_title          = {{{full_title}}}
| full_title_English  = {{{full_title_English}}}
| other_name          = {{{other_name}}}
| key                 = {{{key}}}
| catalogue           = {{{catalogue}}}
| ISWC                = {{{ISWC}}}
| year                = {{{year}}}
| period              = {{{period}}}
| genre               = {{{genre}}}
| style               = {{{style}}}
| form                = {{{form}}}
| related             = {{{related}}}
| occasion            = {{{occasion}}}
| written             = {{{written}}}
| text                = {{{text}}}
| libretto            = {{{libretto}}}
| language            = {{{language}}}
| based_on            = {{{based_on}}}
| meter               = {{{meter}}}
| time                = {{{time}}}
| composed            = {{{composed}}}
| dedication          = {{{dedication}}}
| performed           = {{{performed}}}
| published           = {{{published}}}
| publisher           = {{{publisher}}}
| first_recording     = {{{first_recording}}}
| duration            = {{{duration}}}
| movements           = {{{movements}}}
| scoring             = {{{scoring}}}
| solo                = {{{solo}}}
| vocal               = {{{vocal}}}
| instrumental        = {{{instrumental}}}
| comment             = {{{comment}}}
| premiere_date       = {{{premiere_date}}}
| premiere_location   = {{{premiere_location}}}
| premiere_conductor  = {{{premiere_conductor}}}
| premiere_performers = {{{premiere_performers}}}
| misc                = {{{misc}}}
}}
<pre style="overflow:auto">
{{Infobox musical composition
| name                = 
| subtitle            =
| type                = 
| composer            = 
| image               = <!-- free image only -->
| alt                 = 
| border              = <!-- Set to yes for a border -->
| caption             = 
| translation         = 
| native_name         = 
| native_name_lang    = 
| full_title          = 
| full_title_English  = 
| other_name          = 
| key                 = 
| catalogue           = 
| ISWC                = 
| 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=}} -->
| text                = 
| libretto            = 
| language            = 
| translation         = 
| based_on            =
| meter               = 
| 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             = 
| solo                = 
| vocal               = 
| instrumental        = 
| comment             = 
| premiere_date       = 
| premiere_location   = 
| premiere_conductor  = 
| premiere_performers = 
| misc                = 
}}
</pre>
{{clear}}

=== Additional parameters ===
* {{para|subtitle}} subtitle, appears right below the title
* {{para|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 (music)|Mass]], [[String trio]], [[Tone poem]], [[Song cycle]]
* {{para|full_title}} if the common name is not the full title
* {{para|other_name}} other name(s) the work may be known by, such as ''[[Moonlight Sonata]]''
* {{para|ISWC}} [[International Standard Musical Work Code]], such as "T-000.000.001-0"
* {{para|period}} period of the composition such as "[[contemporary music]]"
* {{para|style}} style of the composition, such as "Free atonality"
* {{para|related}} related works, such a different version, a use in a later composition
* {{para|occasion}} occasion for which the piece was commissioned or composed
* {{para|written}} more general if "composed" can't be said or is not known
* {{para|libretto}} text if it would be described as a libretto, for example for an oratorio
* {{para|based_on}} for example the theme for variations, or a paraphrase
* {{para|meter}} poetic meter
* {{para|time}} time signature if unusual or worth mentioning
* {{para|publisher}} company (or companies) which published the piece
* {{para|first_recording}} date and location of the first recording
* {{para|dedication}} name(s) of dedicatee(s)
* {{para|duration}} duration of a typical performance, such as "12 minutes"
* {{para|solo}} soloist(s)
* {{para|vocal}} vocal performers
* {{para|instrumental}} instrumental performers
* {{para|comment}} comment for facts not covered otherwise 
* {{para|premiere_date}} date the piece was first played for the public
* {{para|premiere_location}} premiere location, such as hall, city, country
* {{para|premiere_conductor}} conductor who led the premiere
* {{para|premiere_performers}} participants in the premiere

== Image use ==
{{para|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 title page 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 ==

=== Example 1 - Symphony ===
{{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}}
| 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}}
}}
<pre style="overflow: auto">
{{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]]
}}</pre>
{{Clear}}

=== Example 2 - Hymn ===
{{Infobox musical composition
| name                = Vom Himmel hoch, da komm ich her
| type                = [[List of hymns by Martin Luther|Hymn by Martin Luther]]
| image               = VomHimmel00007012.jpg
| caption             = 1567 publication
| translation         = From Heaven Above to Earth I Come
| native_name_lang    = [[German language|German]]
| 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}}
}}
<pre style="overflow: auto">
{{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}}
}}
</pre>
{{clear}}

=== Example 3 - Songs ===
{{Infobox musical composition
| name                = {{nowrap|{{lang|de|Wesendonck Lieder}}}}
| type                = [[Song cycle]]
| composer            = [[Richard Wagner]]
| image               = File:Mathilde1850.jpg
| alt                 = 
| caption             = Portrait of Mathilde Wesendonck (1850) by [[Karl Ferdinand Sohn]]
| Title_English       = 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
}}
<pre style="overflow: auto">
{{Infobox musical composition
| name                = {{nowrap|{{lang|de|Wesendonck Lieder}}}}
| type                = [[Song cycle]]
| composer            = [[Richard Wagner]]
| image               = File:Mathilde1850.jpg
| alt                 = 
| caption             = Portrait of Mathilde Wesendonck (1850) by [[Karl Ferdinand Sohn]]
| Title_English       = 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
}}
</pre>
{{clear}}

=== Example 4 - original example of the template ===
{{Infobox musical composition
| name     = Sub Arturo plebs
| image    = Nocover.svg
| alt      = Cover
| form     = [[Motet]]
| composer = [[Johannes Alanus]]
| year     = Late 14th Century
| period   = [[Medieval_music|Mediaeval]]
| style    = [[Ars Nova]]
}}
Note that the old parameters ("cover") should not be used when new infoboxes are created.
<pre style="overflow: auto">
{{Infobox musical composition
| name     = Sub Arturo plebs
| image    = Nocover.svg
| alt      = Cover
| form     = [[Motet]]
| composer = [[Johannes Alanus]]
| year     = Late 14th Century
| period   = [[Medieval_music|Mediaeval]]
| style    = [[Ars Nova]]
}}</pre>
{{clear}}

== Microformats ==

=== hCalendar ===
{{UF-hcal}}

=== hAudio ===
{{UF-audio}}

== See also ==
* {{tl|Infobox album}}
* {{tl|Infobox Bach composition}}
* {{tl|Infobox opera}}


<includeonly>
<!-- Categories go here -->
[[Category:Music infobox templates|Musical composition]]
</includeonly>