Šablona:Seznam/doc

Z AppleWikipedia
Verze z 4. 1. 2014, 04:16, kterou vytvořil Admin (diskuse | příspěvky) (Založena nová stránka s textem „{{Podstránka s dokumentací}}<!-- KATEGORIE, prosíme, přidejte až na spodek této stránky --> Vytváří seznam položek nebo i Wikipedie:Průvodce …“)

(rozdíl) ← Starší verze | zobrazit aktuální verzi (rozdíl) | Novější verze → (rozdíl)
Přejít na: navigace, hledání

Vytváří seznam položek nebo i vnitřních odkazů.

Kód Výsledek
{{Seznam|X1|X2|X3|X4|X5}} X1, X2, X3, X4 a X5
{{Seznam|ns=Šablona|X1|X2|X3|X4|X5}} X1, X2, X3, X4 a X5
{{Seznam|delim=''|X1|X2|X3|X4|X5}} X1, X2, X3, X4 a X5
{{Seznam|nolink=nolink|X1|X2|X3|X4|X5}} X1, X2, X3, X4 a X5
{{Seznam|spojka=, nebo|X1|X2|X3|X4|X5}} X1, X2, X3, X4, nebo X5

Maximálně 20 položek v souvislé řadě.

Předaný seznam položek[editovat]

Vynechané prvky[editovat]

Šablona ukončí generování při prvním vynechaném prvku:

Kód Výsledek
abc{{Seznam|Text 1|Text 2||Text 4}}.xyz abcText 1 a Text 2
.xyz

Nespojitost předaného seznamu není detekována: Další položky za vynechanou jsou ignorovány.

Validace prázdného seznamu[editovat]

Alespoň jeden odkaz je požadován {{Seznam|}}: Šablona {{Seznam}} potřebuje neprázdný spojitý seznam vstupů!

Validace příliš dlouhého seznamu[editovat]

Příliš dlouhý seznam je detekován {{Seznam|x1|x2|x3|x4|x5|x6|x7|x8|x9|x10|x11|x12|x13|x14|x15|x16|x17|x18|x19|x20|x21}}:

x1, x2, x3, x4, x5, x6, x7, x8, x9, x10, x11, x12, x13, x14, x15, x16, x17, x18, x19 a x20
Příliš dlouhý seznam vstupů: Šablona {{Seznam}} podporuje nanejvýš 20 položek v souvislé řadě!

Vstupy do validačních hlášení[editovat]

Jméno šablony zobrazené validačním hlášením je nutno nastavit {{Seznam|šablona=jiná šablona|kategorie=jiná kategorie}}:

Šablona {{jiná šablona}} potřebuje neprázdný spojitý seznam vstupů!

Lze nastavit i cílovou kategorii, kam se stránka s chybou automaticky přidá.

Mezery[editovat]

Mezery se zde nestávají součástí předávané hodnoty, protože výsledkem by jinak mohly být nechtěné mezery způsobené předáváním hodnot přes anonymní parametry.

Kód Výsledek
abc{{Seznam| Link 1 | Link 2 | Link 3 }}xyz abcLink 1, Link 2 a Link 3
xyz
abc{{Seznam|Link 1|Link 2|Link 3}}xyz abcLink 1, Link 2 a Link 3
xyz
abc{{Seznam|Link 1|Link 2|Link 3}}.xyz abcLink 1, Link 2 a Link 3
.xyz - s tečkou za větou

Protahování platnosti odkazu i na další slovo, jak to má systém Wikipedie ve zvyku, ukončí interpunkční znaménko, například tečka za větou.

Spojka[editovat]

Spojka před posledním prvkem je implicitně "a", a to včetně předřazené mezery. Spojku lze ji změnit parametrem spojka, ale pak je na wikipedistovi, aby také předřadil mezeru. Za spojku se mezera vkládá už sama.

