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

Verze z 23. 6. 2015, 11:32

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}}

Při použití šablony bez parametru se název hlavního článku převezme z 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:“.

{{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ý.

Poznámka: Časté, avšak chybné, 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.

Mezery

Mezery se zde nestávají součástí předávané hodnoty, 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 hodnota prvního vstupu převezme hlavní článek podle Wikidat; pokud neexistuje, tak název kategorie.

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
{{Redirect}} – zmínka o přesměrování na podkapitolu

@@ Řádek 10: / Řádek 10: @@
 {{š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 je dvacet.
+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ý.
 ''Poznámka: Časté, avšak chybné, 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
+! Kód !! Výsledek
-!Výsledek
 |-
 |<code><nowiki>{{Hlavní článek|A}}</nowiki></code>
@@ Řádek 25: / Řádek 24: @@
 |<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 44: / Řádek 35: @@
 == 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, 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]].
+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]].
 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]].
 {| class="wikitable"
 ! Kód !! Výsledek
@@ Řádek 70: / Řádek 56: @@
 ==== 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 77: / Řádek 63: @@
 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ří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 ==