Изворни код странице Шаблон:Television ratings graph/док

{{Documentation subpage}}
{{Lua|Module:Television ratings graph}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
== Usage ==
The purpose of the '''{{tl|Television ratings graph}}''' template is to display an [[mw:Extension:EasyTimeline|EasyTimeline]] of the viewer figures for a television series, in both graph and tabular format. Bars are display on the graph for each episode, with the overall episode number below, and seasons are separated by different colours.

===Syntax===
<pre>{{Television ratings graph
| title           = TEXT
| season_title    = TEXT
| nograph         = TEXT
| notable         = TEXT
| color{1,2,...}  = COLOR
| legend{1,2,...} = TEXT
| width           = TEXT
| height          = TEXT
| average         = TEXT
| intervals       = NUMBER
| country         = TEXT
| (Unnamed)       = NUMBER OR HYPHEN
}}</pre>

===Example===
{{collapse top|Code}}
<pre>{{Television ratings graph
| title  = American Horror Story
| color1 = #9F2323 | legend1 = Murder House
| color2 = #14131A | legend2 = Asylum
| color3 = #662C35 | legend3 = Coven
| color4 = #125B5C | legend4 = Freak Show
| color5 = #615500 | legend5 = Hotel
| color6 = #DCC494 | legend6 = Roanoke
| intervals = 5
| country = U.S.
| -
| 3.18
| 2.46
| 2.59
| 2.96
| 2.74
| 2.83
| 3.06
| 2.81
| 2.85
| 2.54
| 2.59
| 3.22
| -
| 3.85
| 3.06
| 2.47
| 2.65
| 2.78
| 1.89
| 2.27
| 2.36
| 2.22
| 2.21
| 2.51
| 2.30
| 2.29
| -
| 5.54
| 4.51
| 3.78
| 3.71
| 3.80
| 4.16
| 4.00
| 4.07
| 3.94
| 3.49
| 3.46
| 3.35
| 4.24
| -
| 6.13
| 4.53
| 4.44
| 4.51
| 4.22
| 3.65
| 3.91
| 3.30
| 3.07
| 2.99
| 3.11
| 2.94
| 3.27
| -
| 5.81
| 4.06
| 3.20
| 3.04
| 2.87
| 2.64
| 2.64
| 2.31
| 2.14
| 1.85
| 1.84
| 2.24
| -
| 5.14
| 3.27
| 3.08
| 2.83
| 2.82
| 2.48
| 
| 
| 
| 
}}</pre>
{{collapse bottom}}<br />

{{Television ratings graph
| title  = American Horror Story
| color1 = #9F2323 | legend1 = Murder House
| color2 = #14131A | legend2 = Asylum
| color3 = #662C35 | legend3 = Coven
| color4 = #125B5C | legend4 = Freak Show
| color5 = #615500 | legend5 = Hotel
| color6 = #DCC494 | legend6 = Roanoke
| intervals = 5
| country = U.S.
| -
| 3.18
| 2.46
| 2.59
| 2.96
| 2.74
| 2.83
| 3.06
| 2.81
| 2.85
| 2.54
| 2.59
| 3.22
| -
| 3.85
| 3.06
| 2.47
| 2.65
| 2.78
| 1.89
| 2.27
| 2.36
| 2.22
| 2.21
| 2.51
| 2.30
| 2.29
| -
| 5.54
| 4.51
| 3.78
| 3.71
| 3.80
| 4.16
| 4.00
| 4.07
| 3.94
| 3.49
| 3.46
| 3.35
| 4.24
| -
| 6.13
| 4.53
| 4.44
| 4.51
| 4.22
| 3.65
| 3.91
| 3.30
| 3.07
| 2.99
| 3.11
| 2.94
| 3.27
| -
| 5.81
| 4.06
| 3.20
| 3.04
| 2.87
| 2.64
| 2.64
| 2.31
| 2.14
| 1.85
| 1.84
| 2.24
| -
| 5.14
| 3.27
| 3.08
| 2.83
| 2.82
| 2.48
| 
| 
| 
| 
}}

== Parameters==
{| class="wikitable"
! colspan="2" | Parameter
! style="width:60%" | Description
! Type
! Status
|-
! Title
| title
| Title of the series in plain text.
| Text
| Required
|-
! Season title
| season_title
| Alternate text instead of "Season", e.g. "Series" for British and Australian shows.
| Text
| Optional
|-
! No Graph
| nograph
| Display the template without the pictorial graph. Set to ''y''.
| Text
| Optional
|-
! No Table
| notable
| Display the template without the data table. Set to ''y''.
| Text
| Optional
|-
! Colors
| color{1,2,...}
| The background color of the bars and legend for each season in hexadecimal format (3 or 6 characters). Requried for each season. Default of #006600.<br />''Format:'' #FFFFFF or #FFF
| String
| Required
|-
! Legend
| legend{1,2,...}
| Alternate text for season names in the graph legend and table.
| Text
| Optional
|-
! Width
| width
| Width of the graph in plain number format. Default is 1,000px.<br />''Format:'' 800
| Number
| Optional
|-
! Height
| height
| Height of the graph in plain number format. Default is 300px.<br />''Format:'' 250
| Number
| Optional
|-
! Average
| average
| Determine if an average value is included as the final figure of a season by setting the parameter to anything. An average column is added to each row but not included in the graph.
| Text
| Optional
|-
! Intervals
| intervals
| When there are too many episodes, the episode numbers along the horizontal axis will begin to bunch together - set this to only display multiples along the horizontal line.<br />''Example:'' Setting this to 5 will display only the episode numbers 1 and multiples of 5, rather than every episode number.
| Number
| Optional
|-
! Country
| country
| The series' country of origin.<br />Setting this parameter will display "Viewers" in the graph and table in lowercase, with the country prepended to it. Not setting the country will display "Viewers" capitalized.
| Text
| Optional
|-
! Viewer figures
| {{N/A}}
| ''Existing figures'': The viewer figures for the seasons in plain number format in millions, a separate unnamed parameter for each viewer figure: {{para||2.50}}<br />''TBD figures'': Include an empty parameter for a viewer figure will set a place for an empty bar in the graph and a {{tlx|N/A|TBD}} cell in the table: {{para||}}<br />''Separating seasons'': Add a new parameter and set it to a hyphen (include before the first season, do not include after the last season): {{para||-}}<br />The template will automatically include spanning {{tlx|N/A}} cells when the number of episodes between seasons differs.
| Number/Hyphen
| Required
|}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Television templates]]
}}</includeonly>