Šablona:Hlavní článek/doc

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 je dvacet.

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..
• 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:

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.

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