Szablon:Cytuj

 Dokumentacja szablonu [zobacz] [edytuj] [historia] [odśwież]

Ten szablon używa języka skryptowego Lua. Wywołuje Moduł:Cytuj.

Ten szablon jest używany na 290 000 stronach. Aby uniknąć nadmiernego obciążenia serwera, wszystkie eksperymenty należy przeprowadzać w swoim brudnopisie. Przetestowane zmiany powinny być dodawane w jednej edycji. Proszę przedyskutować każdą zmianę przed jej wprowadzaniem. Osoba dokonująca zmian w tym szablonie powinna być przygotowana do naprawienia niepożądanych efektów ubocznych swoich działań.

Użycie[edytuj kod]

Uniwersalny szablon cytowania źródeł. Jest to mocno uproszczona wersja standardowych szablonów cytowania: {{Cytuj książkę}}, {{Cytuj pismo}} i {{Cytuj stronę}}. Dzięki integracji zapewnia spójny wygląd wszystkich przypisów i pozycji bibliograficznych.

Autorzy[edytuj kod]

Wszystkie pola, w których przekazywany jest autor podlegają analizie, dzięki której automatycznie znajdowane są imiona i nazwiska, a imiona są skracane. Do sterowania analizą służą znaki specjalne. Zobacz też przykłady na Szablon:Cytuj/test#Autorzy.

Jeśli autorów jest nie więcej niż trzech to w ich nazwach można stosować wikizację np. „…|… = [[Jan Kowalski]] |…”. Jeśli jest ich więcej to wikizacja ma sens jedynie dla pierwszego, gdyż jedynie pierwszy autor jest jawnie prezentowany. Pełna lista jest dostępna w dymku z podpowiedzią stowarzyszonym ze słowami „i inni” dodawanym bezpośrednio po pierwszym autorze. Prezentacja tych danych zależy od używanej przeglądarki.

Uwaga

Użycie średnika jest praktycznie obowiązkowe jeśli jedyny autor ma dwuwyrazowe nazwisko. Przykłady poprawnie obsługiwanych wywołań to „[[Ignace de La Potterie|La Potterie, Ignace de]];” lub „Del Soldato, Eva;”.

Powyższa analiza jest ograniczana do kilkuset pierwszych bajtów treści pola.

Istnieją trzy pola autor, redaktor i autor r, dla których następujące kombinacje w ramach jednego wywołania są poprawne:

Linki zewnętrzne[edytuj kod]

Za generowanie linków zewnętrznych odpowiadają dwa pola url i archiwum. Stowarzyszone z nimi są odpowiednio data dostępu i zarchiwizowano. Zasady poprawnego zapisu odwołania do źródeł dostępnych w sieci wymagają aby zawsze podawać datę dostępu do informacji. Istnieją serwisy internetowe, które w swoim adresie zawierają datę archiwizacji i pełen adres oryginalnego źródła. Pozwala to na uproszczenie wypełniania parametrów szablonu zgodnie z poniższą tabelą.

Adres przekazywany do url jest domyślne podłączany pod tytuł lub czasopismo, jeśli tytułu nie podano. Gdyby takie zachowanie było nieprawidłowe to należy z pola zrezygnować i zastosować standardowy zapis tworzenia linków zewnętrznych bezpośrednio w odpowiednim polu.

Patent[edytuj kod]

Cytowanie opisów patentowych umożliwia pole patent, w którym podaje się identyfikator patentu lub zgłoszenia patentowego. Nadaje ono specyficzne znaczenie następującym polom:

Identyfikator patentu lub zgłoszenia musi przyjąć jedną z następujących form:

Narzędzia cytowania[edytuj kod]

Zestawienie narzędzi ułatwiających wstawianie szablonów cytowania znajduje się na stronie Wikipedia:Narzędzia cytowania.

Przykłady[edytuj kod]

książka – podstawowe użycie

* {{Cytuj |autor = [[Roman Murawski]] |tytuł = Filozofia matematyki |wydawca = [[Wydawnictwo Naukowe PWN]] |miejsce = Warszawa |rozdział = całka |data = 2001 |isbn = 8301136049 |s = 12–15}}

• całka, [w:] RomanR. Murawski RomanR., Filozofia matematyki, Warszawa: Wydawnictwo Naukowe PWN, 2001, s. 12–15, ISBN 83-01-13604-9 .

książka – trzech autorów, tytuł z wikilinkiem, wydanie

* {{Cytuj |autor = [[Joe Bloggs]]; John Smith; Jim Smythe |tytuł = [[Tysiąc akrów|1000 akrów]] |wydanie = 2 |data = 1922 |wydawca = Gebethner i Wolff |s = 103}}

• JoeJ. Bloggs JoeJ., JohnJ. Smith JohnJ., JimJ. Smythe JimJ., 1000 akrów, wyd. 2, Gebethner i Wolff, 1922, s. 103 .

czasopismo naukowe

