⋮ Obsah
Syntaxe Wrap
Příklady použití pluginu Wrap
Základní syntaxe
<WRAP> velkými písmeny „verzálkami“ (případně <block> nebo <div>) vytvoří prvek typu div a měl by se používat pro „velké“ kontejnery, které obklopují odstavce, seznamy, tabulky apod.
<WRAP třídy #id šířka :jazyk> „velký“ obsah </WRAP> nebo <block třídy #id šířka :jazyk> „velký“ obsah </block> nebo <div třídy #id šířka :jazyk> „velký“ obsah </div>
<wrap> malými písmeny „minuskami“ (případně <inline> nebo <span>) vytvoří prvek typu span a měl by se používat pro „malé“ kontejnery, které se nacházejí uvnitř odstavců, seznamů, tabulek apod.
<wrap třídy #id šířka :jazyk>„malý“ obsah</wrap> nebo <inline třídy #id šířka :jazyk>„malý“ obsah</inline> nebo <span třídy #id šířka :jazyk>„malý“ obsah</span>
Upozornění: některé funkce nefungují s malými prvky typu span:
- zarovnání (včetně zarovnání vzniklého změnou směru textu)
- vícesloupcové rozvržení
- a šířky
pokud daný wrap není zároveň plovoucí (floated).
Zkrácená syntaxe pomocí velkého <WRAP /> a malého <wrap /> je dostupná, pokud je kontejner prázdný nebo není potřeba.
<WRAP třídy #id /> nebo <block třídy #id /> nebo <div třídy #id />
a
<wrap třídy #id /> nebo <inline třídy #id /> nebo <span třídy #id />
Třídy a styly
Sloupce a plovoucí prvky
Sloupce lze snadno vytvořit přidáním třídy column a nastavením šířky, např.
<WRAP column 30%>…obsah…</WRAP>
Následující příklad využívá tuto strukturu:
<WRAP group> <WRAP third column>…obsah…</WRAP> <WRAP third column>…obsah…</WRAP> <WRAP third column>…obsah…</WRAP> </WRAP>
Možnosti plovoucího zarovnání
Obvykle postačí použít třídu column, ale pro pokročilejší použití (nejen pro sloupce, ale i pro jiné třídy, jako např. boxy a poznámky) lze využít různé typy „plovoucích“ prvků:
columnodpovídá zarovnání vlevo u jazyků typu LTR a zarovnání vpravo u jazyků typu RTLleftzarovná wrap vlevorightzarovná wrap vpravocenterumístí wrap horizontálně doprostřed stránky
Šířky
Lze nastavit libovolné platné jednotky šířky (pouze pro divy): %, px, em, rem, ex, ch, vw, vh, pt, pc, cm, mm, in, ale nejčastěji se používají:
| typ | např. | poznámka |
|---|---|---|
% | 30% | vhodné ve většině případů |
px | 420px | vhodné pro kontejnery s obrázky o dané šířce |
em | 20em | vhodné pro kontejnery, které se mají přizpůsobovat velikosti písma |
Klíčová slova pro šířku
Pomocí určitých klíčových slov lze automaticky přizpůsobit sloupce dostupnému horizontálnímu prostoru. Tyto sloupce se také přizpůsobují velikosti obrazovky, takže jsou responzivní a na mobilních zařízeních se zalamují pod sebe.
Existují čtyři klíčová slova pro šířku. Neměla by se kombinovat s jinými šířkami, pouze third lze kombinovat s twothirds.
halfvytvoří dva sloupce v řaděthirdvytvoří tři sloupce v řaděquartervytvoří čtyři sloupce v řadětwothirdsspolu sthirdvytvoří poměr 2/3 a 1/3 v jedné řadě
Pozor: Aby klíčová slova pro šířku fungovala správně, je nutné obalit jejich sadu pomocí
<WRAP group>. Pokud kombinujete více typů v jedné skupině, může být potřeba přidat <WRAP clear /> za řadu.
Možnosti lze použít i u prvků typu span (protože každý plovoucí prvek se automaticky stává blokovým prvkem), ale obvykle to nedává smysl. Šířky u span prvků obvykle nefungují (záměrně), ale mohou být užitečné, pokud je prvek plovoucí.
Pozor: Jaký je rozdíl mezi běžnými šířkami a klíčovými slovy pro šířku - a kdy je vhodné co použít? Běžné šířky mohou způsobovat problémy a nikdy se zcela nesčítají, což může vést k narušení rozvržení (viz box model pro technické vysvětlení). Správné nastavení šířek vyžaduje testování v různých prohlížečích. Klíčová slova pro šířku se přizpůsobují automaticky a fungují lépe na mobilních zařízeních. Nevýhodou je nutnost obalujícího wrapu a nekompatibilita se staršími prohlížeči (IE8 a starší).
Všechny tyto možnosti lze použít i v wrapech typu boxy a poznámky (viz níže).
Emulované nadpisy (zastaralé)
Pokud je aktivována konfigurační volba emulatedHeadlines, každý text ve formátu //**__text jako tento__**// nebo //**takto**// vytvoří „emulovaný nadpis“ uvnitř wrapu. Tato funkce je zastaralá a bude v budoucnu odstraněna, protože běžné nadpisy uvnitř wrapů jsou již plně podporovány.
Pokud je tato volba aktivní a potřebujete pouze tučný a kurzívní text bez nadpisu, použijte opačné pořadí: **//Bez nadpisu//**.
Vícesloupcové rozvržení
Vícesloupcové rozvržení funguje nejlépe v moderních prohlížečích (nefunguje v IE9 a starších) a mělo by být považováno za experimentální, protože chování některých prohlížečů je stále nekonzistentní a chybové.
Stačí použít: colsmall pro sloupce s malou šířkou, colmedium pro střední šířku a collarge pro velkou šířku.
Nebo: col2 pro 2 sloupce, col3 pro 3 sloupce, col4 pro 4 sloupce, col5 pro 5 sloupců.
První typ sloupců je určen šířkou, druhý počtem. Sloupce podle šířky jsou vhodné pro různá rozvržení a přizpůsobení různým zařízením.
Poznámka: Vícesloupcové rozvržení nedává smysl pro prvky typu span.
Nepoužívejte tento typ rozvržení pro větší sloupce obsahující více než jen text. V takovém případě použijte sloupce a plovoucí prvky uvedené výše.
Zarovnání
Lze použít následující typy zarovnání textu:
leftalign– zarovnání vlevorightalign– zarovnání vpravocenteralign– zarovnání na středjustify– zarovnání do bloku
Text zarovnaný na střed…
…a text zarovnaný vpravo.
<WRAP centeralign> Text zarovnaný na střed… </WRAP> <WRAP rightalign> …a text zarovnaný vpravo. </WRAP>
Zarovnání nelze použít u prvků typu span.
Boxy a poznámky
Zaoblený box 500px na střed
boxvytvoří rámeček kolem kontejneru a použije výchozí barvy ze souboru šablonystyle.ini(__background_alt__a__text__)- třídy
info,tip,important,alert,help,download,todovytvoří speciální poznámkový kontejner s odpovídající ikonou - třídy
danger,warning,caution,notice,safetyvyužívají bezpečnostní barvy (bez ikon) roundlze přidat k libovolnému prvku s pozadím nebo rámečkem; funguje pouze v moderních prohlížečích (nefunguje v IE8 a starších)
Informace
<WRAP info></WRAP>
Tip
<WRAP tip></WRAP>
Důležité
<WRAP important></WRAP>
Upozornění
<WRAP alert></WRAP>
Nápověda
<WRAP round help></WRAP>
Ke stažení
<WRAP download></WRAP>
Úkol
<WRAP todo></WRAP>
Bezpečnostní poznámky:
V bezpečnostních poznámkách doporučujeme používat pouze jednoduché formátování.
Nebezpečí
<WRAP danger></WRAP>
Varování
<WRAP warning></WRAP>
Opatrnost
<WRAP caution></WRAP>
Poznámka
<WRAP round notice></WRAP>
Bezpečnost
<WRAP round safety></WRAP>
Poznámky a boxy lze použít i uvnitř textu pomocí prvků typu span: info, nápověda, upozornění, důležité, tip, ke stažení, úkol, zaoblený box, nebezpečí, varování, opatrnost, poznámka, bezpečnost info, nápověda, …
Zvýraznění textu (Marks)
Text lze označit jako zvýrazněný, méně významný nebo zvláště zdůrazněný.
Text lze označit jako <wrap hi>zvýrazněný</wrap>, <wrap lo>méně významný</wrap> nebo <wrap em>zvláště zdůrazněný</wrap>.
Upozornění: V některých šablonách může vzhled těchto označení působit nevhodně - doporučuje se jejich vzhled upravit podle potřeby.
Záložky (Tabs)
Řadu záložek lze vytvořit jednoduše tak, že seznam odkazů obalíte pomocí <WRAP tabs></WRAP>.
<WRAP tabs> * [[syntaxe wrap|Nějaká stránka]] * [[syntaxe wrap|Tato stránka]] * [[syntaxe wrap|Další stránka]] </WRAP>
Upozornění: Vzhled těchto záložek závisí na použité šabloně, nikoli na pluginu Wrap. Pokud vidíte pouze seznam odkazů bez záložek, ujistěte se, že jste přidali „tabs“ do konfigurační volby
noPrefix a že vaše šablona podporuje alespoň verzi DokuWiki „Angua“ z 25. 1. 2012.
Různé funkce
Vymazání plovoucího zarovnání
Po použití tříd pro plovoucí prvky se může stát, že následující text zasahuje do prostoru vyhrazeného pouze pro plovoucí kontejnery. K tomu, abyste tomu zabránili, jednoduše přidejte:
<WRAP clear />
Šířka tabulky
Šířku tabulky lze nastavit pomocí třídy tablewidth. Každá tabulka uvnitř tohoto wrapu bude mít vždy šířku 100 %. Tím lze nastavit libovolnou šířku tabulky přidáním šířky k wrapu (nebo žádnou pro 100 %).
| Tabulka | má |
|---|---|
| 80% | šířku |
<WRAP tablewidth 80%> ^ Tabulka ^ má ^ | 80% | šířku | </WRAP>
Odsazení
Tento text bude zobrazen s odsazením.
<wrap indent>Tento text bude zobrazen s odsazením.</wrap>
Záporné odsazení
Tento text bude zobrazen s „negativním“ odsazením.
<wrap outdent>Tento text bude zobrazen s „negativním“ odsazením.</wrap>
Zalomení v kódu
Uvnitř tohoto bloku kódu se slova zalomí na nový řádek, i když jsou všechna na jednom řádku.
<WRAP prewrap 250px> <code> Uvnitř tohoto bloku kódu se slova zalomí na nový řádek, i když jsou všechna na jednom řádku. </code> </WRAP>
Spoiler
Následuje spoiler: Darth Vader je Lukův otec.
Následuje spoiler: <wrap spoiler>Darth Vader je Lukův otec.</wrap>
Text ve spoileru lze přečíst výběrem myší.
Tlačítkové odkazy
Odkaz, který vypadá jako tlačítko:
Odkaz, který vypadá jako tlačítko: <wrap button>[[wiki:Syntax]]</wrap>
Skrytý text
Následující text je skrytý: Johne, prosím uprav tu větu.
Následující text je skrytý: <wrap hide>Johne, prosím uprav tu větu.</wrap>
Upozornění: Text je stále viditelný ve zdrojovém kódu, v ne-moderních prohlížečích a je dohledatelný. Nepoužívejte tuto funkci pro citlivé nebo bezpečnostní informace!
Zalomení stránky
Následující prvek přidá zalomení stránky:
Následující prvek přidá zalomení stránky: <WRAP pagebreak />
Toto nemá žádný vliv na zobrazení v prohlížeči. Zalomení stránky vynutí novou stránku při tisku.
Zákaz zalomení stránky
Následující prvek se pokusí zabránit zalomení stránky:
obsah, který má zůstat pohromadě (např. dlouhá tabulka)
Následující prvek se pokusí zabránit zalomení stránky: <WRAP nopagebreak>obsah, který má zůstat pohromadě (např. dlouhá tabulka)</WRAP>
Toto také nemá vliv na zobrazení v prohlížeči. Při tisku se pokusí zabránit zalomení stránky.
Pouze obrazovka / pouze tisk
<wrap noprint>Tento text se zobrazí na obrazovce, ale nebude vytištěn.</wrap>
Onlyprint
Tento text se nezobrazí na obrazovce, ale bude vytištěn.
<wrap onlyprint>Tento text se nezobrazí na obrazovce, ale bude vytištěn.</wrap>
Kombinování a vnořování
Lze kombinovat a vnořovat všechny třídy a typy boxů, např.:
Vnější box plovoucí vpravo
Vnitřní vnořený box plovoucí vlevo a částečně zdůrazněný a zvýrazněný s vnořenou poznámkou uvnitř.
Text uvnitř vnějšího pravého boxu, ale pod vnitřním levým boxem.
Zaoblený tip box pod tím, po clear.
<WRAP box 350px right :cs> === Vnější box plovoucí vpravo === <WRAP 165px left> Vnitřní vnořený box plovoucí vlevo a částečně <wrap em hi>__zdůrazněný__ a __zvýrazněný__ s vnořenou <wrap notice>__poznámkou__</wrap> uvnitř</wrap>. </WRAP> Text uvnitř vnějšího pravého boxu, ale pod vnitřním levým boxem. <WRAP clear /> <WRAP round tip> Zaoblený tip box pod tím, po ''clear''. </WRAP> </WRAP>
Jazyk a směr textu
Jazyk a směr čtení wrap kontejneru lze změnit přidáním dvojtečky a kódu jazyka, např.:
<WRAP :he>
זה עברית. ((<wrap :cs>To znamená „Toto je hebrejština“, alespoň podle [[http://translate.google.com/|Google Translate]].</wrap>))
</WRAP>
זה עברית. 1)
Směr textu (rtl – zprava doleva, nebo ltr – zleva doprava) se nastaví automaticky a závisí výhradně na zvoleném jazyce. Seznam aktuálně podporovaných jazyků je dostupný na: http://meta.wikimedia.org/wiki/Template:List_of_language_names_ordered_by_code
(Pokud zadáte jazyk, který není v seznamu, nebude mít žádný účinek.)
— Překlad ✿ MartinR 2025-07-24 21:53