Lugiak: naimportována 1 revize

2021-05-13T15:35:40Z

naimportována 1 revize

Mykhal: +relevantní kat.

2019-02-10T20:14:16Z

+relevantní kat.

Nová stránka

{{Podstránka s dokumentací}}
Vytváří seznam položek nebo i [[Wikipedie:Průvodce (odkazy)#Vnitřní odkazy|vnitřních odkazů]].
{| class="wikitable"
! kód !! výsledek
|-
| <code><nowiki>{{Seznam|X1|X2|X3|X4|X5|šablona=seznam}}</nowiki></code>
| {{Seznam|X1|X2|X3|X4|X5|šablona=seznam}}
|-
| <code><nowiki>{{Seznam|ns=Šablona|X1|X2|X3|X4|X5|šablona=seznam}}</nowiki></code>
| {{Seznam|ns=Šablona|X1|X2|X3|X4|X5|šablona=seznam}}
|-
| <code><nowiki>{{Seznam|delim=''|X1|X2|X3|X4|X5|šablona=seznam}}</nowiki></code>
| {{Seznam|delim=''|X1|X2|X3|X4|X5|šablona=seznam}}
|-
| <code><nowiki>{{Seznam|nolink=nolink|X1|X2|X3|X4|X5|šablona=seznam}}</nowiki></code>
| {{Seznam|nolink=nolink|X1|X2|X3|X4|X5|šablona=seznam}}
|-
| <code><nowiki>{{Seznam|spojka=, nebo|X1|X2|X3|X4|X5|šablona=seznam}}</nowiki></code>
| {{Seznam|spojka=, nebo|X1|X2|X3|X4|X5|šablona=seznam}}
|-
| <code><nowiki>{{Seznam|nolink=nolink|spojka1=|spojka2=|X1|X2|X3|X4|X5|šablona=seznam}}</nowiki></code>
| {{Seznam|nolink=nolink|spojka1=|spojka2=|X1|X2|X3|X4|X5|šablona=seznam}}
|}

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

== Místa použití ==
Tato šablona najde uplatnění jak v šablonách, tak nejspíše i v článcích, diskusích a dokumentacích.

Příkledy zde uvedené předpokládají prostor šablon: Na ty jsou totiž kladeny přísnější validační požadavky: Například parametr "šablona" není při použití v článku potřeba, zato je požedován, je-li seznam použit jako součást jiné šablony.

== Předaný seznam položek ==
=== Vynechané prvky ===
Šablona ukončí generování při prvním vynechaném prvku:
{| class="wikitable"
! Kód !! Výsledek
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2||Text 4|šablona=jiná šablona}}.xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2||Text 4|šablona=jiná šablona}}.xyz
|}

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

=== Validace prázdného seznamu ===
Alespoň jeden odkaz je požadován <code><nowiki>{{Seznam|šablona=jiná šablona|}}</nowiki></code>: {{Seznam|šablona=jiná šablona|}}

=== Validace příliš dlouhého seznamu ===
Příliš dlouhý seznam je detekován <code><nowiki>{{Seznam|x1|x2|x3|x4|x5|x6|x7|x8|x9|x10|x11|x12|x13|x14|x15|x16|x17|x18|x19|x20|x21|šablona=jiná šablona}}</nowiki></code>:
: {{Seznam|x1|x2|x3|x4|x5|x6|x7|x8|x9|x10|x11|x12|x13|x14|x15|x16|x17|x18|x19|x20|x21|šablona=jiná šablona}}

=== Vstupy do validačních hlášení ===
Jméno šablony zobrazené validačním hlášením '''je nutno''' nastavit <code><nowiki>{{Seznam|šablona=jiná šablona|kategorie=jiná kategorie}}</nowiki></code>:
: {{Seznam|šablona=jiná šablona}}
Protože bez ní se ukáže jiná chyba:
: {{Seznam|a}}
...ale to jen v namespace "šablona", protože ten je detekován. Parametr "šablona" není třeba nastavovat při použití přímo ve stránce/článku.

Lze nastavit i cílovou kategorii, kam se stránka s chybou automaticky přidá:
* pro články parametr "kategorie" s defaultem [[:kategorie:Údržba:Chybná použití seznamu]],
* pro šablony parametr "kat-šablon" s defaultem [[:kategorie:Údržba:Chybná použití seznamu šablonami]].

