Editace stránky Šablona:Hlavní článek/doc

{{Podstránka s dokumentací}}<!-- KATEGORIE, prosíme, přidávejte až na spodek této stránky -->
{{Tisíckrát}}
Š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|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}}

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 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ě}}.}}''

=== Příklady použití ===
{| class="wikitable"
|-
! Kód !! Výsledek
|-
|<code><nowiki>{{Hlavní článek|A}}</nowiki></code>
|{{Hlavní článek|A}}
|-
|<code><nowiki>{{Hlavní článek|A|B|C}}</nowiki></code>
|{{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 {{Šablona|Podrobně}}
* pro článek zabývající se souvisejícím tématem použijte {{Šablona|Viz též}}

Pokud chcete odkázat na související kategorii:
* vložte do kategorie odkaz pomocí šablony {{Šablona|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 [[Nápověda:Jmenný prostor|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 [[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
|-
|<code><nowiki>{{Hlavní článek| článek 1 &#124; článek 2 &#124; článek 3 }}</nowiki></code>
|{{Hlavní článek| článek 1 | článek 2 | článek 3 }}
|-
|<code><nowiki>{{Hlavní článek|článek 1&#124;článek 2&#124;článek 3}}</nowiki></code>
|{{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 {{Šablona|Hlavní článek}} při použtí v článku zahlásí [[Šablona:Chyba|chybu]]:

{{Hlavní článek}}

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.

== Data šablony ==
{{TemplateDataHeader}}
<templatedata>{
"description": "specifikuje hlavní články asociované s touto kategorií",
"params": {
  "1": {
    "label": "článek 1",
    "description": "jméno 1. hlavního článku, pokud je odlišný kategorie",
    "type": "string/wiki-page-name",
    "default": "",
    "required": false
  },
  "2": {
    "label": "článek 2",
    "description": "jméno 2. hlavního článku, pokud je odlišný kategorie",
    "type": "string/wiki-page-name",
    "default": "",
    "required": false
  },
  "3": {
    "label": "článek 3",
    "description": "jméno 3. hlavního článku, pokud je odlišný kategorie",
    "type": "string/wiki-page-name",
    "default": "",
    "required": false
  },
  "4": {
    "label": "článek 4",
    "description": "jméno 4. hlavního článku, pokud je odlišný kategorie",
    "type": "string/wiki-page-name",
    "default": "",
    "required": false
  },
  "5": {
    "label": "článek 5",
    "description": "jméno 5. hlavního článku, pokud je odlišný kategorie",
    "type": "string/wiki-page-name",
    "default": "",
    "required": false
  }
}}</templatedata>

== Související šablony ==
* {{Šablona|Podrobně}} – odkaz v článku na podrobnější článek
* {{Š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]]
[[Kategorie:Šablony:Hlavičky kategorií]]
[[Kategorie:Wikipedie:Šablony používající údaje z Wikidat]]
</includeonly>