Šablona:Hlavní článek/doc: Porovnání verzí

VizuálníWikitext

Verze z 14. 5. 2016, 21:45

Toto je dokumentační podstránka šablony Šablona:Hlavní článek

Obsahuje návod k použití, kategorie a další obsah, který není součástí samotné šablony.

Použití

Šablona se používá v úvodu kategorie pro odkázání na hlavní článek, který pojednává o tématu dané kategorie.

{{Hlavní článek|Název článku}}

Lze použít i odkazy na více článků, technicky maximální počet je dvacet.

Poznámka: Časté je také využití šablony pro odkaz na podrobnější článek pod nadpisem oddílu článku, k tomuto účelu je však určená šablona {{Podrobně}}.

Příklady použití

Kód	Výsledek
`{{Hlavní článek\|A}}`	Hlavní článek: A
`{{Hlavní článek\|A\|B\|C}}`	Hlavní články: A, B a C

Nesprávné použití

Pokud odkazujete uvnitř článku (nikoli kategorie):

pro článek zabývající se podrobně tématem daného oddílu (sekce) použijte {{Podrobně}}
pro článek zabývající se souvisejícím tématem použijte {{Viz též}}

Pokud chcete odkázat na související kategorii:

vložte do kategorie odkaz pomocí šablony {{Související kategorie}}

Parametry

1 .. 5 - cíle linků, nepojmenované parametry. Cíl 1 je jediný povinný parametr. I proto je v příkladu použit default. U těchto parametrů se předpokládá jejich souvislý sled. Cíl uvádět bez namespace: Ten je zde přednastaven do hlavního prostoru Wikipedie, na články..
prefix - text ještě před textem šablony samotné. Také raději nepoužívat (není důvod).

Prefix

Zastaralý parametr prefix= ... přidává text na začátek. Kód {{Hlavní článek|prefix=Text prefixu.|článek 1|článek 2|článek 3}} dá výsledek:

Hlavní články: článek 1, článek 2 a článek 3

Mezery

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

Protahování platnosti odkazu i na další slovo, jak to má systém Wikipedie ve zvyku, je odstraněno tečkou za větou.

Kód	Výsledek
`{{Hlavní článek\| článek 1 \| článek 2 \| článek 3 }}`	Hlavní články: článek 1, článek 2 a článek 3
`{{Hlavní článek\|článek 1\|článek 2\|článek 3}}`	Hlavní články: článek 1, článek 2 a článek 3

Ošetření chyb vstupů

Případné chyby v použití jsou ověřovány a hlášeny.

Chybějící vstup

Kód {{Hlavní článek}} při použtí v článku zahlásí chybu:

CHYBA: {{Hlavní článek}} — Pro články vně jmenného prostoru „Kategorie“ je vyžadován alespoň jeden odkaz!

I proto jsou v ukázce použity přednastavené defaultní hodnoty.

Při použití {{Hlavní článek}} v kategorii bez zadání prvního vstupu se jako implicitní hodnota prvního vstupu převezme název kategorie.

Příliš mnoho vstupů

Kód {{Hlavní článek|článek1 |článek2 |článek3 |článek4 |článek5 |článek6 |článek7 |článek8 |článek9 |článek10 |článek11 |článek12 |článek13 |článek14 |článek15 |článek16 |článek17 |článek18 |článek19 |článek20 |článek21}} zahlásí chybu:

Hlavní články: článek1, článek2, článek4, článek8, článek16, článek17, článek9, článek18, článek5, článek10, článek20, článek21, článek11, článek3, článek6, článek12, článek13, článek7, článek14, článek19 a článek15

Nesouvislá řada vstupů

Kód {{Hlavní článek|článek 1|článek 2| |článek 3}} odkáže pouze na články zadané v souvislém sledu:

Hlavní články: článek 1, článek 2 a článek 3

Úmyslně je zvoleno přísnější vyhodnocování, protože je přesnější a předchází se tak nechtěnému chování volané šablony. Pokud mají být zobrazeny i odkazy za přeskočeným parametrem, nechť je volání šablony opraveno.

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í VisualEditoru.

Hlavní článek

specifikuje hlavní články asociované s touto kategorií