== Mezery ==
Mezery se zde nestávají součástí předávané hodnoty, protože výsledkem by jinak mohly být [[Nápověda:Neočekávaná odřádkování a mezery#Předávání hodnot přes parametry|nechtěné mezery způsobené předáváním hodnot přes anonymní parametry]].
{| class="wikitable"
! Kód !! Výsledek
|-
|<code><nowiki>abc{{Seznam| Link 1 | Link 2 | Link 3 |šablona=seznam}}xyz</nowiki></code>
|abc{{Seznam| Link 1 | Link 2 | Link 3 |šablona=seznam}}xyz
|-
|<code><nowiki>abc{{Seznam|Link 1|Link 2|Link 3|šablona=seznam}}xyz</nowiki></code>
|abc{{Seznam|Link 1|Link 2|Link 3|šablona=seznam}}xyz
|-
|<code><nowiki>abc{{Seznam|Link 1|Link 2|Link 3|šablona=seznam}}.xyz</nowiki></code>
|abc{{Seznam|Link 1|Link 2|Link 3|šablona=seznam}}.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.

== Spojky ==
Spojka před posledním prvkem je implicitně "a", a to včetně předřazené mezery. Spojku lze změnit parametrem {{para|spojka|}}, ale pak je na wikipedistovi, aby také předřadil mezeru. Za spojku se mezera vkládá už sama, automaticky.
{| class="wikitable"
! kód !! výsledek
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2|Text 3|spojka=&#32;nebo|šablona=seznam}}.xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2|Text 3|spojka= nebo|šablona=seznam}}.xyz
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2|Text 3|spojka=, nebo|šablona=seznam}}.xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2|Text 3|spojka=, nebo|šablona=seznam}}.xyz
..v češtině "vylučovací nebo", [[spojka (slovní druh)|spojka]] [[exkluzivní disjunkce]]
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2|Text 3|spojka=,|šablona=seznam}}.xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2|Text 3|spojka=,|šablona=seznam}}.xyz
|}

Koncovou spojku lze i úplně vypnout, ale to bývá spíše nechtěný stav. Ovšem šablona umí "spojky" nastavovat obecně, pomocí parametrů {{para|spojka1|}} a {{para|spojka2|}}, kde se spojka2 a spojka překrývají. Spojky tedy lze i úplně potlačit:

{| class="wikitable"
! kód !! výsledek
|-
| <code><nowiki>{{Seznam|nolink=nolink|spojka1=|spojka2=|X1|X2|X3|X4|X5|šablona=seznam}}</nowiki></code>
| {{Seznam|nolink=nolink|spojka1=|spojka2=|X1|X2|X3|X4|X5|šablona=seznam}}
|-
| <code>{{případ špatný|<nowiki>{{Seznam|nolink=nolink|spojka=|spojka2=|X1|X2|X3|X4|X5|šablona=seznam}}</nowiki>}}</code>
dvojí použití spojka a spojka2 nemá smysl (přes dva zastiňující se názvy), zjevně má být {{případ správný|{{para|'''spojka1'''|}}}}, a ne jen {{případ špatný|{{para|'''spojka'''|}}}}
| {{Seznam|nolink=nolink|spojka=|spojka2=|X1|X2|X3|X4|X5|šablona=seznam}}
|}

Úmyslné potlačení spojek může mít smysl například pro generování seznamu tagů bez mezer:

{| class="wikitable"
! kód 1 (wiki) !! výsledek 1 = kód 2 (HTML) !! výsledek 2 (zobrazení)
|-
|<code><nowiki>abc{{Seznam|delim=<li>|delim2=</li>|z11|z22|z33|spojka1=|spojka2=|text-pre=<ul>|text-post=</ul>|nolink=nolink|šablona=kotva}}.xyz</nowiki></code>
|abc{{Seznam|delim=<li>|delim2=</li>|z11|z22|z33|spojka1=|spojka2=|text-pre=<ul>|text-post=</ul>|nolink=nolink|šablona=kotva}}.xyz
..kde tagy HTML kódu budou předvedeny až po zobrazení stránky, po ručním příkazu prohlížeči.
|abc<ul><li>z11</li><li>z22</li><li>z33</li></ul>.xyz
|}

