Šablona:Hlavní článek/doc

Z AppleWikipedia
Verze z 6. 1. 2014, 01:42, kterou vytvořil Admin (diskuse | příspěvky) (Založena nová stránka s textem „{{Podstránka s dokumentací}}<!-- KATEGORIE, prosíme, přidávejte až na spodek této stránky --> {{šablona|hlavní článek|článek}} == Použití …“)

(rozdíl) ← Starší verze | zobrazit aktuální verzi (rozdíl) | Novější verze → (rozdíl)
Přejít na: navigace, hledání

{{hlavní článek|článek}}

Použití

Šablona je požívána pro určení hlavního článku:

  • jak v podrobných článcích,
  • tak i v záhlavích kategorií.

V obou případech se sice vkládá stejný kód, ovšem zobrazení v článcích se může při porovnání se zobrazením v kategoriích lišit: Dva různé způsoby zobrazování, v závislosti na jmenném prostoru (namespace).

Lze použít i více odkazů na články, maximálně dvacet.

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

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 AppleWikipedie, 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 AppleWikipedie 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:

Chybí vstupní hodnota: Pro články v hlavním prostoru šablona {{Hlavní článek}} vyžaduje 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:

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 a článek 2

Ú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/doc

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

Parametry šablony
ParametrPopisTypVýchozí hodnotaStav
článek 11jméno 1. hlavního článku, pokud je odlišný kategoriewiki-page-nameprázdnénepovinný
článek 22jméno 2. hlavního článku, pokud je odlišný kategoriewiki-page-nameprázdnénepovinný
článek 33jméno 3. hlavního článku, pokud je odlišný kategoriewiki-page-nameprázdnénepovinný
článek 44jméno 4. hlavního článku, pokud je odlišný kategoriewiki-page-nameprázdnénepovinný
článek 55jméno 5. hlavního článku, pokud je odlišný kategoriewiki-page-nameprázdnénepovinný

Související šablony