View source for Template:Infobox music genre/doc

{{Documentation subpage}}
<!-------------------------------------------------------------------
     Place categories where indicated at the bottom of this page,
     please; interwikis to Wikidata (see [[Wikipedia:Wikidata]]).
 -------------------------------------------------------------------->
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}

For more information, see the [[Wikipedia:WikiProject Music/Music genres task force|WikiProject Music/Music genres task force]].

== Usage ==
{{Parameter names example|name|native_name|etymology|other_names|image|image_size|alt|caption|stylistic_origins|cultural_origins|instruments|derivatives|subgenrelist|subgenres|fusiongenres|regional_scenes|local_scenes|other_topics|current_year=yes}}

<syntaxhighlight lang="wikitext" style="overflow: auto">
{{Infobox music genre
| name              = 
| native_name       = 
| etymology         = 
| other_names       = 
| image             = 
| alt               = 
| caption           = 
| stylistic_origins = 
| cultural_origins  = 
| instruments       = 
| derivatives       = 
| subgenres         = 
| subgenrelist      = 
| fusiongenres      = 
| regional_scenes   = 
| local_scenes      = 
| other_topics      = 
| footnotes         = 
| current_year      = 
}}
</syntaxhighlight>
{{clear}}

'''Example'''<p>For an example of this template filled out, see [[Wikipedia:WikiProject Music/Music genres task force/Infobox|WikiProject Music/Music genres task force/Infobox]].</p>

== Parameters ==
=== name ===
The most used name of the genre.

=== native_name ===
The name in the local language where the genre comes from. 
: If more than one name listed, separate them using {{tl|plainlist}}.

=== native_name_lang ===
[[List of ISO 639-2 codes|ISO 639-2 code]] for the listed native names, e.g. <code>fre</code> for French.
: If more than one, use {{tl|lang}} in {{Para|native_name}} instead.

=== etymology ===
Meaning or derivation of the name, e.g. <code><nowiki>[[Italian language|Italian]] for "slow violent"</nowiki></code>.

=== other_names ===
Additional and alternative names that the genre is known by.
: Use with discretion; discuss on talk before engaging in potentially confusing scenarios like [[progressive rock]]/[[progressive pop]] or [[electropop]]/[[synth-pop]]. For multiple entries, see notes{{r|hlist}}.

