Šablona:Šablona
{{Šablona}}
Vkládání příméhoodkazunašablony,navíc v podobě jako v kódu:{{Š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:{{Šablona|Rozcestník}}
.Výsledkem je přímý odkaz ve tvaru{{Rozcestník}}
.
Šablona testuje, zda cílová šablona skutečně existuje, a nevytváří červené odkazy:{{šablona|zaručeně neeexistující}}
dá{{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í{{š}}
,případně{{tl}}
,z anglickéhotemplate 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):{{šablona|vítejte|subst}}
dá{{subst:vítejte}}
.
Následně se zjistí přítomnost třetího parametru a ten se případně použije k zobrazení parametrů substované šablony:{{Šablona|Vítejte|subst|a}}
dá{{subst:Vítejte|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í:{{šablona|smazat|blábol}}
dá{{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{{!}}
do textu předávané šablony:
příklad wiki-výsledku v článku | |
---|---|
požadovaný výsledek dodokumentacenebo diskuse pro copy&paste z psaného textu, jako usnadnění ostatním |
{{Podrobně| článek_1 | článek_2 | článek_3}}
|
kód předváděný dokumentací nebo v diskusi, nutnéescapování |
použitím nahrazovací šablony
použitímSGML entit| (znak |) |
ještě zdrojovější vrstva kódu pro vytvoření kódu k vložení do dokumentace, složitější, protože zde dokonceselfreference |
použitím nahrazovacích šablon
použitímSGML entit| (znak |) a jejich konstrukcí pomocí & (&) |
Všechny parametry předávanépopisované šabloněse tedy popíšípopisnou šablonouŠablona, té sevšechny popisované hodnotypředají skrze popisnýdruhý parametr,jako text, tedy jakojedna hodnota:článek_1
{{!}}
článek_2{{!}}
článek_3
Předvádění číslovaných parametrů jako pojmenovaných
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ů!
výsledek v textu článku či dokumentace, uživatelský cíl: po všech wiki-strojových interpretacích |
Podrobnější informace naleznete na stránkáchprvní=článek_1adruhý=článek_2.
|
---|---|
požadovaný výsledek dodokumentacenebo diskuse pro copy&paste z psaného textu, jako usnadnění ostatním |
použitím dvojitého číslování a nahrazovací šablony
použitímSGML entit| (znak |) |
kód předváděný dokumentací nebo v diskusi, nutnéescapování |
použitím dvojitého číslování,
použitím entit = (=) a | (|) a jejich konstrukcí pomocí & (&) |
ještě zdrojovější vrstva kódu pro vytvoření kódu k vložení do dokumentace, složitější, protože zde dokonceselfreference |
dvojitým číslováním a šablonami
entitami |
V předávané textové hodnotě"2=2=druhý=článek_2{{šablona|Šablona|!}}1=první=článek_1"
se první levé rovnítko interpretuje jako přiřazení, vewiki-syntaxi,další rovnítka už jsou jen "obyčejné znaky v textu". Tedy v tomto kroku interpretace: V příštím kroku zpracování (text-kód na text, který i nadále bude vystupovat v roli kódu), v dalším kole interpretování příkladu výše, se stane syntakticky významným druhé "první rovnítko zleva". První takové bylo prve požráno při interpretaci:2=
.Původní textový "vstup do parametru" se tedy zkrátil a dokonce rozpadl na dva ještě menší vstupy, do dvou jiných parametrů:2=druhý=článek_2
+{{Šablona|!}}
+1=první=článek_1
.Takový text, potřebuje-li zdokumentovat složitý případ, si wikipedista musí postavit (zkomplikovat) sám, zpětnými úvahami o funkcích wiki interpreterů a šablon.
Potlačení formátování
- Výchozí formátování
<code>
,zobrazování výsledku neproporcionálním písmem a v rámečku, lze potlačit: Kód s potlačeným formátováním{{šablona|vítejte|nocode=nocode}}
dá {{vítejte}}, místo{{vítejte}}
bez potlačení formátování.
Související šablony
- Výstup šablony– uvádí přímý výstup šablony
- Tag– předvádí HTML (resp. XML) značku
- Para– předvádí zápis parametru šablony s případnou hodnotou při konkrétním použití
- Param– předvádí samotný kód parametru šablony, případně i jemu přednastavenou defaultní hodnotu
Data šablony
Tato sekce obsahuje strukturovaný popis parametrů této šablony využívající rozšířeníTemplateData,který umožňuje snadnější používání této šablony v prostředíVizuálního editoru.
Šablona
Vytvoří zformátovaný odkaz na šablonu.
Parametr | Popis | Typ | Stav | |
---|---|---|---|---|
Název šablony | 1 šablona | prázdné | Šablona | povinný |
Substuje se? | 2 subst | Pokud se šablona používá se subst:, vložte subst (viz [[Nápověda:Substituce]]).
| Logická hodnota | nepovinný |
Parametr | 3 param | Použitý parametr | Řetězec | nepovinný |
nocode | nocode | Vypne vnitřní obalování do <code><code></code>, pro použití v příkladech šablon, kde je již takto obalováno,<br />stačí pouhá přítomnost jakékoli hodnoty
| Řetězec | nepovinný |