Tato stránka je zamčena pro neregistrované a nové uživatele

Šablona:Šablona

Z Wikipedie, otevřené encyklopedie
Skočit na: Navigace, Hledání

{{Šablona}}

Template-info.svg Dokumentace   [Zobrazit] [Editovat] [Historie stránky] [vyprázdnit paměť]

Vkládání přímého odkazu na š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í}}{{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ého 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): {{šablona|vítejte|subst}}{{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}}{{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}}{{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
Podrobnější informace naleznete v článcích článek_1 , článek_2 a článek_3.
požadovaný výsledek do dokumentace nebo 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í
  • {{Šablona |Podrobně | článek_1 {{!}} článek_2 {{!}} článek_3}}

použitím nahrazovací šablony {{!}} (znak |)

  • {{Šablona |Podrobně | článek_1 | článek_2 | článek_3}}

použitím SGML 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 dokonce selfreference
  • {{tl |Šablona |Podrobně {{!}} článek_1 {{tl|!}} článek_2 {{tl|!}} článek_3}}

použitím nahrazovacích šablon {{!}} (znak |), {{Šablona}} a pomocí jejího přesměrování {{tl}}

  • {{tl |Šablona |Podrobně | článek_1 | článek_2 | článek_3}}

použitím SGML entit | (znak |) a jejich konstrukcí pomocí & (&)

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: článek_1 {{!}} článek_2 {{!}} článek_3

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ů!

požadovaný výsledek
do dokumentace nebo diskuse
pro copy&paste z psaného textu,
jako usnadnění ostatním
  • {{Podrobně|2=druhý=článek_2|1=první=článek_1}}

použitím dvojitého číslování a nahrazovací šablony {{!}} (znak |)

  • {{Podrobně|2=druhý=článek_2|1=první=článek_1}}

použitím SGML entit | (znak |)

kód předváděný
dokumentací nebo v diskusi,
nutné escapování
  • {{Šablona|Podrobně|2=2=druhý=článek_2{{!}}1=první=článek_1}}

použitím dvojitého číslování, {{!}} a pomocí popisné nahrazovací šablony {{Šablona}}

  • {{Šablona|Podrobně|2=druhý=článek_2|1=první=článek_1}}

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 dokonce selfreference
  • {{tl|Šablona|2=Podrobně{{!}}2=2=druhý=článek_2{{Šablona|!}}1=první=článek_1}}

dvojitým číslováním a šablonami

  • {{tl|Šablona|Podrobně|2=druhý=článek_2|1=první=článek_1}}

entitami

Související šablony

Vytvoří zformátovaný odkaz na šablonu.

Parametry šablony

Tato šablona upřednostňuje parametry formátované v jediném řádku.

Parametr Popis Typ Stav
Substuje se? subst2

Pokud se šablona používá se subst:, vložte subst (viz [[Nápověda:Substituce]]).

Výchozí hodnota
prázdné
Příklad
subst
Automatická hodnota
subst
Řetězec nepovinný
Název šablony šablona1

prázdné

Výchozí hodnota
prázdné
Příklad
prázdné
Automatická hodnota
prázdné
Řetězec povinný
Parametr param3

Použitý parametr

Výchozí hodnota
prázdné
Příklad
prázdné
Automatická hodnota
Řetězec nepovinný