Szablon:Odcinek2/opis

To jest podstrona dokumentacji dla szablonu {{Szablon:Odcinek2 i Szablon:Odcinek2/sublista}}.
Zawiera ona informacje na temat sposobu użycia, kategoryzacji szablonu i inną zawartość niebędącą częścią oryginalnej strony.

Ta strona w pigułce:

w przypadku listy odcinków bez opisów i w jednym artykule (np. Kumple) – #Sezony bez osobnych artykułów

w przypadku listy z opisami (np. Dr House) – #Użycie szablonu

w przypadku listy, która składa się z tabel transkludowanych z innych artykułów (np. Współczesna rodzina) – #Sezony z osobnymi artykułami

Ten szablon tworzy wiersz w wikitabelach, który jest używany w listach odcinków programów telewizyjnych. Liczba i użycie kolumn tabeli jest zdefiniowane przez początek wikitekstu tabeli (szczegóły później), i nie jest zdefiniowane przez ten szablon. Zgodnie z kodem szablonu, by stworzyć wiersz tabeli dla danego artykułu, parametry muszą być albo zawarte, albo wykluczone. Zawarty parametr, także pusty, tworzy komórkę dla tego pola (czyli kolumnę). Wykluczony nie zapewnia komórki dla tego pola, przez co szablon różni się od Szablonu:Odcinek, gdzie dla zapewnienia komórki należy wpisać jakąkolwiek wartość w polu parametru (chociażby  , czyli spację nierozdzielającą).

Parametry[edytuj kod]