Parametry šablony
Parametr		Popis	Typ	Stav
článek 1	`1`	jméno 1. hlavního článku, pokud je odlišný kategorie Výchozí hodnota	Název stránky	nepovinný
článek 2	`2`	jméno 2. hlavního článku, pokud je odlišný kategorie Výchozí hodnota	Název stránky	nepovinný
článek 3	`3`	jméno 3. hlavního článku, pokud je odlišný kategorie Výchozí hodnota	Název stránky	nepovinný
článek 4	`4`	jméno 4. hlavního článku, pokud je odlišný kategorie Výchozí hodnota	Název stránky	nepovinný
článek 5	`5`	jméno 5. hlavního článku, pokud je odlišný kategorie Výchozí hodnota	Název stránky	nepovinný

Související šablony

{{Podrobně}} – odkaz v článku na podrobnější článek
{{Související kategorie}} – odkaz v kategorii na související kategorie
{{Viz též}} – odkaz v článku na související článek

@@ Řádek 1: / Řádek 1: @@
 {{Podstránka s dokumentací}}<!-- KATEGORIE, prosíme, přidávejte až na spodek této stránky -->
-Šablona je učena pouze pro kategorie, pro odkázání na jejich [[Nápověda:Hlavní článek|hlavní článek]], který pojednává o tématu dané kategorie.
 == Použití ==
