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

Aktuální verze z 4. 8. 2018, 05:48

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.

Tato šablona je velmi často použita (i dalšími šablonami).

Každá změna se tak projeví na mnoha místech. Editujte ji s maximální obezřetností, jen pokud víte jistě, co děláte. Pokud úprava způsobí nečekané následky, urychleně ji vraťte. Veškeré experimenty byste měli raději provádět na pískovišti nebo ve svém uživatelském prostoru.

Šablona je učena pouze pro kategorie, pro odkázání na jejich hlavní článek, který pojednává o tématu dané kategorie.

Použití[editovat zdroj]

Šablona se používá v úvodu kategorie. Pro mnoho případů postačí prosté:

{{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 použití této šablony pro odkaz v článku hlavního prostoru WP, pod titulkem kapitoly článku. Pro odkaz na podrobnější článek je určená šablona {{Podrobně}}.

Příklady použití[editovat zdroj]

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í[editovat zdroj]

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[editovat zdroj]

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[editovat zdroj]

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ů[editovat zdroj]

Případné chyby v použití jsou ověřovány a hlášeny.

Chybějící vstup[editovat zdroj]

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[editovat zdroj]

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[editovat zdroj]

{{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 1: / Řádek 1: @@
-{{Podstránka s dokumentací}}
+{{Podstránka s dokumentací}}<!-- KATEGORIE, prosíme, přidávejte až na spodek této stránky -->
-<!--
+{{Tisíckrát}}
-    KATEGORIE a INTERWIKI prosím přidejte až na spodek této stránky
+Š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.
--->
-{{šablona|Hlavní článek|Článek}}
 == Použití ==
-Šablona je požívána pro určení hlavního článku:
+Šablona se používá {{případ správný|'''v úvodu kategorie'''}}. Pro mnoho případů postačí prosté:
-* jak v podrobných článcích,
+:{{Šablona|Hlavní článek}}
-* 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 [[Nápověda:Jmenný prostor|jmenném prostoru]] ([http://www.mediawiki.org/wiki/Help:Magic_words#Namespaces namespace]).
-Lze použít i více odkazů na články, maximálně dvacet.
+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}}
-== Příklady použití ==
+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ý.
-{|class="wikitable"
+''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
+! Kód !! Výsledek
-!Výsledek
 |-
 |<code><nowiki>{{Hlavní článek|A}}</nowiki></code>
@@ Řádek 24: / Řá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}}
--->
 |}
-== Parametry ==
+=== Nesprávné použití ===
-* 1 .. 20 - 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..
+Pokud odkazujete uvnitř článku (nikoli kategorie):
-* prefix - text ještě před textem šablony samotné. Také raději nepoužívat (není důvod).
+* 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éž}}
-=== Prefix ===
+Pokud chcete odkázat na související kategorii:
-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:
+* vložte do kategorie odkaz pomocí šablony {{Šablona|Související kategorie}}
-{{Hlavní článek|prefix=Text prefixu.|článek 1|článek 2|článek 3}}
+== 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, 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 61: / Řá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 67: / Řádek 62: @@
 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 implicitní hodnota prvního vstupu převzme název kategorie.
+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 ==
+{{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ě}} - pro odkaz na dílčí, zato podrobný článek v sekci článku
+* {{Šablona|Podrobně}} – odkaz v článku na podrobnější článek
-* {{Šablona|Viz též}}
+* {{Šablona|Související kategorie}} – odkaz v kategorii na související kategorie
-* {{Šablona|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 interních odkazů|{{PAGENAME}}]]
+[[Kategorie:Šablony:Vnitřní odkazy]]
-[[Kategorie:Šablony hlaviček kategorií|{{PAGENAME}}]]
+[[Kategorie:Šablony:Hlavičky kategorií]]
-[[Kategorie:Šablony úvodních upozornění|{{PAGENAME}}]]
+[[Kategorie:Wikipedie:Šablony používající údaje z Wikidat]]
 </includeonly>