Open main menu

Changes

Template:Infobox record label/doc

13,859 bytes added, 17:13, 28 April 2020
→‎TemplateData: Added aligned format
{{Documentation subpage}}
<!-- Place categories where indicated at the bottom of this page and interwikis at Wikidata -->
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Check for unknown parameters}}

==Usage==
{{Parameter names example | name | image | image_name | image_size | image_alt | caption | parent | founded | defunct | founder | status | distributor | genre | country | location | website }}

<code>{{tl|{{BASEPAGENAME}}}}</code> adds an [[m:infobox|infobox]] to the article page of a [[record label]]. The template's code should go at the top of the page, before the article [[WP:LEAD|lead section]], but below disambiguation notices (see also [[WP:WAI]]).

===Pre-filled sample===

For simple use, you can directly cut-n-paste the sample code below (filling in the relevant fields, deleting the irrelevant fields, and leaving out with their self-documentation comments the fields you don't know or that can be used later):

<pre>
{{Infobox record label <!-- See Wikipedia:WikiProject_Music -->
| name = <!-- "label name" displayed in box title, defaults to page title -->
| image = <!-- logo, such as "LABEL-LOGO.jpg" -->
| image_size = <!-- size -->
| image_alt = <!-- WP:ALT text describing the image -->
| caption = <!-- a caption for the image -->
| parent = <!-- parent company, such as "[[Warner Music Group]]" -->
| founded = <!-- year of foundation, such as {{start date|1950}} -->
| founder = <!-- name of founders, separated by using commas, {{Flatlist}} or {{Hlist}} -->
| defunct = <!-- year the label dissolved, such as {{end date|1990}} -->
| status = <!-- leave blank unless "Inactive" -->
| distributor = <!-- distributors, separated by using commas, {{Flatlist}} or {{Hlist}} -->
| genre = <!-- such as "[[World music|World]]" or "Various", separated by using commas, {{Flatlist}} or {{Hlist}} -->
| country = <!-- origin, such as "United States" or "Turkey" -->
| location = <!-- headquarters city and state -->
| website = <!-- such as "{{URL|www.atlanticrecords.com}}" -->
}}
</pre>

===Empty sample===

If you already know exactly what goes into each field, this version too can be cut-n-pasted directly into your article and filled on the spot, without having to delete the helper comments as you fill it:

<pre>
{{Infobox record label <!-- See Wikipedia:WikiProject_Music -->
| name =
| image =
| image_size =
| image_alt =
| caption =
| parent =
| founded = <!-- {{Start date|YYYY}} -->
| founder =
| defunct = <!-- {{End date|YYYY}} -->
| status =
| distributor =
| genre =
| country =
| location =
| website = <!-- {{URL|example.com}} -->
}}
</pre>

===Fields===

All fields are currently optional (in that not filling them won't cause a display error), but it is recommended to try and fill as much as possible within sourced information, especially <code>founded</code> and <code>country</code>. An empty <nowiki>{{Infobox record label}}</nowiki> will generate only the blue heading with the name of the article.

; name : (Defaults to article name.) Label name displayed in infobox title.
; image : Label logo, such as <code>LABEL-LOGO.jpg</code>.
; image_size: preferably between 100 pixels and 200 pixels wide, depending on its portrait or landscape orientation—default is 180px.
; image_alt : [[Wikipedia:Alternative text for images|alternative text which describes the image]]
; caption : a caption for the image
; parent : Parent company, such as <code><nowiki>[[Warner Music Group]]</nowiki></code>.
; founded : Foundation year, just 4 digits, such as "1950", using {{Tl|Start date}}
; founder : Name of founders, separated by using commas, {{tl|Flatlist}} or {{tl|Hlist}}.
; defunct : Dissolved year, just 4 digits, such as "1990", using {{tl|end date}}
; status : Leave blank unless <code>Inactive</code>.
; distributor : Distributors, separated by using commas, {{tl|Flatlist}} or {{tl|Hlist}}.
; genre : Such as <code><nowiki>[[World music|World]]</nowiki></code> or <code>Various</code>, separated by using commas, {{tl|Flatlist}} or {{tl|Hlist}}.
; country : The single country of origin, such as <code>United States</code> or <code>Turkey</code>. Do not use abbreviations unless absolutely necessary. Do not use flags per [[:WP:INFOBOXFLAG]].
; location : Headquarters city and state or province. Abbreviations, such as "MA" for "Massachusetts", "ON" for "Ontario", etc., should never be used. See Notes{{r|location}} for details.
; website {{nobold|or}} url : Specifies official site of record label using {{[[Template:URL|URL}}, for example: <br /> <code><nowiki>{{URL|www.atlanticrecords.com}}</nowiki></code> (concise) <br /> <code><nowiki>{{URL|www.kalan.com/english/scripts|Kalan.com}}</nowiki></code> (qualified)

Additional field not provided by default:

; bgcolor : (Deprecated, defaults to "{{Colors|black|LightBlue|LightBlue}}".) Background color for box title, not to be used unless justified need.

Be careful not to use {{tl|small}} or <nowiki><small></nowiki> markup in the infobox as infoboxes already use smaller text than the article body and when the font is made too small it is difficult for those with accessibility needs to read.

==Example==

{{Infobox record label <!-- See Wikipedia:WikiProject_Music -->
| name = Republic Records
| image_name = Wikipedia-logo-v2-en.svg
| image_size = 100px
| parent = [[Universal Music Group]]
| founded = {{Start date|1995}}
| founder = {{hlist| [[Monte Lipman]] | Avery Lipman }}
| distributor = {{hlist| Universal Music Group (Worldwide) | [[Virgin EMI Records]] (in the UK) }}
| genre = Various
| country = United States
| location = New York City
| website = {{URL|www.republicrecords.com}}
}}

<pre style="overflow:auto">
{{Infobox record label <!-- See Wikipedia:WikiProject_Music -->
| name = Republic Records
| image_name = Wikipedia-logo-v2-en.svg
| image_size = 100px
| parent = [[Universal Music Group]]
| founded = {{Start date|1995}}
| founder = {{hlist| [[Monte Lipman]] | Avery Lipman }}
| distributor = {{hlist| Universal Music Group (Worldwide) | [[Virgin EMI Records]] (in the UK) }}
| genre = Various
| country = United States
| location = New York City
| website = {{URL|www.republicrecords.com}}
}}
</pre>

The above template code example produces the infobox displayed at right.

* The actual logo is not displayed on this documentation page because of fair-use limitations (it can be used only to illustrate the article about it). A Wikipedia logo is used here to demonstrate logo use and placement.
* Notice in the <code>distributor</code> field how you can go to a new line for a sub-item by hiding the newline in the middle of the <code><nowiki><br /> </nowiki></code>. Doing so is not required (the <code>founder</code> field doesn't use it), and neither version affects the output, but it can make the wikicode more readable and editable with long sub-items.
* Two fields have been omitted in this example: <code>bgcolor</code> (because the default white color is to be used here), and <code>status</code> (because the company is neither inactive nor defunct, and currently unlikely to require the field in the near future).

{{Clear}}<!--PREVENTS INFOBOX OVERFLOWING NEXT SECTION-->

== Notes ==
{{reflist |refs=
<ref name="location">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. {{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>
|}
}}


==Categories==

The template does not create any automatic categorization of the article. You have to add your article to the relevant categories. Suggested categories (and their subcategories) to investigate include:

* One from [[:Category:Record labels by country]]
* One from [[:Category:Record labels by parent]]
* One from [[:Category:Record labels by year of establishment]]
* One or more from [[:Category:Record labels by genre]]

Plus one or more possible special case such as:

* [[:Category:Audiophile record labels]]
* [[:Category:Defunct record labels]]
** or if known [[:Category:Record labels by year of disestablishment]]
* [[:Category:Record label distributors]]
* [[:Category:Reissue record labels]]

And possibly more from:

* [[:Category:Record labels]]

== Microformat ==
{{UF-hcard-org}}

==Tracking category==
* {{clc|Pages using infobox record label with unknown parameters}}

==See also==
<!-- self-listing for quick access on edit history -->
{{#ifeq:{{FULLPAGENAME}}|Template:Infobox record label||
* {{Lts|Infobox record label}}
}} <!-- links to relevant pages -->
* {{Lts|Infobox album}}
* {{Lts|Infobox musical artist}}
** for individual artists, bands or collectives
* [[Wikipedia:WikiProject Music|WikiProject Music]]
** [[Wikipedia:WikiProject Musicians|WikiProject Musicians]]

== TemplateData ==
{{collapse top|[[Wikipedia:TemplateData|TemplateData]] documentation used by [[Wikipedia:VisualEditor|VisualEditor]] and other tools}}
{{TemplateData header|noheader=1}}
<templatedata>
{
"description": "An infobox used to describe a record label, it's general and corporate information, as well as location and official website",
"format": "{{_\n| ___________ = _\n}}\n",
"params": {
"bgcolor": {
"label": "Background color",
"description": "Used to change the background color. It is not required and recommended UNLESS a logical and justified reason is given.",
"type": "string",
"default": "LightBlue."
},
"name": {
"label": "Name",
"description": "The name of the record label. Must not be linked or formatted. ",
"example": "ex. Modular Recordings",
"type": "string",
"required": true
},
"image": {
"label": "Image",
"description": "The logo image for the record label."
},
"image_size": {
"label": "Image size",
"description": "The size of the image. \"px\" must not be added; only the numerical value given.",
"example": "ex. 64",
"default": "100px"
},
"image_alt": {
"label": "Image alternative text",
"description": "The alternative text used to describe the image given for visually-impaired readers.",
"type": "string"
},
"caption": {
"label": "Image caption",
"description": "A caption for the image.",
"example": "Ex. The official logo for Big Beat Records.",
"type": "string"
},
"parent": {
"label": "Parent company",
"description": "The parent company that owns the record label. Must be linked and have its own separate article.",
"example": "ex. [[Sony Music Entertainment]]",
"type": "string"
},
"founded": {
"label": "Founded",
"description": "The foundation year in which the record label was established. Must only be the year and must use the {{start date and age}} if possible.",
"example": "ex. {{start date and age|1887}}",
"type": "string",
"suggested": true
},
"defunct": {
"label": "Defunct",
"description": "The year in which the record company was officially dissolved. Must have the {{end date}} template.",
"example": "ex. {{end date|1953}}"
},
"founder": {
"label": "Founder",
"description": "The person or people who founded the company. If possible, must be linked to its article.",
"example": "ex. Pete Doraine",
"type": "string"
},
"status": {
"label": "Status",
"description": "The current status of the company.",
"example": "Inactive",
"type": "content"
},
"distributor": {
"label": "Distributor",
"description": "The company or companies that distribute the licensed work of the company. If possible, must be linked to its article.",
"example": "ex. Sony Music",
"type": "string"
},
"genre": {
"label": "Genre",
"description": "The genre(s) that are most common for the record label. Must be used with the {{hlist}} template if there are more than one.",
"example": "ex. {{hlist|[[Rock music|Rock]]|[[electronica]]|[[electropop]]|[[neo-psychedelia]]|[[psychedelic rock]]}}",
"type": "string",
"suggested": true
},
"country": {
"label": "Country of origin",
"description": "The record label's country of origin, where it is headquartered. The country MUST NOT be linked.",
"example": "ex. Japan",
"type": "string"
},
"location": {
"label": "Location",
"description": "The official city in which the record label is headquartered in it's country of origin. The exact address is NOT ALLOWED as only the city is.",
"example": "ex. [[Dortmund]]",
"type": "string"
},
"url": {
"label": "Website",
"description": "The official website for the record label. It must be used in accordance with the {{URL}} template so as to be printer-friendly.",
"example": "ex. {{URL|defjam.com}}",
"type": "string"
}
}
}
</templatedata>
{{collapse bottom}}

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Record labels|*<!--STAR-->Infobox record label]]
[[Category:Music infobox templates|Record label]]
[[Category:Business infobox templates|Record label]]
[[Category:Templates that add a tracking category]]
}}</includeonly>
Anonymous user