Lihat sumber Templat:Infobox television season/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE -->
{{High-use|4,500+}}
{{Auto italic title|italic_title}}
{{Lua|Module:Infobox|Module:InfoboxImage|Module:Infobox/dates|Module:String|Module:Check for unknown parameters}}

== Usage ==
{{{{PAGENAMETDOC}}
| italic_title         = no
| show_name            = show_name
| pre_season_qualifier = ''pre_season_qualifier''
| season_qualifier     = ''season_qualifier''
| season_type          = ''season_type''
| season_number        = ''season_number''
| bgcolour             = #CCCCFF<!-- Colours used must meet the contrast requirements of WP:COLOR. -->
| image                = Example-serious.jpg
| image_upright        = 1
| image_size           = 
| image_alt            = Alt text for image
| caption              = ''caption''
| starring             = ''starring''
| country              = ''country''
| num_episodes         = ''num_episodes''
| network              = ''network''
| first_aired          = ''first_aired'' (''released'')
| last_aired           = ''last aired''
| episode_list         = ''episode_list''
}}

<section begin=infobox /><pre style="overflow:auto;">
{{Infobox television season
| show_name            = 
| pre_season_qualifier =
| season_qualifier     = 
| season_type          = 
| season_number        = 
| bgcolour             = <!-- Colours used must meet the contrast requirements of WP:COLOR. -->
| image                = 
| image_upright        = 
| image_size           = 
| image_alt            = 
| caption              = 
| starring             = 
| country              = 
| num_episodes         = <!-- Value is incremented when new episodes air. See template documentation for more info. -->
| network              = 
| released             = <!-- {{Start date|yyyy|mm|dd|df=y}} - Only use this template once-->
| first_aired          = <!-- {{Start date|yyyy|mm|dd|df=y}} - Only use this template once -->
| last_aired           = <!-- {{End date|yyyy|mm|dd}} -->
| episode_list         = 
}}</pre><section end=infobox />

