Šablona:Hlavní článek/doc: Porovnání verzí
cs>Mion238 (prd prd prd) |
m (naimportováno 71 revizí) |
||
(Není zobrazeno 42 mezilehlých verzí od 17 dalších uživatelů.) | |||
Řádek 1: | Řádek 1: | ||
{{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í == | == 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 | článek 2 | č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|článek 2|č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> |
Aktuální verze z 4. 8. 2018, 05:48
Š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|B|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ánek|článek 1|článek 2|č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:
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í
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[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