Editace stránky Šablona:Šablona/doc

Skočit na navigaci Skočit na vyhledávání
Varování: Nejste přihlášen(a). Pokud uložíte jakoukoli editaci, vaše IP adresa bude zveřejněna v historii této stránky. Pokud se přihlásíte nebo si vytvoříte účet, vaše editace budou připsány vašemu uživatelskému jménu a získáte i další výhody.

Editace může být zrušena. Prosím, zkontrolujte porovnání níže, abyste se ujistili, že to chcete provést, a poté pro dokončení zrušení editace níže zobrazené změny zveřejněte.

Aktuální verze Váš text
Řádek 1: Řádek 1:
Viz [[w:cs:Šablona:Šablona/doc]]
{{Podstránka s dokumentací}}
<!--
    KATEGORIE a INTERWIKI prosím přidejte až na spodek této stránky
-->
Vkládání přímého [[Nápověda:Odkazy|odkaz]]u na [[Nápověda:šablony|šablony]], navíc v podobě jako v kódu: {{Šablona|Šablona}}
 
== Účel ==
Vhodné používat na začátku dokumentací šablon, aby se výsledný text dal rychle a snadno překopírovat: Usnadní se tím praktické použití té dokumentované šablony do kódu.
 
== Použití  ==
Potřebujete-li v textu diskuse nebo dokumentace zmínit nějakou šablonu zároveň s přímým odkazem na ní, můžete ho zapsat právě pomocí této šablony a jejího prvního parametru: <code><nowiki>{{Šablona|Rozcestník}}</nowiki></code>. Výsledkem je přímý odkaz ve tvaru {{Šablona|Rozcestník}}.
 
Šablona testuje, zda cílová šablona skutečně existuje, a nevytváří červené odkazy: <code><nowiki>{{šablona|zaručeně neeexistující}}</nowiki></code> dá {{šablona|zaručeně neexistující}}.
 
=== Přesměrování ===
Protože se šablona nepoužívá v hlavním prostoru wikipedie, v článcích (není proč), běžně se používá její zkrácené volaní {{šablona|tl}}, z anglického ''[[:en:template:tl|template link]]'': odkaz na šablonu.
 
== Druhý parametr ==
=== subst ===
V případě použití druhého parametru "subst" se na úvod textu vypíše povel "subst:" (sloužící při skutečném zadání a uložení k náhradě volání šablony ve zdrojovém kódu stránky jejím aktuálním obsahem): <code><nowiki>{{šablona|vítejte|subst}}</nowiki></code> dá {{šablona|vítejte|subst}}.
 
Následně se zjistí přítomnost třetího parametru a ten se případně použije k zobrazení parametrů substované šablony: <code><nowiki>{{Šablona|Vítejte|subst|a}}</nowiki></code> dá {{Šablona|Vítejte|subst|a}}.
 
=== Vstup do popisované šablony ===
Je-li druhý parametr jiná hodnota než "subst", uvažuje se tato jako první parametr popisované šablony a tak se i zobrazí: <code><nowiki>{{šablona|smazat|blábol}}</nowiki></code> dá {{šablona|smazat|blábol}}.
 
==== Ukázka vícera parametrů popisované šablony ====
Pro předvedení předávání šabloně vícera parametrů, než jen jediného, se tohoto zobrazení dosáhne nepřímo, vložením pomocné šablony {{šablona|!}} do textu předávané šablony:
 
