Moduł:Sprawdź/opis

Ten moduł zapewnia platformę programistyczną dla tworzenia szablonów budujących przypadki testowe szablonów Wikipedii. 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

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

Parametry

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
• txt – oczekiwana jest dowolna niepusta wartość pola
• text – oczekiwana jest dowolna niepusta wartość pola, która nie generuje obrazka
• text? – oczekiwana jest wartość pola, która nie generuje obrazka
• 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 ^...$

Modyfikator	Brak parametru np. {{formatprice}}	Pusty parametr np. {{formatprice|1=}}	Niepusty parametr np. {{formatprice|123}}
?	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

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