Template:Episode list/doc
{{Documentation subpage}}
{{High-use}}
{{Lua|Module:Episode list}}
{{Bot use warning|bots=User:cewbot/log/20201008/configuration}}
{{tlb|Episode list}} creates a table row, for use in a list of episodes tables, primarily for television. This template is used in conjunction with {{tl|Episode table}} which creates a consistent and Manual of Style ready table. See walk-through for further explanation.
For pages using a manually created table, either convert them to use this template, or tag them with {{tl|Convert to Episode list}}, which will place the pages in {{clc|Articles lacking Episode list templates}}.
Usage
{{tl|Episode list}} may be added by pasting it as shown below into an article inside an {{tl|Episode table}} template. The number and the type of columns the table has is defined by the {{tl|Episode table}} parameters, and is not defined by this template. See that template's documentation for more information.
In order for this template to provide a table column for a given episode, parameters must either be included or excluded. An included parameter, although empty, will provide a cell for that field (and thus a column), while excluding a parameter will not provide a cell for that field. Empty cells will be automatically filled with "TBA", "TBD", or "N/A".
{{Episode list
| EpisodeNumber =
| EpisodeNumber2 =
| Title =
| RTitle =
| AltTitle =
| RAltTitle =
| TranslitTitle =
| NativeTitle =
| NativeTitleLangCode =
| Aux1 =
| DirectedBy =
| WrittenBy =
| Aux2 =
| Aux3 =
| OriginalAirDate =
| AltDate =
| ProdCode =
| Viewers =
| Aux4 =
| ShortSummary =
| LineColor =
| TopColor =
| RowColor =
}}
{{Episode table |background= |overall= |season= |title= |aux1= |aux1T=Aux1 |director= |writer= |aux2= |aux2T=Aux2 |aux3= |aux3T=Aux3 |airdate= |altdate= |altdateT=AltDate |prodcode= |viewers= |country=U.S. |aux4= |aux4T=Aux4 |episodes=
{{Episode list
| EpisodeNumber = {{{EpisodeNumber}}}
| EpisodeNumber2 = {{{EpisodeNumber2}}}
| Title = {{{Title}}}
| RTitle = {{{RTitle}}}
| AltTitle = {{{AltTitle}}}
| RAltTitle = {{{RAltTitle}}}
| Aux1 = {{{Aux1}}}
| DirectedBy = {{{DirectedBy}}}
| WrittenBy = {{{WrittenBy}}}
| Aux2 = {{{Aux2}}}
| Aux3 = {{{Aux3}}}
| OriginalAirDate = {{{OriginalAirDate}}}
| AltDate = {{{AltDate}}}
| ProdCode = {{{ProdCode}}}
| Viewers = {{{Viewers}}}
| Aux4 = {{{Aux4}}}
| ShortSummary = {{{ShortSummary}}}
}}
}}
Parameters
class="wikitable"
|+ Episode list parameters and basic guidelines ! scope="col" | Parameter ! scope="col" | Explanation |
scope="row" | 1
| The title of the article the table is located in. |
---|
scope="row" | NumParts
| The number of titles an episode has or the number of serials a story has. See examples section for usage. |
id="EpisodeNumber"
! EpisodeNumber | A number representing the episode's order in the series. For example, the first episode would be |
{{Unbulleted list|EpisodeNumber_1|EpisodeNumber_2|etc.}}
| A number representing the episode's order in the series. Used when {{para|NumParts}} is used, as there are multiple entries for an episode, and should be used instead of {{para|EpisodeNumber}}. The number of episodes should not exceed the number set in {{para|NumParts}}. |
scope="row" | EpisodeNumber2
| A second episode number column. Typically used to indicate the episode's order in the season. This parameter can also be useful for when a series aired in a different order. |
scope="row" | {{Unbulleted list|EpisodeNumber2_1|EpisodeNumber2_2|etc.}}
| A second episode number column. Used when {{para|NumParts}} is used, as there are multiple entries for an episode, and should be used instead of {{para|EpisodeNumber2}}. The number of episodes should not exceed the number set in {{para|NumParts}}. |
scope="row" | Title
| The title of the episode. The title will appear in "quotes" when rendered, so it is not necessary to place them in quotes beforehand. Only link to an episode article if it has already been created. |
scope="row" | {{Unbulleted list|Title_1|Title_2|etc.}}
| The title of the episode. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|Title}}. The number of titles should not exceed the number set in {{para|NumParts}}. |
scope="row" | RTitle
| Unformatted parameter that can be used to add a reference after {{para|Title}}, or can be used as a "{{strong|raw}} title" to replace {{para|Title}} completely. Future episodes should include a reference in this field to comply with Wikipedia:Verifiability. |
scope="row" | {{Unbulleted list|RTitle_1|RTitle_2|etc.}}
| Unformatted parameter that can be used to add a reference after {{para|Title}}, or can be used as a "{{strong|raw}} title" to replace {{para|Title}} completely. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|RTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}. |
scope="row" | AltTitle
| An alternative title, such as a title that was originally changed. The title will appear in "quotes" when rendered. If {{para|Title}} is also present, it will be listed below. |
scope="row" | {{Unbulleted list|AltTitle_1|AltTitle_2|etc.}}
| An alternative title, such as a title that was originally changed. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|AltTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}. |
scope="row" | RAltTitle
| Unformatted parameter that can be used to add a reference after {{para|AltTitle}}, or can be used as a "{{strong|raw}} title" to replace {{para|AltTitle}} completely. |
scope="row" | {{Unbulleted list|RAltTitle_1|RAltTitle_2|etc.}}
| Unformatted parameter that can be used to add a reference after {{para|AltTitle}}, or can be used as a "{{strong|raw}} title" to replace {{para|AltTitle}} completely. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|RAltTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}. |
scope="row" | TranslitTitle
| The title of the episode transliteration (Romanization) to Latin characters. |
scope="row" | {{Unbulleted list|TranslitTitle_1|TranslitTitle_2|etc.}}
| The title of the episode transliteration (Romanization) to Latin characters. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|TranslitTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}. |
scope="row" | NativeTitle
| The title of the episode in the native language. |
scope="row" | {{Unbulleted list|NativeTitle_1|NativeTitle_2|etc.}}
| The title of the episode in the native language. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|NativeTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}. |
scope="row" | NativeTitleLangCode
| The [https://www.loc.gov/standards/iso639-2/php/English_list.php language code] of the native title language. |
scope="row" | Aux1
| General purpose parameter. The meaning is specified by the column header. The {{para|Guests}} parameter is an alias of Aux1, both parameters cannot be used at the same time. |
scope="row" | {{Unbulleted list|Aux1_1|Aux1_2|etc.}}
| The title of the serial. Used when {{para|NumParts}} is used, as there are multiple serials in a story, and should be used instead of {{para|Aux1}}. The number of titles should not exceed the number set in {{para|NumParts}}. |
scope="row" | DirectedBy
| Name of the episode's director. |
scope="row" | WrittenBy
| Name of the credited episode's writer(s). |
scope="row" | Aux2
| General purpose parameter. The meaning is specified by the column header. The {{para|MusicalGuests}} parameter is an alias of Aux2, both parameters cannot be used at the same time. |
scope="row" | Aux3
| General purpose parameter. The meaning is specified by the column header. |
scope="row" | OriginalAirDate
| The date the episode first aired, or is scheduled to air. Format date using {{tl|Start date}}; use {{para|df|y}} for day-first format; omit for month-first. |
scope="row" | {{Unbulleted list|OriginalAirDate_1|OriginalAirDate_2|etc.}}
| The date the episode first aired, or is scheduled to air. Used when {{para|NumParts}} is used, as there are multiple serials in a story, and should be used instead of {{para|OriginalAirDate}}. The number of dates should not exceed the number set in {{para|NumParts}}. |
scope="row" | AltDate
| The next notable air date, such as the first air date of an anime in English. Format date per MOS:DATE. Do not use {{tl|Start date}} if {{para|OriginalAirDate}} is present.{{tl|Start date}} emits metadata as part of the parent template's hCalendar microformat. It is only needed once per episode, and may be harmful if used twice or more. |
scope="row" | ProdCode
| The production code in the series. When defined, this parameter also creates a link anchor, prefixed by " |
scope="row" | Viewers
| The number of viewers who watched the episode. Should include a reference. The inclusion of viewer figures is supported by MOS:TV and provides encyclopedic content beyond what might normally be found in a TV guide. It is therefore desirable to include referenced ratings information in an episode list. "Final" viewer numbers should be used. |
scope="row" | {{Unbulleted list|Viewers_1|Viewers_2|etc.}}
| The number of viewers who watched the episode. Used when {{para|NumParts}} is used, as there are multiple serials in a story, and should be used instead of {{para|Viewers}}. The number of parameters should not exceed the number set in {{para|NumParts}}. |
scope="row" | Aux4
| General purpose parameter. The meaning is specified by the column header. |
scope="row" | {{Unbulleted list|Aux4_1|Aux4_2|etc.}}
| General purpose parameter. Used when {{para|NumParts}} is, as there are multiple serials in a story, and should be used instead of {{para|Aux4}}. The number of parameters should not exceed the number set in {{para|NumParts}}. |
scope="row" | ShortSummary
| {{anchor|ShortSummary}}A short 100–200 word plot summary of the episode. Make summaries specific to that episode (as in, a description that would normally not be confused with another episode). Episode summaries must not be copied from other sources, as this violates WP:COPYRIGHT. Further guidance on plot summaries may be found at WP:TVPLOT. Leaving this parameter empty will result in the summary row not appearing for the episode. If |
scope="row" | LineColor
| Colors the separator line between episode entries. If not defined the color defaults to " |
scope="row" | TopColor
| Colors the main row of information (that is, not the {{para|ShortSummary}} row). If not defined, it defaults to the wikitable standard background shading of " |
scope="row" | RowColor
| This parameter is a "switch" that must only be defined when the {{para|EpisodeNumber}} value is not a regular number (e.g. "12–13" for two episodes described in one table entry). When transcluding the table from a season article into a main episode list article, irregular {{para|EpisodeNumber}} values break up the striping effect the template introduces. If the first episode number is even, set {{para|RowColor|on}}. If the first episode number is odd, set {{para|RowColor|off}}. All further uses of Template:Episode list in the table must also have the {{para|RowColor}} parameters defined to alternate between |
=TemplateData=
{{Collapse top|title=TemplateData documentation used by VisualEditor and other tools}}
{{TemplateData header|noheader=1}}
{
"description": "This template creates a table row, for use in a list of episodes, primarily for television. The number, and use, of columns a table has, is defined by the beginning wikitext of that table (further explained below), and is not defined by this template. In order for this template to provide a table column for a given episode, parameters must either be included or excluded. An included parameter, although empty, will provide a cell for that field (and thus column), while excluding a parameter will not provide a cell for that field. Empty cells will be automatically filled with {{TableTBA}}. It is used within {{Episode table}}.",
"params": {
"1": {
"label": "Article name (/sublist)",
"type": "string",
"deprecated": false,
"description": "The title of the article the table is located in. Should be only used with {{Episode list/sublist}} sub-template. "
},
"NumParts": {
"label": "Number of parts",
"type": "number",
"required": false,
"suggested": false,
"deprecated": false,
"description": "The number of titles an episode has or the number of serials a story has."
},
"EpisodeNumber": {
"label": "Episode number",
"type": "number",
"required": false,
"suggested": true,
"deprecated": false,
"description": "A number representing the episode's order in the series. For example, the first episode would be 1
, followed by 2
, and so on."
},
"EpisodeNumber2": {
"label": "Second episode number",
"type": "number",
"required": false,
"suggested": true,
"deprecated": false,
"description": "A second episode number column. Typically used to indicate the episode's order in the season. This parameter can also be useful for when a series aired in a different order."
},
"Title": {
"label": "Title",
"type": "wiki-page-name",
"required": false,
"suggested": true,
"deprecated": false,
"description": "The title of the episode. The title will appear in \"quotes\" when rendered, so it is not necessary to place them in quotes beforehand. Only link to an episode article if it has already been created."
},
"RTitle": {
"label": "Title reference (or title raw)",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "Unformatted parameter that can be used to add a reference after \"Title\", or can be used as a \"raw title\" to replace \"Title\" completely. Future episodes should include a reference in this field to comply with Unformatted parameter that can be used to add a reference after {{para|Title}}, or can be used as a \"{{strong|raw}} title\" to replace {{para|Title}} completely. Future episodes should include a reference in this field to comply with Wikipedia:Verifiability."
},
"AltTitle": {
"label": "Alternative title",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "An alternative title, such as a title that was originally changed. The title will appear in \"quotes\" when rendered. If {{para|Title}} is also present, it will be listed below."
},
"RAltTitle": {
"label": "Alternative title's reference (or alternative title raw)",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "Unformatted parameter that can be used to add a reference after {{para|AltTitle}}, or can be used as a \"{{strong|raw}} title\" to replace {{para|AltTitle}} completely."
},
"TranslitTitle": {
"label": "Transliteration title",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "The title of the episode transliteration (Romanization) to Latin characters."
},
"NativeTitle": {
"label": "Native title",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "The title of the episode in the native language."
},
"NativeTitleLangCode": {
"label": "Native title language code",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "The language code of the native title language."
},
"Aux1": {
"label": "Extra column 1",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "General purpose parameter. The meaning is specified by the column header.",
"aliases": [
"Guests"
]
},
"DirectedBy": {
"label": "Directed by",
"type": "string",
"required": false,
"suggested": true,
"deprecated": false,
"description": "Name of the episode's director."
},
"WrittenBy": {
"label": "Written by",
"type": "string",
"required": false,
"suggested": true,
"deprecated": false,
"description": "Name of the credited episode's writer(s)."
},
"Aux2": {
"label": "Extra column 2",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "General purpose parameter. The meaning is specified by the column header.",
"aliases": [
"MusicalGuests"
]
},
"Aux3": {
"label": "Extra column 3",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "General purpose parameter. The meaning is specified by the column header."
},
"OriginalAirDate": {
"label": "Original air date",
"type": "string",
"required": false,
"suggested": true,
"deprecated": false,
"description": "The date the episode first aired, or is scheduled to air. Format date using {{tl|Start date}}; use {{para|df|y}} for day-first format; omit for month-first."
},
"AltDate": {
"label": "Second notable air date",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "The next notable air date, such as the first air date of an anime in English. Format date per MOS:DATE. Do not use {{tl|Start date}} if {{para|OriginalAirDate}} is present."
},
"ProdCode": {
"label": "Production code",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "The production code in the series."
},
"Viewers": {
"label": "Number of viewers",
"type": "string",
"required": false,
"suggested": true,
"deprecated": false,
"description": "The number of viewers who watched the episode. Should include a reference."
},
"Aux4": {
"label": "Extra column 4",
"type": "content",
"required": false,
"suggested": false,
"deprecated": false,
"description": "General purpose parameter. The meaning is specified by the column header."
},
"ShortSummary": {
"label": "Short summary",
"type": "string",
"required": false,
"suggested": true,
"deprecated": false,
"description": "A short 100–200 word plot summary of the episode. Make summaries specific to that episode (as in, a description that would normally not be confused with another episode). Episode summaries must not be copied from other sources, as this violates WP:COPYRIGHT. "
},
"LineColor": {
"label": "Border color",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "Colors the separator line between episode entries. If not defined the color defaults to \"#CCCCFF
\"."
},
"TopColor": {
"label": "Top color",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "Colors the main row of information (that is, not the {{para|ShortSummary}} row). If not defined, it defaults to the wikitable standard background shading of \"#F9F9F9
\", except when {{para|ShortSummary}} is used, and then it defaults to \"#f2f2f2
\"."
},
"RowColor": {
"label": "Row banding color override",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "This parameter is a \"switch\" that must only be defined when the {{para|EpisodeNumber}} value is not a regular number (e.g. \"12–13\" for two episodes described in one table entry). When transcluding the table from a season article into a main episode list article, irregular {{para|EpisodeNumber}} values break up the striping effect the template introduces. If the first episode number is even, set {{para|RowColor|on}}. If the first episode number is odd, set {{para|RowColor|off}}. All further uses of Template:Episode list in the table must also have the {{para|RowColor}} parameters defined to alternate between off
and on
to avoid further breakages in the striping."
},
"Title_1": {
"label": "Title (multi-part episode 1)",
"type": "wiki-page-name",
"required": false,
"suggested": true,
"deprecated": false,
"description": "The title of the episode. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|Title}}. The number of titles should not exceed the number set in {{para|NumParts}}."
},
"Title_2": {
"inherits": "Title_1"
},
"Title_3": {
"inherits": "Title_1"
},
"Title_4": {
"inherits": "Title_1"
},
"Title_5": {
"inherits": "Title_1"
},
"Title_6": {
"inherits": "Title_1"
},
"Title_7": {
"inherits": "Title_1"
},
"Title_8": {
"inherits": "Title_1"
},
"Title_9": {
"inherits": "Title_1"
},
"RTitle_1": {
"label": "Title reference / title raw (multi-part episode 1)",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "Unformatted parameter that can be used to add a reference after {{para|Title}}, or can be used as a \"{{strong|raw}} title\" to replace {{para|Title}} completely. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|RTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}."
},
"RTitle_2": {
"inherits": "RTitle_1"
},
"RTitle_3": {
"inherits": "RTitle_1"
},
"RTitle_4": {
"inherits": "RTitle_1"
},
"RTitle_5": {
"inherits": "RTitle_1"
},
"RTitle_6": {
"inherits": "RTitle_1"
},
"RTitle_7": {
"inherits": "RTitle_1"
},
"RTitle_8": {
"inherits": "RTitle_1"
},
"RTitle_9": {
"inherits": "RTitle_1"
},
"AltTitle_1": {
"label": "Alternative title (multi-part episode 1)",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "An alternative title, such as a title that was originally changed. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|AltTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}."
},
"AltTitle_2": {
"inherits": "AltTitle_1"
},
"AltTitle_3": {
"inherits": "AltTitle_1"
},
"AltTitle_4": {
"inherits": "AltTitle_1"
},
"AltTitle_5": {
"inherits": "AltTitle_1"
},
"AltTitle_6": {
"inherits": "AltTitle_1"
},
"AltTitle_7": {
"inherits": "AltTitle_1"
},
"AltTitle_8": {
"inherits": "AltTitle_1"
},
"AltTitle_9": {
"inherits": "AltTitle_1"
},
"RAltTitle_1": {
"label": "Alternative title's reference / alternative title raw (multi-part episode 1)",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "Unformatted parameter that can be used to add a reference after {{para|AltTitle}}, or can be used as a \"{{strong|raw}} title\" to replace {{para|AltTitle}} completely. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|RAltTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}."
},
"RAltTitle_2": {
"inherits": "RAltTitle_1"
},
"RAltTitle_3": {
"inherits": "RAltTitle_1"
},
"RAltTitle_4": {
"inherits": "RAltTitle_1"
},
"RAltTitle_5": {
"inherits": "RAltTitle_1"
},
"RAltTitle_6": {
"inherits": "RAltTitle_1"
},
"RAltTitle_7": {
"inherits": "RAltTitle_1"
},
"RAltTitle_8": {
"inherits": "RAltTitle_1"
},
"RAltTitle_9": {
"inherits": "RAltTitle_1"
},
"TranslitTitle_1": {
"label": "Transliteration title (multi-part episode 1)",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "The title of the episode transliteration (Romanization) to Latin characters. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|TranslitTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}."
},
"TranslitTitle_2": {
"inherits": "TranslitTitle_1"
},
"TranslitTitle_3": {
"inherits": "TranslitTitle_1"
},
"TranslitTitle_4": {
"inherits": "TranslitTitle_1"
},
"TranslitTitle_5": {
"inherits": "TranslitTitle_1"
},
"TranslitTitle_6": {
"inherits": "TranslitTitle_1"
},
"TranslitTitle_7": {
"inherits": "TranslitTitle_1"
},
"TranslitTitle_8": {
"inherits": "TranslitTitle_1"
},
"TranslitTitle_9": {
"inherits": "TranslitTitle_1"
},
"NativeTitle_1": {
"label": "Native title (multi-part episode 1)",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "The title of the episode in the native language. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|NativeTitle}}. The number of titles should not exceed the number set in {{para|NumParts}}."
},
"NativeTitle_2": {
"inherits": "NativeTitle_1"
},
"NativeTitle_3": {
"inherits": "NativeTitle_1"
},
"NativeTitle_4": {
"inherits": "NativeTitle_1"
},
"NativeTitle_5": {
"inherits": "NativeTitle_1"
},
"NativeTitle_6": {
"inherits": "NativeTitle_1"
},
"NativeTitle_7": {
"inherits": "NativeTitle_1"
},
"NativeTitle_8": {
"inherits": "NativeTitle_1"
},
"NativeTitle_9": {
"inherits": "NativeTitle_1"
},
"Aux1_1": {
"label": "Extra column 1 (multi-part episode 1)",
"type": "string",
"required": false,
"suggested": false,
"deprecated": false,
"description": "The title of the serial. Used when {{para|NumParts}} is used, as there are multiple titles for an episode, and should be used instead of {{para|Aux1}}. The number of titles should not exceed the number set in {{para|NumParts}}."
},
"Aux1_2": {
"inherits": "Aux1_1"
},
"Aux1_3": {
"inherits": "Aux1_1"
},
"Aux1_4": {
"inherits": "Aux1_1"
},
"Aux1_5": {
"inherits": "Aux1_1"
},
"Aux1_6": {
"inherits": "Aux1_1"
},
"Aux1_7": {
"inherits": "Aux1_1"
},
"Aux1_8": {
"inherits": "Aux1_1"
},
"Aux1_9": {
"inherits": "Aux1_1"
},
"OriginalAirDate_1": {
"label": "Original air date (multi-part episode 1)",
"type": "date",
"required": false,
"suggested": true,
"deprecated": false,
"description": "The date the episode first aired, or is scheduled to air. Used when {{para|NumParts}} is used, as there are multiple serials in a story, and should be used instead of {{para|OriginalAirDate}}. The number of dates should not exceed the number set in {{para|NumParts}}."
},
"OriginalAirDate_2": {
"inherits": "OriginalAirDate_1"
},
"OriginalAirDate_3": {
"inherits": "OriginalAirDate_1"
},
"OriginalAirDate_4": {
"inherits": "OriginalAirDate_1"
},
"OriginalAirDate_5": {
"inherits": "OriginalAirDate_1"
},
"OriginalAirDate_6": {
"inherits": "OriginalAirDate_1"
},
"OriginalAirDate_7": {
"inherits": "OriginalAirDate_1"
},
"OriginalAirDate_8": {
"inherits": "OriginalAirDate_1"
},
"OriginalAirDate_9": {
"inherits": "OriginalAirDate_1"
},
"Viewers_1": {
"label": "Number of viewers (multi-part episode 1)",
"type": "string",
"required": false,
"suggested": true,
"deprecated": false,
"description": "The number of viewers who watched the episode. Used when {{para|NumParts}} is used, as there are multiple serials in a story, and should be used instead of {{para|Viewers}}. The number of dates should not exceed the number set in {{para|NumParts}}."
},
"Viewers_2": {
"inherits": "Viewers_1"
},
"Viewers_3": {
"inherits": "Viewers_1"
},
"Viewers_4": {
"inherits": "Viewers_1"
},
"Viewers_5": {
"inherits": "Viewers_1"
},
"Viewers_6": {
"inherits": "Viewers_1"
},
"Viewers_7": {
"inherits": "Viewers_1"
},
"Viewers_8": {
"inherits": "Viewers_1"
},
"Viewers_9": {
"inherits": "Viewers_1"
},
"Aux4_1": {
"label": "Extra column 4 (multi-part episode 1)",
"type": "content",
"required": false,
"suggested": false,
"deprecated": false,
"description": "General purpose parameter. The meaning is specified by the column header. Used when {{para|NumParts}} is used, as there are multiple serials in a story, and should be used instead of {{para|Aux4}}. The number of dates should not exceed the number set in {{para|NumParts}}."
},
"Aux4_2": {
"inherits": "Aux4_1"
},
"Aux4_3": {
"inherits": "Aux4_1"
},
"Aux4_4": {
"inherits": "Aux4_1"
},
"Aux4_5": {
"inherits": "Aux4_1"
},
"Aux4_6": {
"inherits": "Aux4_1"
},
"Aux4_7": {
"inherits": "Aux4_1"
},
"Aux4_8": {
"inherits": "Aux4_1"
},
"Aux4_9": {
"inherits": "Aux4_1"
},
"EpisodeNumber3": {
"label": "Third episode number",
"description": "A third episode number column. Used in rare cases when episodes have a third order of numbering.",
"type": "number"
}
},
"format": "{{_\n| ____________________= _\n}}\n",
"paramOrder": [
"1",
"NumParts",
"EpisodeNumber",
"EpisodeNumber2",
"EpisodeNumber3",
"Title",
"RTitle",
"AltTitle",
"RAltTitle",
"TranslitTitle",
"NativeTitle",
"NativeTitleLangCode",
"Aux1",
"DirectedBy",
"WrittenBy",
"Aux2",
"Aux3",
"OriginalAirDate",
"AltDate",
"ProdCode",
"Viewers",
"Aux4",
"ShortSummary",
"LineColor",
"TopColor",
"RowColor",
"Title_1",
"Title_2",
"Title_3",
"Title_4",
"Title_5",
"Title_6",
"Title_7",
"Title_8",
"Title_9",
"RTitle_1",
"RTitle_2",
"RTitle_3",
"RTitle_4",
"RTitle_5",
"RTitle_6",
"RTitle_7",
"RTitle_8",
"RTitle_9",
"AltTitle_1",
"AltTitle_2",
"AltTitle_3",
"AltTitle_4",
"AltTitle_5",
"AltTitle_6",
"AltTitle_7",
"AltTitle_8",
"AltTitle_9",
"RAltTitle_1",
"RAltTitle_2",
"RAltTitle_3",
"RAltTitle_4",
"RAltTitle_5",
"RAltTitle_6",
"RAltTitle_7",
"RAltTitle_8",
"RAltTitle_9",
"TranslitTitle_1",
"TranslitTitle_2",
"TranslitTitle_3",
"TranslitTitle_4",
"TranslitTitle_5",
"TranslitTitle_6",
"TranslitTitle_7",
"TranslitTitle_8",
"TranslitTitle_9",
"NativeTitle_1",
"NativeTitle_2",
"NativeTitle_3",
"NativeTitle_4",
"NativeTitle_5",
"NativeTitle_6",
"NativeTitle_7",
"NativeTitle_8",
"NativeTitle_9",
"Aux1_1",
"Aux1_2",
"Aux1_3",
"Aux1_4",
"Aux1_5",
"Aux1_6",
"Aux1_7",
"Aux1_8",
"Aux1_9",
"OriginalAirDate_1",
"OriginalAirDate_2",
"OriginalAirDate_3",
"OriginalAirDate_4",
"OriginalAirDate_5",
"OriginalAirDate_6",
"OriginalAirDate_7",
"OriginalAirDate_8",
"OriginalAirDate_9",
"Viewers_1",
"Viewers_2",
"Viewers_3",
"Viewers_4",
"Viewers_5",
"Viewers_6",
"Viewers_7",
"Viewers_8",
"Viewers_9",
"Aux4_1",
"Aux4_2",
"Aux4_3",
"Aux4_4",
"Aux4_5",
"Aux4_6",
"Aux4_7",
"Aux4_8",
"Aux4_9"
]
}
{{Collapse bottom}}
Complete usage walk-through
To create an episode list, first create the table columns with the use of {{tl|Episode table}} as following:
{{Episode table |overall= |title= |airdate= |prodcode= |episodes=
Be mindful that {{para|episodes}} has been included as the final parameter of {{tl|Episode table}} for the individual {{tl|Episode list}} templates to appear, as excluding it can cause lint errors.
Next, add the {{tl|Episode list}} templates below:
{{Episode list
| EpisodeNumber =
| Title =
| OriginalAirDate =
| ProdCode =
| ShortSummary =
}}
{{Episode list
| EpisodeNumber =
| Title =
| OriginalAirDate =
| ProdCode =
| ShortSummary =
}}
Lastly, after the final episode list template, close the {{tl|Episode table}} with:
}}
The complete code will look like this:
{{Episode table |overall= |title= |airdate= |prodcode= |episodes=
{{Episode list
| EpisodeNumber =
| Title =
| OriginalAirDate =
| ProdCode =
| ShortSummary =
}}
{{Episode list
| EpisodeNumber =
| Title =
| OriginalAirDate =
| ProdCode =
| ShortSummary =
}}
}}
Examples
= Standard =
To create an episode list with the columns: episode number in series, episode number in season, title, director, writer, show-specific parameter, air date, production code and number of U.S. viewers – add the following code:
{{Episode table |background=#812f09 |overall= |season= |title= |director= |writer= |aux2= |aux2T=Ben's location |airdate= |prodcode= |viewers= |country=U.S. |episodes=
{{Episode list/sublist|List of Carnivàle episodes
| EpisodeNumber = 1
| EpisodeNumber2 = 1
| Title = Milfay
| DirectedBy = Rodrigo García
| WrittenBy = Daniel Knauf
| Aux2 = Milfay, Oklahoma
| OriginalAirDate = {{Start date|2003|9|14}}
| ProdCode = 1–01
| Viewers = 5.3
| ShortSummary = Ben suffers strange dreams about a trench war, and a tattooed man stalking in a cornfield.
| LineColor = 812f09
}}
{{Episode list/sublist|List of Carnivàle episodes
| EpisodeNumber = 2
| EpisodeNumber2 = 2
| Title = After the Ball Is Over
| DirectedBy = Jeremy Podeswa
| WrittenBy = Daniel Knauf
| Aux2 = Tipton, Missouri
| OriginalAirDate = {{Start date|2003|9|21}}
| ProdCode = 1–02
| Viewers = 3.49
| ShortSummary = Ben is slowly setting in as a carnival roustabout.
| LineColor = 812f09
}}
}}
{{Episode table |background=#812f09 |overall= |season= |title= |director= |writer= |aux2= |aux2T=Ben's location |airdate= |prodcode= |viewers= |country=U.S. |episodes=
{{Episode list
| EpisodeNumber = 1
| EpisodeNumber2 = 1
| Title = Milfay
| DirectedBy = Rodrigo García
| WrittenBy = Daniel Knauf
| Aux2 = Milfay, Oklahoma
| OriginalAirDate = {{Start date|2003|9|14}}
| ProdCode = 1–01
| Viewers = 5.3
| ShortSummary = Ben suffers strange dreams about a trench war, and a tattooed man stalking in a cornfield.
| LineColor = 812f09
}}
{{Episode list
| EpisodeNumber = 2
| EpisodeNumber2 = 2
| Title = After the Ball Is Over
| DirectedBy = Jeremy Podeswa
| WrittenBy = Daniel Knauf
| Aux2 = Tipton, Missouri
| OriginalAirDate = {{Start date|2003|9|21}}
| ProdCode = 1–02
| Viewers = 3.49
| ShortSummary = Ben is slowly setting in as a carnival roustabout.
| LineColor = 812f09
}}
}}
= Non-English titles =
To create an episode list which includes a native title and/or transliterated title – add the following code:
{{Episode table |background=#0C5829 |overall= |overallT=Japanese episode {{abbr|no.|number}} |season= |seasonT=U.S. episode {{abbr|no.|number}} |title= |director= |writer= |airdate= |episodes=
{{Episode list/sublist|List of Pokémon: Indigo League episodes
| EpisodeNumber = 1
| EpisodeNumber2 = 1
| Title = Pokémon, I Choose You!
| RTitle = (Pokémon I Choose You!)
| TranslitTitle = Pokemon! Kimi ni Kimeta!
| NativeTitle = ポケモン! きみにきめた!
| NativeTitleLangCode = ja
| DirectedBy = Masamitsu Hidaka
| WrittenBy = Shoji Yonemura
| OriginalAirDate = {{Start date|1997|4|1}}
| ShortSummary = Ash Ketchum is finally 10 years old, old enough to become a Pokémon Trainer.
| LineColor = #0C5829
}}
}}
{{Episode table |background=#0C5829 |overall= |overallT=Japanese episode {{abbr|no.|number}} |season= |seasonT=U.S. episode {{abbr|no.|number}} |title= |director= |writer= |airdate= |episodes=
{{Episode list
| EpisodeNumber = 1
| EpisodeNumber2 = 1
| Title = Pokémon, I Choose You!
| RTitle = (Pokémon I Choose You!)
| TranslitTitle = Pokemon! Kimi ni Kimeta!
| NativeTitle = ポケモン! きみにきめた!
| NativeTitleLangCode = ja
| DirectedBy = Masamitsu Hidaka
| WrittenBy = Shoji Yonemura
| OriginalAirDate = {{Start date|1997|4|1}}
| ShortSummary = Ash Ketchum is finally 10 years old, old enough to become a Pokémon Trainer.
| LineColor = #0C5829
}}
}}
= Episode with multiple titles =
To create an episode list which includes an episode with multiple titles – add the following code:
{{Episode table |background=#69D0E3 |overall= |title= |airdate= |episodes=
{{Episode list/sublist|Ninja Nonsense
| NumParts = 2
| EpisodeNumber = 1
| Title_1 = Shinobu, the Ninja Apprentice, Appears
| TranslitTitle_1 = Minarai Ninja, Shinobu Kenzan no Maki
| NativeTitle_1 = 見習い忍者、忍見参の巻
| Title_2 = The Master Appears
| TranslitTitle_2 = Tōryō, Arawaru no Maki
| NativeTitle_2 = 頭領、現るの巻
| NativeTitleLangCode = ja
| OriginalAirDate = {{Start date|2004|7|8}}
| ShortSummary = Episode summary
| LineColor = #69D0E3
}}
}}
{{Episode table |background=#69D0E3 |overall= |title= |airdate= |episodes=
{{Episode list
| NumParts = 2
| EpisodeNumber = 1
| Title_1 = Shinobu, the Ninja Apprentice, Appears
| TranslitTitle_1 = Minarai Ninja, Shinobu Kenzan no Maki
| NativeTitle_1 = 見習い忍者、忍見参の巻
| Title_2 = The Master Appears
| TranslitTitle_2 = Tōryō, Arawaru no Maki
| NativeTitle_2 = 頭領、現るの巻
| NativeTitleLangCode = ja
| OriginalAirDate = {{Start date|2004|7|8}}
| ShortSummary = Episode summary
| LineColor = #69D0E3
}}
}}
= Serials =
To create an episode list for a serial (such as those used in Doctor Who) – add the following code:
{{Episode table
|background = #8D3D63 |overall= |overallT=Story |series= |seriesT=Serial |title= |aux1= |aux1T=Serial titles |director= |writer= |airdate= |prodcode= |viewers= |country=UK |aux4= |aux4T=Appreciation Index |episodes =
{{Episode list/sublist|Doctor Who (season 1)
| NumParts = 4
| EpisodeNumber = 1
| EpisodeNumber2 = 1
| Title = An Unearthly Child
| Aux1_1 = "An Unearthly Child"
| Aux1_2 = "The Cave of Skulls"
| Aux1_3 = "The Forest of Fear"
| Aux1_4 = "The Firemaker"
| DirectedBy = Waris Hussein
| WrittenBy = Anthony Coburn
| OriginalAirDate_1 = {{Start date|1963|11|23|df=y}}
| OriginalAirDate_2 = 30 November 1963
| OriginalAirDate_3 = 7 December 1963
| OriginalAirDate_4 = 14 December 1963
| ProdCode = A
| Viewers_1 = 4.4
| Viewers_2 = 5.9
| Viewers_3 = 6.9
| Viewers_4 = 6.4
| Aux4_1 = 63
| Aux4_2 = 59
| Aux4_3 = 56
| Aux4_4 = 55
| ShortSummary = Schoolteachers Ian Chesterton and Barbara Wright are concerned about one of their pupils, Susan Foreman.
| LineColor = 8D3D63
}}
}}
{{Episode table
|background = #8D3D63 |overall= |overallT=Story |series= |seriesT=Serial |title= |aux1= |aux1T=Serial titles |director= |writer= |airdate= |prodcode= |viewers= |country=UK |aux4= |aux4T=Appreciation Index |episodes =
{{Episode list
| NumParts = 4
| EpisodeNumber = 1
| EpisodeNumber2 = 1
| Title = An Unearthly Child
| Aux1_1 = "An Unearthly Child"
| Aux1_2 = "The Cave of Skulls"
| Aux1_3 = "The Forest of Fear"
| Aux1_4 = "The Firemaker"
| DirectedBy = Waris Hussein
| WrittenBy = Anthony Coburn
| OriginalAirDate_1 = {{Start date|1963|11|23|df=y}}
| OriginalAirDate_2 = 30 November 1963
| OriginalAirDate_3 = 7 December 1963
| OriginalAirDate_4 = 14 December 1963
| ProdCode = A
| Viewers_1 = 4.4
| Viewers_2 = 5.9
| Viewers_3 = 6.9
| Viewers_4 = 6.4
| Aux4_1 = 63
| Aux4_2 = 59
| Aux4_3 = 56
| Aux4_4 = 55
| ShortSummary = Schoolteachers Ian Chesterton and Barbara Wright are concerned about one of their pupils, Susan Foreman.
| LineColor = 8D3D63
}}
}}
Transclusion of the list on another page
When a TV series article is split into season pages, create each season's episode list on the corresponding season article. If the series also has a "List of episodes" article, do not re-create the tables in it, and instead transclude the table from the season articles to the list of episodes article.
Use {{tlx|Episode list}} for episode tables and lists that are not transcluded to any other article. Use {{tlx|Episode list/sublist|[article name]}} for episode tables and lists that are transcluded to another article, such as a list of episodes article, or the parent series article, where "[article name]" is the name of the article the episode lists exists on and is transcluded from.
For example, the TV series Lost has season articles for each of its seasons. An episode table is located in each of its season articles, such as Lost (season 1) and Lost (season 2). Each season is then transcluded to List of Lost episodes.
For the purpose of transclusion, each sublist must make use of <onlyinclude>
tags, with the opening tag just before the WikiTable, and the closing tag at the very end of the table. This prevents the lead, external links, templates, categories, interwiki links, and all other unnecessary information from being transcluded onto the main list.
When transcluding onto the main list, you should make use of {{tl|Main}}.
= Transclusion examples =
On a season article, such as Lost (season 3), the code should be as follows:
<onlyinclude>
{{Episode table |background=#2E5528 |overall= |season= |title= |director= |writer= |aux2= |aux2T=Featured
character(s) |airdate= |viewers= |country=U.S. |episodes=
{{Episode list/sublist|Lost (season 3)
| EpisodeNumber = 69
| EpisodeNumber2 = 20
| Title = The Man Behind the Curtain
| DirectedBy = Bobby Roth
| WrittenBy = Elizabeth Sarnoff & Drew Goddard
| Aux2 = Ben
| OriginalAirDate = {{Start date|2007|5|9}}
| Viewers = 12.11<ref name="viewers"/>
| ShortSummary = Locke meets the Others' mysterious leader Jacob.
| LineColor = 2E5528
}}
{{Episode list/sublist|Lost (season 3)
| EpisodeNumber = 70
| EpisodeNumber2 = 21
| Title = Greatest Hits
| DirectedBy = Stephen Williams
| WrittenBy = Edward Kitsis & Adam Horowitz
| Aux2 = Charlie
| OriginalAirDate = {{Start date|2007|5|16}}
| Viewers = 12.32<ref name="viewers"/>
| ShortSummary = Jack learns of the Others' plan.
| LineColor = 2E5528
}}
}}</onlyinclude>
And similar for the other season articles of the series, such as Lost (season 4):
<onlyinclude>
{{Episode table |background=#00549A |overall= |season= |title= |director= |writer= |aux2= |aux2T=Featured
character(s) |airdate= |viewers= |country=U.S. |episodes=
{{Episode list/sublist|Lost (season 4)
| EpisodeNumber = 73
| EpisodeNumber2 = 1
| Title = The Beginning of the End
| DirectedBy = Jack Bender
| WrittenBy = Damon Lindelof & Carlton Cuse
| Aux2 = Hurley
| OriginalAirDate = {{Start date|2008|1|31}}
| Viewers = 17.77<ref name="rankings"/>
| ShortSummary = The survivors of 815 split into two groups led by Jack and Locke.
| LineColor = 00549A
| RowColor = on
}}
{{Episode list/sublist|Lost (season 4)
| EpisodeNumber = 74
| EpisodeNumber2 = 2
| Title = Confirmed Dead
| DirectedBy = Stephen Williams
| WrittenBy = Drew Goddard & Brian K. Vaughan
| Aux2 = Faraday
| OriginalAirDate = {{Start date|2008|2|7}}
| Viewers = 16.96<ref name="rankings"/>
| ShortSummary = A science team from the freighter arrives on the island.
| LineColor = 00549A
| RowColor = off
}}
|}</onlyinclude>
The following code should appear on List of Lost episodes:
Season 1
{{Main|Lost (season 1)}}
{{:Lost (season 1)}}
Season 2
{{main|Lost (season 2)}}
{{:Lost (season 2)}}
Note the colon ({{strong|:}}) at the beginning of the transclusions; this is necessary when transcluding an article. If you tried to transclude Lost (season 1), without using the colon, you would get Template:Lost (season 1), a redlink to a nonexistent template.
The above code will appear as follows:
;Season 3
{{main|Lost (season 3)}}
{{Episode table |background=#2E5528 |overall= |season= |title= |director= |writer= |aux2= |aux2T=Featured
character(s) |airdate= |viewers= |country=U.S. |episodes=
{{Episode list/sublist|Lost (season 2)
| EpisodeNumber = 69
| EpisodeNumber2 = 20
| Title = The Man Behind the Curtain
| DirectedBy = Bobby Roth
| WrittenBy = Elizabeth Sarnoff & Drew Goddard
| Aux2 = Ben
| OriginalAirDate = {{Start date|2007|5|9}}
| Viewers = 12.11{{dummy ref}}
| ShortSummary = Locke meets the Others' mysterious leader Jacob.
| LineColor = 2E5528
}}
{{Episode list/sublist|Lost (season 3)
| EpisodeNumber = 70
| EpisodeNumber2 = 21
| Title = Greatest Hits
| DirectedBy = Stephen Williams
| WrittenBy = Edward Kitsis & Adam Horowitz
| Aux2 = Charlie
| OriginalAirDate = {{Start date|2007|5|16}}
| Viewers = 12.32{{dummy ref}}
| ShortSummary = Jack learns of the Others' plan.
| LineColor = 2E5528
}}
}}
;Season 4
{{main|Lost (season 4)}}
{{Episode table |background=#00549A |overall= |season= |title= |director= |writer= |aux2= |aux2T=Featured
character(s) |airdate= |viewers= |country=U.S. |episodes=
{{Episode list/sublist|Lost (season 4)
| EpisodeNumber = 73
| EpisodeNumber2 = 1
| Title = The Beginning of the End
| DirectedBy = Jack Bender
| WrittenBy = Damon Lindelof & Carlton Cuse
| Aux2 = Hurley
| OriginalAirDate = {{Start date|2008|1|31}}
| Viewers = 17.77{{dummy ref|2}}
| ShortSummary = The survivors of 815 split into two groups led by Jack and Locke.
| LineColor = 00549A
| RowColor = on
}}
{{Episode list/sublist|Lost (season 4)
| EpisodeNumber = 74
| EpisodeNumber2 = 2
| Title = Confirmed Dead
| DirectedBy = Stephen Williams
| WrittenBy = Drew Goddard & Brian K. Vaughan
| Aux2 = Faraday
| OriginalAirDate = {{Start date|2008|2|7}}
| Viewers = 16.96{{dummy ref|2}}
| ShortSummary = A science team from the freighter arrives on the island.
| LineColor = 00549A
| RowColor = off
}}
}}
= Tips =
It may be helpful to include a hidden message that will appear when someone edits the article. Placed above the table headers and under the article section, such as:
Episodes
{{Episode table
This message won't be visible when normally viewing the article. A message such as this notes where one can get help for the template.
Microformat
{{UF-hcal-multi}}
For shows where each episode is from a different, single, specific place (for example, Time Team, one of the Aux fields can contain the coordinates, applied using {{tl|coord}}.
Subpages
{{Special:PrefixIndex/Template:Episode list}}
"Hacks" of this template, also known as "forks", are discouraged. Any discussion regarding forks should occur on this template's, not the fork's or article's, talk page.
Episode list templates
- Wikipedia:WikiProject Television/Episode coverage task force
- Wikipedia:WikiProject Television/Templates
- Wikipedia:Television episodes
- {{tlx|WikiProject Television|needs-episode-list{{=}}yes}}
Notes
{{Reflist|group="N"}}
Tracking categories
{{Transcluded section|source=Module:Episode list/doc}}
{{Trim|{{#section:Module:Episode list/doc|Tracking}}}}