Tekst źródłowy strony Szablon:Cytuj odcinek/opis

{{Podstrona dokumentacji}}
<!-- EDYTUJ DOKUMENTACJĘ SZABLONU PONIŻEJ TEJ LINII -->
{{Szablony cytowania}}
Szablon {{S|Cytuj odcinek}} służy do cytowania poszczególnych odcinków programów telewizyjnych i radiowych, głównie seriali i innych audycji cyklicznych. Może on jednak być też używany w innych przypadkach.

== Ogólne ==
Nazwy wszystkich parametrów w szablonie (czyli '''tytuł''', '''odcinek link''' itp.) '''muszą''' być pisane małymi literami. Jedynym wymaganym do podania parametrem, by szablon działał, jest parametr '''tytuł'''.

Poniżej pełna wersja szablonu, którą należy skopiować i wkleić do artykułu. Następnie, podaje się wartości parametrów, które nas interesują, a pozostałe, nieużyte, parametry się wycina.

'''Forma pozioma'''
{| class="wikitable" cellpadding="6"
|colspan="3"|
: <span style="font-family:Courier; "><nowiki>{{Cytuj odcinek | tytuł = | odcinek link = | url = | serial = | serial link = | autorzy = | stacja = | stacja2 = | miasto = | emisja = | początek = | koniec = | sezon = | seria = | numer = | minuta = | transkrypcja = | transkrypcja url = | data dostępu = </nowiki>{{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}<nowiki>}}</nowiki></span>
|}

'''Forma pionowa'''
<pre><nowiki>
{{Cytuj odcinek
 |tytuł            = 
 |odcinek link     = 
 |url              = 
 |serial           = 
 |serial link      = 
 |autorzy          = 
 |stacja           = 
 |stacja2          = 
 |miasto           = 
 |emisja           = 
 |początek         = 
 |koniec           = 
 |sezon            = 
 |seria            = 
 |numer            = 
 |minuta           = 
 |transkrypcja     = 
 |transkrypcja url = 
 |data dostępu     = </nowiki>{{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY2}}<nowiki>
}}
</nowiki></pre>

== Pola ==
=== Wikilinki ===
Większość wartości parametrów może być jednocześnie odnośnikiem do artykułu na Wikipedii (np. '''stacja''' = <nowiki>[[Fox Broadcasting Company|FOX]]</nowiki>), lecz powinno się tworzyć odnośniki tylko do istniejących artykułów. Linki '''nie mogą''' zawierać żadnych nawiasów poza nawiasami okrągłymi <code>()</code> — nie należy używać nawiasów: <code><nowiki><>[]{}</nowiki></code>.

=== Parametry ===
* '''tytuł''': Tytuł cytowanego wydania\odcinka programu\serialu.
** '''odcinek link''': Tytuł artykułu na Wikipedii dotyczącego danego odcinka. Tytuł należy wpisać w formie <code>Tytuł odcinka</code>, '''nie należy''' go wpisywać w formie <code><nowiki>[[Tytuł odcinka]]</nowiki></code> - szablon podlinkuje odpowiedni artykuł samodzielnie. W tym polu można podać nazwę konkretnej sekcji artykułu (np. <code>Tytuł artykułu#konkretna sekcja artykułu</code>) - wtedy szablon utworzy link bezpośrednio do niej.
** '''url''': Tego parametru używamy, gdy nie istnieje artykuł dotyczący danego odcinka na Wikipedii i chcemy podać link zewnętrzny do strony internetowej\innego źródła dotyczącego interesującego nas odcinka. Parametr ten będzie działał tylko, jeśli parametr '''odcinek link''' (patrz wyżej) będzie pusty.
* '''serial''': Nazwa serialu, którego odcinek cytujemy. Uzupełniamy '''tylko''', jeśli cytowany odcinek jest częścią jakiejś większej serii.
** '''serial link''': Podobnie, jak w przypadku parametru '''odcinek link''', podajemy tu nazwę artykułu na Wikipedii, lecz tym razem dotyczącego całego serialu. Nie linkujemy artykułu samodzielnie, szablon zrobi to za nas. Możemy też podać nazwę konkretnej sekcji artykułu. Jeśli szablon {{S|Cytuj odcinek}} jest wykorzystywany właśnie w artykule o danym serialu, ten parametr pomijamy (w przeciwnym wypadku mogą wystąpić błędy działania szablonu).
* '''autorzy''': Scenarzyści, reżyserzy, producenci itp. Można samodzielnie dopisać w nawiasie "rodzaj autorstwa" np. <code>Jan Kowalski (reż.)</code>.
* '''stacja''': Stacja telewizyjna, w której został wyemitowany dany odcinek.
** '''stacja2''': Lokalna stacja telewizyjna, w której został wyemitowany dany odcinek.
** '''city''': Miasto związane z lokalną stacją telewizyjną, w której został wyemitowany dany odcinek.
* '''emisja''': Dokładna data emisji cytowanego programu w formacie <code>23 czerwca 2008</code>. Jeśli emisja miała miejsce w dłuższym okresie czasu (np. audycja dwuodcinkowa z odstępem pomiędzy odcinkami wynoszącym tydzień), to zamiast parametru '''emisja''' stosujemy parametry '''początek''' i '''koniec''':
** '''początek''': Dokładna data emisji pierwszej części cytowanego programu, format daty jak powyżej.
** '''koniec''': Dokładna data emisji ostatniej części cytowanego programu, format daty jak powyżej.
* '''sezon''': Wiele produkcji jest podzielonych na sezony, dzięki temu parametrowi możemy podać ww. informację.  Parametr '''sezon''' może być użyty tylko jeśli parametr '''seria''' (patrz poniżej) jest nieuzupełniony.
* '''seria''': Alternatywna możliwość oznaczania odcinków, zwłaszcza dla produkcji brytyjskich, gdzie zamiast podziału na sezony, występuje podział na serie. Parametr '''seria''' może być użyty jedynie gdy pole '''sezon''' jest puste.
* '''numer''': Tu można podać numer odcinka. W przypadku produkcji podzielonych na sezony lub serie, podajemy numer odcinka w obrębie danego sezonu/serii, nie od początku serialu. Niektóre produkcje stosują numerację odcinków, która już zawiera w sobie numer sezonu - w tym wypadku omijamy pole '''sezon''' lub '''seria''', wypełniając tylko pole '''numer'''.
* '''minuta''': Tego parametru używamy tylko, gdy istnieje potrzeba zacytowania konkretnego fragmentu odcinka (coś w rodzaju numeru strony w przypadku szablonów służących do cytowania źródeł pisanych)
* '''transkrypcja''': Parametr ten zaznacza, że źródłem informacji, którą popieramy przypisem używającym tego szablonu była transkrypcja (stenogram, scenariusz) programu, a nie program sam w sobie. Przy użyciu tego parametru szablon wyświetli tekst: <code>Transkrypcja.</code>
** LUB '''transcripturl''': Parametr ten umożliwia podanie linku zewnętrznego do transkrypcji, która była źródłem naszej informacji.
* '''data dostępu''': Parametru tego można użyć, gdy w parametrze '''url''' podajemy adres do cytowanego materiału (np. plik audio audycji radiowej, którą cytujemy).

== Przykłady użycia szablonu ==
=== Użycie szablonu na przykładzie serialu ===
Zapis składni szablonu:

<pre>
{{cytuj odcinek
 |tytuł        = Simpsons Roasting on an Open Fire
 |odcinek link = Simpsons Roasting on an Open Fire
 |serial       = Simpsonowie
 |serial link  = Simpsonowie
 |autorzy      = Mimi Pond (scen.)
 |stacja       = [[Fox Broadcasting Company|FOX]]
 |emisja       = 17 grudnia 1989
 |sezon        = 1
 |numer        = 1
}}
</pre>

A oto końcowy efekt:

{{cytuj odcinek
 |tytuł        = Simpsons Roasting on an Open Fire
 |odcinek link = Simpsons Roasting on an Open Fire
 |serial       = Simpsonowie
 |serial link  = Simpsonowie
 |autorzy      = Mimi Pond (scen.)
 |stacja       = [[Fox Broadcasting Company|FOX]]
 |emisja       = 17 grudnia 1989
 |sezon        = 1
 |numer        = 1
}}

=== Użycie szablonu na przykładzie audycji nieodcinkowej ===
Zapis składni szablonu:

<pre>
{{Cytuj odcinek
 |tytuł            = BBC-TV Presents: The 2008 World Snooker Championship Live at The Crucible
 |odcinek link     = BBC Snooker World Championship coverage (2008)
 |serial           = Wide World of Snooker
 |serial link      = Wide World of Snooker (program telewizyjny)
 |autorzy          = Prezenterzy: [[Dennis Taylor]] and [[Clive Everton]]
 |stacja           = [[British Broadcasting Corporation|BBC]]
 |stacja2          = [[BBC Two]]
 |miasto           = [[Sheffield]], [[Anglia]]
 |emisja           = 27 kwietnia 2004
 |minuta           = 2:34
 |transkrypcja url = http://bbc.com/transkrypcjaaudycji.html
 |data dostępu     = 23 czerwca 2008
}}
</pre>

A oto końcowy efekt:

{{Cytuj odcinek
 |tytuł            = BBC-TV Presents: The 2008 World Snooker Championship Live at The Crucible
 |odcinek link     = BBC Snooker World Championship coverage (2008)
 |serial           = Wide World of Snooker
 |serial link      = Wide World of Snooker (program telewizyjny)
 |autorzy          = Prezenterzy: [[Dennis Taylor]] and [[Clive Everton]]
 |stacja           = [[British Broadcasting Corporation|BBC]]
 |stacja2          = [[BBC Two]]
 |miasto           = [[Sheffield]], [[Anglia]]
 |emisja           = 27 kwietnia 2004
 |minuta           = 2:34
 |transkrypcja url = http://bbc.com/transkrypcjaaudycji.html
 |data dostępu     = 23 czerwca 2008
}}

== Parametry szablonu ([[Pomoc:Jak dodać TemplateData|strukturyzacja VE]]) ==
<templatedata>
{
	"description": "Szablon Cytuj odcinek służy do cytowania poszczególnych odcinków programów telewizyjnych i radiowych, głównie seriali i innych audycji cyklicznych. Może on jednak być też używany w innych przypadkach",
	"params": {
		"tytuł": {
			"label": "Tytuł",
			"type": "content",
			"suggested": true,
			"required": true,
			"description": "Tytuł cytowanego wydania/odcinka programu/serialu"
		},
		"odcinek link": {
			"label": "odcinek link",
			"type": "string",
			"suggested": false,
			"required": false,
			"description": "Tytuł artykułu na Wikipedii dotyczącego danego odcinka. Tytuł należy wpisać w formie Tytuł odcinka, nie należy go wpisywać w formie Tytuł odcinka - szablon podlinkuje odpowiedni artykuł samodzielnie. W tym polu można podać nazwę konkretnej sekcji artykułu (np. Tytuł artykułu#konkretna sekcja artykułu) - wtedy szablon utworzy link bezpośrednio do niej."
		},
		"url": {
			"label": "URL",
			"type": "string",
			"suggested": false,
			"required": false,
			"description": "Tego parametru używamy, gdy nie istnieje artykuł dotyczący danego odcinka na Wikipedii i chcemy podać link zewnętrzny do strony internetowej/innego źródła dotyczącego interesującego nas odcinka. Parametr ten będzie działał tylko, jeśli parametr odcinek link (patrz wyżej) będzie pusty."
		},
		"autorzy": {
			"label": "Autorzy",
			"type": "content",
			"suggested": true,
			"required": false,
			"description": "Scenarzyści, reżyserzy, producenci itp. Można samodzielnie dopisać w nawiasie 'rodzaj autorstwa' np. Jan Kowalski (reż.)."
		},
		"data dostępu": {
			"label": "Data dostępu",
			"type": "string",
			"suggested": false,
			"required": false,
			"description": "Parametru tego można użyć, gdy w parametrze url podajemy adres do cytowanego materiału (np. plik audio audycji radiowej, którą cytujemy)."
		},
		"serial": {
			"description": "Nazwa serialu, którego odcinek cytujemy. Uzupełniamy tylko, jeśli cytowany odcinek jest częścią jakiejś większej serii."
		},
		"serial link": {
			"description": "Podobnie, jak w przypadku parametru odcinek link, podajemy tu nazwę artykułu na Wikipedii, lecz tym razem dotyczącego całego serialu. Nie linkujemy artykułu samodzielnie, szablon zrobi to za nas. Możemy też podać nazwę konkretnej sekcji artykułu. Jeśli szablon {{Cytuj odcinek}} jest wykorzystywany właśnie w artykule o danym serialu, ten parametr pomijamy (w przeciwnym wypadku mogą wystąpić błędy działania szablonu)."
		},
		"stacja": {
			"description": "Stacja telewizyjna, w której został wyemitowany dany odcinek."
		},
		"emisja": {
			"description": "Dokładna data emisji cytowanego programu w formacie 23 czerwca 2008. Jeśli emisja miała miejsce w dłuższym okresie czasu (np. audycja dwuodcinkowa z odstępem pomiędzy odcinkami wynoszącym tydzień), to zamiast parametru emisja stosujemy parametry początek i koniec"
		},
		"sezon": {
			"description": "Wiele produkcji jest podzielonych na sezony, dzięki temu parametrowi możemy podać ww. informację. Parametr sezon może być użyty tylko jeśli parametr seria (patrz poniżej) jest nieuzupełniony."
		},
		"seria": {
			"description": "Alternatywna możliwość oznaczania odcinków, zwłaszcza dla produkcji brytyjskich, gdzie zamiast podziału na sezony, występuje podział na serie. Parametr seria może być użyty jedynie gdy pole sezon jest puste."
		},
		"numer": {
			"description": "Tu można podać numer odcinka. W przypadku produkcji podzielonych na sezony lub serie, podajemy numer odcinka w obrębie danego sezonu/serii, nie od początku serialu. Niektóre produkcje stosują numerację odcinków, która już zawiera w sobie numer sezonu - w tym wypadku omijamy pole sezon lub seria, wypełniając tylko pole numer."
		},
		"minuta": {
			"description": "Tego parametru używamy tylko, gdy istnieje potrzeba zacytowania konkretnego fragmentu odcinka (coś w rodzaju numeru strony w przypadku szablonów służących do cytowania źródeł pisanych)"
		},
		"transkrypcja": {
			"description": "Parametr ten zaznacza, że źródłem informacji, którą popieramy przypisem używającym tego szablonu była transkrypcja (stenogram, scenariusz) programu, a nie program sam w sobie. Przy użyciu tego parametru szablon wyświetli tekst: Transkrypcja."
		}
	},
	"maps": {
		"citoid": {
			"url": "url",
			"title": "tytuł",
			"date": "emisja",
			"label": "stacja",
			"studio": "stacja",
			"network": "stacja",
			"publisher": "stacja",
			"distributor": "stacja",
			"programTitle": "serial",
			"publicationTitle": "serial",
			"accessDate": "data dostępu",
			"episodeNumber": "numer",
			"podcaster": "autorzy",
			"performer": "autorzy",
			"director": "autorzy",
			"contributor": "autorzy",
			"author": "autorzy"
		}
	},
	"paramOrder": [
		"tytuł",
		"odcinek link",
		"url",
		"autorzy",
		"data dostępu",
		"serial",
		"serial link",
		"stacja",
		"emisja",
		"sezon",
		"seria",
		"numer",
		"minuta",
		"transkrypcja"
	],
	"format": "inline"
}
</templatedata>

<includeonly>
<!-- DODAJ KATEGORIE PONIŻEJ TEJ LINII -->
[[Kategoria:Szablony cytowania|{{PAGENAME}}]]

<!-- DODAJ INTERWIKI PONIŻEJ TEJ LINII -->
</includeonly>