Difference between revisions of "Template:Infobox record label/doc"
imported>Othienog |
imported>Walter Görlitz |
||
| Line 1: | Line 1: | ||
| + | {{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 --> | {{Infobox record label <!-- See Wikipedia:WikiProject_Music --> | ||
| − | | name = | + | | 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 = | ||
| − | | founded = {{Start date| | + | | image_size = |
| − | | founder = | + | | image_alt = |
| − | | status = | + | | caption = |
| − | | distributor = | + | | 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. | ||
| + | ; 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 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 | | genre = Various | ||
| − | | country = | + | | country = United States |
| − | | location = | + | | location = New York City |
| − | | website = | + | | 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--> | ||
| + | |||
| + | ==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> | <templatedata> | ||
{ | { | ||
| − | "params": {}, | + | "params": { |
| − | "description": " | + | "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" | ||
| + | } | ||
| + | }, | ||
| + | "description": "An infobox used to describe a record label, it's general and corporate information, as well as location and official website.", | ||
| + | "format": "block" | ||
} | } | ||
</templatedata> | </templatedata> | ||
| + | {{collapse bottom}} | ||
| + | |||
| + | <includeonly>{{sandbox other|| | ||
| + | <!-- Categories below this line, please; interwikis at Wikidata --> | ||
| + | [[Category:Music infobox templates|Record label]] | ||
| + | [[Category:Business infobox templates|Record label]] | ||
| + | [[Category:Record labels|*<!--STAR-->Infobox record label]] | ||
| + | }}</includeonly> | ||
Revision as of 03:24, 15 March 2019
| This is a documentation subpage for Template:Infobox record label. It contains usage information, categories and other content that is not part of the original template page. |
| This template uses Lua: |
Contents
Usage
Template:Parameter names example
{{Infobox record label}} adds an infobox to the article page of a record label. The template's code should go at the top of the page, before the article 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):
{{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}}" -->
}}
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:
{{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}} -->
}}
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 founded and country. An empty {{Infobox record label}} 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
LABEL-LOGO.jpg. - image_size
- preferably between 100 pixels and 200 pixels wide, depending on its portrait or landscape orientation—default is 180px.
- image_alt
- alternative text which describes the image
- caption
- a caption for the image
- parent
- Parent company, such as
[[Warner Music Group]]. - founded
- Foundation year, just 4 digits, such as "1950", using {{Start date}}
- founder
- Name of founders, separated by using commas, {{Flatlist}} or {{Hlist}}.
- defunct
- Dissolved year, just 4 digits, such as "1990", using {{end date}}
- status
- Leave blank unless
Inactive. - distributor
- Distributors, separated by using commas, {{Flatlist}} or {{Hlist}}.
- genre
- Such as
[[World music|World]]orVarious, separated by using commas, {{Flatlist}} or {{Hlist}}. - country
- The single country of origin, such as
United StatesorTurkey. Do not use abbreviations unless absolutely necessary. Do not use flags per WP:INFOBOXFLAG. - location
- Headquarters city and state or province.
- website or url
- Specifies official site of record label using {{[[Template:URL|URL}}, for example:
{{URL|www.atlanticrecords.com}}(concise)
{{URL|www.kalan.com/english/scripts|Kalan.com}}(qualified)
Additional field not provided by default:
- bgcolor
- (Deprecated, defaults to "LightBlue".) Background color for box title, not to be used unless justified need.
Be careful not to use {{small}} or <small> markup in the infobox as infoboxes already use smaller text than the article body and when the font is is made too small it is difficult for those with accessibility needs to read.
Example
| Republic Records | |
|---|---|
| Parent company | Universal Music Group |
| Founded | 1995 |
| Founder |
|
| Distributor(s) |
|
| Genre | Various |
| Country of origin | United States |
| Location | New York City |
| Official website | Template:URL |
{{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}}
}}
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
distributorfield how you can go to a new line for a sub-item by hiding the newline in the middle of the<br />. Doing so is not required (thefounderfield 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:
bgcolor(because the default white color is to be used here), andstatus(because the company is neither inactive nor defunct, and currently unlikely to require the field in the near future).
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
- Category:Record label distributors
- Category:Reissue record labels
And possibly more from:
Microformat
Tracking category
See also
- Template:Infobox record label(edit talk links history)
- Template:Infobox album(edit talk links history)
- Template:Infobox musical artist(edit talk links history)
- for individual artists, bands or collectives
- WikiProject Music
TemplateData
TemplateData documentation used by VisualEditor and other tools
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
See the monthly parameter usage report for this template.
TemplateData for Infobox record label An infobox used to describe a record label, it's general and corporate information, as well as location and official website.
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||