Šablona:Zvýrazňovač/doc

Šablona zvýrazňovač umožňuje zvýraznění textu podobně jako označení zvýrazňovačem na papíře, a to i českými názvy některých základních barev (v ženském rodě).

Navíc šablona vybrané barvy předefinovává, aby je zesvětlila, jinak by běžný černý text na příliš tmavém pozadí standardních sytých barev byl špatně čitelný.

Použití

Použijte tento copypaste: {{Zvýrazňovač|_text_|barva=_barva_|title=_title_}}

Příklady {{Zvýrazňovač|chci zelený podklad|barva=zelená|title=příklad: zelený podklad}} dá chci zelený podklad, zde zrovna v barvě definované uvnitř samotné šablony.

Syntaxe

 {{Zvýrazňovač|_text_
             [|barva=_barva_]
             [|title=_title_]
 }}

[...] zde značí nepovinnost parametru

Pořadí parametrů není nutné dodržovat.

Parametry

Text ke zvýraznění

• |1 – libovolný řetězec, text ke zvýraznění

Text prázdný nebo z mezer

Vstup je sice je nepovinný, nevyhodí chybu, takové použití |1 však nemá smysl.

• Volání "{{Zvýrazňovač}}" dá výsledek "{{{1}}}".
• Volání "{{Zvýrazňovač|}}" dá výsledek "".
• Volání "{{Zvýrazňovač| }}" dá výsledek " ".
• Volání "{{Zvýrazňovač|  }}" dá výsledek " ".
• Volání "{{Zvýrazňovač| <nowiki />}}" dá výsledek " ".

Parametr barva

• |barva = žlutá – kód barvy pozadí zvýrazňovaného textu; nepovinný.

určení barvy

• kódem RGB pro požadovanou barevu, ve formátu #RRGGBB nebo #RGB, jak jsou používány v CSS,
• názvem barvy.

Zpět na obsah

Možné názvy

standardní

Standardní názvy barev jsou definovány konsorciem W3C, viz seznam pojmenovaných barev.

šablonou předefinované

Šablona některé názvy definuje úplně nové, zejména české, malými písmeny, některé již definované, existující a běžně používané, takto předefinovává na jiné hodnoty: Cílem je změna pozadí textu, typicky tedy jsou místně definované barvy poněkud zesvětlené, pro lepší čitelnost standardního černého textu.

Šablona manipuluje s těmito barvami a jejich názvy:

• žlutá – pro zvýraznění textu použita barva žlutá, yellow a Yellow
• sv.žlutá – pro zvýraznění textu použita barva sv.žlutá
• zelená – pro zvýraznění textu použita barva zelená, green, ale standardně Green
• sv.zelená – pro zvýraznění textu použita barva sv.zelená
• modrá – pro zvýraznění textu použita barva modrá, blue, ale standardně Blue
• sv.modrá – pro zvýraznění textu použita barva sv.modrá
• červená – pro zvýraznění textu použita barva červená, red, ale standardně Red
• růžová – pro zvýraznění textu použita barva růžová, pink, ale standardně Pink
• cyanová – pro zvýraznění textu použita barva cyanová, cyan a Cyan
• sv.cyanová – pro zvýraznění textu použita barva sv.cyanová, lightcyan a LightCyan
• šedá – pro zvýraznění textu použita barva šedá, grey, ale standardně Grey
• bílá – pro zvýraznění textu použita barva bílá, white a White
• hnědá – pro zvýraznění textu použita barva hnědá, brown, ale standardně Brown

Jiné barvy, zde neuvedené, šablona zobrazí beze změny, čímž je ponechána možnost odkazu na předefinované standardní názvy barev. (Například s velkými písmeny, což rozlišuje šablona, ne však CSS.)

Barva nezadána

hodnota délky nula

Jako výchozí hodnota pro určení barvy zvýraznění, když žádná není výslovně zadána ({prázdná}), se používá žlutá, taková je uvnitř šablony přednastavena.

hodnota barvy neprázdná, ale mezera

Hodnoty pojmenovaných parametrů jsou běžně trimovány, přesto lze zadat vstup i jen z mezer, výslovně:

• "{{Zvýrazňovač|barva ani nezmíněna|}}" dá výsledek "barva ani nezmíněna"
• "{{Zvýrazňovač|barva prázdná, bez mezer|barva=}}" dá výsledek "barva prázdná, bez mezer"
• "{{Zvýrazňovač|barva z mezer, ořezaných|barva= }}" dá výsledek "barva z mezer, ořezaných"
• "{{Zvýrazňovač|barva z výslovných mezer|barva=  }}" dá výsledek "barva z výslovných mezer"
• "{{Zvýrazňovač|barva z výslovných mezer|barva= <nowiki />}}" dá výsledek "barva z výslovných mezer"

Zpět na obsah

Parametr title

• |title = zvýrazněno – tooltip, text ke zobrazení v bublině při nadjetí myší na zvýrazňovaný text; nepovinný.

Příklady použití

• Seznam stránek používajících Zvýrazňovač

Zvýraznění bez určení barvy

Lorem ipsum {{Zvýrazňovač|dolor}} sit amet.

Lorem ipsum dolor sit amet.

Zvýraznění barvou určenou názvem

Lorem ipsum {{Zvýrazňovač|dolor|barva=zelená}} sit amet.

Lorem ipsum dolor sit amet.

Zvýraznění barvou určenou kódem

Používejte velmi uváženě jen tam, kde je to nezbytné.

Lorem ipsum {{Zvýrazňovač|dolor|barva=#C9F}} sit amet.

Lorem ipsum dolor sit amet.

Určená barva nerozpoznána

Lorem ipsum {{Zvýrazňovač|dolor|barva=132xyz}} sit amet.

Postup vyhodnocování:

1. Detekce prázdného vstupu, použila by se přednastavená barva. (první default)
2. Detekce hodnot ze seznamu, použila by se dohledaná barva z šablony.
3. Barva šablonou nerozpoznána, vstupní hodnota tedy beze změny propadne šablonou (druhý default) do generovaného HTML (opravdu tam bude zapsaná), kde ji zpracuje browser jako CSS hodnotu:
   • A to se mu buď povede,
   • anebo ji bude ignorovat.

Lorem ipsum dolor sit amet.

<span style="background-color: 132xyz;">dolor</span>

Zpět na obsah