Šablona:EndSudOnly/doc: Porovnání verzí

Z Svět příběhů
Přejít na: navigace, hledání
(Založena nová stránka s textem „#PŘESMĚRUJ SudOnly/doc“)
 
m
 
(Nejsou zobrazeny 2 mezilehlé verze od stejného uživatele.)
Řádek 1: Řádek 1:
#PŘESMĚRUJ SudOnly/doc
+
{{Podstránka s dokumentací}}<!--  KATEGORIE prosím přidejte až na spodek této stránky  -->
 +
 
 +
Jde o dvojici šablon {{šablona|SudOnly}} a {{šablona|EndSudOnly}} vymezující vodorovnými kládami napříč stránkou takovou oblast článku, kde je prozrazována podstatná část děje, tedy aby čtenáři nebylo nechtěně pokaženo překvapení a zážitek z díla samotného, pokud ho ještě nezná.
 +
 
 +
== Použití ==
 +
:''Jednoduché shrnutí naleznete v článku [[Wikipedie:Varování SudOnly]].''
 +
 
 +
'''Šablona {{Šablona|SudOnly}}''' do článku přidá varování o možném prozrazení obsahu, filmu, knihy apod, a vymezí začátek takove oblasti článku:
 +
{{SudOnly}}
 +
 
 +
Odkaz na začátku vymezené oblasti vede na její konec, vymezená část článku se přeroluje, čtenář ji tak může snadno přeskočit.
 +
 
 +
'''Šablona {{Šablona|EndSudOnly}}''' zase ukončuje oblast s popisem obsahu:
 +
{{EndSudOnly}}
 +
 
 +
'''Syntax:''' <code><nowiki>{{SudOnly|název kotvy|ukazuj}}</nowiki></code>, <code><nowiki>{{EndSudOnly|název kotvy|ukazuj}}</nowiki></code>
 +
 
 +
'''Prvním''' přijímaným parametrem lze určit vlastní hodnoty ID pro počáteční a hlavně cílovou HTML kotvu. Z jediné hodnoty <code>"předaná kotva"</code> si pomocí prefixů obě šablony vytvoří obě ID, např: <code>"počáteční předaná kotva"</code> a <code>"cílová předaná kotva"</code>.
 +
 
 +
Jeden odskok lze ponechat s implicitním jménem, ale všechny další už je třeba pojmenovat. Explicitní určení názvu kotvy umožní označit více "SudOnly" oblastí v jediném článku: Bez přejmenování cíle by oba odskoky končily na stejném místě, na ostatní cíle by nebylo jak skočit.
 +
 
 +
'''Doporučený''' způsob volby názvu identifikátoru je copy&paste názvu kapitoly článku.
 +
 
 +
'''Varování:''' Duplicitní ID způsobí, že výsledné HTML bude z pohledu XML nevalidní! V běžné praxi by toto sice neměl být zásadní problém, ale důsledky v DHTML mohou být nepředvídatelné. Unikátnost identifikátorů je starostí editujícího wikipedisty.
 +
 
 +
Pro úspěšné spárování obou šablon se předpokládá, že '''oběma šablonám''', začátku i konci oblasti, bude dán '''stejný název kotvy''': To musí zajistit editující wikipedista.
 +
 
 +
{{SudOnly|Druhým parametrem|Druhým parametrem}}
 +
<code><nowiki>{{SudOnly|Druhým parametrem|Druhým parametrem}}</nowiki></code>
 +
 
 +
'''Druhým parametrem''' lze určit zda se mají ID kotev viditelně zobrazovat, na jeho hodnotě nezáleží. Tento parametr je dostupný jen pro úplnost: Jeho využití je spíše pro informativní účely a ladění, než pro samu funkci přeskakování vpřed. Předpokládá se jeho využití jen pro ''náhled'' před uložením, ale článek samotný by se měl ukládat bez této hodnoty.
 +
 
 +
<code><nowiki>{{EndSudOnly|Druhým parametrem|Druhým parametrem}}</nowiki></code>
 +
{{EndSudOnly|Druhým parametrem|Druhým parametrem}}
 +
 
 +
<includeonly>
 +
[[Kategorie:Součásti pro šablonu SudOnlyu]]
 +
</includeonly>

Aktuální verze z 20. 5. 2021, 15:06

Jde o dvojici šablon {{SudOnly}} a {{EndSudOnly}} vymezující vodorovnými kládami napříč stránkou takovou oblast článku, kde je prozrazována podstatná část děje, tedy aby čtenáři nebylo nechtěně pokaženo překvapení a zážitek z díla samotného, pokud ho ještě nezná.

Použití[editovat]

Jednoduché shrnutí naleznete v článku Wikipedie:Varování SudOnly.

Šablona {{SudOnly}} do článku přidá varování o možném prozrazení obsahu, filmu, knihy apod, a vymezí začátek takove oblasti článku: Šablona:SudOnly

Odkaz na začátku vymezené oblasti vede na její konec, vymezená část článku se přeroluje, čtenář ji tak může snadno přeskočit.

Šablona {{EndSudOnly}} zase ukončuje oblast s popisem obsahu:

Syntax: {{SudOnly|název kotvy|ukazuj}}, {{EndSudOnly|název kotvy|ukazuj}}

Prvním přijímaným parametrem lze určit vlastní hodnoty ID pro počáteční a hlavně cílovou HTML kotvu. Z jediné hodnoty "předaná kotva" si pomocí prefixů obě šablony vytvoří obě ID, např: "počáteční předaná kotva" a "cílová předaná kotva".

Jeden odskok lze ponechat s implicitním jménem, ale všechny další už je třeba pojmenovat. Explicitní určení názvu kotvy umožní označit více "SudOnly" oblastí v jediném článku: Bez přejmenování cíle by oba odskoky končily na stejném místě, na ostatní cíle by nebylo jak skočit.

Doporučený způsob volby názvu identifikátoru je copy&paste názvu kapitoly článku.

Varování: Duplicitní ID způsobí, že výsledné HTML bude z pohledu XML nevalidní! V běžné praxi by toto sice neměl být zásadní problém, ale důsledky v DHTML mohou být nepředvídatelné. Unikátnost identifikátorů je starostí editujícího wikipedisty.

Pro úspěšné spárování obou šablon se předpokládá, že oběma šablonám, začátku i konci oblasti, bude dán stejný název kotvy: To musí zajistit editující wikipedista.

Šablona:SudOnly {{SudOnly|Druhým parametrem|Druhým parametrem}}

Druhým parametrem lze určit zda se mají ID kotev viditelně zobrazovat, na jeho hodnotě nezáleží. Tento parametr je dostupný jen pro úplnost: Jeho využití je spíše pro informativní účely a ladění, než pro samu funkci přeskakování vpřed. Předpokládá se jeho využití jen pro náhled před uložením, ale článek samotný by se měl ukládat bez této hodnoty.

{{EndSudOnly|Druhým parametrem|Druhým parametrem}}