== Jmenný prostor ==
Lze zadat také [[Nápověda:Jmenný prostor#Technické podrobnosti|jmenný prostor]] vnitřních odkazů, to pomocí parametru <code>ns</code>. Opět: správnost generovaných linků je na wikipedistovi.
{| class="wikitable"
! Kód !! Výsledek
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2|Text 3|šablona=seznam}}.xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2|Text 3|šablona=seznam}}.xyz, na články
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2|Text 3|ns=|šablona=seznam}}.xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2|Text 3|ns=|šablona=seznam}}.xyz, na články
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2|Text 3|ns=Šablona|šablona=seznam}}.xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2|Text 3|ns=Šablona|šablona=seznam}}.xyz, na šablony
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2|Text 3|ns=Šablona|nolink=nolink|šablona=seznam}}.xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2|Text 3|ns=Šablona|nolink=nolink|šablona=seznam}}.xyz, přebytečný ničemu nevadí
|}

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

== Bez odkazů ==
Šablona umí generovat i seznam textových položek be odkazů: Implicitně se odkazy generují, ovšem přepínačem <code>nolink</code> je lze vypnout.
{| class="wikitable"
! Kód !! Výsledek
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}xyz
|-
|<code><nowiki>abc{{Seznam|Text 1|Text 2|Text 3|nolink=nolink|delim='''|šablona=seznam}}xyz</nowiki></code>
|abc{{Seznam|Text 1|Text 2|Text 3|nolink=nolink|delim='''|šablona=seznam}}xyz
|}