Parametry szablonu i wytyczne
Nazwa pola	Typ parametru	Opis	Sugerowane wartości
numer	Nieobowiązkowy, lecz mile widziany	Numer odcinka liczony od początku serialu. Np. pierwszy odcinek powinien być opisany jako `1` itd. Po zdefiniowaniu, numer tworzy link do anchora (kotwicę), poprzedzony przez `ep`. Np. `[[Lista odcinków#ep1]]`. Przy tworzeniu kotwicy, tekst jest traktowany dosłownie. By stworzyć najprostsze wersje anchorów, czyli takie, o których wspomniano w przykładzie, należy wpisać tylko liczbę – bez formatowania (w tym wytłuszczenia).	liczba – bez formatowania ani innej treści
odcinek	Nieobowiązkowy	Kolumna dla drugiego numeru odcinka. Gdy na serial składa się wiele sezonów, parametr ten używany jest, by przedstawić numer odcinka w pojedynczym sezonie.	liczba
tytuł	Obowiązkowy	Tytuł odcinka. W trybie czytania zostaje on ujęty w cudzysłowach („”) i wytłuszczoną czcionką, dlatego nie należy wpisywać tytułów w cudzysłowach i/lub boldem. Można linkować do artykułu na temat odcinka, jeżeli został on wcześniej stworzony. W przypadku polskiego serialu to tutaj zaleca się wpisać tytuł odcinka.	wikitekst, linki do istniejących artykułów
polski tytuł	Nieobowiązkowy	Polski (w przypadku seriali zagranicznych) lub alternatywny tytuł odcinka. Tak jak `tytuł`, zostaje on ujęty w cudzysłowach i wytłuszczoną czcionką.	wikitekst
źródło źródło pl	Nieobowiązkowy	Niesformatowany parametr, który po zdefiniowaniu będzie zawierać przypisy umieszczone po tytule i/lub polskim tytule. Przyszłe epizody powinny zawierać przypisy, by spełniać wytyczne zawarte w Wikipedia:Weryfikowalność.	wikitekst, linki do istniejących artykułów
dopisek dopisek pl	Nieobowiązkowy	Niesformatowany parametr, który po zdefiniowaniu będzie zawierać dowolny tekst umieszczony pod tytułem i/lub polskim tytułem.	wikitekst
aux1	Nieobowiązkowy	Parametr uniwersalny. Znaczenie musi być określone z nagłówku tabeli.	wikitekst, linki do istniejących artykułów
reżyseria	Nieobowiązkowy	Reżyser odcinka.
scenariusz	Nieobowiązkowy	Autor (autorzy) scenariusza odcinka.
aux2	Nieobowiązkowy	Parametr uniwersalny. Znaczenie musi być określone z nagłówku tabeli.
premiera USA premiera POL	Nieobowiązkowy	Data pierwszej emisji epizodu, np. `1 stycznia 2010`, `25 sierpnia 2013`. W przypadku serialu polskiego wybór nazwy pola nie ma znaczenia.	data
kod produkcji	Nieobowiązkowy	Kod produkcji odcinka. Po zdefiniowaniu, szablon tworzy link do anchora poprzedzony przez `pc`; na przykład `[[Lista odcinków#pc01]]`.	zwykły tekst
oglądalność USA oglądalność POL	Nieobowiązkowy, lecz mile widziany	Oglądalność odcinka najlepiej podana w milionach. W przypadku pola `oglądalność USA` należy wpisać oryginalną oglądalność w oryginalnym kraju, natomiast w polu `oglądalność POL` zaleca się wpisać polską oglądalność, jeżeli serial nie jest polski. W przypadku serialu polskiego wybór nazwy pola nie ma znaczenia.	liczba, po niej przypis
aux3	Nieobowiązkowy	Parametr uniwersalny. Znaczenie musi być określone z nagłówku tabeli.	wikitekst, linki do istniejących artykułów
opis	Nieobowiązkowy	Streszczenie fabuły odcinka. Nie może ono być skopiowane innych źródeł, gdyż narusza to prawa autorskie.	wikitekst, linki do istniejących artykułów
kolor linii	Nieobowiązkowy	Kolory linii oddzielającej poszczególne epizody. Jeżeli nie zostaje on zdefiniowany to domyślnym kolorem staje się "`#CCCCFF`". Użycie kratki (`#`) lub czegokolwiek prócz prawidłowego kodu szesnastkowego skutkuje błędami w składni szablonu.	Kod szesnastkowy nie poprzedzony przez `#`. Np. `00ff00` zamiast `#00ff00`.
kolor góry	Nieobowiązkowy	Kolory głównego wiersza z informacjami (nie z `opis`em). Jeżeli nie zostaje on zdefiniowany, to domyślnie tabela będzie cieniowana kolorem `#F9F9F9`. Gdy `opis` jest używany, domyślnym kolorem jest `#F2F2F2`.
kolor rzędu	Nieobowiązkowy	Ten parametr jest „przełącznikiem”, który musi być zdefiniowany, gdy parametr `numer=` nie jest wyrażony zwykłą liczbą (np. `12–13` dla dwóch epizodów w jednym wierszu tabeli). W trakcie transkluzji tabeli z artykułu na temat sezonu do głównej listy odcinków, nieregularne wpisy w polu `numer=` doprowadzają do popsucia się efektu naprzemiennego kolorowania tabeli, który został wprowadzony do szablonu. Gdy pierwszy odcinek jest liczbą parzystą, należy zdefiniować `kolor rzędu=` jako `tak`. Gdy pierwszy odcinek jest liczbą nieparzystą, należy zdefiniować `kolor rzędu=` jako `nie`. We wszystkich użyciach Szablonu:odcinek2 w tabeli, należy również zdefiniować parametry `kolor rzędu=` naprzemiennie jako `tak` oraz `nie` by uniknąć błędów w wyświetlaniu się kolorów.	`Tak`, `tak`, `T`, `t`, `On`, `on`, `Yes`, `yes`, `Y` lub `Nie`, `nie`, `N`, `n`, `y`, `Off`, `off`, `No`, `no`

To jest miejsce, gdzie umieszcza się informacje przez renderingiem (| kolor linii =, | kolor góry = i | kolor rzędu = nie są pokazane, ponieważ nie zawierają tekstu do wyświetlenia):

