Admin: Obsah stránky nahrazen textem „Viz w:cs:Šablona:Chyba/doc“

2016-05-14T11:41:37Z

Obsah stránky nahrazen textem „Viz w:cs:Šablona:Chyba/doc“

Admin v 14. 5. 2016, 10:46

2016-05-14T10:46:59Z

← Starší verze		Verze z 14. 5. 2016, 12:46
Řádek 36:		Řádek 36:

	=== Skrytý popis chyby ===		=== Skrytý popis chyby ===
	Kromě chybových hlášení, které může být v různých článcích různé, podle textu zadaného při volání, lze chybové hlášení stále dohledat i ve výsledném [[HyperText Markup Language\|HTML]] kódu článku: Popis chyby je jen pomocí [[Kaskádové styly\|CSS]] vlastnosti <code>display: none;</code> sice vyloučen ze zobrazování, ovšem text zadaný do šablony {{šablona\|chyba}} bude v kódu přítomen.		Kromě chybových hlášení, které může být v různých článcích různé, podle textu zadaného při volání, lze chybové hlášení stále dohledat i ve výsledném [[w:cs:HyperText Markup Language\|HTML]] kódu článku: Popis chyby je jen pomocí [[Kaskádové styly\|CSS]] vlastnosti <code>display: none;</code> sice vyloučen ze zobrazování, ovšem text zadaný do šablony {{šablona\|chyba}} bude v kódu přítomen.

	Ovšem jakmile se tento schovávací mechanismus použije a skutečně dojde na prohledávání HTML, samotné hlášení "Chyba!" stále nijak nepomůže k rozpoznání problému! Je '''na zodpovědnosti''' wikipedisty, autora šablony, který skrývá chybová hlášení, aby do textu zahrnul i odkaz na šablonu, ve které chyba nastala!		Ovšem jakmile se tento schovávací mechanismus použije a skutečně dojde na prohledávání HTML, samotné hlášení "Chyba!" stále nijak nepomůže k rozpoznání problému! Je '''na zodpovědnosti''' wikipedisty, autora šablony, který skrývá chybová hlášení, aby do textu zahrnul i odkaz na šablonu, ve které chyba nastala!

Admin v 14. 5. 2016, 08:06

2016-05-14T08:06:22Z

← Starší verze		Verze z 14. 5. 2016, 10:06
Řádek 124:		Řádek 124:
	\| {{#iferror: <span class="error">chyba dovnitř</span> \| {{chyba\|chyba ven}} \| O.K. }}		\| {{#iferror: <span class="error">chyba dovnitř</span> \| {{chyba\|chyba ven}} \| O.K. }}
	\|}		\|}
	Pomocí takového mechanismu se lze přiblížit [[ExceptionHandling]]u jako má třeba [[Objektově orientované programování\|objektové programování]]: Pak lze chybová hlášení používat na způsob třetí hodnoty [[tříhodnotová logika\|tříhodnotové logiky]], vedla klasických "ano" a "ne".		Pomocí takového mechanismu se lze přiblížit [[ExceptionHandling]]u jako má třeba [[Objektově orientované programování\|objektové programování]]: Pak lze chybová hlášení používat na způsob třetí hodnoty [[w:cs:tříhodnotová logika\|tříhodnotové logiky]], vedla klasických "ano" a "ne".

	=== Praktické použití tříhodnotové logiky ===		=== Praktické použití tříhodnotové logiky ===

Admin v 3. 5. 2016, 09:40

2016-05-03T09:40:54Z

← Starší verze		Verze z 3. 5. 2016, 11:40
Řádek 156:		Řádek 156:
	<includeonly>		<includeonly>
	<!-- Přidávejte KATEGORIE a INTERWIKI, prosíme, pod tento řádek -->		<!-- Přidávejte KATEGORIE a INTERWIKI, prosíme, pod tento řádek -->
	[[Kategorie:~~Pomocné šablony~~\|{{PAGENAME}}]]		[[Kategorie:Šablony pomocné\|{{PAGENAME}}]]

	</includeonly>		</includeonly>