{| class="wikitable"
! příklad wiki-výsledku v článku
| {{Podrobně | článek_1 | článek_2 | článek_3}}
|-
! požadovaný výsledek do [[šablona:dokumentace|dokumentace]] nebo diskuse<br />pro copy&paste z psaného textu, jako usnadnění ostatním
| {{Šablona |Podrobně | článek_1 {{!}} článek_2 {{!}} článek_3}}
|-
! kód předváděný dokumentací nebo v diskusi,<br />nutné [[w:cs:escapování]]
|
* {{šablona |Šablona |Podrobně {{!}} článek_1 {{šablona|!}} článek_2 {{šablona|!}} článek_3 }}
použitím  nahrazovací šablony {{Šablona|!}} (znak |)
* {{šablona |Šablona |Podrobně &#124; článek_1 &amp;#124; článek_2 &amp;#124; článek_3}}
použitím [[HTML entita|SGML entit]] &amp;#124; (znak &#124;)
|-
! ještě zdrojovější vrstva kódu<br />pro vytvoření kódu k vložení do dokumentace,<br />složitější, protože zde dokonce [[autoreference|selfreference]]
|
* {{šablona|tl |Šablona {{!}}Podrobně {{tl|!}} článek_1 {{šablona|tl|!}} článek_2 {{šablona|tl|!}} článek_3 }}
použitím nahrazovacích šablon {{Šablona|!}} (znak |), {{Šablona|Šablona}} a pomocí jejího přesměrování {{Šablona|tl}}
* {{šablona|tl |Šablona &#124;Podrobně &amp;#124; článek_1 &amp;amp;#124; článek_2 &amp;amp;#124; článek_3 }}
použitím [[HTML entita|SGML entit]] &amp;#124; (znak &#124;) a jejich konstrukcí pomocí &amp;amp; (&amp;)
|}
 
Všechny parametry předávané ''popisované šabloně'' se tedy popíší ''popisnou šablonou'' Šablona, té se ''všechny popisované hodnoty'' předají skrze popisný ''druhý parametr'', jako text, tedy jako ''jedna hodnota'': <code>článek_1 {{šablona|!}} článek_2 {{šablona|!}} článek_3</code>
 
==== Předvádění pojmenovaných parametrů ====
Zápis pojmenovaných parametrů podle čísel sice je možný (je-li tak šablona naprogramovaná, aby používala obojí), ale je třeba mít na paměti, že s postupujícím rozkódováváním do příkladů se také mění relativní pozice těchto parametrů!
 
{| class="wikitable"
! požadovaný výsledek<br />do [[šablona:dokumentace|dokumentace]] nebo diskuse<br />pro copy&paste z psaného textu,<br />jako usnadnění ostatním
|
* {{Šablona|Podrobně|2=2=druhý=článek_2{{!}}1=první=článek_1}}
použitím dvojitého číslování a nahrazovací šablony {{Šablona|!}} (znak |)
* {{Šablona|Podrobně|2&#61;druhý&#61;článek_2{{!}}1&#61;první&#61;článek_1}}
použitím [[HTML entita|SGML entit]] &amp;#124; (znak &#124;)
 
|-<!-- doc a zdrojaky jeho prikladu jsou zapsane spravne, ale WP interpret wiki inerpretuje znacky "code" nespravne!
Spatne zpracovani:
* <nowiki><code>x<code>y</code>z</code></nowiki>
interpretuje jako
* <nowiki><code>x (code-ignorovan) y</code>z (/code-ignorovan)</nowiki>
Takze je neinterpretuje jako vnorene XML tagy, ale spis jako "HTML komentare" (podle prvniho vyskytu). Pritom to ale ''jsou'' XML tagy!
 
Reseni A, uplne:
Opravit wiki-interpret
 
Reseni B, docasne:
upravit sablonu {Sablona}, aby neobklopovala tagem "code", ale radeji "span" s nastavenym attr style (jako ma tag code, CSS class code?).
...to uz nez se interpret opravi a klidne i pak: Stejne jde jen o stylovani, tak se s tim wiki-stroj nemusi zatezovat
-->
! kód předváděný<br />dokumentací nebo v diskusi,<br />nutné [[w:cs:escapování]]
|
* {{tl|Šablona|2=Podrobně{{!}}2=2=druhý=článek_2{{Šablona|!}}1=první=článek_1}}
použitím dvojitého číslování, {{Šablona|!}} a pomocí popisné nahrazovací šablony {{Šablona|Šablona}}
* {{tl|Šablona|Podrobně&#124;2&amp;#61;druhý&amp;#61;článek_2&amp;#124;1&amp;#61;první&amp;#61;článek_1}}
použitím entit &amp;#61; (&#61;) a &amp;#124; (&#124;) a jejich konstrukcí pomocí &amp;amp; (&amp;)
|-
! ještě zdrojovější vrstva kódu<br />pro vytvoření kódu k vložení do dokumentace,<br />složitější, protože zde dokonce [[autoreference|selfreference]]
|
* {{šablona|tl|2=Šablona{{!}}2=Podrobně{{tl|!}}2=2=druhý=článek_2{{šablona|Šablona|!}}1=první=článek_1}}
dvojitým číslováním a šablonami
* {{šablona|tl|Šablona{{!}}Podrobně&amp;#124;2&amp;amp;#61;druhý&amp;amp;#61;článek_2&amp;amp;#124;1&amp;amp;#61;první&amp;amp;#61;článek_1}}
entitami
|}
 
<includeonly><!-- KATEGORIE a INTERWIKI zde, děkujeme -->
{{DEFAULTSORT:{{PAGENAME}}}}
[[Kategorie:Šablony Wikipedie]]
[[Kategorie:Šablony užívající ParserFunctions]]
Všechny příspěvky do Enviwiki jsou zveřejňovány podle licencí Creative Commons Uveďte autora – Zachovejte licenci 3.0 Unported (podrobnosti najdete na Enviwiki:Autorské právo). Pokud si nepřejete, aby váš text byl nemilosrdně upravován a volně šířen, pak ho do Enviwiki neukládejte.
Uložením příspěvku se zavazujete, že je vaším dílem nebo je zkopírován ze zdrojů, které nejsou chráněny autorským právem (tzv. public domain). NEVKLÁDEJTE DÍLA CHRÁNĚNÁ AUTORSKÝM PRÁVEM BEZ DOVOLENÍ!
Storno Pomoc při editování (otevře se v novém okně)
Náhled stránky s touto šablonou