Quelltext der Seite Vorlage:Zuschauerzahlen/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Der Zweck der '''{{Vorlage|Zuschauerzahlen}}-'''Vorlage ist es, eine [[Hilfe:Zeitleisten|Zeitleiste]] der Zuschauerzahlen von [[Fernsehserie]]n sowohl in grafischer als auch in tabellarischer Form darzustellen. Dazu wird in einem Balkendiagramm jede Episode als Balken dargestellt. Die Staffeln werden in unterschiedlichen Farben angezeigt.

== Kopiervorlage ==
<pre style="white-space:pre-wrap; overflow:auto;">
{{Zuschauerzahlen
| title           = TEXT
| season_title    = TEXT
| nograph         = TEXT
| notable         = TEXT
| color{1,2,...}  = FARBE
| legend{1,2,...} = TEXT
| refs            = BELEGE
| width           = ZAHL
| height          = ZAHL
| average         = TEXT
| intervals       = ZAHL
| bar_width       = ZAHL
| country         = TEXT
| (Unbenannt)     = ZAHL ODER TRENNSTRICH
}}
</pre>

== Parameter ==
{| class="wikitable"
! colspan="2" | Parameter
! style="width:60%" | Beschreibung
! Typ
! Status
|-
! Titel
| title
| Titel der Serie im Klartext.
| Text
| Erforderlich
|-
! Staffeltitel
| season_title
| Alternativer Text anstelle von „Staffel“.
| Text
| Optional
|-
! Kein Diagramm
| nograph
| Zeigt die Vorlage ohne das Diagramm an, wenn der Parameter auf „y“ gesetzt ist.
| Text
| Optional
|-
! Keine Tabelle
| notable
| Zeigt die Vorlage ohne die Datentabelle an, wenn der Parameter auf „y“ gesetzt ist.
| Text
| Optional
|-
! Farben
| color{1,2,...}
| Die Hintergrundfarbe der Balken und Legende für jede Staffel im Hexadezimalformat (drei oder sechs Zeichen). Erforderlich für jede Staffel. Standard ist #006600.<br />''Format:'' #FFFFFF oder #FFF
| String
| Erforderlich
|-
! Legende
| legend{1,2,...}
| Alternativer Text für Staffelnamen in der Legende und in der Tabelle.
| Text
| Optional
|-
! Belege
| refs
| Die Belege für die Zuschauerzahlen im normale Belegformat. Erforderlich zur Überprüfung der Werte.<br />
Quellen für die Daten sind beispielsweise:
* {{USA|#}} [https://tvseriesfinale.com/television-ratings/tv-ratings-by-season-channel/ TV Series Finale]
* {{USA|#}} [https://showbuzzdaily.com/tag/ratings Showbuzz Daily]
* {{USA|#}} [https://tvline.com/category/ratings/ TVLine]
* {{DEU|#}} [https://www.dwdl.de/zahlenzentrale/ DWDL.de]
* {{DEU|#}} [https://www.quotenmeter.de/c/21/quoten Quotenmeter]
| Beleg
| Erforderlich
|-
! Breite
| width
| Breite des Diagramms als Zahl. Der Standardwert ist 1000 px.<br />''Format:'' 800
| Zahl
| Optional
|-
! Höhe
| height
| Höhe des Diagramms als Zahl. Der Standardwert ist 300 px.<br />''Format:'' 250
| Zahl
| Optional
|-
! Durchschnitt
| average
| Legt fest, dass der letzte Wert einer Staffel als Durchschnittswert angezeigt wird, wenn der Parameter auf eine beliebigen Text gesetzt wird. Der Durchschnittswert erscheint nur in der Tabelle, jedoch nicht im Diagramm.
| Text
| Optional
|-
! Abstände
| intervals
| Wenn es zu viele Episoden gibt, fangen die Episodennummern entlang der horizontalen Achse an, sich zu bündeln - stelle dies so ein, dass nur ein Vielfaches entlang der horizontalen Linie angezeigt wird.<br />''Beispiel:'' Wenn diese Einstellung auf 5 gesetzt wird, werden nur die Episodennummern 1 und das Vielfache von 5 angezeigt und nicht jede Episodennummer.
| Zahl
| Optional
|-
! Balkenbreite
| bar_width
| Breite der Balken auf dem Diagramm im einfachen Zahlenformat.
| Zahl
| Optional
|-
! Land
| country
| Das Ursprungsland der Serie.
| Text
| Optional
|-
! Zuschauerzahlen
| {{N/A}}
| ''Existierende Werte:'' Die Zuschauerzahlen für die Staffeln werden in Millionen angegeben, wobei für jede Zahl ein unbenannter Parameter verwendet wird. ''Beispiel:'' <code><nowiki>|2.50</nowiki></code><br />''Ausstehende Werte:'' Bei Einfügen eines leeren Parameters für eine Zuschauerzahl wird ein Platz für einen leeren Balken im Diagramm gesetzt und eine {{Tlx|N/A|–}} Zelle in die Tabelle. ''Beispiel:''  <code><nowiki>|</nowiki></code><br />''N/A-Werte:'' Nicht verfügbare Zuschauerzahlen werden auf N/A gesetzt, ein leerer Balken im Diagramm ergänzt und eine {{Tlx|N/A}} Zelle in der Tabelle. ''Beispiel:'' <code><nowiki>|N/A</nowiki></code><br />''Staffeln teilen:'' Füge einen neuen Parameter vor jeder Staffel hinzu und setzen ihn auf einen Bindestrich. ''Beispiel:'' : <code><nowiki>|–</nowiki></code><br />Die Vorlage wird automatisch das Zellenelemente {{Tlx|N/A}} enthalten, wenn die Anzahl der Episoden zwischen den Staffeln unterschiedlich ist.
| Zahl/Bindestrich/Text
| Erforderlich
|}

== Beispiele ==
<pre style="white-space:pre-wrap; overflow:auto;">
{{Zuschauerzahlen
| 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
| refs   = <ref></ref><ref></ref>
| 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>{{Zuschauerzahlen
| 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
| refs   = <ref>ref1</ref><ref>ref2</ref>
| 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
| 
| 
| 
| 
}}

<includeonly>
[[Kategorie:Vorlage:mit Lua-Programmierung]]
[[Kategorie:Vorlage:Film und Fernsehen]]
[[Kategorie:Vorlage:Zeitleiste Medien]]
</includeonly>