* {{Cytuj |autor = Benoit Viollet, Fabrizio Andreelli, Sebastian B. Jørgensen, Christophe Perrin, Alain Geloen, Daisy Flamez, James Mu, Claudia Lenzner, Olivier Baud, Myriam Bennoun, Emmanuel Gomas, Gaël Nicolas, Jørgen F.P. Wojtaszewski, Axel Kahn, David Carling, Frans C. Schuit, Morris J. Birnbaum, Erik A. Richter, Rémy Burcelin, Sophie Vaulont |tytuł = The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity |data = 2003 |czasopismo = The Journal of Clinical Investigation |doi = 10.1172/JCI16567 |wolumin = 111 |numer = 1 |pmid = 12511592 |pmc = 151837 |s = 91–98}}

• BenoitB. Viollet BenoitB. i inni, The AMP-activated protein kinase α2 catalytic subunit controls whole-body insulin sensitivity, „The Journal of Clinical Investigation”, 111 (1), 2003, s. 91–98, DOI: 10.1172/JCI16567, PMID: 12511592, PMCID: PMC151837 .

strona WWW

* {{Cytuj |url = https://wyborcza.pl/7,75400,24963690,dajmy-lasom-posadzic-sie-samym.html |autor = [[Adam Wajrak]] |tytuł = Dajmy lasom posadzić się samym |opublikowany = Wyborcza.pl |data = 2019-07-05 |data dostępu = 2022-01-24}}

• AdamA. Wajrak AdamA., Dajmy lasom posadzić się samym [online], Wyborcza.pl, 5 lipca 2019 [dostęp 2022-01-24] .

zarchiwizowana strona WWW

z widoczną w URL-u informacją o archiwizacji:

* {{Cytuj |archiwum = https://web.archive.org/web/20190809220934/https://wyborcza.pl/7,75400,24963690,dajmy-lasom-posadzic-sie-samym.html |autor = [[Adam Wajrak]] |tytuł = Dajmy lasom posadzić się samym |opublikowany = Wyborcza.pl |data = 2019-07-05}}

• AdamA. Wajrak AdamA., Dajmy lasom posadzić się samym, Wyborcza.pl, 5 lipca 2019 [zarchiwizowane 2019-08-09] .

bez danych o archiwizacji w URL-u:

* {{Cytuj | url = http://wyborcza.pl/1,75475,13748049,Milion_widzow_obejrzalo__Drogowke_.html| autor = *Redakcja Kulturalna | tytuł = Milion widzów obejrzało „Drogówkę” | data = 2013-04-16 | opublikowany = Wyborcza.pl | archiwum = http://archive.is/gupyt |zarchiwizowano= 2013-09-20}}

Redakcja Kulturalna, Milion widzów obejrzało „Drogówkę” [online], Wyborcza.pl, 16 kwietnia 2013 [zarchiwizowane z adresu 2013-09-20] .

Szablony[edytuj kod]

Gotowe zestawy do skopiowania i wypełnienia:

• cytowanie książki

  {{Cytuj |autor = |tytuł = |wydanie = |miejsce = |wydawca = |data = |opis = |s = |isbn = }}

  {{Cytuj |autor r = |rozdział = |redaktor = |tytuł = |wydanie = |miejsce = |wydawca = |data = |opis = |s = |isbn = }}

• cytowanie artykułu z czasopisma

  {{Cytuj |autor = |tytuł = |czasopismo = |odpowiedzialność = |wolumin = |numer = |miejsce = |wydawca = |data = |s = |issn = }}

• cytowanie strony internetowej

  {{Cytuj |autor = |url = |tytuł = |praca = |opublikowany = |data = |data dostępu = 2024-04-16}}

Należy pamiętać o usunięciu niewykorzystanych pól.

Błędy i komunikaty[edytuj kod]

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

Szablon w wyniku analizy i przetwarzana parametrów dodaje na końcu wyniku kategorie i komunikaty informujące o błędach lub o sposobie działania.

Brakujące pola: nazwy pól. Nieprawidłowe pola: nazw pól. Nieznane pola: nazwy pól. Przestarzałe pola: nazwy pól. Gołe linki: nazwy pól.

Standardowe sprawdzanie wartości parametrów z użyciem {{#invoke:Sprawdź|Parametry}}. Należy również pilnować zasady, że nie podaje się pustych pól.

 Kategoria:Szablon cytuj do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 13 elementów)

Tylko tytuł.

Wykrywanie wywołań szablonu tylko z jednym niepustym polem tytuł.

 Kategoria:Szablon cytuj do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 13 elementów)

???

Nie udało się zidentyfikować typu cytowanego źródła. Dobór przekazanych parametrów sugeruje najczęściej cytowanie strony internetowej z książką lub czasopismem.

 Kategoria:Szablon cytowania bez określonego trybu (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 2924 elementów)

p?

Podano jednocześnie pola opublikowany i wydawca. To pierwsze nie jest w takim przypadku wyświetlane.

 Kategoria:Szablon cytowania zawiera pola 'opublikowany' i 'wydawca' (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 0 elementów)

j?

Podano dwa pola czasopismo i opublikowany o identycznej treści.

 Kategoria:Szablon cytuj do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 13 elementów)

!!!

Analiza pola z listą autorów sygnalizuje problem z ich odróżnianiem stosując przecinek jako separator

 Kategoria:Szablon cytuj do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 13 elementów)

a?

Szablony cytujące czasopisma, które mają podany identyfikator pmid mogą zawierać i często zawierają listę autorów w formacie przypominającym zapis na stronach PMID.

 Kategoria:Szablon cytowania zastosował alternatywną metodę analizy pola z opisem autora (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 81 elementów)

wiki?

Istnieje podejrzenie, że cytowane źródło może wskazywać na Wikipedię.

 Kategoria:Szablon cytowania wskazuje na Wikipedię (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 16 elementów)

dostęp?

Akceptowane wartości w polu dostęp są zdefiniowane w Moduł:Cytuj/dostęp.

 Kategoria:Szablon cytuj do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 13 elementów)

url

Początek adresu w polu url sugeruje, że jest to link, który może być wygenerowany z użyciem jakiegoś pola obsługującego identyfikator publikacji.

 Kategoria:Szablon cytuj do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 13 elementów)

Url

W szablonie znajduje się niepuste pole url lecz jego wartość nie została użyta. Prawdopodobnie pole z tytułem zawiera już inny link.

 Kategoria:Szablon cytuj do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 13 elementów)

1 stycznia

Daty podane w formacie RRRR-01-01 zostały uznane za bardzo częsty błąd generowany przez Citoid, który daty roczne wzbogaca o dzień 1 stycznia. Są one automatycznie zamieniane na RRRR. Jeśli data 1 stycznia RRRR ma być faktycznie umieszczona w szablonie to należy zastosować dowolny alternatywny jej zapis.

Ta informacja nie dodaje żadnej kategorii

data?, data dostępu?, zarchiwizowano?

Nieprawidłowa lub nierozpoznana data. W przypadku stron internetowych lub szablonów pochodnych, na przykład linkujących do zewnętrznych baz danych, może to być również brak dziennej daty dostępu.

 Kategoria:Szablon cytuj do sprawdzenia (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 13 elementów)

i inni

W polu z listą autorów znaleziono treść i inni lub jej synonim. Szablon nie narzuca żadnych ograniczeń na liczbę osób, więc najlepiej zawsze wymieniać wszystkich.

 Kategoria:Szablon cytowania nie zawiera wszystkich autorów (edytuj • dysk. • historia • linkujące • obserwuj • rejestr • 364 elementów)

Istnieje też możliwość wskazania, że szablon zmienił nazwę czasopisma z wykorzystaniem modułu Moduł:Cytuj/czasopisma. W tym celu należy dopisać w swoim CSS następujący kod:

.citation.c:after {
	color: [kolor];
	font-weight: bold; [linia opcjonalna]
	content: " [wyświetlany tekst komunikatu]";
}

Przykład:

.citation.c:after {
	color: magenta;
	font-weight: bold; 
	content: " c ?";
}

daje dopisek „ c?”.

Parametry szablonu (strukturyzacja VE)[edytuj kod]

Uwaga! Część aliasów zawiera wersję z innych języków i nie powinno się ich używać. Np. aliasy w języku angielskim ułatwiają tłumaczenie z Angielskiej Wikipedii. Niezależnie od tego zawsze lepiej jest używać form podstawowych, nie aliasów.

Dostosowywanie[edytuj kod]

Ostateczny wynik działania szablonu zawiera niektóre fragmenty opakowane w znaczniki <span>. W zależności od zawartości mają one przypisany atrybut klasy, który może być wykorzystany w CSS do dostosowania wyglądu według własnych upodobań. Lista dostępnych klas jest następująca:

Kategorie techniczne generowane przez szablon[edytuj kod]

• Kategoria:Szablon cytowania w trybie 'cytuj książkę' bez obowiązkowych parametrów (0)
• Kategoria:Szablon cytowania w trybie 'cytuj pismo' bez obowiązkowych parametrów (0)
• Kategoria:Szablon cytowania w trybie 'cytuj stronę' bez obowiązkowych parametrów (0)
• Kategoria:Szablon cytowania bez określonego trybu (2924)
• Kategoria:Szablon cytowania zawiera pola 'opublikowany' i 'wydawca' (0)
• Kategoria:Szablon cytowania zastosował alternatywną metodę analizy pola z opisem autora (81)
• Kategoria:Szablon cytowania zamienił nazwę czasopisma (8615)
• Kategoria:Szablon cytowania wskazuje na Wikipedię (16)
• Kategoria:Szablon cytowania nie zawiera wszystkich autorów (364)
• Kategoria:Szablon cytowania używa pól opisowych (7553)
• Kategoria:Uniwersalny szablon cytowania – brak strony (52 579)

Zobacz też[edytuj kod]

• Wikipedia:Bibliografia
• Kategoria:Szablony informujące o problemach z uźródłowieniem

Linki zewnętrzne[edytuj kod]

• Narzędzie do konwersji szablonów cytowania z angielskiego (Beau, malarz pl).
• Generator przypisów z ISBN, ISSN, DOI, PMID, PMCID, url, … (malarz pl) na bazie narzędzia citoid.
• Generator przypisów do książek z Polony (Witia).