-Šablona se používá {{případ správný|'''v úvodu kategorie'''}}. Pro mnoho případů postačí prosté:
+Šablona se používá v úvodu kategorie pro odkázání na [[Enviwiki:Kategorizace#Hlavní článek|hlavní článek]], který pojednává o tématu dané kategorie.
-:{{Šablona|Hlavní článek}}
-Při použití šablony bez parametru se název hlavního článku převezme z [[Wikipedie:Wikidata|Wikidat]]. Pokud na Wikidatech není parametr hlavního článku vyplněn, použije se jako název článku stejné jméno jako je název dané kategorie, jen bez označení jmenného prostoru „Kategorie:“.
+{{šablona|Hlavní článek|Název článku}}
-:{{šablona|Hlavní článek|Název článku}}
-Použití s parametrem názvu článku. Lze použít i odkazy na více článků, technicky maximální počet není přesně stanovený.
+Lze použít i odkazy na více článků, technicky maximální počet je dvacet.
-''Poznámka: Časté, avšak chybné, je použití této šablony {{případ špatný|pro odkaz v článku hlavního prostoru WP, pod titulkem kapitoly článku.}} {{případ správný|Pro odkaz na podrobnější článek je určená šablona {{šablona|Podrobně}}.}}''
+''Poznámka: Časté je také využití šablony pro odkaz na podrobnější článek pod nadpisem oddílu článku, k tomuto účelu je však určená šablona {{š|Podrobně}}.''
 === Příklady použití ===
-{| class="wikitable"
+{|class="wikitable"
 |-
-! Kód !! Výsledek
+!Kód
+!Výsledek
 |-
 |<code><nowiki>{{Hlavní článek|A}}</nowiki></code>
@@ Řádek 23: / Řádek 21: @@
 |<code><nowiki>{{Hlavní článek|A|B|C}}</nowiki></code>
 |{{Hlavní článek|A|B|C}}
+<!--
+|-
+|<code><nowiki>{{Hlavní článek|A|o1=Alternativní nadpis}}</nowiki></code>
+|{{Hlavní článek|A|o1=Alternativní nadpis}}
+|-
+|<code><nowiki>{{Hlavní článek|A|B|o2=Nadpis B|C|o1=Nadpis A|o3=Nadpis C}}</nowiki></code>
+|{{Hlavní článek|A|B|o2=Nadpis B|C|o1=Nadpis A|o3=Nadpis C}}
+-->
 |}
@@ Řádek 34: / Řádek 40: @@
 == Parametry ==
-* 1 ... 5 - cíle linků, nepojmenované parametry. Cíl 1 je jediný povinný parametr. I proto je v příkladu použit default. U těchto parametrů se předpokládá jejich souvislý sled. Cíl uvádět bez [[Nápověda:Jmenný prostor|namespace]]: Ten je zde přednastaven do hlavního prostoru Wikipedie, na články.
+* 1 .. 5 - cíle linků, nepojmenované parametry. Cíl 1 je jediný povinný parametr. I proto je v příkladu použit default. U těchto parametrů se  předpokládá jejich souvislý sled. Cíl uvádět bez [[Nápověda:Jmenný prostor|namespace]]: Ten je zde přednastaven do hlavního prostoru Wikipedie, na články..
+* prefix - text ještě před textem šablony samotné. Také raději nepoužívat (není důvod).
+=== Prefix ===
+Zastaralý parametr <code>prefix= ...</code> přidává text na začátek. Kód {{Šablona|Hlavní článek|2=prefix=Text prefixu.{{!}}článek 1{{!}}článek 2{{!}}článek 3}} dá výsledek:
+{{Hlavní článek|prefix=Text prefixu.|článek 1|článek 2|článek 3}}
 === Mezery ===
-Mezery se zde nestávají součástí předávané hodnoty, 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]].
+Mezery se zde nestávají součástí předávané hodnoty, ačkoli 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]].
-Protahování platnosti odkazu i na další slovo, jak to má systém Wikipedie ve zvyku, je odstraněno [[interpunkční znaménko|tečkou za větou]].
+Protahování platnosti odkazu i na další slovo, jak to má systém Wikipedie ve zvyku, je odstraněno [[w:cs:interpunkční znaménko|tečkou za větou]].
 {| class="wikitable"
 ! Kód !! Výsledek
@@ Řádek 55: / Řádek 66: @@
 ==== Chybějící vstup ====
-Kód {{Šablona|Hlavní článek}} při použtí v článku zahlásí [[Šablona:Chyba|chybu]]:
+Kód {{Šablona|Hlavní článek}} při použtí v článku zahlásí [[Šablona:chyba|chybu]]:
 {{Hlavní článek}}
@@ Řádek 61: / Řádek 72: @@
 I proto jsou v ukázce použity přednastavené defaultní hodnoty.
-Při použití {{Šablona|Hlavní článek}} v kategorii bez zadání prvního vstupu se jako hodnota prvního vstupu převezme hlavní článek podle Wikidat; pokud neexistuje, tak název kategorie.
+Při použití {{Šablona|Hlavní článek}} v kategorii bez zadání prvního vstupu se jako implicitní hodnota prvního vstupu převezme název kategorie.
+==== Příliš mnoho vstupů ====
+Kód {{Šablona|Hlavní článek|článek1 &#124;článek2 &#124;článek3 &#124;článek4 &#124;článek5 &#124;článek6 &#124;článek7 &#124;článek8 &#124;článek9 &#124;článek10 &#124;článek11 &#124;článek12 &#124;článek13 &#124;článek14 &#124;článek15 &#124;článek16 &#124;článek17 &#124;článek18 &#124;článek19 &#124;článek20 &#124;článek21}} zahlásí [[Šablona:chyba|chybu]]:
+{{Hlavní článek|článek1 |článek2 |článek3 |článek4 |článek5 |článek6 |článek7 |článek8 |článek9 |článek10 |článek11 |článek12 |článek13 |článek14 |článek15 |článek16 |článek17 |článek18 |článek19 |článek20 |článek21}}
+==== Nesouvislá řada vstupů ====
+Kód {{Šablona|Hlavní článek|článek 1&#124;článek 2&#124; &#124;článek 3}} odkáže pouze na články zadané v souvislém sledu:
+{{Hlavní článek|článek 1|článek 2| |článek 3}}
+Úmyslně je zvoleno přísnější vyhodnocování, protože je přesnější a předchází se tak nechtěnému chování volané šablony. Pokud mají být zobrazeny i odkazy za přeskočeným parametrem, nechť je volání šablony opraveno.
 == Data šablony ==
@@ Řádek 109: / Řádek 132: @@
 * {{Šablona|Související kategorie}} – odkaz v kategorii na související kategorie
 * {{Šablona|Viz též}} – odkaz v článku na související článek
-* {{Šablona|Redirect}} – zmínka o přesměrování na podkapitolu
 <includeonly>
-[[Kategorie:Šablony:Vnitřní odkazy|{{PAGENAME}}]]
+[[Kategorie:Šablony interních odkazů|{{PAGENAME}}]]
 [[Kategorie:Šablony hlaviček kategorií|{{PAGENAME}}]]
 [[Kategorie:Šablony úvodních upozornění|{{PAGENAME}}]]
-[[Kategorie:Wikipedie:Šablony používající údaje z Wikidat|{{PAGENAME}}]]
 </includeonly>