{{{numer}}}	{{{odcinek}}}	„{{{tytuł}}}”{{{źródło}}} {{{dopisek}}}	„{{{polski tytuł}}}”{{{źródło pl}}} {{{dopisek pl}}}	{{{aux1}}}	{{{reżyseria}}}	{{{scenariusz}}}	{{{aux2}}}	{{{premiera USA}}}	{{{premiera POL}}}	{{{kod produkcji}}}	{{{oglądalność USA}}}	{{{oglądalność POL}}}	{{{aux3}}}
{{{opis}}}

Użycie szablonu[edytuj kod]

Podczas używania parametrów nieobowiązkowych (takich jak aux1 czy kod produkcji) należy zawrzeć tylko parametry, które są używane, a nagłówki dostosować do szablonu. Dzięki temu można uniknąć sytuacji, gdy pojawia się wiele pól, gdzie jedne są wypełnione, a drugie nie. Komórka tabeli pojawia się wraz z zawartym parametrem, nieważne, czy jest wypełniony.

By zacząć listę odcinków, dodaj ten szablon, gdzie powinien być wiersz odcinka w liście odcinków. Oto pełna składnia; usuń wszystkie nieużywane parametry:

{{odcinek2
 |numer           = 
 |odcinek         = 
 |tytuł           = 
 |źródło          = 
 |dopisek         = 
 |polski tytuł    = 
 |źródło pl       = 
 |dopisek pl      = 
 |aux1            = 
 |reżyseria       = 
 |scenariusz      = 
 |aux2            = 
 |premiera USA    = 
 |premiera POL    = 
 |kod produkcji   = 
 |oglądalność USA = 
 |oglądalność POL = 
 |aux3            = 
 |opis            = 
 |kolor linii     = 
}}

Ponieważ to tylko część wikitabeli, należy ją najpierw otworzyć.

Uwaga! Bardzo ważne jest, by usunąć z tego przykładu wszystkie parametry nieobowiązkowe, których nie zamierzamy używać.

Sublisty[edytuj kod]

Sezony z osobnymi artykułami[edytuj kod]

Czasami, gdy mamy do czynienia z długim serialem, którego sezony mają własne artykuły, możemy podzielić listę na sublisty. Wtedy lista powinna być podzielona według sezonów lub lat.

Sublisty powinny nosić nazwę „[tytuł serialu] (sezon Y)” i być transkludowane na główną listę bez duplikowania tych samych informacji. Dla stron ze sublistami powinno się używać {{odcinek2/sublista|Lista odcinków serialu X}} przy każdym odcinku, gdzie „Lista odcinków serialu X” jest nazwą dla artykułu z listą główną. Więc, pracując nad Listą odcinków serialu Pamiętniki wampirów, powinniśmy podzielić ją na Pamiętniki wampirów (seria 1) i Pamiętniki wampirów (seria 2), a przy każdym epizodzie wpisywać {{odcinek2/sublista|Lista odcinków serialu Pamiętniki wampirów}}.

Przy transkluzji, szablon usuwa wszystkie streszczenia i zmienia kolory rzędów na naprzemiennie platynowy i srebrny. Czasem wieloczęściowe odcinki mogą zepsuć wzór pomiędzy odcinkami o parzystym i nieparzystym numerze. Aby to naprawić używa się parametru kolor rzędu. Treść Tak koloruje wiersz na kolor srebrny, jak każdy parzysty numer w artykule Lista odcinków serialu X, a treść Nie koloruje wiersz na kolor platynowy, tak jak kaźdy numer nieparzysty.

W celu transkluzji każda sublista musi zawierać tag <onlyinclude> tuż przed otwarciem wikitabeli i tag </onlyinclude> na samym końcu tabeli. Dzięki temu reszta artykułu, np. definicje, główni bohaterowie, linki zewnętrzne, kategorie i inne niepotrzebne informacje nie są zawarte w transkluzji.

