Pomoc:Parametry

Z Wikipedii

Parametry są konstrukcjami wikikodu, możliwymi do stosowania dzięki rozszerzeniu silnika MediaWiki w postaci funkcji parsera, stosowanymi do tworzenia szablonów, szablonów specjalnych, a zwłaszcza infoboksów, czyli de facto wikimakr. Parametrem jest taki element wikikodu, który znajduje się w treści szablonu i występuje po trzech otwierających (lewych) nawiasach klamrowych.

[edytuj] Rodzaje parametrów

[edytuj] Parametry typowe

Ze względu na specyfikację (wywołanie) parametrów można je podzielić na dwa rodzaje, po dwa typy każdy. Podział i nazwy są umowne. Typy te to:

• parametry nienazwane (numeryczne): np. {{{1}}}, {{{2}}}, {{{3}}} etc.
• parametry nazwane: np. {{{nazwa_parametru}}}, {{{miasto w Polsce}}}, {{{WARTOŚĆ}}} etc.

Uwaga 1: parametry w mediawiki są wrażliwe na wielkość liter i tak np. {{{miasto w Polsce}}} oraz {{{miasto w polsce}}} to dwa różne parametry. W parametrach rozróżnialna jest też spacja i podkreślnik, więc {{{miasto w Polsce}}} i {{{miasto_w_Polsce}}} to też dwa różne parametry.

Uwaga 2: Nazwy parametrów bezwzględnie powinny być tworzone z polskimi znakami diakrytycznymi oraz poprawne ortograficznie. A więc nie np. zrodlo, lecz źródło. Najlepiej też zawsze używać _ zamiast spacji.

[edytuj] Parametry nazwane

Powyższe dwa rodzaje różnią się sposobem wywoływania. I tak:

{{Szablon|nazwa parametru=treść|dwa=treść2}}

powoduje wywołanie szablonu o nazwie Szablon, w miejsce parametru o nazwie nazwa parametru podstawiając tekst treść, zaś w miejsce parametru dwa podstawiając tekst treść2. To samo osiągnie się, gdy wywołamy szablon w następujący sposób:

{{Szablon|dwa=treść2|nazwa parametru=treść}}

Tak więc w przypadku tzw. parametrów nazwanych nie ma znaczenia ich kolejność w wywołaniu szablonu.

[edytuj] Parametry nienazwane

Parametry nienazwane (numeryczne) przekazujemy w następujący sposób:

{{Szablon|treść|treść2}}

Uwaga: parametry nienazwane można (a czasami trzeba) przekazywać do szablonu w sposób podobny do parametrów nazwanych, jako nazwę podając ich numery.

Analogiczny efekt do powyższego przykładu uzyskamy dla następujących wywołań:

• numerowanie parametrów:

{{Szablon|1=treść|2=treść2}}

• zmiana kolejności parametrów:

{{Szablon|2=treść2|1=treść}}

• tak też można:

{{Szablon|treść|2=treść2}}
{{Szablon|2=treść2|treść}}

• ale to już są błędne wywołania:

{{Szablon|1=treść|treść2}}
{{Szablon|treść2|1=treść}}

Uwaga: Tak naprawdę parametry numeryczne są parametrami nazwanymi, w których nazwy są numerami. Gdy wszystkie parametry w wywołaniu szablonu są ponazywane, wtedy ich kolejność nie ma znaczenia.

[edytuj] Parametry warunkowe

Drugim rodzajem parametrów są parametry warunkowe. Tworzy się je poprzez dodanie znaku "|" (ang. pipe) przed nawiasami klamrowymi zamykającymi parametr. Ten rodzaj również dzieli się na dwa typy:

• puste, np. {{{1|}}}, {{{nazwa_miasta|}}}, etc.
• wypełnione, np. {{{1|2}}}, {{{nazwa_miasta|Warszawa}}}, {{{2|{{{3}}}}}}, {{{2|{{{miasto|}}}}}}, etc.

Uwaga: W przypadku parametrów warunkowych wypełnionych, po znaku "|" pojawia się tekst. To może być ciąg znaków, liczb, lecz również kolejny parametr (także może być to parametr warunkowy wypełniony), a nawet szablon z innymi lub tymi samymi parametrami.

Wywołanie tego rodzaju parametrów jest analogiczne jak wcześniejszych. Różnią się natomiast efektem końcowym, gdy brak jest wywołania, a więc gdy w wywołaniu szablonu zabraknie danego parametru. Mianowicie, oprogramowanie wiki traktuje parametr pusty, jak by go nie było, natomiast zamiast parametru wypełnionego wstawia tekst znajdujący się po znaku "|".

Uwaga: Nie działa to, gdy wywołanie jest puste. Wymagany jest brak wywołania. A więc {{Szablon|wartość1=}} będzie wyglądało jak wywołanie parametru pustego, nawet gdy parametr wartość1 jest wypełniony. Aby ten sposób działał, należy wywołać szablon bez tego parametru, np. {{Szablon}}, lub {{Szablon|}}.

[edytuj] Przykłady

Przykłady dotyczą hipotetycznego szablonu o nazwie testowy. Szablon ten zawiera treść z kolumny kod szablonu. Wywołanie wygląda jak w kolumnie wywołanie. W kolumnie efekt znajduje się efekt takiego wywołania lub wyjaśnienie, dlaczego kod nie działa.

Miasto '''{{{1}}}'''
ma {{{2}}} mieszkańców.

Miasto '''{{{miasto}}}'''
ma {{{liczba_mieszkańców}}}

Urodził{{{płeć|a}}} się:

Urodził{{{płeć|a}}} się:

Urodził{{{płeć|a}}} się:

Wyrażenie {{{wyrażenie}}}
jest spełnione

Wyrażenie {{{1}}}
jest spełnione

Wyrażenie {{{1}}}
jest spełnione

Urodził{{{płeć|a}}} się:

Miasto {{{Nazwa miasta|}}}:

Miasto {{{Nazwa miasta|}}}:

Miasto {{{Nazwa miasta|}}}
ma {{{mieszkańcy}}} mieszkańców:

[edytuj] Zobacz też

• Pomoc:Funkcje parsera

[edytuj] Linki zewnętrzne

• (en) m:Help:Parameter_default
• (en) m:Help:Help:Substitution