Š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|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|B|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:
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ánek|článek 1|článek 2|č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 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:
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:
Ú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í
| Parametr | Popis | Typ | Stav | |
|---|---|---|---|---|
| článek 1 | 1 | jméno 1. hlavního článku, pokud je odlišný kategorie
| Název stránky | nepovinný |
| článek 2 | 2 | jméno 2. hlavního článku, pokud je odlišný kategorie
| Název stránky | nepovinný |
| článek 3 | 3 | jméno 3. hlavního článku, pokud je odlišný kategorie
| Název stránky | nepovinný |
| článek 4 | 4 | jméno 4. hlavního článku, pokud je odlišný kategorie
| Název stránky | nepovinný |
| článek 5 | 5 | jméno 5. hlavního článku, pokud je odlišný kategorie
| 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