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

Z Svět příběhů
Přejít na: navigace, hledání
m
 
Řádek 1: Řádek 1:
 
{{Podstránka s dokumentací}}<!--  KATEGORIE prosím přidejte až na spodek této stránky  -->
 
{{Podstránka s dokumentací}}<!--  KATEGORIE prosím přidejte až na spodek této stránky  -->
  
Jde o dvojici šablon {{šablona|Spoiler}} a {{šablona|Endspoiler}} 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á.
+
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í ==
 
== Použití ==
:''Jednoduché shrnutí naleznete v článku [[Wikipedie:Varování spoiler]].''
+
:''Jednoduché shrnutí naleznete v článku [[Wikipedie:Varování SudOnly]].''
  
'''Šablona {{Šablona|Spoiler}}''' 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 {{Š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:
{{Spoiler}}
+
{{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.
 
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|Endspoiler}}''' zase ukončuje oblast s popisem obsahu:
+
'''Šablona {{Šablona|EndSudOnly}}''' zase ukončuje oblast s popisem obsahu:
{{Endspoiler}}
+
{{EndSudOnly}}
  
'''Syntax:''' <code><nowiki>{{Spoiler|název kotvy|ukazuj}}</nowiki></code>, <code><nowiki>{{Endspoiler|název kotvy|ukazuj}}</nowiki></code>
+
'''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>.
 
'''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 "spoiler" 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.
+
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.
 
'''Doporučený''' způsob volby názvu identifikátoru je copy&paste názvu kapitoly článku.
Řádek 26: Řádek 26:
 
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.
 
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.
  
{{Spoiler|Druhým parametrem|Druhým parametrem}}
+
{{SudOnly|Druhým parametrem|Druhým parametrem}}
<code><nowiki>{{Spoiler|Druhým parametrem|Druhým parametrem}}</nowiki></code>
+
<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.
 
'''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>{{Endspoiler|Druhým parametrem|Druhým parametrem}}</nowiki></code>
+
<code><nowiki>{{EndSudOnly|Druhým parametrem|Druhým parametrem}}</nowiki></code>
{{Endspoiler|Druhým parametrem|Druhým parametrem}}
+
{{EndSudOnly|Druhým parametrem|Druhým parametrem}}
  
 
<includeonly>
 
<includeonly>
[[Kategorie:Součásti pro šablonu spoileru]]
+
[[Kategorie:Součásti pro šablonu SudOnlyu]]
 
</includeonly>
 
</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}}