แม่แบบ:Infobox musical composition/doc

== Usage**

**Subset version**

**Hymn version**

**Full syntax infobox**

**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  or .

**Subset parameters**
 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 Noteslocation for location details.- performed date and location of notable performances, typically the premiere. See Noteslocation for location details. See Noteslocation for location details.- published date(s) and location(s) of publishing. See Noteslocation for location details.- movements number of movements- scoring scoring- misc room to enter additional information

**Additional parameters**
 subtitle subtitle, appears right below the title- 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 Noteslocation 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 Noteslocation for location details.- premiere_location premiere location, such as hall, city, country. See Noteslocation for location details.- premiere_conductor conductor who led the premiere- premiere_performers participants in the premiere

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

**Image use**
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**

**Symphony**

**Hymn**

**Songs**

**Notes**
}

**Microformats**

**hCalendar**

**hAudio**

**Tracking categories**
 Pages using infobox musical composition with unknown parameters- Wikipedia requested audio of songs

**See also**
 Infobox album- Infobox opera