W trakcie transkluzji powinno się używać {{Osobny artykuł}}. Np. odnosząc się ponownie od Pamiętników wampirów, lista główna powinna zawierać następujący kod poniżej nagłówka listy odcinków:

== Seria 1 ==
{{Osobny artykuł|Pamiętniki wampirów (seria 1)}}
{{:Pamiętniki wampirów (seria 1)}}
<!-- Edycja tej listy możliwa jest po przejściu do trybu edycji artykułu podanego powyżej -->

== Seria 2 ==
{{Osobny artykuł|Pamiętniki wampirów (seria 2)}}
{{:Pamiętniki wampirów (seria 2)}}
<!-- Edycja tej listy możliwa jest po przejściu do trybu edycji artykułu podanego powyżej -->

Ważne jest postawienie dwukropka (: ) na początku odwołań (na przykład, {{:Lista odcinków serialu ...); to konieczne dla prawidłowej transkluzji. W trakcie transkluzji Listy odcinków serialu Pamiętniki wampirów bez użycia dwukropka, można otrzymać Szablon:Lista odcinków serialu Pamiętniki wampirów, czerwony link do nieistniejącego szablonu.

Przykłady[edytuj kod]

Jeżeli następujący kod znajduje się na stronie Współczesna rodzina (sezon 3):

<onlyinclude>
{| class="wikitable" width="100%"
!style="background-color: #FFD700; color:#100; text-align: center;"| №
!style="background-color: #FFD700; color:#100; text-align: center;"| #
!style="background-color: #FFD700; color:#100; text-align: center;"| Tytuł
!style="background-color: #FFD700; color:#100; text-align: center;"| Reżyseria
!style="background-color: #FFD700; color:#100; text-align: center;"| Scenariusz
!style="background-color: #FFD700; color:#100; text-align: center;"| Premiera {{flaga|USA}}
!style="background-color: #FFD700; color:#100; text-align: center;"| Premiera {{flaga|POL}}
{{Odcinek2/sublista|Lista odcinków serialu Współczesna rodzina
 |odcinek      = 23
 |numer        = 71
 |tytuł        = Tableau Vivant
 |reżyseria    = Gail Mancuso
 |scenariusz   = Elaine Ko,Jeffrey Richman, Bill Wrubel
 |premiera USA = 16 maja 2012
 |premiera POL = 31 lipca 2012
 |opis         = Phil nie wie jak najłagodniej zwolnić Mitchella z jego pół-etatowej pracy. Cameron i Claire mają różne opinie na temat uczenia dzieci dyscypliny. Luke zamierza przyjąć medal za ugaszenie pożaru, który sam wzniecił. Gloria i Jay kłócą się przy wyborze lunchu. Rodzina pomaga Alex w stworzeniu żywego obrazu [[Norman Rockwell|Normana Rockwella]], ''Freedom from want''.
 |kolor linii  = FFD700
}}
{{Odcinek2/sublista|Lista odcinków serialu Współczesna rodzina
 |odcinek      = 24
 |numer        = 72
 |tytuł        = Baby on Board
 |reżyseria    = Steven Levitan
 |scenariusz   = Abraham Higginbotham
 |premiera USA = 23 maja 2012
 |premiera POL = 1 sierpnia 2012
 |opis         = Cameron i Mitchell dowiadują się, że wkrótce urodzi się dziecko, na które czekali. Zabierają ze sobą Glorię, która ma pełnić rolę tłumacza. Jednak na miejscu spotyka ich rozczarowanie. Jay i Manny zajmują się Lily. Alex wybiera się na bal szkolny. Haley zamierza ujawnić rodzicom swoje plany na przyszłość podczas kolacji z Dylanem. Gloria odkrywa, że jest w ciąży.
 |kolor linii  = FFD700
}}
|}
</onlyinclude>

A na stronie Współczesna rodzina (sezon 4) znajduje się taki kod:

<onlyinclude>
{| class="wikitable" width="100%"
|-
!style="background-color: #33CC66; color:#100; text-align: center;"| №
!style="background-color: #33CC66; color:#100; text-align: center;"| #
!style="background-color: #33CC66; color:#100; text-align: center;"| Tytuł
!style="background-color: #33CC66; color:#100; text-align: center;"| Reżyseria
!style="background-color: #33CC66; color:#100; text-align: center;"| Scenariusz
!style="background-color: #33CC66; color:#100; text-align: center;"| Premiera {{flaga|USA}}
!style="background-color: #33CC66; color:#100; text-align: center;"| Premiera {{flaga|POL}}
{{Odcinek2/sublista|Lista odcinków serialu Współczesna rodzina
 |odcinek      = 1
 |numer        = 73
 |tytuł        = Bringing Up Baby
 |reżyseria    = Steven Levitan
 |scenariusz   = Paul Corrigan, Brad Walsh
 |premiera USA = 26 września 2012
 |premiera POL = 12 lutego 2013
 |opis         = 65. urodziny Jaya. Jego przyjaciele i Phil urządzają mu niespodziankę. Gloria nie wie jak powiedzieć Jayowi i rodzinie, że jest w ciąży. Claire postanawia przygotować ojca na tę wiadomość. Mitch i Cam mówią Lily, że nie będzie miała braciszka. Haley prosi Claire, by Dylan mógł z nimi zamieszkać.
'''Gościnnie:''' [[Chazz Palminteri]], [[Ernie Hudson]]
 |kolor linii   = 33CC66
}}
{{Odcinek2/sublista|Lista odcinków serialu Współczesna rodzina
 |odcinek      = 2
 |numer        = 74
 |tytuł        = Schooled
 |reżyseria    = Jeff Melman
 |scenariusz   = Steven Levitan & Dan O'Shannon
 |premiera USA = 10 października 2012
 |premiera POL = 13 lutego 2013
 |opis         = Haley wybiera się na studia, Lily do przedszkola, a Gloria i Jay do szkoły rodzicielskiej. Cam i Mitch wdają się w kłótnię z parą lesbijek, których syn dokuczał Lily. Gloria i Jay uważają, że lepiej znają się na wychowywaniu dzieci i wychodzą z zajęć. Claire i Phil zawstydzają Haley, kiedy pomagają jej w przeprowadzce.
 |kolor linii  = 33CC66
}}
|}
</onlyinclude>

I gdyby w kodzie artykułu Lista odcinków serialu Współczesna rodzina zawarto:

== Sezon 3 ==
{{Osobny artykuł|Współczesna rodzina (sezon 3)}}
{{:Współczesna rodzina (sezon 3)}}

== Sezon 4 ==
{{Osobny artykuł|Współczesna rodzina (sezon 4)}}
{{:Współczesna rodzina (sezon 4)}}

To lista odcinków serialu Współczesna rodzina wyglądałaby następująco:

Sezon 3

Osobny artykuł: Współczesna rodzina (sezon 3).

№	#	Tytuł	Reżyseria	Scenariusz	Premiera	Premiera
71	23	Tableau Vivant	Gail Mancuso	Elaine Ko,Jeffrey Richman, Bill Wrubel	16 maja 2012	31 lipca 2012
72	24	Baby on Board	Steven Levitan	Abraham Higginbotham	23 maja 2012	1 sierpnia 2012

Sezon 4

Osobny artykuł: Współczesna rodzina (sezon 4).

№	#	Tytuł	Reżyseria	Scenariusz	Premiera	Premiera
73	1	Bringing Up Baby	Steven Levitan	Paul Corrigan, Brad Walsh	26 września 2012	12 lutego 2013
74	2	Schooled	Jeff Melman	Steven Levitan & Dan O'Shannon	10 października 2012	13 lutego 2013

Sezony bez osobnych artykułów[edytuj kod]

W przypadku, gdy nie utworzono osobnych artykułów dla każdego z sezonów serialu, a także nie streszczono poszczególnych epizodów, można również stosować szablon {{odcinek2/sublista}}, jednak po pionowej kresce należy wpisać {{PAGENAME}} Pozwoli to na utworzenie cieniowanego wzorku na tabeli.

Przykład[edytuj kod]

Gdy w kodzie artykułu Lista odcinków serialu Kumple zostaje wpisane:

{| class="wikitable"  style="width:100%"
!style="background: #6699CC"| №
!style="background: #6699CC"| #
!style="background: #6699CC"| Tytuł
!style="background: #6699CC"| Polski tytuł
!style="background: #6699CC"| Główna postać
!style="background: #6699CC"| Reżyseria
!style="background: #6699CC"| Scenariusz
!style="background: #6699CC"| Premiera ([[Wielka Brytania|UK]])
{{odcinek2/sublista|{{PAGENAME}}
|numer        = 1
|odcinek      = 1
|tytuł        = Tony
|polski tytuł = Tony
|aux1         = Tony Stonem
|reżyseria    = Paul Gay
|scenariusz   = Bryan Elsley
|premiera USA = 25 stycznia 2007
}}
{{odcinek2/sublista|{{PAGENAME}}
|numer        = 2
|odcinek      = 2
|tytuł        = Cassie
|polski tytuł = Cassie
|aux1         = Cassie Ainsworth
|reżyseria    = Paul Gay
|scenariusz   = Bryan Elsley
|premiera USA = 1 lutego 2007
}}
{{odcinek2/sublista|{{PAGENAME}}
|numer        = 3
|odcinek      = 3
|tytuł        = Jal
|polski tytuł = Jal
|aux1         = Jal Fazer
|reżyseria    = Adam Smith
|scenariusz   = Bryan Elsley
|premiera USA = 8 lutego 2007
}}
{{odcinek2/sublista|{{PAGENAME}}
|numer        = 4
|odcinek      = 4
|tytuł        = Chris
|polski tytuł = Chris
|aux1         = Chris Miles
|reżyseria    = Adam Smith
|scenariusz   = Jack Thorne
|premiera USA = 15 lutego 2007
}}
{{odcinek2/sublista|{{PAGENAME}}
|numer        = 5
|odcinek      = 5
|tytuł        = Sid
|polski tytuł = Sid
|aux1         = Sid Jenkins
|reżyseria    = Minkie Spiro
|scenariusz   = Jamie Brittain
|premiera USA = 22 lutego 2007
}}
|}

To wyrenderowana tabela będzie wyglądała tak:

№	#	Tytuł	Polski tytuł	Główna postać	Reżyseria	Scenariusz	Premiera (UK)
1	1	Tony	Tony	Tony Stonem	Paul Gay	Bryan Elsley	25 stycznia 2007
2	2	Cassie	Cassie	Cassie Ainsworth	Paul Gay	Bryan Elsley	1 lutego 2007
3	3	Jal	Jal	Jal Fazer	Adam Smith	Bryan Elsley	8 lutego 2007
4	4	Chris	Chris	Chris Miles	Adam Smith	Jack Thorne	15 lutego 2007
5	5	Sid	Sid	Sid Jenkins	Minkie Spiro	Jamie Brittain	22 lutego 2007

Porada[edytuj kod]

Może się okazać pomocne zawarcie ukrytej wiadomości, która pojawi się w trybie edycji kodu źródłowego artykułu. Umieszczona nad nagłówkami tabeli lub pod sekcją w artykule może wyglądać następująco:

==Odcinki==
<!-- Pomocy proszę szukać pod adresem http://pl.wikipedia.org/wiki/Szablon:Odcinek2 -->
<onlyinclude>
{| class="wikitable plainrowheaders"
...
|}

Ta wiadomość nie będzie widoczna w trybie czytania artykułu, lecz może być pomocna w przypadku trudności z szablonem.

Szablony list odcinków[edytuj kod]

Błędy[edytuj kod]

Błędy należy zgłaszać na stronie Wikipedia:Kawiarenka/Kwestie techniczne.