Šablona:Šablona/doc: Porovnání verzí
(Založena nová stránka: {{Podstránka s dokumentací}} <!-- KATEGORIE a INTERWIKI prosím přidejte až na spodek této stránky --> Vkládání přímého odkazu na [[N...) |
Bez shrnutí editace |
||
Řádek 35: | Řádek 35: | ||
| {{Šablona |Podrobně | článek_1 {{!}} článek_2 {{!}} článek_3}} | | {{Šablona |Podrobně | článek_1 {{!}} článek_2 {{!}} článek_3}} | ||
|- | |- | ||
! kód předváděný dokumentací nebo v diskusi,<br />nutné [[escapování]] | ! 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 }} | * {{šablona |Šablona |Podrobně {{!}} článek_1 {{šablona|!}} článek_2 {{šablona|!}} článek_3 }} |
Verze z 14. 5. 2016, 21:22
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í}}
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í {{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}}
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 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é w:cs:escapování |
použitím nahrazovací šablony
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 |
použitím nahrazovacích šablon
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 |
použitím dvojitého číslování a nahrazovací šablony
použitím SGML 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 dokonce selfreference |
dvojitým číslováním a šablonami
entitami |