Przejdź do zawartości

Moduł:Sprawdź/opis

Z Wikibooks, biblioteki wolnych podręczników.

Ten moduł zapewnia platformę programistyczną dla tworzenia szablonów budujących przypadki testowe szablonów Wikibooks'a. Przypadki testowe mogą być tworzone ręcznie, aczkolwiek te tworzone za pomocą szablonów opartych na module Lua, takim jak niniejszy moduł, mają taką zaletę, że argumenty szablonu muszą być wprowadzone jedynie jednokrotnie, co zmniejsza nakład pracy konieczny do tworzenia testów, a także zmniejsza ryzyko występowania błędów w danych wejściowych.

Porównaj

[edytuj]

Ta funkcja jest obecnie wykorzystywana przez szablon {{Przypadek testowy}}.

Parametry

[edytuj]

Funkcja do wykrywania wywołań szablonów z nierozpoznanymi, pustymi lub przestarzałymi parametrami. Należy ją wywołać ze wszystkimi możliwymi parametrami, jakie przyjmuje szablon podlegający sprawdzaniu.

Opis parametrów
pole status uwagi
bez nazwy konfiguracja działania wymagany klasa lub klasa odstęp suffix
inny deklaracja pola obsługiwanego w szablonie opcjonalny txt, num, num?, uri, uri?, old, ^…$ lub pusty
Konfiguracja
  • klasa – ciąg znaków bez spacji umieszczany jako wartość atrybutu class w tagu <span> z wygenerowanym raportem
  • odstęp – ciąg znaków odstępu oddzielający pozostałą treść konfiguracji, jeśli zawiera znak nowej linii to przed wygenerowanym raportem jest również umieszczany znak nowej linii
  • suffix – treść dołączana po wygenerowanym raporcie, zwykle deklaracja technicznej kategorii
Sprawdzanie parametrów
  • pusty – parametr jest opcjonalny, jest to najczęściej stosowany sposób użycia, obecnie domyślnie zezwala na treść bez obrazków i linków zewnętrznych
  • all – (poprzednio txt) oczekiwana jest dowolna niepusta wartość pola
  • text – oczekiwana jest dowolna niepusta wartość pola, która nie generuje obrazka ani linku zewnętrznego
  • text? – oczekiwana jest wartość pola, która nie generuje obrazka ani linku zewnętrznego
  • text-link – oczekiwana jest dowolna niepusta wartość pola, która nie generuje obrazka
  • text-link? – oczekiwana jest wartość pola, która nie generuje obrazka
  • text-img – oczekiwana jest dowolna niepusta wartość pola, która nie generuje linku zewnętrznego
  • text-img? – oczekiwana jest wartość pola, która nie generuje linku zewnętrznego
  • num – sprawdzanie, czy przekazana wartość jest liczbą
  • num? – sprawdzanie, czy przekazana wartość jest pusta lub jest liczbą
  • uri – sprawdzanie, czy przekazana wartość jest linkiem obsługiwanym przez MediaWiki
  • uri? – sprawdzanie, czy przekazana wartość jest pusta lub jest linkiem
  • grafika – sprawdzanie, czy przekazana wartość jest nazwą pliku graficznego
  • grafika? – sprawdzanie, czy przekazana wartość jest pusta lub jest nazwą pliku graficznego
  • old – informuje, że przekazywany parametr jest przestarzały
  • ^…$ – tekst rozpoczynający się znakiem ^ i zakończony na $ w całości traktowany jest jako wyrażenie regularne Lua wskazującego prawidłowy parametr
Tabela poprawności dla num i ^...$[uwaga 1]
Modyfikator Brak parametru

np. {{Przykładowy szablon}}

Pusty parametr

np. {{Przykładowy szablon|1=}}

Niepusty parametr

np. {{Przykładowy szablon|123}}

?[uwaga 2] poprawne poprawne wg testu
bez mod. poprawne wg testu wg testu
! Brakujące pola: ... wg testu wg testu
Przykład
{{#invoke:Sprawdź|Parametry|=problemy-w-szablonie [[Kategoria:Błędy wywołań w szablonie]]|parametr_w_szablonie_1=|parametr_w_szablonie_2=num?}}

odn

[edytuj]

Funkcja sprawdzająca prawidłowość parametrów w {{odn}}.

Uwagi

[edytuj]
  1. Sprawdzone tylko dla testów num i ^...$. Pozostałe testy mogą nie mieć wszystkich modyfikatorów albo mogą zachowywać się inaczej.
  2. ^...$? nie jest obsługiwane, użyto {{#if:{{{1|}}}|^...$}}