Se kilde til Skabelon:TV ratings/doc

<noinclude>{{Dokumentationsside}}</noinclude>
{{lua|Modul:TV ratings}}
'''All ratings should be [[Wikipedia:Citing sources|cited with a reference]]''', preferably not an [[Wikipedia:Cite_sources#Embedded_links|embedded link]].

<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
== Usage ==
{{TV ratings
| rev1 = ''[[RogerEbert.com]]''
| rev1score = {{Rating|4|5}}{{sup|[1]}}
| rev2 = ''[[The Hollywood Reporter]]''
| rev2score = 9/10{{sup|[2]}}
}}

Only add a rating if you [[Wikipedia:Citing sources|cite it with a reference]].

== Instructions ==
The template is not to be a substitute for a section in paragraph form, since a review can not be accurately boiled down to a simple rating out of five stars or other numeric score. If an article is lacking a reception section in prose, but the information is presented in table format, the {{para|noprose|yes}} parameter can be used to tag the article as needing a reception section in prose.

This template is generally the first element after the heading for the section on Reception, Critical reception, Reviews, or something similar. The template should not be used in place of a reception section.

The reviews should be listed alphabetically in the '''Reviews''' field. The information in the reviewer field should be the name of the source. Don't forget to [[wikilink]] to the relevant article.

The information in the score field should be the rating given in the review (e.g. 4/5). The rating should use the same format as in the review, to accurately portray the score of the review. For star ratings you should use the [[Skabelon:Rating|star rating template]]; for example, entering <code><nowiki>{{Rating|4.5|5}}</nowiki></code>, will render: {{Rating|4.5|5}}.

For reviews at [[Rotten Tomatoes]] it is convenient to use "RT=" in the template.

For reviews at [[Metacritic]] it is convenient to use "MC=" in the template.

Please note that the [[minus sign]] character ([[−]]) is not the same thing as a [[hyphen]] ([[-]]).

After the rating should be the citation of the source of the review. Per [[Wikipedia:Citing sources]] do not add reviews without a citation. This means a properly formatted footnote, in most cases providing the author, date, and source, along with an external link if available. Do not use an embedded link with no information (e.g. [https://en.wikipedia.org/wiki/ link]) as this promotes [[link rot]] and is inconsistent with [[Wikipedia:Cite_sources#Embedded_links|Wikipedia's policy on embedded links]]. If you must use an embedded link, be sure to manually provide a full citation in the article's References section per [[Wikipedia:Cite_sources#Embedded_links|Wikipedia:Citing sources]].

== Usage ==
<pre>
{{TV ratings
| title =
| subtitle =
<!-- Aggregate scores -->
| MC = 
| RT =
| aggregate1 = 
| aggregate1score = 
| aggregate2 = 
| aggregate2score = 
| aggregate3 = 
| aggregate3score = 
<!-- ... -->
<!-- Reviewers -->
| rev1 =
| rev1score =
| rev2 =
| rev2score =
| rev3 =
| rev3score =
<!-- ... -->
<!-- Article needs reviews expanded into prose -->
| noprose = <!--yes-->
}}
</pre>

== Parameters ==
Required fields:

:; ''rev#''
:: The name of the reviewer. Too many is not advised, except in appropriate circumstances. For instance, a particularly popular or long-running series, which has several prominent reviews over decades' time.
:; ''rev#score''
:: The rating given by the reviewer.

All of the following fields are optional:

:; ''title''
:: Can be used to provide a custom title for the table, otherwise, it will default to "Professional ratings".
:; ''subtitle''
:: Used to add additional text before the collapsible section. This is necessary to add if want a longer title, as long titles via the "title" parameter will not center correctly.
:; ''width''
:: Sets the width of the table; default is 24.2em.
:; ''MC''
:: [[Metacritic]] score.
:; ''aggregate#''
:: Name of a [[review aggregator]].
:; ''aggregate#score''
:: The rating given by the review aggregator.
:; ''noprose''
:: Should only be used for articles that do not have a Reception section summarizing the reviews. If set to ''yes'', will categorize articles into [[:Category:Articles with TV ratings that need to be turned into prose]].
:; ''RT''
:: [[Rotten Tomatoes]] score.

== Example ==
For example, entering

<pre style="overflow:auto">
{{TV ratings
| MC = 75/100<ref name="Meta">{{cite web|url=https://www.metacritic.com/tv/hillary/season-1|title=Hillary Season 1|publisher=Metacritic|accessdate=6. marts 2020}}</ref>
| RT = 73%<ref name="RT">{{cite web|url=https://www.rottentomatoes.com/tv/hillary/s01|title=Hillary: Season 1|publisher=Rotten Tomatoes|accessdate=6. marts 2020}}</ref>
| rev1 = ''[[RogerEbert.com]]''
| rev1score = {{Rating|3.5|4}}<ref name="Roger Ebert">{{cite web|url=https://www.rogerebert.com/reviews/hillary|title=Hillary|publisher=RogerEbert.com|last=Tallerico|first=Brian|accessdate=6. marts 2020}}</ref>
| rev2 = ''[[Star Tribune]]''
| rev2score = {{rating|3|4}}<ref name="StarT">{{cite web|url=http://www.startribune.com/documentary-hillary-sets-out-to-prove-the-polarizing-political-figure-is-likable-enough/568278822/|title=Documentary 'Hillary' sets out to prove the polarizing political figure is likable enough|newspaper=Star Tribune|last=Justin|first=Neal|accessdate=6. marts 2020}}</ref>
}}
</pre>

will render

{{TV ratings
| MC = 75/100<ref name="Meta">{{cite web|url=https://www.metacritic.com/tv/hillary/season-1|title=Hillary Season 1|publisher=Metacritic|accessdate=6. marts 2020}}</ref>
| RT = 73%<ref name="RT">{{cite web|url=https://www.rottentomatoes.com/tv/hillary/s01|title=Hillary: Season 1|publisher=Rotten Tomatoes|accessdate=6. marts 2020}}</ref>
| rev1 = ''[[RogerEbert.com]]''
| rev1score = {{Rating|3.5|4}}<ref name="Roger Ebert">{{cite web|url=https://www.rogerebert.com/reviews/hillary|title=Hillary|publisher=RogerEbert.com|last=Tallerico|first=Brian|accessdate=6. marts 2020}}</ref>
| rev2 = ''[[Star Tribune]]''
| rev2score = {{rating|3|4}}<ref name="StarT">{{cite web|url=http://www.startribune.com/documentary-hillary-sets-out-to-prove-the-polarizing-political-figure-is-likable-enough/568278822/|title=Documentary 'Hillary' sets out to prove the polarizing political figure is likable enough|newspaper=Star Tribune|last=Justin|first=Neal|accessdate=6. marts 2020}}</ref>
}}
{{clear}}

and generate the following footnotes with the sources:
{{reflist}}

== Template data ==
{{TemplateDataHeader}}
<templatedata>
{
	"description": "This template creates a table with reviews for television. Only add a rating if you cite it with a reference. The template is not to be a substitute for a section in paragraph form.",
	"params": {
		"rev1": {
			"label": "First reviewer",
			"type": "string",
			"required": true,
			"description": "The name of the first reviewer."
		},
		"rev1score": {
			"label": "First reviewer's rating",
			"type": "string",
			"required": true,
			"description": "The rating given by the first reviewer. "
		},
		"rev2": {
			"label": "Second reviewer",
			"type": "string",
			"description": "The name of the second reviewer. More reviewers can be added with parameters in the format rev[#] (the next one would be rev3). It is recommended to include no more than 10 reviews, but more can be added in exceptional circumstances."
		},
		"rev2score": {
			"label": "Second reviewer's rating",
			"type": "string",
			"description": "The rating given by the second reviewer. More ratings can be added with parameters in the format rev[#]score (the next one would be rev3score). It is recommended to include no more than 10 reviews, but more can be added in exceptional circumstances."
		},
		"title": {
			"label": "Table title",
			"type": "string",
			"description": "A custom title for the table, replacing \"professional ratings\"."
		},
		"subtitle": {
			"label": "Table subtitle",
			"type": "string",
			"description": "Additional text before the collapsible section. This is necessary to add if you want a longer title, as long titles in the \"title\" parameter will not work right."
		},
		"width": {
			"label": "Table width",
			"type": "string",
			"description": "The width of the table."
		},
		"MC": {
			"label": "Metacritic score",
			"type": "string",
			"description": "The Metacritic score. Appears under the \"Aggregate scores\" header."
		},
		"noprose": {
			"label": "Article lacks prose section",
			"type": "string",
			"description": "Set this to \"yes\" to flag articles that have an album ratings table without a prose reviews section."
		},
		"RT": {
			"label": "Rotten Tomatoes score",
			"description": "The AnyDecentMusic? score. Appears under the \"Aggregate scores\" header.",
			"type": "string"
		},
		"aggregate1": {
			"label": "First review aggregator",
			"description": "The name of the first review aggregator.",
			"type": "string"
		},
		"aggregate1score": {
			"label": "First review aggregator's rating",
			"description": "The rating given by the first review aggregator.",
			"type": "string"
		},
		"aggregate2": {
			"label": "Second review aggregator",
			"description": "The name of the second review aggregator.",
			"type": "string"
		},
		"aggregate2score": {
			"label": "Second review aggregator's rating",
			"description": "The rating given by the second review aggregator.",
			"type": "string"
		}
	},
	"format": "block"
}
</templatedata>

== See also ==
*[[:Skabelon:Album ratings]]
*[[:Skabelon:Film and game ratings]]
*[[:Skabelon:Video game reviews]]

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->

<!-- [[Kategori:Bedømmelsesskabeloner]] -->
[[Kategori:TV-skabeloner]]
}}</includeonly>