Kód Výsledek
abc{{Seznam|Text 1|Text 2|Text 3|spojka=&#32;nebo}}.xyz abcText 1, Text 2 nebo Text 3
.xyz
abc{{Seznam|Text 1|Text 2|Text 3|spojka=, nebo}}.xyz abcText 1, Text 2, nebo Text 3
.xyz, "vylučovací nebo", spojka exkluzivní disjunkce
abc{{Seznam|Text 1|Text 2|Text 3|spojka=,}}.xyz abcText 1, Text 2, Text 3
.xyz
abc{{Seznam|Text 1|Text 2|Text 3|spojka=}}.xyz abcText 1, Text 2Text 3
.xyz

Spojku lze i úplně vypnout, ale to je spíše nechtěný stav.

Jmenný prostor[editovat]

Lze zadat také jmenný prostor vnitřních odkazů, to pomocí parametru ns. Opět: správnost generovaných linků je na wikipedistovi.

Kód Výsledek
abc{{Seznam|Text 1|Text 2|Text 3}}.xyz abcText 1, Text 2 a Text 3
.xyz, na články
abc{{Seznam|Text 1|Text 2|Text 3|ns=}}.xyz abcText 1, Text 2 a Text 3
.xyz, na články
abc{{Seznam|Text 1|Text 2|Text 3|ns=Šablona}}.xyz abcText 1, Text 2 a Text 3
.xyz, na šablony
abc{{Seznam|Text 1|Text 2|Text 3|ns=Šablona|nolink=nolink}}.xyz abcText 1, Text 2 a Text 3
.xyz, přebytečný ničemu nevadí

Šablona vytváří správné odkazy i do jiných jmenných prostorů než jen do hlavního prostoru článků, jejich namespace však neukazuje, pouze název stránky samotné.

Bez odkazů[editovat]

Šablona umí generovat i seznam textových položek be odkazů: Implicitně se odkazy generují, ovšem přepínačem nolink je lze vypnout.

Kód Výsledek
abc{{Seznam|Text 1|Text 2|Text 3|nolink=nolink}}xyz abcText 1, Text 2 a Text 3
xyz
abc{{Seznam|Text 1|Text 2|Text 3|nolink=nolink|delim='''}}xyz abcText 1, Text 2 a Text 3
xyz

Různé ohraničovače[editovat]

Šablona umí rozdílným počátečním a koncovým ohraničovačem u každého prvku:

Kód Výsledek
abc{{Seznam|delim=+|delim2=*|Text 1|Text 2|Text 3|nolink=nolink}}xyz abc+Text 1*, +Text 2* a +Text 3*
xyz

Úmyslné použití různých ohraničovačů může mít ve výsledku opět efekt wiki syntaxe:

Kód Výsledek Účinek wiki syntaxe
abc{{Seznam|delim=*|Text 1|Text 2|Text 3|nolink=nolink}}xyz abc
  • Text 1*,
  • Text 2* a
  • Text 3*
    xyz
odrážkový seznam, ovšem pro ukončení se používá stejný znak, zde tedy přebytečný "*"
abc{{Seznam|delim=*|delim2=|Text 1|Text 2|Text 3|nolink=nolink}}xyz abc
  • Text 1,
  • Text 2 a
  • Text 3
    xyz
odrážkový seznam
abc{{Seznam|delim=''[[|delim2=]]''|Text 1|Text 2|Text 3|nolink=nolink}}xyz abcdelim2=Text 1delim2=, delim2=Text 2delim2= a delim2=Text 3delim2=
xyz
sekvence prostých odkazů, ovšem chybná
abc{{Seznam|delim=''&#91;[|delim2=]]''|Text 1|Text 2|Text 3|nolink=nolink}}xyz abc[[Text 1]], [[Text 2]] a [[Text 3]]
xyz
kód pro vytvoření seznamu odkazů
abc{{Seznam|delim2=]]''|delim=''[[|Text 1|Text 2|Text 3|nolink=nolink}}xyz delim2=]]|delim=[[|Text 1|Text 2|Text 3|nolink=nolink}}xyz ...kolize při interpretaci
abc{{Seznam|delim=''[<nowiki></nowiki>[|delim2=]]''|Text 1|Text 2|Text 3|nolink=nolink}}xyz abc[[Text 1]], [[Text 2]] a [[Text 3]]
xyz
kód pro vytvoření seznamu odkazů

Formulace pro jednotné a množné číslo[editovat]

Je podporováno řízení úvodního textu před seznamem podle počtu položek seznamu: Lze ke zobrazení zadat dvě verze podobného textu, pomocí parametrů text-singular a text-plural.

Kód Výsledek
{{Seznam|text-singular=položka|text-plural=položky|X1}} položkaX1
{{Seznam|text-singular=položka|text-plural=položky|X1|X2}} položkyX1 a X2

Odsazovací mezera je volitelná, tedy musí být součástí předaných textů:

Kód Výsledek
{{Seznam|text-singular=položka&#32;|text-plural=položky&#32;|X1}} položka X1
{{Seznam|text-singular=položka&#32;|text-plural=položky&#32;|X1|X2}} položky X1 a X2

Pokud texty nejsou nastaveny, nezobrazí se nic, resp. "prázdný řetězec".

Související šablony pro seznamy[editovat]

  • {{převést na seznam}} - šablona pro označení šablon s obsahem ala seznam, bude označená jako "k předělání na článek se seznamem"
  • {{převést seznam na kategorii}} - šablona pro označení článku ala seznam, bude označený jako "k předělání na kategorii"
    • {{vytvořit podkategorie podle zemí}}
  • {{seznam}} - seznam položek jako vstup do šablony, různé seznamy s různými typy výstupů
  • {{šablony}} - seznam šablon jako vstup do šablony
  • {{seznam šablon}} a {{šablona položka}} - pro popis Wikipedie