View source for Template:Infobox Simpsons episode/doc

{{Documentation subpage}}
{{Lua|Module:Check for unknown parameters}}
{{Wraps infobox|Infobox television episode}}
{{Auto italic title|italic_title|short=yes}}
{{Auto short description}}

'''Template:Infobox Simpsons episode''' is used to create an [[WP:Infobox|infobox]] which summarizes the main information of a ''[[The Simpsons]]'' episode.

== Usage ==
The infobox may be added by pasting the template as shown below into an article, typically at the top of an article above the lead section. This infobox creates a [[WP:Short description|short description]] based on the data provided to the infobox. For more information on this, see the documentation at [[Template:Television episode short description]].

{{Infobox Simpsons episode
| title          = {{{title}}}
| image          = {{{image}}}
| image_size     = {{{image_size}}}
| image_alt      = {{{image_alt}}}
| caption        = {{{caption}}}
| season         = {{{season}}}
| episode        = {{{episode}}}
| director       = {{{director}}}
| writer         = {{{writer}}}
| story          = {{{story}}}
| teleplay       = {{{teleplay}}}
| based_on       = {{{based_on}}}
| music          = {{{music}}}
| editor         = {{{editor}}}
| production     = {{{production}}}
| airdate        = {{{airdate}}}
| length         = {{{length}}}
| guests         = {{{guests}}}
| blackboard     = {{{blackboard}}}
| couch_gag      = {{{couch_gag}}}
| commentary     = {{{commentary}}}
| prev           = {{{prev}}}
| next           = {{{next}}}
}}
<section begin=infobox />
<syntaxhighlight lang="wikitext" style="overflow: auto;">
{{Infobox Simpsons episode
| title          = 
| image          = <!-- bare filename only. Wikilinking, "File:", and pixel size not required. -->
| image_size     = <!-- raw number. "px" not required. -->
| image_alt      = 
| caption        = 
| season         = 
| episode        = 
| director       = 
| writer         = 
| story          = 
| teleplay       = 
| based_on       = 
| music          = 
| editor         = 
| production     = 
| airdate        = <!-- {{Start date|YYYY|MM|DD}} -->
| length         = 
| guests         = 
| blackboard     = 
| couch_gag      = 
| commentary     = 
| prev           = 
| next           = 
}}
</syntaxhighlight>
<section end=infobox />
{{clear}}