Jiří Dlouhý: Založena nová stránka: {{Podstránka s dokumentací}} {{šablona|chyba}} == Účel == Tato šablona slouží pro označení povinných parametrů volaných šablon a pro validaci vstupních hodn...

2011-03-05T07:14:53Z

Založena nová stránka: {{Podstránka s dokumentací}} {{šablona|chyba}} == Účel == Tato šablona slouží pro označení povinných parametrů volaných šablon a pro validaci vstupních hodn...

Nová stránka

{{Podstránka s dokumentací}}
{{šablona|chyba}}

== Účel ==
Tato šablona slouží pro označení povinných parametrů volaných šablon a pro validaci vstupních hodnot.

Účelem šablony je:
* ošetření chyb při volání šablon,
* určení jejich důvodu a
* určení jejich původu, pro umožnění snadného nalezení místa jejich projevu ve výsledném článku.
Pro dosažení těchto účelů působí šablona tyto účinky:
* přidání článku z hlavního prostoru wikipedie do chybové kategorie a
* označení místa chyby, kdekoli, nejen ve článcích hlavního prostoru.

== Použití ==
V textu chybového hlášení se mají objevit tyto informace:
* odkaz na šablonu, která chybová hlášení generuje, ideálně pomocí <code><nowiki>{{Šablona|Chybu generující šablona}}</nowiki></code>
* popis chyby,
** především tedy přímo název chybějícho parametru: <code>hodnota parametru "NutnýVstup" chybí, ačkoli je požadována!</code>
** nebo s ukázkou hodnoty mimo rozsah: <code>hodnota "{{{NutnýVstup}}}" parametru "NutnýVstup" nebyla rozpoznána!</code>

Při editaci šablon a jejich rozšiřování o chybová hlášení se ujistěte, že nevzniknou žádná [[Nápověda:Neočekávaná odřádkování a mezery|nechtěná odřádkování]].

=== Příklady možných hlášení ===
==== Vůbec nezadáno ====
<code><nowiki>{{Chyba|Šablona {{Šablona|Chybu generující šablona}} požaduje pro parametr "NutnýVstup" zadat nějakou hodnotu!}}</nowiki></code>
{{Chyba|Šablona {{Šablona|Chybu generující šablona}} požaduje pro parametr "NutnýVstup" zadat nějakou hodonotu!}}

==== Zadáno mimo definiční rozsah ====
<code><nowiki>{{Chyba|Šablona {{Šablona|Chybu generující šablona}} hodnotu "{{{1}}}" zadanou do parametru "NutnýVstup" nerozeznala!}}</nowiki></code>
{{Chyba|Šablona {{Šablona|Chybu generující šablona}} hodnotu "{{{1}}}" zadanou do parametru "NutnýVstup" nerozeznala!}}

== Účinky ==
=== Zařazení do kategorie ===
Šablona typicky plní '''[[:Kategorie:Chybná volání šablon|kategorii Chybná volání šablon]]''' (přednastavená cílová kategorie), do ní ovšem vkládá pouze články z hlavního [[Nápověda:Jmenný prostor|jmenného prostoru]]. (To například pro odstínění stránek [[:Šablona:Dokumentace|dokumentací]].) Plnění zařizuje šablona {{šablona|Kategorie}}.

=== Skrytý popis chyby ===
Kromě chybových hlášení, které může být v různých článcích různé, podle textu zadaného při volání, lze chybové hlášení stále dohledat i ve výsledném [[HyperText Markup Language|HTML]] kódu článku: Popis chyby je jen pomocí [[Kaskádové styly|CSS]] vlastnosti <code>display: none;</code> sice vyloučen ze zobrazování, ovšem text zadaný do šablony {{šablona|chyba}} bude v kódu přítomen.

Ovšem jakmile se tento schovávací mechanismus použije a skutečně dojde na prohledávání HTML, samotné hlášení "Chyba!" stále nijak nepomůže k rozpoznání problému! Je '''na zodpovědnosti''' wikipedisty, autora šablony, který skrývá chybová hlášení, aby do textu zahrnul i odkaz na šablonu, ve které chyba nastala!
* Použijte text, jako by se měl čtenářům ukázovat, aby objasňoval potíž.
* Do textu zahrňte i odkaz na šablonu samotnou.
Příklad:
<pre>{{chyba|Šablona {{Šablona|Dohledatelná}} selhala, ikdyž má všechny parametry, protože to tak zrovna chci!}}</pre>
Vygenerovaný výsledek:
{{chyba|Šablona {{Šablona|Dohledatelná}} selhala, ikdyž má všechny parametry, protože to tak zrovna chci!}}

