Šablona:Povinný parametr/doc

Toto je dokumentační podstránka šablony Šablona:Povinný parametr

Obsahuje návod k použití, kategorie a další obsah, který není součástí samotné šablony.

Tato šablona je velmi často použita (případně i dalšími šablonami).

Každá změna se tak projeví na mnoha místech. Editujte ji s maximální obezřetností, jen pokud víte jistě, co děláte. Pokud úprava způsobí nečekané následky, urychleně ji vraťte. Veškeré experimenty byste měli raději provádět na pískovišti nebo ve svém uživatelském prostoru.

Šablona slouží jako základ vnořování "stacktrace" při validacích a hlášeních chyb.

Autokategorizuje

• šablony používající tuto šablonu do Kategorie:Šablony:Validující a hlásící chyby.
• šablony s chybou pak dále do kategorie:Údržba:Šablony volající šablony bez povinných a také do kategorie:Údržba:Šablony s chybným voláním šablon, tedy defaultní cílové kategorie šablony {{chyba}},
• články s chybou do kategorie:Údržba:Chybná volání bez povinných, to pomocí šablony {{chyba}}.

Namespace se při kategorizaci skutečně rozlišuje.

Hodnota nepojmenovaně:

{{Povinný parametr|{{{stáří|{{{věk|}}}}}}|parametr=věk|šablona={{{šablona|{{subst:PAGENAME}}}}}}}

{{Povinný parametr|{{{stáří|{{{věk|}}}}}}|parametr=věk|šablona=příkladová}}

Hodnota pojmenovaně:

{{Povinný parametr|hodnota={{{stáří|{{{věk|}}}}}}|parametr=věk|šablona={{{šablona|{{subst:PAGENAME}}}}}}}

{{Povinný parametr|hodnota={{{stáří|{{{věk|}}}}}}|parametr=věk|šablona=příkladová}}

Výsledkem je v optimálním případě "nic": Není potřeba cokoli hlásit a čímkoli wikipedstu obtěžovat.

Celkem tu jsou 3 vstupy: 2 klíčové předpoklady do hlášení a konečně sama hodnota k ověření, že do povinného vstupu validované šablony bylo něco zadáno.

Při použití tedy nezapomeňte předat:

• šablona - název editované šablony, kam se teď editujete a zavádíte validaci. Zádává se jako textová konstanta, řetězec: název editované šablony lze vyplnit buď ručně, nebo pomocí {{{šablona|{{subst:PAGENAME}}}}} při vkládání této šablony.
• param - název parametru, který je v editované šabloně povinný. Zádává se ručně jako textová konstanta, řetězec: vstup. Ten samozřejmě má být stejný, jako skutečně používané parametry, aby uživatel šablony nebyl zmaten a aby se mu v hlášeních podával pravdivý název parametru.
• hodnota - nepojmenovaný vstup 1 - předejte hodnotu právě tím parametrem editované šablony, jaký jste uvedli jako hodnotu do názvu parametru: {{{vstup|}}}, případně i se všemi jeho synonymními voláními {{{parametr|{{{vstup|}}}}}}

Účelem této šablony je systematičnost: Jsou jednak provedena samotná ověření/testy, dále také standardizována chybová hlášení.

{{Povinný parametr|<!-- nic nezadáno -->|parametr=věk|šablona=příkladová}}

{{Povinný parametr||parametr=věk|šablona=příkladová}}

{{Povinný parametr|parametr=věk|šablona=příkladová}}

Šablona „příkladová“ požaduje hodnotu v parametru „věk“, ta ale chybí!

{{Povinný parametr|{{{stáří|{{{věk|}}}}}}|parametr=|šablona=příkladová}}

{{Povinný parametr|{{{stáří|{{{věk|}}}}}}|šablona=příkladová}}

Šablona „příkladová“ požaduje název validovaného parametru, ten ale chybí! Pro nepojmenovaný parametr zadejte jeho číslo.

{{Povinný parametr|{{{stáří|{{{věk|}}}}}}|parametr=|šablona=}}

Šablona „“ požaduje název validovaného parametru, ten ale chybí! Pro nepojmenovaný parametr zadejte jeho číslo. Šablona pro stacktrace požaduje stacktrace nebo název šablony: „|stacktrace={{{stacktrace|}}}>editovaná šablona“ nebo alespoň „|šablona=editovaná šablona“. Ani jeden z těchto parametrů však nebyl obdržen!

{{Povinný parametr|{{{stáří|{{{věk|}}}}}}}}

Šablona „“ požaduje název validovaného parametru, ten ale chybí! Pro nepojmenovaný parametr zadejte jeho číslo. Šablona pro stacktrace požaduje stacktrace nebo název šablony: „|stacktrace={{{stacktrace|}}}>editovaná šablona“ nebo alespoň „|šablona=editovaná šablona“. Ani jeden z těchto parametrů však nebyl obdržen!

{{Povinný parametr|<!-- nic nezadáno -->|parametr=věk|šablona=}}

{{Povinný parametr||parametr=věk|šablona=}}

{{Povinný parametr|parametr=věk|}}

Šablona „“ požaduje hodnotu v parametru „věk“, ta ale chybí! Šablona pro stacktrace požaduje stacktrace nebo název šablony: „|stacktrace={{{stacktrace|}}}>editovaná šablona“ nebo alespoň „|šablona=editovaná šablona“. Ani jeden z těchto parametrů však nebyl obdržen!

{{Povinný parametr|{{{stáří|{{{věk|}}}}}}|parametr=věk|šablona=}}

{{Povinný parametr|{{{stáří|{{{věk|}}}}}}|parametr=věk}}

Šablona „“ požaduje hodnotu v parametru „věk“, ta ale chybí! Šablona pro stacktrace požaduje stacktrace nebo název šablony: „|stacktrace={{{stacktrace|}}}>editovaná šablona“ nebo alespoň „|šablona=editovaná šablona“. Ani jeden z těchto parametrů však nebyl obdržen!

• {{Povinný stacktrace}}