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

Z Enviwiki
Skočit na navigaci Skočit na vyhledávání
cs>Matěj Orlický
(omezení na kategorie a další úpravy, více v diskusi)
m (naimportováno 71 revizí)
 
(Není zobrazeno 26 mezilehlých verzí od 10 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 -->
{{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á v úvodu kategorie pro odkázání na [[Wikipedie:Kategorizace#Hlavní článek|hlavní článek]], který pojednává o tématu dané kategorie.
Šablona se používá {{případ správný|'''v úvodu kategorie'''}}. Pro mnoho případů postačí prosté:
:{{Šablona|Hlavní článek}}


{{šablona|Hlavní článek|Název článku}}
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}}


Lze použít i odkazy na více článků, technicky maximální počet je dvacet.
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é je také využití šablony pro odkaz na podrobnější článek pod nadpisem oddílu článku, k tomuto účelu je však určená šablona {{š|Podrobně}}.''
''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í ===
=== Příklady použití ===
{|class="wikitable"
{| class="wikitable"
|-
|-
!Kód
! Kód !! Výsledek
!Výsledek
|-
|-
|<code><nowiki>{{Hlavní článek|A}}</nowiki></code>
|<code><nowiki>{{Hlavní článek|A}}</nowiki></code>
Řádek 21: Řádek 24:
|<code><nowiki>{{Hlavní článek|A|B|C}}</nowiki></code>
|<code><nowiki>{{Hlavní článek|A|B|C}}</nowiki></code>
|{{Hlavní článek|A|B|C}}
|{{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}}
-->
|}
|}


Řádek 40: Řádek 35:


== Parametry ==
== 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..
* 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.
* prefix - text ještě před textem šablony samotné. Také raději nepoužívat (není důvod).
 
=== Prefix ===
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:
 
{{Hlavní článek|prefix=Text prefixu.|článek 1|článek 2|článek 3}}


=== Mezery ===
=== 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]].
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"
{| class="wikitable"
! Kód !! Výsledek
! Kód !! Výsledek
Řádek 66: Řádek 56:


==== Chybějící vstup ====
==== 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}}
{{Hlavní článek}}
Řádek 72: Řádek 62:
I proto jsou v ukázce použity přednastavené defaultní hodnoty.
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řevezme 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 ==
== Data šablony ==
Řádek 132: Řádek 110:
* {{Šablona|Související kategorie}} – odkaz v kategorii na související kategorie
* {{Šablona|Související kategorie}} – odkaz v kategorii na související kategorie
* {{Šablona|Viz též}} – odkaz v článku na související článek
* {{Šablona|Viz též}} – odkaz v článku na související článek
* {{Šablona|Redirect}} – zmínka o přesměrování na podkapitolu


<includeonly>
<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>
</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
{{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:

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

ParametrPopisTypStav
článek 11

jméno 1. hlavního článku, pokud je odlišný kategorie

Výchozí hodnota
Název stránkynepovinný
článek 22

jméno 2. hlavního článku, pokud je odlišný kategorie

Výchozí hodnota
Název stránkynepovinný
článek 33

jméno 3. hlavního článku, pokud je odlišný kategorie

Výchozí hodnota
Název stránkynepovinný
článek 44

jméno 4. hlavního článku, pokud je odlišný kategorie

Výchozí hodnota
Název stránkynepovinný
článek 55

jméno 5. hlavního článku, pokud je odlišný kategorie

Výchozí hodnota
Název stránkynepovinný

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