=== Stylování chyby ve zdrojovém kódu stránky ===
Chybová hlášení jsou stylována podle této definice CSS třídy, konkrétně ze souboru <code>/common/shared.css</code>:
<pre>.error {
color: red;
font-size: larger;
}</pre>

== Příklady použití ==
{| class="wikitable"
|-
! Kód
! Výsledek
! [[Kaskádové styly|CSS]] styl
|-
| {{šablona|Chyba}}
| {{Chyba}}
|
|-
| {{šablona|Chyba|}}
| {{Chyba|}}
|
|-
| {{šablona|Chyba|popis chyby}}
| {{Chyba|popis chyby}}
|
|-
| {{šablona|Chyba|<nowiki>popis chyby|kategorie=Jiná cílová kategorie</nowiki>}}
| {{Chyba|popis chyby}}
|
|-
| {{šablona|Chyba|<nowiki>popis chyby|skrytý=skrytý</nowiki>}}
| {{Chyba|popis chyby|skrytý=skrytý}}
| <code>display: none;</code>
|-
| {{šablona|Chyba|<nowiki>popis chyby|skrytý=</nowiki>}}
| {{Chyba|popis chyby|skrytý=}}
| <code>display: none;</code>
|}

== Parametry ==
Šablonu lze zavolat i bez parametrů: Implicitní hlášení pak je {{Chyba}}.
* <code><nowiki>{{{1}}}</nowiki></code> - nepojmenovaný volitelný (ale doporučený) parametr (první): Hodnotou je hlášení o chybě, text ke zobrazení.
* <code>skrytý</code> - volitelný parametr, text popisu chyby bude skryt, ale stále obsažen v HTML kódu výsledného článku (hledejte <code>title="Chyba v použití šablony!" class="error"</code>). Je-li tento parametr použit, žádné hlášení se čtenáři nezobrazí: Takové chování je vhodné například pro ošetření zastaralých parametrů používaných šablon, aby se všechna volání s takovými parametry mohla postupně opravit/nahradit. Na hodnotě parametru nezáleží, nepoužívá se, stačí i jen jeho přítomnost.
* <code>kategorie</code> - volitelný parametr, cílová kategorie, do které se má článek s chybou zařadit.

== Skrytý popis ==
V situacích, kdy sice je cílem varovat o chybném použití šablony, ovšem bez nevzhledného porušení obsahu příliš dlouhým hlášením, lze použít vnořené skryté hálšení:
<code><nowiki>abc{{Chyba|Chybný vstup!{{Chyba|skrytý=skrytý|Šablona {{Šablona|Chybu generující šablona}} hodnotu "{{{1}}}"zadanou do parametru "NutnýVstup" nerozeznala!}}}}xyz</nowiki></code>
abc{{Chyba|Chybný vstup!{{Chyba|skrytý=skrytý|Šablona {{Šablona|Chybu generující šablona}} hodnotu "{{{1}}}" zadanou do parametru "NutnýVstup" nerozeznala!}}}}xyz

Z příkladu je vidět, že se čtenáři v článcích zobrazí pouze minimalistická verze popisu chyby. Naproti tomu wikipedisté vědí, že takové články jsou kategorizovány a že i v samotném článku, v jeho zdrojovém [[HyperText Markup Language|HTML]] kódu, je podrobný popis chyby uveden a k dohledání.

Předané chyby lze takto detekovat ikdyž jsou generovány skrytě, parametrem "skrytý".

