⋮ 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:

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ů:

  • column odpovídá zarovnání vlevo u jazyků typu LTR a zarovnání vpravo u jazyků typu RTL
  • left zarovná wrap vlevo
  • right zarovná wrap vpravo
  • center umí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.

  • half vytvoří dva sloupce v řadě
  • third vytvoří tři sloupce v řadě
  • quarter vytvoří čtyři sloupce v řadě
  • twothirds spolu s third vytvoří 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:

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

  • box vytvoří rámeček kolem kontejneru a použije výchozí barvy ze souboru šablony style.ini (__background_alt__ a __text__)
  • třídy info, tip, important, alert, help, download, todo vytvoří speciální poznámkový kontejner s odpovídající ikonou
  • třídy danger, warning, caution, notice, safety využívají bezpečnostní barvy (bez ikon)
  • round lze 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 help></WRAP>

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>

Výstraha

<WRAP caution></WRAP>

Oznámení

<WRAP notice></WRAP>

Bezpečnost

<WRAP 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, stažení, úkol, zaoblený box, nebezpečí, varování, výstraha, oznámení, bezpečnost

<wrap info>info</wrap>, <wrap help>nápověda</wrap>, atd.

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á
šířku 80 %
<WRAP tablewidth 80%>
^ Tabulka ^ má   ^
| šířku   | 80 % |
</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: Syntaxe formátování

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

Tento text se zobrazí na obrazovce, ale nebude vytištěn.

<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>

Kotva

Kotva umožňuje definovat konkrétní místo na stránce, na které lze odkazovat.

K definování kotvy použijte následující syntaxi:

<wrap #nazevkotvy />

Na kotvu lze odkazovat pomocí: #nazevkotvy
Vyzkoušejte: nazevkotvy

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 2026-02-03 19:19

1)
To znamená „Toto je hebrejština“, alespoň podle Google Translate.