Difference between revisions of "Template:Infobox single/doc"
imported>Jc86035 m (→Code) |
imported>Jc86035 m (TemplateData) |
||
| Line 194: | Line 194: | ||
"type": "string", | "type": "string", | ||
"suggested": true | "suggested": true | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
}, | }, | ||
"released": { | "released": { | ||
| Line 372: | Line 356: | ||
"label": "Miscellaneous data", | "label": "Miscellaneous data", | ||
"description": "This field allows you to provide more infobox data such as additional chronologies using {{Extra chronology}}, a track listing using {{Extra track listing}}, extra covers using {{Extra album cover}}, or a sample of the music using {{Audiosample}}. Set 'Type=single' on those templates so the section titles use the same background color as the rest of the infobox.", | "description": "This field allows you to provide more infobox data such as additional chronologies using {{Extra chronology}}, a track listing using {{Extra track listing}}, extra covers using {{Extra album cover}}, or a sample of the music using {{Audiosample}}. Set 'Type=single' on those templates so the section titles use the same background color as the rest of the infobox.", | ||
| + | "type": "string" | ||
| + | }, | ||
| + | "A-side": { | ||
| + | "aliases": [ | ||
| + | "a-side" | ||
| + | ], | ||
| + | "label": "A-side", | ||
| + | "description": "The A-side song title if different from the name. If it has a Wikipedia article use a link. Only one of the fields 'A-side' or 'B-side' should be used.", | ||
| + | "type": "string" | ||
| + | }, | ||
| + | "B-side": { | ||
| + | "aliases": [ | ||
| + | "b-side" | ||
| + | ], | ||
| + | "label": "B-side", | ||
| + | "description": "Use this field to display the B-side song title appearing on the opposite side of the single. If it has a Wikipedia article use a link. Only one of the fields 'A-side' or 'B-side' should be used.", | ||
"type": "string" | "type": "string" | ||
} | } | ||
| Line 384: | Line 384: | ||
"artist", | "artist", | ||
"album", | "album", | ||
| − | " | + | "A-side", |
| − | " | + | "B-side", |
"released", | "released", | ||
"recorded", | "recorded", | ||
Revision as of 17:23, 10 May 2017
| This is a documentation subpage for Template:Infobox single. It contains usage information, categories and other content that is not part of the original template page. |
| File:Ambox warning yellow.svg | This template is used on approximately 53,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.
Transclusion count updated automatically (see documentation). |
| File:Lua-Logo.svg | This template uses Lua: |
Contents
Usage
This is the template for a single (A- or B-side), not a song.
Code
| "Script error: No such module "If empty"." | ||||
|---|---|---|---|---|
| Song by Script error: No such module "If empty". | ||||
| from the album Script error: No such module "If empty". | ||||
| Released | August 14, 1995 (UK) | |||
| Recorded | 1995 | |||
| Genre | Britpop | |||
| Length | Lua error in package.lua at line 80: module 'Module:Duration' not found. | |||
| Label | ||||
| Producer(s) | Stephen Street | |||
| Blur singles chronology | ||||
| ||||
{{Infobox single
| name =
| cover = <!-- just the file name -->
| border =
| alt =
| caption =
| artist =
| album =
| A-side =
| B-side =
| released = <!-- {{start date|YYYY|MM|DD}} -->
| format =
| recorded =
| studio =
| venue =
| genre =
| length = <!-- {{duration|m=MM|s=SS}} -->
| label =
| writer =
| producer =
| ISWC =
| chronology =
| last_single =
| this_single =
| next_single =
| misc =
}}
Parameters
- Name
- This field should contain the name of the single. This field is mandatory.
- Cover
- Upload a copy of the single cover (under fair use—use the tag "{{Non-free album cover}}"). Enter the file name only into the field:
<Image Name>.jpg. - Border
- Type "yes" in this field to place a 1px border around the single's cover.
- Alt
- Alt text for the cover image, to describe it to visually impaired readers. See WP:ALT.
- Artist
- This field should contain the name of the artist. This field is mandatory.
- Album
- If the single was also released on an album, enter the name of the album. If the album has a Wikipedia article, link the article name as usual. The template will italicize the album name. For guidelines on whether a single should be described as being from a particular album, see template:infobox album#Template:Singles.
- A-side
- Use this field to display the A-side song title appearing on the opposite side of the single. If it has a Wikipedia article use a link.
- B-side
- Use this field to display the B-side song title appearing on the opposite side of the single. If it has a Wikipedia article use a link. Only one of the fields "A-side" or "B-side" should be used.
- Released
- This field should refer to the earliest known commercial release date, using a single occurrence of {{Start date}} as {{Start date|YYYY|MM|DD}}, for example "{{Start date|2007|7|31}}". (Use "{{Start date|YYYY|MM}}" if only year and month are known, or "{{Start date|YYYY}}" for just a year).
- Recorded
- This field should include the date(s) the single was recorded. The location of the recording is now included in the
StudioorVenuefield. - Venue
- For live recordings, include the name of the venue (concert hall, stadium, etc.) and location. Link as appropriate.
- Studio
- If the single was recorded in a recording studio, enter the name and location here. Link the studio, but not well-known cities (see WP:OVERLINK). Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1]
- Format
- The way that the single was originally released; i.e. 7-inch single, 12-inch single, CD single, cassette single, digital download (note the piped download link). Do not use
"or″(double quote) for inches (use 7-inch instead of 7"; if necessary to abbreviate, use 7 in). See WP:Units. Numbers should be expressed in figures rather than spelled out (use 10-inch instead of ten-inch). The format type should also be specified (single, record, etc.), rather than using the measurement alone. Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1] - Genre
- The music genre(s) that the single is from. These must not be original research, and should be stated and referenced in a 'Composition' section of the article. Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1].
- Length
- The length should use {{Duration}} thus:
{{Duration|m=3|s=45}}, renders as Script error: No such module "Duration"., for 3 minutes 45 seconds - Label
- This field should refer to the label on which the single/album was originally released. Where significantly different versions have been released (featuring alternate track listings) e.g. U.S. vs. UK, the later release date and/or record label should be mentioned in the article. Drop words like "Records" from the end of the label's name (e.g. use [[Universal Records|Universal]] rather than [[Universal Records]]).
- Producer
- This field allows display of the song's producer(s). Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1]
- ISWC
- International Standard Musical Work Code
- Writer
- This field allows display of the song's writer(s). Separate multiple values using commas, {{flatlist}} or {{hlist}}.[1].
- Misc
- This field allows you to provide more infobox data such as additional chronologies using {{Extra chronology}}, a track listing using {{Extra track listing}}, extra covers using {{Extra album cover}}, or a sample of the music using {{Audiosample}}. Set
|Type=singleon those templates so the section titles use the same background color as the rest of the infobox.
Chronology
The chronology section should link to the previous single on the left and the next single on the right. Songs should be ordered based on the first release dates of their official singles.
- For first singles the left box (the "
|last_single=" field) should be left blank. - For latest singles, the right box (the "
|next_single=" field) should be left blank.
By default, the chronology section begins with an "artist Chronology" header. If you specify the optional "{{{1}}}" field, the text you supply will replace the "artist" portion of that header. This is useful when a single is released by two or more artists and you want to supply a chronology for each using the built-in chronology for one artist and the {{Extra chronology}} template for the other(s).
Wikipedia's date style guidelines recommend that years should not be linked within the chronology section.
- Note: album cover images should NOT be used in this section as they do not meet Wikipedia fair use requirements.
Examples
Here are some examples of articles using the infoboxes:
Notes
- ↑ 1.0 1.1 1.2 1.3 1.4 For short horizontal lists of two or three items, comma separators are acceptable, but for longer lists the use of {{flatlist}} or {{hlist}} is preferred as they offer a benefit to users of screen readers. Vertical lists should always be implemented by {{plainlist}} or {{ubl}} and never by
<br />tags for reasons of accessibility.
Microformat
TemplateData
TemplateData for Infobox single
An Infobox for singles
| Parameter | Description | Type | Status | |
|---|---|---|---|---|
| Name | name Name | The name of the single.
| String | optional |
| Cover | cover image Cover | An image of the single cover, a file name, e.g. 'Relax_single.jpg'. The image should be uploaded with the fair use tag {{Non-free album cover}}. | String | suggested |
| Border | border Border | Set to yes to put a 1 pixel border around the cover image. | String | optional |
| Alt text | alt Alt | Alt text for the cover image, to describe it to visually impaired readers. | String | suggested |
| Caption | caption Caption | Caption for the cover image. | String | optional |
| Artist | artist Artist | The name of the artist. | String | required |
| Album | album from Album from_album Album | If the single was also released on an album, enter the name of the album. If the album has a Wikipedia article, link the article name as usual. The template will italicize the album name. For guidelines on whether a single should be described as being from a particular album, see [[Template:infobox album#Template:Singles]]. | String | suggested |
| A-side | A-side a-side | The A-side song title if different from the name. If it has a Wikipedia article use a link. Only one of the fields 'A-side' or 'B-side' should be used. | String | optional |
| B-side | B-side b-side | Use this field to display the B-side song title appearing on the opposite side of the single. If it has a Wikipedia article use a link. Only one of the fields 'A-side' or 'B-side' should be used. | String | optional |
| Released | released Released | The earliest known date of commercial release, using a single occurrence of {{Start date}} as {{Start date|YYYY|MM|DD}}, for example {{Start date|2007|7|31}}. (Use {{Start date|YYYY|MM}} if only year and month are known, or {{Start date|YYYY}} for just a year). | String | suggested |
| Recorded | recorded Recorded | This field should include details on when and where the song was recorded. Separate multiple values using {{Plainlist}}. | String | optional |
| Venue | venue Venue | For live recordings, include the name of the venue (concert hall, stadium, etc.) and location. Link as appropriate. | String | optional |
| Studio | studio Studio | If the single was recorded in a recording studio, enter the name and location here. Link the studio, but not well-known cities (see WP:OVERLINK). Separate multiple values using commas, {{flatlist}} or {{hlist}}. | String | optional |
| Format | format Format | The way that the single was released; i.e. 7-inch single, 12-inch single, CD single, cassette single, digital download (note the piped download link). Separate multiple values using {{Flatlist}}. | String | optional |
| Genre | genre Genre | The music genres that the single is from. These must not be original research, and should be stated and referenced in a 'Composition' section of the article. Separate multiple values using {{Flatlist}}. | String | suggested |
| Length | length Length | The length should use {{Duration}} thus: {{Duration|m=3|s=45}}, renders as 3:45, for 3 minutes 45 seconds | String | suggested |
| Label | label Label | This field should refer to the label on which the single/album was originally released. Where significantly different versions have been released (featuring alternate track listings) e.g. U.S. vs. UK, the later release date and/or record label should be mentioned in the article. Drop words like 'Records' from the end of the label's name (e.g. use [[Universal Records|Universal]] rather than [[Universal Records]]). Separate multiple values using {{Flatlist}}. | String | suggested |
| Producer | producer Producer | The song's producer(s). Separate multiple values using {{Flatlist}}. | String | optional |
| ISWC | ISWC iswc | International Standard Musical Work Code
| String | optional |
| Writer | writer Writer | The song's writer(s). Separate multiple values using {{Flatlist}}. | String | optional |
| Chronology | chronology Chronology | Header for chronology section
| String | optional |
| Last single title | last_single_title Last single title | Title of the previous single in the artist's chronology. Link when appropriate.
| String | optional |
| Last single year | last_single_year Last single year | Year of the previous single in the artist's chronology.
| Unknown | optional |
| Previous single | last_single Last single | Previous single in the artist's chronology (in quotation marks), above its year of release (in brackets). Link when appropriate.
| String | optional |
| This single | this_single This single | Name (in bold and in quotation marks) and year of this single for the chronology.
| String | optional |
| Next single title | next_single_title Next single title | Title of the next single in the artist's chronology. Link when appropriate.
| String | optional |
| Next single year | next_single_year Next single year | Year of the next single in the artist's chronology.
| String | optional |
| Next single | next_single Next single | Next single in the artist's chronology (in quotation marks), above its year of release (in brackets). Link when appropriate. Don't use this parameter with «Next single title» or «Next single year».
| String | optional |
| Miscellaneous data | misc Misc | This field allows you to provide more infobox data such as additional chronologies using {{Extra chronology}}, a track listing using {{Extra track listing}}, extra covers using {{Extra album cover}}, or a sample of the music using {{Audiosample}}. Set 'Type=single' on those templates so the section titles use the same background color as the rest of the infobox. | String | optional |
Tracking category
- Category:Pages using infobox single with unknown parameters (0)
- Category:Pages using Infobox single with deprecated certification parameter (0)
See also