Template:Episode list/doc

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 row for a given article, 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.

Parameters

Episode list parameters and basic guidelines

Field name	Type	Description	Recommended values
EpisodeNumber	Optional, desirable	A number representing the episode's order in the series. For example, the first episode would be 1 or 01, and so on. When defined, the specified number also generates a link anchor, prefixed by "ep"; for example, "[[List of episodes#ep1]]" or "[[List of episodes#ep01]]". In creating the anchor, the text specified for the number is treated literally: to generate the most straight-forward versions of anchors as previously exemplified, specify only a number, omitting any use of formatting, including bold.	number
EpisodeNumber2	Optional	A second episode number column. Useful for when a series aired in a different order, or only included certain episodes, etc. When used with multi-season series, this field is typically used to represent the episode's order in the season.
Title	Required	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.	wikitext, may include links to valid articles.
RTitle	Optional	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.	wikitext, references, etc
AltTitle	Optional	An alternative title, such as the title of a foreign show's episode in its native language, or a title that was originally changed. It will be listed below Title and be presented in "quotes".	wikitext, may include links to valid articles.
RAltTitle	Optional	Unformatted parameter that can be used to add a reference after "AltTitle", or can be used as a "raw title" to replace "AltTitle" completely.	wikitext, references, etc
Aux1	Optional	General purpose parameter. The meaning is specified by the column header.	wikitext, may include links
DirectedBy	Optional	Name of the episode's director
WrittenBy	Optional	Primary writer(s) of the episode
Aux2	Optional	General purpose parameter. The meaning is specified by the column header.
Aux3	Optional	General purpose parameter. The meaning is specified by the column header.
OriginalAirDate	Optional	This is the date the episode first aired on TV, or is scheduled to air.	date, formatted using {{start date}}.
AltDate	Optional	The next notable air date, such as the first air date of an anime in English.	date. Do not use {{start date}} if OriginalAirDate is present.
ProdCode	Optional	The production code in the series. When defined, this parameter also creates a link anchor, prefixed by "pc"; for example, "[[List of episodes#pc01]]".	plain text
Viewers	Optional, desirable	Number of viewers who watched the episode. Should include a reference. The inclusion of viewer figures is supported and provides encyclopaedic content beyond what might normally be found in a TV guide. It is therefore desirable to include referenced ratings information in an episode list.	Number, followed by a reference.
Aux4	Optional	Optional parameter. The meaning is specified by the table header.	wikitext, may include links
ShortSummary	Optional	A short 100–300 word summary of the episode. Make summaries specific to that episode (as in, a description that would normally not be confused with another episode). Leaving this parameter empty will result in the summary row not appearing for this episode.
LineColor	Optional	Colors the separator line between episode entries. If not defined the color defaults to "#CCCCFF". Use of "#", or anything but a valid hex code will result in an invalid syntax.	Hex code, not preceded by "#". e.g. enter "00ff00" instead of "#00ff00"
TopColor	Optional	Colors the main row of information (that is, not the ShortSummary row). If not defined, it defaults to the wikitable standard background shading of "#F9F9F9", except when ShortSummary is used, and then it defaults to "#f2f2f2". The excessive use of the parameter is discouraged by Wikipedia's guideline on styles and markup options.
RowColor	Optional	This parameter is a "switch" that must only be defined when the EpisodeNumber= entry is not a regular number (eg. "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 EpisodeNumber= entries break up the striping effect the template introduces. If the first episode number is even, define RowColor= as On. If the first episode number is odd, define RowColor= as Off. All further uses of Template:Episode list in the table must also have the RowColor= parameters defined to alternate between Off and On to avoid further breakages in the striping.	"On", "on", "Yes", "yes", "Y", or "y"; "Off", "off", "No", "no", "N", "n"

This is where information from the template is placed when rendered ({{{LineColor}}}, {{{TopColor}}}, and {{{RowColor}}} are not shown, since there's no text to display):

{{{EpisodeNumber}}}	{{{EpisodeNumber2}}}	"{{{Title}}}"{{{RTitle}}} "{{{AltTitle}}}"{{{RAltTitle}}}	{{{Aux1}}}	{{{DirectedBy}}}	{{{WrittenBy}}}	{{{Aux2}}}	{{{Aux3}}}	{{{OriginalAirDate}}}	{{{AltDate}}}	{{{ProdCode}}}	{{{Viewers}}}	{{{Aux4}}}
{{{ShortSummary}}}

Using the template

When using optional parameters (such as Aux1 or AltDate) only list the parameters that are being used, and adjust the table headers accordingly. This will help avoid confusion when one entry has a parameter filled out, and another does not. A table cell will be open for each listed parameter, whether it is filled out or not.

To apply an entry to an episode listing, add this template where the episode would go in the List of episodes. The full syntax is as follows, remove the parameters that are not being used in the table:

{{Episode list
| EpisodeNumber   = 
| EpisodeNumber2  = 
| Title           = 
| RTitle          = 
| AltTitle        = 
| RAltTitle       = 
| Aux1            = 
| DirectedBy      = 
| WrittenBy       = 
| Aux2            = 
| Aux3            = 
| OriginalAirDate = 
| AltDate         = 
| ProdCode        = 
| Viewers         = 
| Aux4            = 
| ShortSummary    = 
| LineColor       = 
}}

Because this is only part of a WikiTable, you first must "open" the WikiTable. You need to edit this example according to the optional parameters that you want to show in your table, ensuring that the code used complies with requirements. For example, to create a list with only EpisodeNumber, Title, OriginalAirDate, ProdCode, and ShortSummary parameters, open the table as follows:

{|class="wikitable plainrowheaders" style="width:100%; margin:auto;"
|-
! scope="col" style="width:3em;" | No.
! scope="col" | Title
! scope="col" style="width:12em;" | Original air date
! scope="col" | Production code

The {{Episode list}} templates would then follow here:

{{Episode list
| EpisodeNumber   = 01
| Title           = Reborn
| OriginalAirDate = {{start date|1998|09|21}}
| ProdCode        = 98101-201
| ShortSummary    = Immortal thief Amanda is followed by detectives Nick Wolfe and Claudia Hoffmann.
}}
{{Episode list
| EpisodeNumber   = 02
| Title           = Full Disclosure
| OriginalAirDate = {{start date|1998|09|28}}
| ProdCode        = 98102-202
| ShortSummary    = Wolfe and Amanda cannot prevent Navajo code talker Walter from being killed.
}}

After the final episode entry (template) you will close the WikiTable with:

|}

Examples

The above code would appear as follows:

No.	Title	Original air date	Production code
01	"Reborn"	September 21, 1998 (1998-09-21)	98101-201
Immortal thief Amanda is followed by detectives Nick Wolfe and Claudia Hoffmann.
02	"Full Disclosure"	September 28, 1998 (1998-09-28)	98102-202
Wolfe and Amanda cannot prevent Navajo code talker Walter from being killed.

A more complex case would look like the following:

{|class="wikitable plainrowheaders" style="width:100%; margin:auto; table-layout:fixed;"
|-
! scope="col" style="background-color: #812f09; color: #ffffff;" | Number<br />in series
! scope="col" style="background-color: #812f09; color: #ffffff;" | Number<br />in season
! scope="col" style="background-color: #812f09; color: #ffffff;" | Title
! scope="col" style="background-color: #812f09; color: #ffffff;" | Directed by
! scope="col" style="background-color: #812f09; color: #ffffff;" | Written by
! scope="col" style="background-color: #812f09; color: #ffffff;" | Ben's location
! scope="col" style="background-color: #812f09; color: #ffffff; width:12em;" | Original air date
! scope="col" style="background-color: #812f09; color: #ffffff;" | Production code
! scope="col" style="background-color: #812f09; color: #ffffff;" | U.S. viewers<br />(million)
{{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
}}
|}

Number in series	Number in season	Title	Directed by	Written by	Ben's location	Original air date	Production code	U.S. viewers (million)
1	1	"Milfay"	Rodrigo García	Daniel Knauf	Milfay, Oklahoma	September 14, 2003 (2003-09-14)	1–01	5.3
Ben suffers strange dreams about a trench war, and a tattooed man stalking in a cornfield.
2	2	"After the Ball Is Over"	Jeremy Podeswa	Daniel Knauf	Tipton, Missouri	September 21, 2003 (2003-09-21)	1–02	3.49
Ben is slowly setting in as a carnival roustabout.

Sublists

Occasionally, when dealing with a very long series, you may wish to break the list up into separate sublists. When doing so, the list should be broken at season breaks, or otherwise years.

Sublists should be named as "List of X episodes (season y)", and transcluded onto the main list to prevent ending up with two lists of duplicate information. For sublist pages, you should use {{Episode list/sublist|List of X episodes}} for each episode, where "List of X episodes" is the name of the main episode list. So, for instance, if you're working on [[List of Bleach episodes]], you would split it into List of Bleach episodes (season 1) and List of Bleach episodes (season 2), and each episode on the sublist would use {{tld|Episode list/sublist|List of Bleach episodes}}.

When transcluded onto the main list, this template removes any summaries, and alternates the background row color between light and dark gray, depending on the value of {{{EpisodeNumber}}}. Occasionally, a multi-part episode will skew the pattern between odd and even EpisodeNumbers, to rectify this, use the RowColor parameter. A "On" input will color the row dark gray, like an even number normally would, on the "List of X episodes" page, while a "Off" input will color the row light gray, like an odd number normally would.

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 {{main}}. For example, referring to Bleach again, the main list would have the following code under the "Episode list" header:

== Season 1 ==
{{main|List of Bleach episodes (season 1)}}
{{:List of Bleach episodes (season 1)}}
<!-- To edit the episodes in this section, you need to edit the article listed above. -->

== Season 2 ==
{{main|List of Bleach episodes (season 2)}}
{{:List of Bleach episodes (season 2)}}
<!-- To edit the episodes in this section, you need to edit the article listed above. -->

Note the colon (:) at the beginning of the transclusions (for example, {{:List of ...); this is necessary when transcluding an article. If you tried to transclude List of Bleach episodes (season 1), without using the colon, you would get Template:List of Bleach episodes (season 1), a redlink to a nonexistent template.

Examples

If the following code is on List of Degrassi: The Next Generation episodes (season 6):

<onlyinclude>
{| class="wikitable plainrowheaders" style="width:100%; margin:auto;"
|-
! scope="col" style="background-color: #432; color:#fff;" width="20"|No. in<br />series
! scope="col" style="background-color: #432; color:#fff;" width="20"|No. in<br />season
! scope="col" style="background-color: #432; color:#fff;" |Title
! scope="col" style="background-color: #432; color:#fff;" width="120"|Canadian airdate
! scope="col" style="background-color: #432; color:#fff;" width="120"|Premiere airdate
! scope="col" style="background-color: #432; color:#fff;" width="50"|Production code
{{Episode list/sublist|List of Degrassi: The Next Generation episodes
| EpisodeNumber   = 105
| EpisodeNumber2  = 5
| Title           = Eyes Without a Face
| RTitle          = &nbsp;<small>Part One</small>
| OriginalAirDate = {{start date|2006|12|05}}
| AltDate         = {{start date|2006|10|20}} ([[The N]])
| ProdCode        = 605
| ShortSummary    = Peter, Danny and Derek decide to join the Spirit Squad.
| LineColor       = 432
}}
{{Episode list/sublist|List of Degrassi: The Next Generation episodes
| EpisodeNumber   = 106
| EpisodeNumber2  = 6
| Title           = Eyes Without a Face
| RTitle          = &nbsp;<small>Part Two</small>
| OriginalAirDate = {{start date|2006|12|12}}
| AltDate         = {{start date|2006|11|3}} (The N)
| ProdCode        = 606
| ShortSummary    = Darcy's relationship with Spinner comes to an end.
| LineColor       = 432
}}
{{Episode list/sublist|List of Degrassi: The Next Generation episodes
| EpisodeNumber   = 107
| EpisodeNumber2  = 7
| Title           = Working for the Weekend
| OriginalAirDate = {{start date|2006|12|19}}
| AltDate         = {{start date|2006|11|10}} (The N)
| ProdCode        = 607
| ShortSummary    = The results for Spinner's career aptitude test upset him.
| LineColor       = 432
}}
|}
</onlyinclude>

If the following code is on List of Degrassi: The Next Generation episodes (season 7):

<onlyinclude>
{| class="wikitable plainrowheaders" style="width:100%; margin:auto;"
|-
! scope="col" style="background-color: #ea0; color:#fff;" width="20"|No. in<br />series
! scope="col" style="background-color: #ea0; color:#fff;" width="20"|No. in<br />season
! scope="col" style="background-color: #ea0; color:#fff;" |Title
! scope="col" style="background-color: #ea0; color:#fff;" width="120"|Canadian airdate
! scope="col" style="background-color: #ea0; color:#fff;" width="120"|Premiere airdate
! scope="col" style="background-color: #ea0; color:#fff;" width="50"|Production code
{{Episode list/sublist|List of Degrassi: The Next Generation episodes
| RowColor        = Y
| EpisodeNumber   = 108–109
| EpisodeNumber2  = 1–2
| Title           = Standing in the Dark
| OriginalAirDate = {{start date|2008|01|14}}
| AltDate         = {{start date|2007|10|05}} ([[The N]])
| ProdCode        = 701 & 702
| ShortSummary    = The school has merged with nearby Lakehurst High, following a devastating fire there.
| LineColor       = ea0
}}
{{Episode list/sublist|List of Degrassi: The Next Generation episodes
| RowColor        = N
| EpisodeNumber   = 110
| EpisodeNumber2  = 3
| Title           = Love is a Battlefield
| OriginalAirDate = {{start date|2008|01|21}}
| AltDate         = {{start date|2007|10|12}} (The N)
| ProdCode        = 703
| ShortSummary    = Paige begins to get back on her feet after dropping out of university.
| LineColor       = ea0
}}
{{Episode list/sublist|List of Degrassi: The Next Generation episodes
| RowColor        = Y
| EpisodeNumber   = 111
| EpisodeNumber2  = 4
| Title           = It's Tricky
| RTitle          = <ref name="episode titles">
| OriginalAirDate = {{start date|2008|01|28}}
| AltDate         = {{start date|2007|10|19}} (The N)
| ProdCode        = 704
| ShortSummary    = Ashley decides she wants to get back into the music industry.
| LineColor       = ea0
}}
|}
</onlyinclude>

And if the following code is on List of Degrassi: The Next Generation episodes:

== Season 6 ==
{{main|List of Degrassi: The Next Generation episodes (season 6)}}
{{:List of Degrassi: The Next Generation episodes (season 6)}}
<!-- To edit the episodes in this section, you need to edit the article listed above. -->

== Season 7 ==
{{main|List of Degrassi: The Next Generation episodes (season 7)}}
{{:List of Degrassi: The Next Generation episodes (season 7)}}
<!-- To edit the episodes in this section, you need to edit the article listed above. -->

List of Degrassi: The Next Generation episodes will appear as follows:

Season 6

Main article: Main

No. in series	No. in season	Title	Canadian airdate	Premiere airdate	Production code
105	5	"Eyes Without a Face" Part One	December 5, 2006 (2006-12-05)	October 20, 2006 (2006-10-20) (The N)	605
106	6	"Eyes Without a Face" Part Two	December 12, 2006 (2006-12-12)	November 3, 2006 (2006-11-03) (The N)	606
107	7	"Working for the Weekend"	December 19, 2006 (2006-12-19)	November 10, 2006 (2006-11-10) (The N)	607

Season 7

Main article: Main

No. in series	No. in season	Title	Canadian airdate	Premiere airdate	Production code
108–109	1–2	"Standing in the Dark"	January 14, 2008 (2008-01-14)	October 5, 2007 (2007-10-05) (The N)	701 & 702
110	3	"Love is a Battlefield"	January 21, 2008 (2008-01-21)	October 12, 2007 (2007-10-12) (The N)	703
111	4	"It's Tricky"[1]	January 28, 2008 (2008-01-28)	October 19, 2007 (2007-10-19) (The N)	704

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==
<!-- For help with this template see http://en.wikipedia.org/wiki/Template:Episode_list -->
<onlyinclude>
{| class="wikitable plainrowheaders"

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

The HTML mark up produced by this template includes an hCalendar microformat, which makes the event details parsable by computers, either acting automatically to catalogue article across Wikipedia, or via a browser tool operated by a person, to (for example) add the subject to a calendar or diary application. For more information about the use of microformats on Wikipedia, please see the microformat project.

Dates will only be included if you use {{Start date}} or {{End date}} (use the former for single dates).

hCalendar uses HTML classes including:

• attendee
• contact
• description
• dtend
• dtstart
• location
• organiser
• summary
• vevent

Please do not rename or remove these classes; nor collapse nested elements which use them.

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 {{coord}}.

Episode list templates

• Wikipedia:WikiProject Television/Episode lists
• Template:Episode list
  • Template:S-Episode list
• Template:Japanese episode list
  • Template:S-Japanese episode list
• Template:Television needs episode list

Subpages

• Episode list
• Episode list/doc
• Episode list/sublist
• Episode list2
• Episode list2/doc

"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.

See also

• {{Infobox television}}
• {{Infobox television season}}
• {{Infobox television episode}}
• Wikipedia:WikiProject Television#More television templates