== Parameters ==
{{Transcluded section|source=Template:Infobox television episode/doc}}
{{Trim|{{#section:Template:Infobox television episode/doc|Param-lead}}}}

{| class="wikitable"
|+ Template parameters
! scope="col" | Parameter
! scope="col" | Explanation
|-
{{Trim|{{#section:Template:Infobox television episode/doc|Parameters}}}}
|-
! scope="row" | blackboard
| A transcription of what [[Bart Simpson]] writes on the blackboard during the intro sequence, or what happens during this time.
|-
! scope="row" | couch_gag
| A description of the couch gag at the end of the show's intro sequence.
|-
! scope="row" | commentary{{efn|{{para|commentary}} also uses the plainlist class.}}
| The names of the staff members who provide audio commentary on the episode. Separate multiple people using bulleted lists (<code>*</code>)
|}

===TemplateData===
{{Collapse top|title=[[Wikipedia:TemplateData|TemplateData]] documentation used by [[Wikipedia:VisualEditor|VisualEditor]] and other tools}}
{{TemplateData header|noheader=1}}
<templatedata>
{
	"description": "Infobox used on articles about The Simpsons television episodes.",
	"params": {
		"italic_title": {
			"label": "Italic title",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "A \"no\" value will disable the automatic italicization of the series name in the parenthesis. This parameter should not be used most of the time. If the title should not be in quotation marks, use \"rtitle\" instead."
		},
		"title": {
			"label": "Title",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The title of the episode. Should not be used if the title is the same as the article title as the infobox handles this automatically. The title is automatically put within quotation marks."
		},
		"image": {
			"label": "Image",
			"type": "wiki-file-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "An image relevant to the episode."
		},
		"image_size": {
			"label": "Image size",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Image size in pixels. Should be 250 or less. If not specified, image defaults to frameless (220px). 'px' is not required."
		},
		"image_upright": {
			"label": "Image upright",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"default": "1.13",
			"description": ""
		},
		"image_alt": {
			"label": "Image alt",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Alt text for image per WP:MOSALT."
		},
		"caption": {
			"label": "Image caption",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "A caption explaining the image."
		},
		"season": {
			"label": "Season number",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The number of the season this episode is part of."
		},
		"episode": {
			"label": "Episode number",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The number of the episode within the season."
		},
		"director": {
			"label": "Director",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The director(s) of this episode. Separate multiple people using bulleted lists (<code>*</code>). In addition, link each director to their appropriate article if possible."
		},
		"writer": {
			"label": "Writer",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The writer(s) of this episode. Separate multiple people using bulleted lists (<code>*</code>). In addition, link each writer to their appropriate article if possible."
		},
		"story": {
			"label": "Story writer",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The writer(s) of the episode's story. Separate multiple people using bulleted lists (<code>*</code>). Use this field instead of the normal writer field if television episodes divide writing credits between teleplay and story writers."
		},
		"teleplay": {
			"label": "Teleplay writer",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The writer(s) of the episode's teleplay. Separate multiple people using bulleted lists (<code>*</code>). Use this field instead of the normal writer field if television episodes divide writing credits between teleplay and story writers."
		},
		"based_on": {
			"label": "Based on",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The original work the episode is based on. Use {{Tl|Based on}} to add the title of the source material and the name(s) of the source material writer(s). Use this field in conjunction with teleplay and story where applicable. This field should be used if the episode is based on previously produced or published material, such as books, plays, articles, old screenplays, etc. and should not be used where the source material is ambiguous. This field should not be used for general adaptations, such as ''The Flash'' (2014 TV series) episodes being based on characters from DC Comics, however, do use it if a specific episode of that series is a direct adaptation of a specific comic."
		},
		"music": {
			"label": "Music",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The music of this episode. Separate multiple songs using bulleted lists (<code>*</code>). Television episodes often include numerous songs; only include the most notable (typically songs playing during key scenes)."
		},
		"editor": {
			"label": "Editor",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The editor(s) of this episode. Separate multiple people using bulleted lists (<code>*</code>). In addition, link each editor to their appropriate article if possible."
		},
		"production": {
			"label": "Production code",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The production code or number of this episode. Separate multiple codes using bulleted lists (<code>*</code>)."
		},
		"airdate": {
			"label": "Airdate",
			"type": "date",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The original airing date of the episode; use {{Start date}}. Separate multiple dates using bulleted lists (<code>*</code>)."
		},
		"length": {
			"label": "Episode length",
			"type": "number",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The original length of the episode, including credits, in minutes. It should indicate run-time (without commercials), or with commercials.",
			"aliases": [
				"runtime"
			]
		},
		"guests": {
			"label": "Guest stars",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "Guest star(s) of this episode. Separate multiple people using bulleted lists (<code>*</code>). If using bullets, include the character the guest actor portray in the episode after their name in the infobox (using a single space, \"as\" and another single space: \"<actor> as <character>\"). Provide a link to the appropriate article if possible. Only guest actors in notable roles should be included in the list."
		},
		"blackboard": {
			"label": "Blackboard",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "A transcription of what [[Bart Simpson]] writes on the blackboard during the intro sequence, or what happens during this time."
		},
		"couch_gag": {
			"label": "Couch gag",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "A description of the couch gag at the end of the show's intro sequence."
		},
		"commentary": {
			"label": "Commentary",
			"type": "string",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The names of the staff members who provide audio commentary on the episode. Separate multiple people using bulleted lists (<code>*</code>)."
		},
		"prev": {
			"label": "Previous episode",
			"type": "wiki-page-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The title of the previous episode. If an article or redirect exist, link to it. If one does not exist, consider creating a redirect to the episode anchor in the season article. If a redirect isn't created directly link to the season article with an anchor to that episode. If this is the last episode of the TV series, leave blank. The title is automatically put within quotation marks, unless rprev is used."
		},
		"next": {
			"label": "Next episode",
			"type": "wiki-page-name",
			"required": false,
			"suggested": false,
			"deprecated": false,
			"description": "The title of the next episode. If an article or redirect exist, link to it. If one does not exist, consider creating a redirect to the episode anchor in the season article. If a redirect isn't created directly link to the season article with an anchor to that episode. If this is the last episode of the TV series, leave blank. The title is automatically put within quotation marks, unless rnext is used."
		}
	},
	"format": "\n{{_\n| _______________= _\n}}\n",
	"paramOrder": [
		"italic_title",
		"title",
		"image",
		"image_size",
		"image_upright",
		"image_alt",
		"caption",
		"season",
		"episode",
		"director",
		"writer",
		"story",
		"teleplay",
		"based_on",
		"music",
		"editor",
		"production",
		"airdate",
		"length",
		"guests",
		"blackboard",
		"couch_gag",
		"commentary",
		"prev",
		"next"
	]
}
</templatedata>
{{Collapse bottom}}

== Example ==
{{Infobox Simpsons episode
| title          = Cape Feare
| image          = 
| image_alt      = 
| caption        =
| season         = 5
| episode        = 2
| airdate        = {{Start date|1993|10|07}}
| production     = 9F22
| writer         = [[Jon Vitti]]
| director       = [[Rich Moore]]
| guests         = 
* [[Kelsey Grammer]] as [[Sideshow Bob]]
| blackboard     = "The cafeteria deep fryer is not a toy"
| couch_gag      = The family forms a chorus line, which turns into a large production number.
| commentary     =
* [[Matt Groening]]
* Al Jean
* Jon Vitti
| prev           = [[Homer's Barbershop Quartet]]
| next           = [[Homer Goes to College]]
}}

<syntaxhighlight lang="wikitext" style="overflow: auto;">
{{Infobox Simpsons episode
| title          = Cape Feare
| image          = 
| image_alt      = 
| caption        = 
| season         = 5
| episode        = 2
| airdate        = {{Start date|1993|10|07}}
| production     = 9F22
| writer         = [[Jon Vitti]]
| director       = [[Rich Moore]]
| guests         = 
* [[Kelsey Grammer]] as [[Sideshow Bob]]
| blackboard     = "The cafeteria deep fryer is not a toy"
| couch_gag      = The family forms a chorus line, which turns into a large production number.
| commentary     = 
* [[Matt Groening]]
* Al Jean
* Jon Vitti
| prev           = [[Homer's Barbershop Quartet]]
| next           = [[Homer Goes to College]]
}}
</syntaxhighlight>
{{clear}}

== Tracking category ==
* {{Category link with count|Pages using infobox television episode with unknown parameters}}

== See also ==
{{Film- and television-related infobox templates}}

== Notes ==
{{Notelist}}

<includeonly>{{Sandbox other||
<!-- CATEGORIES HERE, THANKS -->
[[Category:Television episode infobox templates|Simpsons episode]]
[[Category:The Simpsons templates]]
[[Category:Templates that add a tracking category]]
}}</includeonly>