== Použití chyb ==
Kromě použití této šablony jako nápovědy při volání šablon a jako nástroje pro kategorizaci a následnou údržby Wikipedie lze chyby také detekovat v šablonách a reagovat na ně. Klíčová je zde CSS třída <code>class="error"</code>: Na tu totiž reaguje interní funkce <code>{{#iferror:</code>, šablona tedy má možnost detekovat chybu předanou z jiné šablony a reagovat na ní.<ref>{{en}}[http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions#.23iferror iferror, Help:Extension:ParserFunctions], Wiki Help na commons, mediawiki.org</ref> Na základě detekované chyby lze větvit další činnost: Buď vygenerovat vlastní chybu, anebo tuto předanou naopak ošetřit. Takové vnitřně detekované chyby jsou pak pouze dočasné hodnoty během zpracovávání šablony, do výsledku a do samotného článku se vůbec nemusí zahrnout: Záleží jen na wikipedistovi a jeho šabloně.

{| class="wikitable"
|-
! Kód
! Výsledek
|-
| <code><nowiki>{{#iferror: {{#expr: a+1}} | error | O.K. }}</nowiki></code>
| {{#iferror: {{#expr: a+1}} | error | O.K. }}
|-
| <code><nowiki>{{#iferror: {{Vnitřně Volaná Šablona Možná Generující I Chybová Hlášení}} | error | O.K. }}</nowiki></code>
| {{#iferror: {{Vnitřně Volaná Šablona Možná Generující I Chybová Hlášení}} | error | O.K. }}
|-
| <code><nowiki>{{#iferror: {{Chyba|chyba dovnitř}} | error | O.K. }}</nowiki></code>
| {{#iferror: {{Chyba|chyba dovnitř}} | error | O.K. }}
|-
| <code><nowiki>{{#iferror: a | error | O.K. }}</nowiki></code>
| {{#iferror: a | error | O.K. }}
|-
| <code><nowiki>{{#iferror: chyba dovnitř | {{chyba|chyba ven}} | O.K. }}</nowiki></code>
| {{#iferror: chyba dovnitř | {{chyba|chyba ven}} | O.K. }}
|}
Pomocí takového mechanismu se lze přiblížit [[ExceptionHandling]]u jako má třeba [[Objektově orientované programování|objektové programování]]: Pak lze chybová hlášení používat na způsob třetí hodnoty [[tříhodnotová logika|tříhodnotové logiky]], vedla klasických "ano" a "ne".

=== Praktické použití tříhodnotové logiky ===
Prostý příklad testování chyby předané z vnořené šablony: Nejdříve volána pro test chyby, pak znovu už pro hodnotu samotnou.
<pre><nowiki>{{#iferror: {{IsInt|{{{num|}}}}}
| {{chyba|Hodnota "num" není číslo!}}
| {{IsInt|{{{num|}}}}}
}}</nowiki></pre>

Komplexnější možné (už programátorsky překomplikované) testování chyby z volané vnořené šablony, navíc i s původním chybovým hlášením:
<pre><nowiki>{{#iferror: {{IsInt|{{{num|}}}}}
| {{chyba|Šablona {{Šablona|Tento příklad}} detekovala, že hodnota v parametru "num" není číslo!
{{chyba|skrytý=skrytý|{{IsInt|{{{num|}}}}} }}
}}
| {{IsInt|{{{num|}}}}}
}}</nowiki></pre>

== Odkazy ==
=== Reference ===
<references/>

=== Související články ===
* [[w:Exception (programování)]]
* [[w:Kategorie:Validace volání šablon]]

=== Externí odkazy ===
* [http://bits.wikimedia.org/skins-1.5/common/shared.css?283-16 shared.css], bits.wikimedia.org, zdroj definice třídy "error"

<includeonly>

[[Kategorie:Pomocné šablony|{{PAGENAME}}]]

</includeonly>

Šablona:Chyba/doc - Historie editací

Admin: Obsah stránky nahrazen textem „Viz w:cs:Šablona:Chyba/doc“

Admin v 14. 5. 2016, 10:46

Admin v 14. 5. 2016, 08:06

Admin v 3. 5. 2016, 09:40

Jiří Dlouhý: Založena nová stránka: {{Podstránka s dokumentací}} {{šablona|chyba}} == Účel == Tato šablona slouží pro označení povinných parametrů volaných šablon a pro validaci vstupních hodn...