=== image ===
An image that would best supplement the described genre. Since [[Wikipedia talk:WikiProject Music/Archive 37#RFC about band photos in genre articles|2018]], the general consensus says to refrain against using photos of specific bands and musicians.
: Images should be sufficiently clear for display at 220 pixels' width. Set to only the image name, e.g. <code>Example.png</code>, not <code>Image:Example.png</code> or <code><nowiki>[[File:Example.png|200px|abc]]</nowiki></code>. 

;image_size
: For size adjustments additional parameter {{Para|image_size}} can be used, the width should be entered in pixels without "px". For example, use <code>260</code> so the image would be fully embedded in the template.

=== alt ===
Alt text for the image, for visually impaired and other readers who cannot see the image.
: The optional field when the caption is not enough to describe the image. See [[WP:ALT]].

=== caption ===
Caption for the image to be displayed under the image.

=== stylistic_origins ===
List of genres, musical and cultural roots that influenced the emergence of the described genre. 
: For general rules on genres listing, see [[#subgenres]] section.

=== cultural_origins ===
The year (or time period) and the geographical location of the genre's origins, e.g. <code><nowiki>Early-to-mid 1980s, [[Berlin]], Germany</nowiki></code> or <code><nowiki>Early 19th century, [[Mumbai]] region, India</nowiki></code>.
: See notes{{r|location}} for location details, and notes{{r|hlist}} for multiple entries.

=== instruments ===
List of musical instruments that are typical for the genre.
: For multiple entries, see notes{{r|hlist}}.

=== derivatives ===
List of influenced genres that use some of the elements inherent to the genre without being a child genre or subcategory.
: For general rules on genres listing, see [[#subgenres]] section.

=== subgenres ===
List of child genres that share characteristics with the described genre and fall within its subcategory. 
: When listing genres, aim for specificity and explicit detailing (e.g. <code><nowiki>[[Deep house]]</nowiki></code> rather than <code><nowiki>[[House music|House]]</nowiki></code> or <code><nowiki>[[Electronic dance music|EDM]]</nowiki></code> ). Genres should be separated by using commas, {{tl|flatlist}} or {{tl|hlist}}.{{r|hlist}} Genres should be wikilinked. Use piped links where needed, for example: <code><nowiki>[[Pop music|Pop]], [[Rock music|rock]]</nowiki></code>. Most genres are not proper nouns and should not be capitalized. However, the first word in a list of multiple genres should be capitalized. Genres that are sourced in the article itself do not require a source in the infobox, but sometimes it can be useful to have the source listed again anyway, to help prevent edit warring. A hidden comment such as <code><nowiki><!-- genres listed here are sourced in the article text --></nowiki></code> can also be used to this end if needed. For multiple entries, see notes{{r|hlist}}.

=== subgenerelist ===
Article containing the complete list of subgenres for the described genre.
: Place only existing list articles, without square brackets, e.g. <code>List of rock genres</code>. The list dedicated to the parent genre of the described genre should not be placed here, even if described genre is mentioned in the list as a subgenre.

=== fusiongenres ===
List of [[Music_genre#Subtypes|fusion genres]] that have additional parent genres, being a subcategory of both.
: For general rules on genres listing, see [[#subgenres]] section.

=== regional_scenes ===
Articles specializing in regional variants of the described genre, established within the countries or large regions, e.g. [[British rock]] or [[American pop]].
: Articles should be pipelinked as <code><nowiki>[[British rock|Britain]]</nowiki></code> and <code><nowiki>[[American rock|United States]]</nowiki></code>. See notes{{r|location}} for location details, and notes{{r|hlist}} for multiple entries. The list should not contain links redirecting to articles about the countries themselves, if the genre has well-known scenes without articles, it is better to leave them unlinked. Specific subgenres which have names derived out of country names should not be included here, e.g. [[Dutch house]], because the genre is not equivalent to "any house music of the Netherlands". The same goes for articles on time periods or specific parts of the scene, e.g. [[Early Norwegian black metal scene]]), as it's not covering black metal scene of Norway generally.

=== local_scenes ===
Articles specializing in local scenes related to the genre, mostly existing within the cities, or small regions within a country, e.g. [[Madchester]] or [[The Scene That Celebrates Itself]].
: The list should contain the original names of the scenes, i.e. there's no need to pipelink scene names with city names. Direct links to the cities or region articles should not be placed here, use unlinked text. For multiple entries, see Notes{{r|hlist}} for details.

=== other_topics ===
Related articles which did not fall into the categories above, or other articles closely related to the genre, including lists, dedicated to the genre. 
: For multiple entries, see notes{{r|hlist}}. Articles dedicated to musical artists usually should not be placed here.

=== footnotes ===
Collects all used notes into a numbered list.
: Used in pair with {{tl|efn}} in the template, displays list of notes via {{tl|notelist}}. To use, place <code><nowiki>{{notelist}}</nowiki></code> in the field. 

=== current_year ===
Places the link to [[{{CURRENTYEAR}} in music]] articles at the bottom of the infobox, dedicated to very few specific genres.
: Set <code>yes</code> to include such links. Link will update automatically for new years, once the "<new year> in <genre>" article has been written. If no article has been written for the old year nor the new year, it will redlink the new year's article to encourage its creation. Has two optional further parameters:

; current_year_title
The "{{CURRENTYEAR}} in <genre>" function assumes that the current page's title is the genre's name, i.e., if you use this on [[classical music]], it will link to "{{CURRENTYEAR}} in classical music"). If that is not the case, use this parameter to specify the genre's name. The annual-update feature will work just the same.

; current_year_override
This overrides the whole parameter, for if the desired article uses some unusual title formulation (e.g. "2010s in classical music"). If this parameter is used, the link will '''''not''''' update for new years.

== Notes ==
{{reflist |refs=
<ref name="hlist">For short horizontal lists of two or three items, comma separators are acceptable, but for longer lists the use of {{tl|flatlist}} or {{tl|hlist}} is preferred as they offer a benefit to users of screen readers. Don't use other list templates or {{tag|br|s}} tags for reasons of [[Wikipedia:Manual of Style/Accessibility#Vertical lists|accessibility]].</ref>
<ref name="location">As per [[Wikipedia talk:WikiProject Music/Archive 39#Naming countries in infoboxes|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, US" and "Cardiff, Wales, UK", rather than spelling out the full country name. Avoid using abbreviations for states or provinces in all nations. {{xt|New Hampshire}} rather than {{!xt|NH}}, {{xt|New South Wales}} rather than {{!xt|NSW}}, or {{xt|British Columbia}} rather than {{!xt|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.</ref>
|}
}}

== TemplateData ==
{{Collapse top|title=[[Wikipedia:TemplateData|TemplateData]] documentation used by [[Wikipedia:VisualEditor|VisualEditor]] and other tools}}
{{TemplateData header|noheader=1}}
<templatedata>
{
	"description": "An infobox for music genres, describing the genre in its origin, instrumentality and other information",
	"format": "{{_\n| _________________ = _\n}}\n",
	"params": {
		"name": {
			"label": "Name",
			"description": "The name of the genre. If foreign, state the English version of the name.",
			"example": "Alternative music",
			"type": "string",
			"required": true
		},
		"native_name": {
			"label": "Native name",
			"description": "The native name of the genre, if applicable.",
			"type": "string",
			"example": "{{lang|fr|Nom français}}"
		},
		"etymology": {
			"label": "Etymology",
			"type": "string",
			"description": "Meaning or derivation of the name."
		},
		"stylistic_origins": {
			"label": "Stylistic origins",
			"description": "The genres that stylistically formed the genre, either parents genres or influences.",
			"example": "{{hlist|[[House music|House]]|[[pop punk]]|[[electropop]]}}",
			"type": "string",
			"required": true
		},
		"cultural_origins": {
			"label": "Cultural origins",
			"description": "The cultural origins of the genre, with a year and specific location.",
			"example": "Early 1960s – late 1970s, United Kingdom",
			"type": "string",
			"required": true
		},
		"instruments": {
			"label": "Typical instruments",
			"description": "The instruments that are popularly associated with the genre",
			"example": "{{hlist|[[Drums]]|[[vocals]]|[[bass guitar]]}}",
			"type": "string"
		},
		"derivatives": {
			"label": "Derivative forms",
			"description": "Genres that are derivative of or descend from the genre.",
			"example": "[[Alternative pop]]",
			"type": "string"
		},
		"subgenres": {
			"label": "Subgenres",
			"description": "The subgenres that descend from the genre. Genres should be wikilinked and separated by using commas, {{tl|htlist}} or {{tl|flatlist}}.",
			"example": "{{hlist|[[Deep house]]|[[electro house]]|[[progressive house]]|[[UK hard house]]}}",
			"type": "string"
		},
		"fusiongenres": {
			"label": "Fusion genres",
			"description": "Genres resulting from the genre mixing with another genre, i.e. subgenres of two fused genres.",
			"example": "{{hlist|[[Synth-pop]]|[[electropop]]|[[dream pop]]}}",
			"type": "string"
		},
		"regional_scenes": {
			"label": "Regional scenes",
			"description": "Typical locations that house the genre, in terms of regional locations such as countries.",
			"example": "[[British rock music|United Kingdom]]",
			"type": "string"
		},
		"local_scenes": {
			"label": "Local scenes",
			"description": "Typical locations that house the genre, in terms of cities and more exact locations",
			"example": "New Orleans, Louisiana",
			"type": "string"
		},
		"other_topics": {
			"label": "Other genre topics",
			"description": "Topics based on the genre specified or stated.",
			"type": "string"
		},
		"other_names": {
			"label": "Other names",
			"description": "Additional and alternative names that the genre is known by. ",
			"type": "string"
		},
		"image": {
			"label": "Image",
			"description": "Image to use in infobox. Set to only the image name..",
			"example": "ABBA - TopPop 1974 5.png",
			"type": "wiki-file-name"
		},
		"image_size": {
			"label": "Image size",
			"description": "Should only be specified if the image is smaller than 220 pixels width.",
			"type": "number"
		},
		"alt": {
			"label": "Image alt text",
			"description": "Alt text for the image, for visually impaired and other readers who cannot see the image.",
			"type": "line"
		},
		"caption": {
			"label": "Image caption",
			"description": "Caption for the image.",
			"type": "string"
		},
		"subgenrelist": {
			"label": "Subgenres list article",
			"description": "Title of existing article, which lists the subgenres.",
			"example": "List of rock genres",
			"type": "wiki-page-name"
		},
		"current_year": {
			"label": "Current year genre portal",
			"description": "Places the link to \"current year in music\" articles at the bottom of the infobox.",
			"type": "line",
			"autovalue": "yes"
		}
	},
	"paramOrder": [
		"name",
		"native_name",
		"etymology",
		"other_names",
		"image",
		"image_size",
		"alt",
		"caption",
		"stylistic_origins",
		"cultural_origins",
		"instruments",
		"derivatives",
		"subgenrelist",
		"subgenres",
		"fusiongenres",
		"regional_scenes",
		"local_scenes",
		"other_topics",
		"current_year"
	]
}
</templatedata>
{{Collapse bottom}}

== Tracking categories ==
* {{clc|Pages using infobox music genre with unknown parameters}}

<includeonly>{{Sandbox other||

<!-------------------------------------------------------------------
       Categories below here, please; interwikis to Wikidata.
 -------------------------------------------------------------------->
[[Category:Music genre templates| ]]
[[Category:Music infobox templates|Music Genre]]
[[Category:Templates that add a tracking category]]
}}</includeonly>