Š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.
--->
 == Použití ==
-Šablona je požívána jak pro určení hlavního článku '''v podrobných článcích''', tak i '''v záhlaví kategorií'''. V obou případech se sice vkládá stejný text, ovšem zobrazení v článcích se může při porovnání se zobrazením v kategoriích lišit.
+Šablona se používá {{případ správný|'''v úvodu kategorie'''}}. Pro mnoho případů postačí prosté:
+:{{Šablona|Hlavní článek}}
-Lze použít i více odkazů na články, maximálně deset, a pro každý odkaz lze zadat jiný popisek ke zobrazení.
+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ý.
+''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
 |-
-| <pre>{{Hlavní článek|A}}</pre>
+|<code><nowiki>{{Hlavní článek|A}}</nowiki></code>
-|      {{Hlavní článek|A}}
+|{{Hlavní článek|A}}
 |-
-| <pre>{{Hlavní článek|A|B|C}}</pre>
+|<code><nowiki>{{Hlavní článek|A|B|C}}</nowiki></code>
-|      {{Hlavní článek|A|B|C}}
+|{{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
 |-
-| <pre>{{Hlavní článek|A|o1=Alternativní nadpis}}</pre>
+|<code><nowiki>{{Hlavní článek| článek 1 &#124; článek 2 &#124; článek 3 }}</nowiki></code>
-|      {{Hlavní článek|A|o1=Alternativní nadpis}}
+|{{Hlavní článek| článek 1 | článek 2 | článek 3 }}
 |-
-| <pre>{{Hlavní článek|A|B|o2=Nadpis B|C|o1=Nadpis A|o3=Nadpis C}}</pre>
+|<code><nowiki>{{Hlavní článek|článek 1&#124;článek 2&#124;článek 3}}</nowiki></code>
-|      {{Hlavní článek|A|B|o2=Nadpis B|C|o1=Nadpis A|o3=Nadpis C}}
+|{{Hlavní článek|článek 1|článek 2|článek 3}}
-<!--
-|-
-| <pre>{{Hlavní článek|A|písmo=kurzíva}}</pre>
-|      {{Hlavní článek|A|písmo=kurzíva}}
--->
 |}
-<includeonly><!-- KATEGORIE a INTERWIKI zde, děkujeme -->
+=== Ošetření chyb vstupů ===
-[[Kategorie:Šablony interních odkazů|{{PAGENAME}}]]
+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
-<!--interwiki-->
+<includeonly>
-[[af:Sjabloon:Hoofartikel]]
+[[Kategorie:Šablony:Vnitřní odkazy]]
-[[an:Plantilla:Catmás]]
+[[Kategorie:Šablony:Hlavičky kategorií]]
-[[ar:قالب:مزيد]]
+[[Kategorie:Wikipedie:Šablony používající údaje z Wikidat]]
-[[bg:Шаблон:Категория инфо]]
-[[bn:Template:মূল নিবন্ধ]]
-[[ca:Plantilla:Infocat]]
-[[da:Skabelon:Katmere]]
-[[el:Πρότυπο:Catmore]]
-[[en:Template:Catmore]]
-[[eo:Ŝablono:Catmore]]
-[[es:Plantilla:Catmás]]
-[[eu:Txantiloi:Nagusia]]
-[[fr:Modèle:Article principal]]
-[[gu:Template:Catmore]]
-[[hr:Predložak:Catmore]]
-[[hsb:Předłoha:HlejTežKategorija]]
-[[hu:Sablon:Kategóriaszócikk]]
-[[hy:Կաղապար:CatMain]]
-[[ia:Patrono:Catmore]]
-[[id:Templat:Artikelutama]]
-[[is:Snið:Skoða meira]]
-[[ja:Template:Catmore]]
-[[ko:틀:분류 설명]]
-[[lb:Template:Catmore]]
-[[li:Sjabloon:Catmore]]
-[[lt:Šablonas:Plačiau]]
-[[lv:Veidne:Catmore]]
-[[mk:Шаблон:Катпов]]
-[[no:Mal:Hovedartikkel]]
-[[oc:Modèl:ArticlePrincipal]]
-[[pl:Szablon:Artykuł kategorii]]
-[[pt:Predefinição:Catmore]]
-[[ro:Format:Catmore]]
-[[ru:Шаблон:CatMain]]
-[[sh:Template:Main]]
-[[sk:Šablóna:Catmore]]
-[[sl:Predloga:Članek ktgr]]
-[[sr:Шаблон:Кат]]
-[[sv:Mall:Huvudartikel]]
-[[tl:Template:Catmore]]
-[[tr:Şablon:Kategori açıklaması]]
-[[uk:Шаблон:Докладніше]]
-[[vi:Tiêu bản:Bài chính thể loại]]
-[[zh:Template:Catmore]]
 </includeonly>