=== Parameters ===
{| class="wikitable plainrowheaders" style="background-color: white;"
|+ Infobox television season parameters and basic guidelines
! scope="col" style="background-color: whitesmoke;" | Field name
! scope="col" style="background-color: whitesmoke;" | Type
! scope="col" style="background-color: whitesmoke;" | Description
! scope="col" style="background-color: whitesmoke;" | Values
|-
| scope="row" | season_name
| required
| Season name. The series title will be automatically italicised. ''Only necessary if the complete season name cannot be created with the follow five parameters.''
| plain text
|-
| scope="row" | show_name
| required
| Show name. The name of the show.
| plain text
|-
| scope="row" | pre_season_qualifier
| required
| Pre-season qualifier. For cases where disambiguation (typically of the show's premiering year) before the season is required (e.g. the pre-season qualifier for [[Dallas (1978 TV series) (season 7)]] is ''(1978 TV series)'').
| plain text
|-
| scope="row" | season_qualifier
| required
| Season qualifier. For cases where disambiguation (typically of the show's origin country) before the season type is required (e.g. the season qualifier for [[The Apprentice (U.S. season 2)]] is ''U.S.'').
| plain text
|-
| scope="row" | season_type
| required
| Season type. To determine the usage of the word "season" for American-based shows, or "series" for shows using British-English.
| plain text
|-
| scope="row" | season_number
| required
| Season number. The ''X''th season of this particular show. This number is also used to generate links for the previous and next seasons, if applicable.
| number
|-
| scope="row" | bgcolour
| rowspan="6" | optional
| Six-digit hex code used to colour header rows. Must include a hash symbol (#) before the code. e.g. <code>#81a6e3</code>. The [[Wikipedia:Colour contrast|contrast between background and foreground colors]], if used, must meet the guidelines at [[WP:COLOR]].
| hex code
|-
| scope="row" | image
| A suitable image. The image does not need to be wikilinked and should exclude "File:" e.g. <code><nowiki>Example.png</nowiki></code> and underscores should not replace spaces. Typically the image will be DVD cover art, although this is not mandated. Free content should be used where available.
| raw image name excluding "File:"
|-
| scope="row" | image_upright
| Use of this parameter is preferred to using "image_size", as it allows [[Wikipedia:Autosizing images|autosizing of images]] according to user preferences. By default the infobox image scales to upright=1, which is 220 px if the default thumbnail size has not been changed at [[Special:Preferences]]) The size should not be set to a value that would result in an image width greater than 300px.
| raw number
|-
| scope="row" | image_size
| Width of the image in pixels, excluding "px". If not specified the image width defaults to the value explained above in "image_upright". The size should not be set greater than 300px.
| raw number
|-
| scope="row" | image_alt
| Alt text, as required by [[MOS:ALT]].
| rowspan="2" | wikitext, may include links
|-
| scope="row" | caption
| A caption for the image
|-
| scope="row" | starring
| rowspan="7" | optional, desirable
| The show's star or stars. Separate multiple entries using {{tl|Plainlist}} or {{tl|Unbulleted list}}. Cast are listed in original credit order followed by order in which new cast joined the show. Years and/or seasons should not be included.
| wikitext, may include links
|-
| scope="row" | country
| Country of origin. Do not use flag icons, as this places an unnecessary emphasis on nationality - see [[MOS:INFOBOXFLAG]] for a detailed rationale. Do not link to a country article, e.g., <nowiki>[[</nowiki>[[United States]]<nowiki>]]</nowiki>, per [[WP:OVERLINK]].
| plain text
|-
| scope="row" | num_episodes
| The number of episodes released in the season. This parameter should only be incremented when new episodes air. An inline citation is required if the total number of episodes produced is greater than the number aired, such as in the case of a show being cancelled.
| number
|-
| scope="row" | network
| name of the network on which the season aired.
| wikitext, may include links
|-
| scope="row" | released
| Date all episodes for the season were released, generally for those airing on [[streaming media]] sites such as [[Netflix]], using {{tl|Start date}}. e.g. <code><nowiki>{{Start date|2011|9|23}}</nowiki></code> or <code><nowiki>{{Start date|2011|9|23|df=y}}</nowiki></code> 
| date formatted using {{tl|Start date}}. Use "{{para|df|y}}", when appropriate, to show "23 May" instead of "May 23,".
|-
| scope="row" | first_aired
| Date the season commenced airing, using {{tl|Start date}}. e.g. <code><nowiki>{{Start date|2011|9|23}}</nowiki></code> or <code><nowiki>{{Start date|2011|9|23|df=y}}</nowiki></code> Only insert the date after it has happened.
| date formatted using {{tl|Start date}}. Use "{{para|df|y}}" when appropriate.
|-
| scope="row" | last_aired
| Date the season finished airing, using {{tl|End date}}. e.g. <code><nowiki>{{End date|2012|5|17}}</nowiki></code> or <code><nowiki>{{End date|2012|5|17|df=y}}</nowiki></code> While the season is airing, <code><nowiki>{{End date|present}}</nowiki></code> should be used.
| date formatted using {{tl|End date}}. "{{para|df|y}}".
|-
| scope="row" | prev_season<br />or<br />prev_series
| rowspan="3" | optional, desirable
| If one exists, this field should include a wikilink to the previous season in the series. This field should be left blank if 1) no season article exists or 2) any redirect for the season does not link to a specific section regarding the season. ''Only required if the previous season link cannot be automatically generated by the template using the "season_number" variable.'' (e.g. [[Road Rules: South Pacific]])
| rowspan="2" | wikitext, should include a wikilink to the appropriate article.
|-
| scope="row" | next_season<br />or<br />next_series
| If one exists, this field should include a wikilink to the next season in the series. This field should be left blank if 1) no season article exists or 2) any redirect for the season does not link to a specific section regarding the season. ''Only required if the next season link cannot be automatically generated by the template using the "season_number" variable.'' (e.g. [[Road Rules: South Pacific]])
|-
| scope="row" | episode_list
| If one exists, this field should include the name of the main episode list article for the series. If no article exists, this field should be left blank. Wikilinking is not required. The article name will be formatted and wikilinked automatically by the infobox. For example {{para|episode_list|List of NCIS episodes}} will result in [[List of NCIS episodes|List of ''NCIS'' episodes]].
| plain text, should not be wikilinked.
|-
| scope="row" style="background:#e8e8e8; color:#000; text-align:center;" colspan="4" | '''The following fields are not for general use. They are only to be used in articles that previously used forks of this template that have been deleted or are otherwise no longer used and even then, they are only to be used to replace parameters that existed in the forked templates.<br />When completed, data will appear underneath a header titled "Additional information".'''
|-
| scope="row" | film_start
| rowspan="5" | optional
| Date filming of the season commenced, using {{tl|Start date}}. e.g. <code><nowiki>{{Start date|2011|1|5}}</nowiki></code> Should include a reference if the date is not referenced in the article's prose.
| date formatted using {{tl|Start date}}. Use "{{para|df|y}}" when appropriate.
|-
| scope="row" | film_end
| Date filming of the season ended, using {{tl|End date}}. e.g. <code><nowiki>{{End date|2011|3|31}}</nowiki></code> Should include a reference if the date is not referenced in the article's prose. If <code>film_start</code> does not exist, <code>film_end</code> will not display.
| date formatted using {{tl|End date}}. Use "{{para|df|y}}" when appropriate.
|-
| scope="row" | celebrity_winner
| This field is for use in dance competition related programs and lists the name of the celebrity winner of the competition.
| rowspan="2" | wikitext, may include links
|-
| scope="row" | professional_winner
| This field is for use in dance competition related programs and lists the name of the professional dancer who won the competition.
|-
| scope="row" | website
| Relevant website details. Use {{URL|http://www.example.com}}, replacing "http://www.example.com" with the website's [[Uniform resource locator|url]].
| url. Use {{tl|URL}}
|-
| scope="row" style="background:#e8e8e8; color:#000; text-align:center;" colspan="4" | '''Note: Do not link to an article more than once in the infobox.'''
|}

==== All parameters (not for general use) ====
<pre>{{Infobox television season
| season_name          = 
| show_name            = 
| pre_season_qualifier = 
| season_qualifier     = 
| season_type          = 
| season_number        = 
| bgcolour             = <!-- Colours used must meet the contrast requirements of WP:COLOR. -->
| image                = 
| image_upright        = 
| image_size           = 
| image_alt            = 
| caption              = 
| starring             = 
| country              = 
| num_episodes         = 
| network              = 
| released             = <!-- {{Start date|yyyy|mm|dd}} -->
| first_aired          = <!-- {{Start date|yyyy|mm|dd}} -->
| last_aired           = <!-- {{End date|yyyy|mm|dd}} -->
| film_start           = <!-- This field is only for use in certain articles. --><!-- {{Start date|yyyy|mm|dd}} -->
| film_end             = <!-- This field is only for use in certain articles. --><!-- {{End date|yyyy|mm|dd}} -->
| celebrity_winner     = <!-- This field is only for use in certain articles. -->
| professional_winner  = <!-- This field is only for use in certain articles. -->
| website              = <!-- {{URL|}} -->
| prev_season          = <!-- or |prev_series  = -->
| next_season          = <!-- or |next_series  = -->
| episode_list         = 
}}</pre>

=== Controlling line-breaking in embedded bulletless lists ===
Template {{tlx|nbsp}} may be used with {{tlx|wbr}} and {{tlx|nowrap}} to control line-breaking in bulletless lists embedded in the infobox (e.g. cast and other credits lists), to prevent wrapped long entries from being confused with multiple entries. See [[Template:Wbr/doc#Controlling line-breaking in infoboxes]] for details.

=== Calculating "image_upright" ===
The following table provides an approximate conversion from a "px" value, to an "image_upright" value based on a default thumbnail setting of 220px (size is default multiplied by upright value then rounded to nearest 10).
{| class="wikitable plainrowheaders"
|-
! scope="col" | "px" setting
! scope="col" | image_upright=
|-
| scope="row" | 170
| 0.75
|-
| scope="row" | 180
| 0.8
|-
| scope="row" | 190
| 0.85
|-
| scope="row" | 200
| 0.9
|-
| scope="row" | 210
| 0.95
|-
| scope="row" | 220
| 1
|-
| scope="row" | 230
| 1.05
|-
| scope="row" | 240
| 1.1
|-
| scope="row" | 250
| 1.15
|-
| scope="row" | 260
| 1.2
|-
| scope="row" | 270
| 1.23
|-
| scope="row" | 280
| 1.25
|-
| scope="row" | 290
| 1.3
|-
| scope="row" | 300
| 1.35
|}

== Tracking categories ==
* {{clc|Television season articles that use custom fields}} – articles that use custom fields
* {{clc|Articles using Template:Infobox television season with invalid colour combination}} – articles that use [[WP:COLOR]]-violating colour combinations
* {{clc|Pages using infobox television season with unknown parameters}} – articles using unsupported infobox parameters
* {{clc|Infobox television season articles that use the season_name parameter}}

== Microformat ==
{{UF-hcal}}

== Example ==
{{Infobox television season
| italic_title  = no
| show_name     = NCIS
| season_number = 12
| bgcolour      = #9F3500
| image         = Example-serious.jpg
| caption       = Sampul DVD A.S. Musim 12
| starring      = {{Plainlist|
* [[Mark Harmon]]
* [[Michael Weatherly]]
* [[Pauley Perrette]]
* [[Sean Murray (aktor)|Sean Murray]]
* [[Brian Dietzen]]
* [[Emily Wickersham]]
* [[Rocky Carroll]]
* [[David McCallum]]
}}
| country       = Amerika Serikat
| num_episodes  = 24
| network       = [[CBS]]
| first_aired   = {{Start date|2014|9|23}}
| last_aired    = {{End date|2015|5|12}}
| episode_list  = Daftar episode NCIS
}}
<pre style="overflow:auto">{{Infobox television season
| italic_title  = no
| show_name     = NCIS
| season_number = 12
| bgcolour      = #9F3500
| image         = Example-serious.jpg
| caption       = Sampul DVD A.S. Musim 12
| starring      = {{Plainlist|
* [[Mark Harmon]]
* [[Michael Weatherly]]
* [[Pauley Perrette]]
* [[Sean Murray (aktor)|Sean Murray]]
* [[Brian Dietzen]]
* [[Emily Wickersham]]
* [[Rocky Carroll]]
* [[David McCallum]]
}}
| country       = Amerika Serikat
| num_episodes  = 24
| network       = [[CBS]]
| first_aired   = {{Start date|2014|9|23}}
| last_aired    = {{End date|2015|5|12}}
| episode_list  = Daftar episode NCIS
}}</pre>

== Subpages ==
<!-- <ul class="listify">{{Special:Prefixindex/Template:Infobox television season}}</ul> -->
The following is a list of subpages of {{tl|Infobox television season}}, which are not redirects.

* [[Template:Infobox television season/doc|Template documentation]]
* [[Template:Infobox television season/sandbox|Template sandbox]]
* [[Template:Infobox television season/testcases|Template testcases]]

== See also ==
* [[Template:Episode list]] for creating an episode list.

== References ==
{{reflist}}

{{Film and Television related infobox templates}}

<includeonly>{{basepage subpage|
<!-- CATEGORIES HERE, THANKS -->
[[Category:Television infobox templates|Television season]]
[[Category:Templates that add a tracking category]]

}}</includeonly>