=== Různé ohraničovače ===
Šablona umí obsah "ozávorkovat" rozdílným počátečním a koncovým ohraničovačem u každého prvku:
{| class="wikitable"
! Kód !! Výsledek
|-
|<code>abc<nowiki>{{Seznam|delim=+|delim2=*|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}</nowiki>xyz</code>
|abc{{Seznam|delim=+|delim2=*|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}xyz
|}

Úmyslné použití různých ohraničovačů může mít ve výsledku opět efekt wiki syntaxe:
{| class="wikitable"
! Kód !! Výsledek !! Účinek wiki syntaxe
|-
|<code>abc{{Případ špatný|<nowiki>{{Seznam|delim=*|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}</nowiki>}}xyz</code>
|abc{{Seznam|delim=*|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}xyz
|odrážkový seznam, ovšem pro ukončení se používá stejný znak, zde tedy přebytečný "*"
|-
|<code>abc{{Případ správný|<nowiki>{{Seznam|delim=*|delim2=|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}</nowiki>}}xyz</code>
|abc{{Seznam|delim=*|delim2=|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}xyz
|odrážkový seznam
|-
|<code>abc{{Případ špatný|<nowiki>{{Seznam|delim=''[[|delim2=]]''|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}</nowiki>}}xyz</code>
|abc{{Seznam|delim=''[[delim2=]]''|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}xyz
|sekvence prostých odkazů, ovšem chybná
|-
|<code>abc{{Případ správný|<nowiki>{{Seznam|delim=''&#91;[|delim2=]]''|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}</nowiki>}}xyz</code>
|abc{{Seznam|delim=''[[|delim2=]]''|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}xyz
|kód pro vytvoření seznamu odkazů
|-
|<code>abc{{Případ špatný|<nowiki>{{Seznam|delim2=]]''|delim=''[[|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}</nowiki>}}xyz</code>
|abc{{Seznam|delim2=]]''|delim=''[[|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}xyz
|...kolize při interpretaci
|-
|<code>abc{{Případ správný|<nowiki>{{Seznam|delim=''[<nowiki/>[|delim2=]]''|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}</nowiki>}}xyz</code>
|abc{{Seznam|delim=''[<nowiki/>[|delim2=]]''|Text 1|Text 2|Text 3|nolink=nolink|šablona=seznam}}xyz
|kód pro vytvoření seznamu odkazů
|}

== Texty kolem seznamu ==
Lze nastavit texty kolem seznamu: Je podporováno zadávání textů před a za seznamem, pomocí parametrů <code>text-pre</code> a <code>text-post</code>.
{| class="wikitable"
! Kód !! Výsledek
|-
| <code><nowiki>{{Seznam|šablona=seznam|text-pre=Seznam položek|text-post=konečný.|X1|X2}}</nowiki></code>
| {{Seznam|šablona=seznam|text-pre=Seznam položek|text-post=konečný.|X1|X2}}
|}
Odsazovací mezera je volitelná, tedy musí být součástí předaných textů. Preferevaný způsob vynucování koncových a počátečních mezer je pomocí <code><nowiki /></code>. Buď proto, že se s nimi snáze manipuluje v příkladech, nebo aby wiki-výsledek byl méně závislý na platformě toho-kterého počítače.
{| class="wikitable"
! Kód !! Výsledek
|-
| <code><nowiki>{{Seznam|šablona=seznam|text-pre=Seznam položek&#32;|text-post=&#32;konečný.|X1|X2}}</nowiki></code>
| {{Seznam|šablona=seznam|text-pre=Seznam položek |text-post= konečný.|X1|X2}}
|-
| <code><nowiki>{{Seznam|šablona=seznam|text-pre=Seznam položek <nowiki/>|text-post=<nowiki/> konečný.|X1|X2}}</nowiki></code>
| {{Seznam|šablona=seznam|text-pre=Seznam položek <nowiki/>|text-post=<nowiki/> konečný.|X1|X2}}
|}

=== Formulace pro jednotné a množné číslo ===
Lze nastavit i texty do seznamu: 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ů <code>text-singular</code> a <code>text-plural</code>.
{| class="wikitable"
! Kód !! Výsledek
|-
| <code><nowiki>{{Seznam|šablona=seznam|text-singular=položka|text-plural=položky|X1}}</nowiki></code>
| {{Seznam|šablona=seznam|text-singular=položka|text-plural=položky|X1}}
|-
| <code><nowiki>{{Seznam|šablona=seznam|text-singular=položka|text-plural=položky|X1|X2}}</nowiki></code>
| {{Seznam|šablona=seznam|text-singular=položka|text-plural=položky|X1|X2}}
|-
| <code><nowiki>{{Seznam|šablona=seznam|text-singular=položka&#32;|text-plural=položky&#32;|X1}}</nowiki></code>
| {{Seznam|šablona=seznam|text-singular=položka |text-plural=položky |X1}}
|-
| <code><nowiki>{{Seznam|šablona=seznam|text-singular=položka&#32;|text-plural=položky&#32;|X1|X2}}</nowiki></code>
| {{Seznam|šablona=seznam|text-singular=položka |text-plural=položky |X1|X2}}
|-
| <code><nowiki>{{Seznam|šablona=seznam|text-singular=položka <nowiki/>|text-plural=položky <nowiki/>|X1}}</nowiki></code>
| {{Seznam|šablona=seznam|text-singular=položka <nowiki/>|text-plural=položky <nowiki/>|X1}}
|-
| <code><nowiki>{{Seznam|šablona=seznam|text-singular=položka <nowiki/>|text-plural=položky <nowiki/>|X1|X2}}</nowiki></code>
| {{Seznam|šablona=seznam|text-singular=položka <nowiki/>|text-plural=položky <nowiki/>|X1|X2}}
|}

Aby se prostřední část nemusela opakovat, existuje ješte parametr <code>text-mezi</code>.
{| class="wikitable"
! Kód !! Výsledek
|-
| <code><nowiki>{{Seznam|stacktrace=seznam|text-pre=Kompletní seznam a jeho <nowiki/>|text-singular=položka|text-plural=položky|text-mezi=<nowiki/> s odkazem <nowiki/>|text-post=<nowiki/> vystaven.|X1}}</nowiki></code>
| {{Seznam|stacktrace=seznam|text-pre=Kompletní seznam a jeho <nowiki/>|text-singular=položka|text-plural=položky|text-mezi=<nowiki/> s odkazem <nowiki/>|text-post=<nowiki/> vystaven.|X1}}
|-
| <code><nowiki>{{Seznam|stacktrace=seznam|text-pre=Kompletní seznam a jeho <nowiki/>|text-singular=položka|text-plural=položky|text-mezi=<nowiki/> s odkazem <nowiki/>|text-post=<nowiki/> vystaven.|X1|X2}}</nowiki></code>
| {{Seznam|stacktrace=seznam|text-pre=Kompletní seznam a jeho <nowiki/>|text-singular=položka|text-plural=položky|text-mezi=<nowiki/> s odkazem <nowiki/>|text-post=<nowiki/> vystaven.|X1|X2}}
|}

Pokud texty nejsou nastaveny, nezobrazí se nic, resp. místo každého jen "prázdný [[Textový řetězec|řetězec]]".

<includeonly>
[[Kategorie:Šablony:Vnitřní odkazy]]
[[Kategorie:Šablony:Typografické]]
[[Kategorie:Šablony:Seznamové]]
</includeonly>

← Starší verze	Verze z 13. 5. 2021, 15:35
(Žádný rozdíl)

Šablona:Seznam/doc - Historie editací

Lugiak: naimportována 1 revize

Mykhal: +relevantní kat.